"Ich hätte gerne Docman für mein Joomla." - Zur Erklärung, es handelt sich dabei um eine offenbar beliebte und weit verbreitete Downloadkomponente für Joomla. Ausgiebiges gibt es hier nachzulesen.

Der Eindruck mag ja subjektiv sein, doch kommt mir die Joomla-Welt ziemlich chaotisch vor. Es gibt Komponenten, die passen nur auf die Joomla-Version 1.0, andere laufen mit Hilfe der Aktivierung des Legacy-Plugins, wieder andere sind mittlerweile oder überhaupt für das aktuelle Joomla 1.5 geschaffen. Alleine herauszufinden um welche Art Komponente - 1.0, beide Verianten oder 1.5 - es sich bei einer beschriebenen Erweiterung handelt ist manchmal eine Herausforderung. Und dann geht nicht selten die Suche los nach Sprachdateien.

Nun, da ich eh schon alles zusammengekratzt habe was man für die reibungslose Installation von Docman 1.4 stable benötigt, kann ich auch alle erforderlichen Links in einem Blogbeitrag verfügbar machen. Übrigens, die Testversion Docman 1.5 die Joomla 1.5 native unterstützt, wird bereits intern getestet. Vielleicht wollen Sie ja bis zur Veröffentlichung warten. Falls nicht, hier ist der Link zum Download von Docman 1.4 stable. Nicht vergessen, unter Erweiterungen > Plugins muss System Legacy aktiviert sein.

Die Sprachdateien in UTF-8 gibt es unter diesem Link. Und eine ausführliche Anleitung (am Versionsunterschied - die Anleitung bezieht sich auf 1.4RC3 - brauchen Sie sich nicht zu stören), auch an welche Positionen die Sprachdateien zu verbringen sind, finden Sie hier.

Und noch eine kleine Überraschung erlebte ich mit Joomla, nachdem ich auf die aktuelle Version von Easybook umgestellt hatte. Das fiel mir nicht gleich auf, weil die Einträge weiterhin angezeigt wurden. Doch als ich einen neuen Beitrag freigeben wollte, wurde dies durch folgende Meldung quittiert: Fehler: Konnte den Veröffentlichungsstatus des Eintrags nicht ändern - Unknown column 'id' in 'where clause' SQL=UPDATE jos_easybook SET published = 0 WHERE (id=2). Das Datenbankfeld gbid wurde nämlich zu id. Je nach Werkzeug - MySQL Administrator lokal oder direkt über die Datenbankverwaltung phpMyAdmin auf dem Server - ist die Änderung an der Tabelle jos_easybook (Präfix kann auch anders lauten wie jos_ je nachdem was bei der Installation vereinbart wurde) vorzunehmen.

Falls der Zugriff über den lokal instalierten MySQL Administrator erfolgt, mit Edit Table die Tabelle zur Bearbeitung öffnen, Feldname anklicken, ändern und mit übernehmen bestätigen. Fertig.

Im anderen Fall unter phpMyAdmin die Tabelle anklicken, auf das Bearbeiten-Symbol der ersten Zeile klicken, gbid zu id machen, und mit speichern absegnen. Das wars.

Nach der Umstellung auf suchmaschinenfreundliche Links (ohne über mod_rewrite zu gehen) war das Gästebuch außerdem nicht mehr erreichbar. Hier half es, es einfach noch mal mit seinem Menüeintrag zu verlinken. Das Formular musste ich ebenfalls über die Konfigurationseinstellungen (Achtung, gibt nur noch den Button oben rechts) neu zugänglich machen.

Zur Menüreihenfolge von Joomla gibt es eine Menge mehr oder weniger hilfreicher Tipps, zum Beispiel "ändere doch einfach die Reihenfolge". Gelegentlich kommt es vor, dass die Reihenfolge in der Menüverwaltung stimmt, und trotzdem auf der Site falsch angezeigt wird. In meinem speziellen Fall ging es um ein Untermenü innerhalb des Hauptmenüs. Auch den Cache zu leeren brachte kein Ergebnis. Also versuchte ich das Folgende:

Ich setzte ein Häkchen vor einen der falsch platzierten Menüpunkte und wählte den Befehl "verschieben". Damit versetzte ich die widerspenstige Verlinkung vorübergehend direkt ins Hauptmenü. Wieder in der Menüverwaltung klickte ich den Menüpunkt ein weiteres Mal an und verschob ihn dahin, wo ich ihn haben wollte. Danach funktionierte die Anzeige korrekt.

