Robert Deutz meistens harmlos

Ich werde jetzt nicht die siebenundzwanzigste „Hello World“ Komponente schreiben, sondern es soll ja am Ende etwas sinnvolles dabei raus kommen. Meiner Meinung nach fehlt es Joomla! an einer brauchbaren Kommentarerweiterung. Bei fast jeder –die ich ausprobiert habe- finde ich Punkte die mich stören. Die Entwicklung einer neuen steht schon seit langem auf meiner Liste und das Thema ist nicht so komplex das man es in einigen Blog Beiträgen nicht erläutern könnte.

So wir wissen nun was, jetzt braucht das Ding noch einen Namen. Meine Erweiterungen fangen meistens mit „com_rdbs_“ an und dann folgt ein beschreibender Name. In dem Fall ist comment sicher eine gute Wahl. Also die Erweiterung heißt com_rdbs_comment und weil es so schick ist bekommt diese den Codenamen: Statler.

Wenn man ganz gerne programmiert möchte man auch möglichst schnell los legen. Also los geht’s. Wir bauen uns zunächst man ein minimal Paket um etwas installieren zu können. Sinnvoll ist dabei die Trennung nach Back- und Frontend. Weiß man schon welche Menüpunkte man im Backend haben möchte, ist das auch ganz praktisch, wenn nicht dann eben nicht.

Unser Minimalpaket enthält die folgenden Dateien:

Zur Installation benötigt man eine XML-Beschreibung, diese enthält einen allgemeinen Teil mit Informationen zu der Erweiterung und Informationen welche Dateien zu installieren sind.

Schauen wir uns den Bereich für die Dateien an

<files folder="site">
  <filename>rdbs_comment.php</filename>
</files>
<languages>
  <language tag="en-GB">site/languages/en-GB.com_rdbs_comment.ini</language>
  <language tag="de-DE">site/languages/de-DE.com_rdbs_comment.ini</language>
</languages>

Joomla 1.5 bietet die Möglichkeit Erweiterungen mehrsprachig anzubieten, das Minimalpaket ist für zwei Sprachen vorbereitet: Deutsch und Englisch. Diese Dateien werden vom Joomla-Installer (hoffentlich) an die richtige Stelle kopiert, für das Frontend ist das der languages Ordner und für das Backend der administrator/languages Ordner.

Kommen wir nun zu dem Adminbereich:

<administration>
  <menu>RDBS Comment</menu>
  <submenu>
    <menu link="option=com_rdbs_comment&amp;section=about&amp;task=about">About</menu>
    <menu link="option=com_rdbs_comment&amp;section=comments&amp;task=view">View Comments</menu>
  </submenu>  
  <files folder="admin">
    <filename>admin.rdbs_comment.php</filename>
  </files>
  <languages>
    <language tag="en-GB">admin/languages/en-GB.com_rdbs_comment.ini</language>
    <language tag="de-DE">admin/languages/de-DE.com_rdbs_comment.ini</language>
  </languages>
</administration>

Zuerst das Menü, bei den beiden Einträgen „About“ und „View Comments“ bin ich mir sicher, dass ich diese benötigen werde. Dann noch eine paar Files, natürlich auch wieder die zwei Sprachdateien.

Alles einpacken und schon kann man installieren. Dabei muss man mindestens zwei Punkte beachten:
1) der Erweiterungsname wird aus dem Feld Name in der XML-Datei gebildet, dabei werden die Leerzeichen jedoch entfernt und alle Zeichen in Kleinbuchstaben umgewandelt. Nimmt man also als Name „RDBS Comment“ wird daraus „rdbscomment“, das würde aber nicht zu unseren anderen Dateien passen. Ich verwende einfach keine Leerzeichen, sondern immer einen Unterstrich, also „RDBS_Comment“.
2) Es werden nur die Sprachen installiert, die auch vorhanden sind, nimmt man also ein out off the box joomla, wird nur das englische Sprachfile installiert.

Hier gibt es das Archiv zum Dowmload

Hat man in das Archiv leere Dateien getan, dann passiert nicht viel, es kommt eine leere Seite. Hurra keine Fehlermeldung!

Wenn wir eine „Hello World“ Erweiterung erstellen wollten, müssten wir jetzt nur noch ein

< ?php echo „Hello World“ ?>

in die admin.rdbs_comment.php und in die rdbs_comment.php eintragen und schon wären wir fertig. Damit man es im Frontend auch sehen kann, müsste man allerdings noch einen Menüpunkt anlegen.

Ich hatte ja gesagt, dass ich keine Hello World Erweiterung vorstellen möchte, außerdem passt der mühsam ausgedachte Name nicht dazu. Man kann daran, aber schon etwas Wichtiges erkennen. Joomla! macht nicht wirklich viel, es includiert im Backend einfach die Datei „admin.rdbs_comment.php“ und wenn man einen Menüpunkt anlegt im Frontend die Datei „rdbs_comment.php“. Wir können uns also die wildesten Sachen ausdenken, wie wir unsere Anwendung aufbauen oder es so machen wie die Programmierer sich das gedacht haben.

Es ist natürlich sehr verwegen von mir hier Mutmaßungen bzgl. der Gedankengänge der Programmierer anzustellen, aber urteilt einfach selbst, ob jemand nachgedacht hat oder doch nicht.

Was ist also der Joomla! Weg?

Bei der Programmierung wird das Architekturmuster Model-View-Controller verwendet. Die theoretische Abhandlung über Software-Entwicklung ist einen Raum weiter. Wer es also genau wissen will, was das Ganze genau bedeutet, der kann bei Wikipedia nachschauen bzw. dort mit den Nachforschungen beginnen. Ich übersetze das für mich so:

Model: Daten
View: Ansicht
Controller: Ablaufsteuerung

Wir legen jetzt ein paar Verzeichnisse unter administrator/com_rdbs_comment an. Und da ich schon weiß wie es weiter geht, auch noch ein paar Dateien. Das sollte dann so aussehen:

Ich finde, das ist ein passender Moment um die Erste Folge von „Joomla! 1.5 erweitern“ zu beenden. Ich habe für die nötige Spannung gesorgt und kann den zweiten Teil in Ruhe vorbereiten. Ich beeil mich auch.