Schnelleinstieg in die Clansuite-Entwicklung

[vain]

Hallo,

dieser Beitrag ist eine Anleitung für den Schnelleinstieg in die Clansuite-Entwicklung.

Behandelt wird:

• die Einrichtung eines lokalen Entwicklungs-Webservers
• das Holen des Clansuite-Quellcodes aus dem SVN-Archiv
• die Einrichtung der Entwicklungsumgebung (Stichworte: mysql, vhosts, hosts, putty, filezilla, webdevtools für Firefox)
• sowie die Installation der Clansuite Community Toolbar

Grundlage für die Beschreibung ist ein Windows-XP Betriebssystem - allerdings können die Schritte denkanalog für Linux übertragen werden.

[vain]

[Schritt 1] Einrichten des lokalen Webservers

Am einfachsten lässt sich ein Webserver installieren, indem man das XAMPP-Package von Apachefriends verwendet. Dieses Package ist bereits so eingerichtet, dass es ohne großen Konfigurationsaufwand lauffähig ist. Die normale XAMPP Version, aber auch der "XAMPP Lite" können eingesetzt werden.
Beachte(!): Die von mir bereitgestellten Konfigurationsdateien beziehen sich immer auf den "xampplite"!

Download: http://www.apachefriends.org/de/xampp-windows.html

Hinweis-1: Im Verzeichnis von Xampp findet man die Datei "xampp-control.exe". Diese kann in die Taskleiste gezogen werden (drag'n'drop), wo sie dann einen komfortablen Server-Startknopf darstellt.

Hinweis-2: Sollte man den Apache Server nicht starten können und zeigt sich immer der Fehlercode: 0xc0150002. Dann ist das Microsoft  Visual C++ 2005 Redistributable Package (x86) nicht vorhanden und muss zunächst installiert werden.

[vain]

[Schritt 2] Clansuite Sourcecode mittels TortoiseSVN aus dem SVN holen

Der Sourcecode von Clansuite ist aus dem  Subversion-Quellcode Archiv zu holen.

a)  SVN-Userinterface: TortoiseSVN

Ich rate hier zu "Tortoise SVN". Es ist ein nützliches Standardtool für diese Aufgabe, da es sich in den Explorer einklinkt und dort ein SVN Verwaltungsmenü anbietet.
Download: http://tortoisesvn.net/downloads

Hinweis-1: Es gibt auch andere SVN-Userinterfaces, wie z.B.: RapidSVN,gSVN

b) Clansuite Sourcecode

Im Datei-Explorer-Kontextmenü (rechte Maustaste) sollte nun "SVN Checkout" und ein Menü mit dem Namen "Tortoise SVN" auftauchen.

Die URLs für Checkout sind:
svn://svn.gna.org/svn/clansuite/trunk - checkt nur den trunk/head aus
svn://svn.gna.org/svn/clansuite - checkt das ganze Projekt aus

Als Checkout-Directory kann man direkt den lokalen Webserverpfad nehmen:
C:\xampplite\htdocs\clansuite
Ich verwende ein Verzeichnis namens "work" und lege alle Projekte darin ab. C:\xampplite\htdocs\work\clansuite

Hinweis-1:
Das Verzeichnis "C:\xampplite\htdocs\" entspricht der Browser-URL "http://localhost".
Das Verzeichnis "C:\xampplite\htdocs\work" entspricht der Browser-URL "http://localhost/work/".

Hinweis-2:
Man gehe mit dem Explorer in das Verzeichnis "C:\xampplite\htdocs\work\", dort ist "clansuite" enthalten. Hier nun per Kontextmenü eine "Verknüpfung erstellen" und diese in die Taskleiste ziehen. Hierdurch erhält man einen sofortigen Sprung in das Entwicklungsverzeichnis.

[vain]

[Schritt 3] Umgebung einrichten

a) MySQL

http://localhost/phpmyadmin/ aufrufen und neuen User namens "Clansuite" mit Passwort "toop" anlegen.

b) VirtualHost

Wer sich den virtuellen Host "www.clansuite-dev.com" lokal einrichtet, kann später die Schnellverknüpfungen der Clansuite Toolbar nutzen.
(Warum nicht www.clansuite.com? Weil die Adresse dann den echten Host, mit der Internetseite inklusive Forum, ersetzen würde und man folglich keinen Zugang hätte.)