Mögliches Problem: Beiträge können nicht gesichert oder gelöscht werden (Tinymce). Problem Nummer zwei betrifft die Verwaltung von Media-Dateien, die mit der Fehlermeldung member function authorize() on a non-object in [...]\administrator\components\com_media\views\media\tmpl\default.php on line 64 kommt.

Die Lösung fand ich im Joomla-Forum. Es müssen lediglich zwei Dateien ausgetauscht werden, wie hier beschrieben.

Letzte Woche beschrieb ich meine Abenteuer bei der lokalen Migration von Joomla 1.0.x auf Joomla 1.5.x. Nachdem ich das gemacht hatte, rüstete ich noch ein paar Komponenten nach, und es lief so weit alles glatt. Heute war der Termin für den Ernstfall. Auf dem Server installierte ich Joomla nicht, sondern nahm eins zu eins die lokale (unter Linux vorgenommene) Installation samt ihrer Datenbank und passte nur die configuration.php auf die neue Serverumgebung an.

Im Webhostingpaket ist neben der Standard-PHP-Version 4.x noch eine weitere 4.x und PHP 5 enthalten. Joomla selber kommt zur Not noch mit PHP 4 aus, nicht aber eine der gewählten Zusatzkomponenten. Die einzige Information die ich in der Administrationshilfe des Providers bekam war, dass wenn ich eine andere als die Standard-PHP-Version wünschte, dies in der .htaccess vereinbaren müsse. Wie genau das vor sich geht, wäre wohl zu viel des Verratens gewesen, das musste ich dann anderorts in Erfahrung bringen. Folgende Zeile in der .htaccess brachte es dann: AddHandler php5-cgi .php

Das Standard-Template von Joomla lässt sich nicht deinstallieren. Es muss zuerst ein anderes Template zum Standard erklärt werden. Das khepri-Template wurde ich durch deinstallieren allerdings los, und büßte nachfolgend die Administrationsoberfläche ein. Es reichte, von der Sicherungskopie khepri wieder ins Verzeichnis Administrator > templates zu kopieren.

Ansonsten muss ich zwar einräumen, dass Joomla ein wenig anders ist als Wordpress oder Drupal, auch in Bezug auf die Anfertigung von Templates, doch nachdem ich mich nun weitgehend mit den grundlegenden Funktionen vertraut gemacht habe, kann ich mir vorstellen, es in der Praxis zu vertiefen.

Zur Zeit mach' ich echt seltsame Sachen. Ubuntu in meiner Virtual Box installieren zum Beispiel. Und nun ein Joomla Upgrade. Nachdem ich gefragt wurde, ob ich das machen könnte, richtete ich eine Testumgebung ein und vollzog die Migration in sicherer Umgebung. Da meines Wissens nicht nur noch einige Joomla 1.0.x online sein sollen, sondern ab dem 22. Juli diesen Jahres auch die Weiterentwicklung daran eingestellt wird, schreibe ich (mir) die wichtigsten Schritte vorsichtshalber hier auf.

Von Joomla 1.o.12 auf Joomla 1.5.x kann man eigentlich nicht upgraden. Der Vorgang nennt sich in dem Fall Migration. Das wird dann erforderlich, wenn sich an den Datentabellen eines Systems etwas verändert hat, und die Inhalte daher nicht mehr eins zu eins vom darüber installierten Upgrade eingelesen werden können. Weil mir Datenstrukturen mehr sagen als unvertraute Content-Management-Oberflächen, war klar, dass ich den Weg der händischen Migration gehe.

Zuerst kopierte ich das komplette Web vom Server in ein Webverzeichnis meines virtuellen Ubuntus, importierte die Datenbanksicherung, änderte die configuration.php auf die lokalen Bedingungen und rief die Site auf (eine Installation des Joomla-CMS ist auf diese Weise nicht erforderlich).

Zwei grundlegende Änderungen in der Datenbankstruktur haben sich abgespielt die einem Upgrade wie man es sonst bei neuen CMS-Versionen kennt, im Wege stehen. Die erste sah ich - anfangs Ahnungslose - auch gleich nach dem Aufruf der lokalen Webkopie. Die Umlaute waren futsch. Dies war ein leidiger, jedoch glücklicherweise abklingender Nebeneffekt einer Phase, in der gängige Systeme bei denen früher regionale Gegebenheiten den verwendeten Zeichensatz bestimmten, auf den universellen Zeichensatz UTF-8 umgestellt werden mussten, und damit die Umlaute in manchen MySQL-Datenbanken zu kryptischen Wortunterbrechungen mutierten.