Unter "c:\xampplite\apache\conf\extra" findet man die Datei "httpd-vhosts.conf".
In dieser Datei kann manuell der Vhost "ServerName clansuite-dev.com", sowie "ServerAlias www.clansuite-dev.com" hinzugefügt werden.
Alternativ kann die Datei einfach mit meiner Version aus dem SVN ersetzt werden.
Die entsprechende Datei gibts hier: http://svn.gna.org/svn/clansuite/branches/development/xampp/httpd-vhosts.conf

Damit das System diese URL auf den lokalen Server umleitet, muss noch die "hosts"-Datei
im Verzeichnis "c:\windows\system32\drivers\etc\hosts" angepasst werden.
Man trage "127.0.0.1 clansuite-dev.com" sowie "127.0.0.1 www.clansuite-dev.com" um eine entsprechende URL-Namensauflösung zum localhost zu erhalten.
Alternativ kann auch meine Datei aus dem SVN geholt werden:
http://svn.gna.org/svn/clansuite/branches/development/xampp/hosts

Eine ausführliche Anleitung zu diesem Thema gibts auch nochmal in diesem Thread:
http://www.clansuite.com/smf/index.php?topic=46.msg174#msg174

c) Filezilla

Für FTP Transfers lohnt sich die Installation von Filezilla.

Download:
http://www.filezilla.de/download.htm

d) Putty

Für die Verwaltung von SSH-Keys unter Windows-Systemen rate ich zu Putty.

Download:
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
http://the.earth.li/~sgtatham/putty/latest/x86/putty-0.60-installer.exe

e) Webdeveloper Tools für Firefox

Firebug:
http://www.getfirebug.com/
https://addons.mozilla.org/de/firefox/addon/1843

YSlow:
http://developer.yahoo.com/yslow/
https://addons.mozilla.org/en-US/firefox/downloads/file/21643/

FirePHP:
http://www.firephp.org/

Webdeveloper Toolbar:
http://chrispederick.com/work/web-developer/
https://addons.mozilla.org/de/firefox/addon/60

f) Xdebug - als PHP-Debugger einbinden
In "c:\xampplite\apache\php.ini" nach "xdebug" suchen und die Auskommentierung der Zeile "extension=php_xdebug.dll" entfernen.

Falls "php_xdebug.dll" nicht vorhanden ist, dann von http://xdebug.org/ downloaden.
Entsprechend umbenennen und ins Verzeichnis "C:\xampplite\php\ext" ablegen.

Ausführliche Anleitung zum Thema in diesem Thread:
http://www.clansuite.com/smf/index.php?topic=96.0

g) AsciiDoc + Python
Für die automatische Erstellung der Dokumentation wird AsciiDoc und deshalb auch Python benötigt.
AsciiDoc: http://www.methods.co.nz/asciidoc/
Python: http://www.python.org/ftp/python/2.5.1/python-2.5.1.msi

Für die SourceCode-Highlighting Features von AsciiDoc wird "src-highlite" des GNU Packets benötigt.
http://gnuwin32.sourceforge.net/

h) gettext Tools
Für die automatische Erstellung der Übersetzungsdateien bzw. das Auslesen von zu übersetzenden Texten werden die gettext Tools benötigt.
http://www.gnu.org/software/gettext



Fertig!

[vain]

[Letzter Schritt] Clansuite Toolbar
Um einen komfortablen Zugriff auf alle Projektinformationen zu haben, kann man nun noch die Clansuite Community Toolbar herunterladen und durch "Ausführen mit Firefox" im Browser installieren. Unter "Optionen" lassen sich die Entwicklermenüs einschalten.

Eine Besonderheit stellen die ersten 4 Links des Menüs "httpd" dar.
Mit ihnen ist es möglich, direkt den virtuellen Host "clansuite-dev.com" im Browser aufzurufen.

"Frontend @ localhost"	->	"http://www.clansuite-dev.com"
"Admin Control Panel"	->	"http://www.clansuite-dev.com/?mod=admin"
"Installation"	->	"http://www.clansuite-dev.com/installation/"
"Web-Installation"	->	"http://www.clansuite-dev.com/installation/webinstaller/webinstaller.php"