Ein häufig benutzter Zeichensatz (#1) in unserem Sprachraum war früher ISO 8859-1 (in der MySQL-Admin-Exportdatei latin1), und daraus sollte nun UTF-8 werden. Spontan hatte ich die Idee, im Webdevoloper Express (mit dem editiere ich alles was mit Webentwicklung zu tun hat) eine leere Textdatei zu öffnen, den Inhalt der gesicherten Datenbank hinein zu kopieren und neu zu speichern (alternativ: Windows-Editor, Datei speichern unter..., Dateityp alle Dateien datenbanknamen.sql, und im Dropdownfeld Codierung im unteren Bereich des Dialogfensters Speichern unter UTF-8 auswählen - bedauerlicherweise muss man hierbei jedoch auf die Zeilenumbrüche verzichten, doch jeder Editor mit dem Webseiten entwickelt werden können, sollte dazu geeignet sein).

Den Zeichensatz nur anders zu definieren reicht nicht, da die Zeicheninformation bereits in der Datei selbst festgelegt ist - das gilt übrigens auch für alle anderen Webdokumente, in denen Zeichensätze angegeben sind, und etwaige Verwirrungen bei Umlauten sind auf dieselbe Weise zu lösen. Dann braucht man nur noch den Zeichensatz im Beschreibungskopf der Datenbank umbenennen, latin1 wird zu utf8. Das kam dann in eine eigene Datenbank, die Konfiguration des alten Webs änderte ich entsprechend, und da waren sie alle wieder - die Umlaute.

Joomla 1.5.x muss komplett neu installiert werden. Die Beispieldaten abwählen. Stattdessen die Option Migration auswählen, und einfach auf die Angabe eines Migrationsskriptes verzichten (es sei denn, es ist tatsächlich eines vorhanden natürlich). Die neue von 1.5.x angelegte Datenbank im Originalzustand sichern (mit DROP und CREATE Table, falls beim Einlesen der INSERTs aus der alten Datenbank was schief geht, dann hat man ein 1.5.x-Backup für die Wiederherstellung einer frischen, leeren Installation). Daher beim für die Migration vorgesehenen Export der Daten aus der 1.0.x-Version keinesfalls die Tabellen generieren lassen (kein Häkchen im Block Struktur), sondern nur vollständige INSERTs anhaken, so dass später jeder Wert dem richtigen Feldnamen zugeordnet werden kann, auch wenn mal ein neues Feld dazwischen liegen sollte. Die UTF-8-Umwandlung nicht vergessen (oder eine Kopie der Backupdatei bearbeiten und dort die Tabellenstrukturen entfernen).

Bei zwei Tabellen ist es erforderlich, je einen Feldnamen zu ändern (#2). Auch das lässt sich ganz einfach in der Textdatei in den INSERTs berichtigen - deren Inhalte mussten bei mir jedoch gar nicht übertragen werden. Bei der ersten Tabelle werden es ansonsten alle Einträge ab der zweiten Zeile sein. Die erste ist bereits während der Installation belegt worden vom Administrator.
in der 'jos_core_acl_aro' Tabelle heißt das erste Feld statt 'aro_id' nun 'id'.
in der 'jos_core_acl_aro_groups' Tabelle, wird aus dem ersten Feld 'group_id' ebenfalls 'id'.

Mit dem MySQL-Query-Browser öffnete ich die Textdatei (datenbankname.sql) mit den zu übernehmenden Daten als Skriptdatei. Das erste Ausführen zeigt die Dateninhalte an, das zweite überträgt sie dann in die neue 1.5.x-Joomladatenbank. Beteiligt waren hierbei nur die Daten einer Grundinstallation, ohne Zusatzmodule. Die werde noch extra abgehandelt und die Tabellen mit dem QueryBrowser Erweiterung für Erweiterung befüllt.

Nur die Inhalte nachfolgender Tabellen übertrug ich in die neue Datenbank:

`jos_categories` (wichtig)
`jos_contact_details`
`jos_content` (wichtig)
`jos_content_frontpage`
`jos_content_rating`
`jos_core_acl_aro` (erst ab der 2. Zeile!)
`jos_core_acl_groups_aro_map` (Eintrag der mit Bestehendem identisch war, weggelassen)
`jos_menu` (wichtig)
`jos_newsfeeds`
`jos_sections`
`jos_stats_agents`
`jos_users` (erst ab der 2. Zeile)
`jos_weblinks`

Da dies mehr eine nächtliche Schilderung wurde, ergänzend zwei Links, die mir als eine Anleitung geeignet erscheinen.

http://www.nik-it.de/joomla/wissenswertes/content-auf-joomla-1.5-umstellen.html

http://www.joomigration.de/Tutorial/tutorial-einleitung.html