Coppermine installieren und in Joomla integrieren

Coppermine ist eine sehr beliebte, ausgereifte und leistungsfähige Fotogalerie die auf PHP und MySQL basiert. Sie läuft standalone und ist keine Joomlakomponente. Man kann die Galerie jedoch mit einer sogenannten Bridge in Joomla integrieren. Die Galerie erkennt dann die Joomlabenutzer und wird designmässig ohne iFrame wie beim Wrapper in Joomla integriert.

In dieser Anleitung wird gezeigt wie man die Coppermine Gallery installiert und anschliessend mit der Bridge von mehdiplugins.com in Joomla integriert. Dies funktioniert sowohl mit Joomla 1.0.x als auch mit Joomla 1.5. Die Screenshots in dieser Anleitung stammen fast alle von Joomla 1.0.x.

Grundinstallation von Coppermine

Das Prinzip ist dasselbe wie bei Joomla und anderen PHP Anwendungen.

So sollte das aussehen.

Im Browser den ganzen Pfad zum Coppermine Ordner aufrufen.

Dieser Screen erscheint für einige Sekunden. Bitte warten.

Grundinstallation

In dieser Maske bitte die relevanten Daten für die DB usw. eintragen. Installiert Coppermine bitte in dieselbe Datenbank wie euer Joomla. Beim DB Präfix würde ich eine neutrale Bezeichnung benutzen wie z.b. cpg_. Coppermine gibt dort standardmässig noch die Versionsnummer dazu was ja keinen Sinn macht. Wenn ihr alles eingetragen und kontrolliert hat klickt bitte auf Let's Go!.

Tja das wars eigentlich schon. Klickt auf Let's Continue!

Coppermine begrüsst dich nun freundlich. Du kannst dich jetzt anmelden.

Installation der Bridge

Ladet euch die aktuellste Bridge bei Joomla-Downloads.de oder direkt bei auf der Entwicklerseite herunter. Dort ist auch die etwas rudimentäre Originalanleitung in Englisch zu finden.

Entpackt das heruntergeladene Zipfile auf eurer Festplatte. Ihr seht jetzt verschiedene Ordner für die jeweilige Joomlaversion.

Joomla 1.0.x

Joomla 1.5.x

Meldet euch in eurem Joomlabackend an und öffnet den Komponenteninstaller unter Installers > Components > Durchsuchen und wählt dann die com_coppermine.zip aus und klickt auf Öffnen.

Upload...

Den Anweisungen entweder Folge leisten oder einfach hier weiterlesen.

Öffne das Menü wo der Link zur Galerie rein soll.

Joomla 1.0.x

Joomla 1.5.x

Joomla 1.0.x

Joomla 1.5.x

Bei diesem Link muss die Url zum Installationsordner der Coppermine rein. Ohne Slash am Schluss. Danach speichern.

Diese beiden Dateien, die im Zipfile der Bridge mit dabei waren, müssen jetzt in den Bridge Ordner von Coppermine kopiert werden. Für Joomla 1.0.x und 1.5 sind nicht dieselben Dateien erforderlich. Es schadet jedoch nichts wenn ihr sowohl die Dateien für Joomla 1.0.x wie auch die für 1.5 hochladet. (Dieser Schritt entfällt wenn ihr Coppermine bei uns heruntergeladen habt)

Der folgende Schritt entfällt ebenfalls, falls ihr Coppermine hier heruntergeladen habt. Ansonsten bitte folgendes Vorgehen: Nun müssen zwei Dateien von Coppermine gehackt werden. Falls ihr dieselbe Coppermine Version verwendet für die ihr die Bridge heruntergeladen habt, dann sind die fertig gehackten Files im Ordner cpg14xx\hacked files (siehe Bild). Das ist der Fall wenn ihr Galerie und Bridge hier aus dem Downloadbereich heruntergeladen habt. Die Datei bridgemgr.php müsst ihr in den Rootordner von Coppermine kopieren und die vorhandene Datei überschreiben. Die zweite Datei functions.inc.php soll in den Coppermine Unterordner /include kopiert werden. Bestehende Datei bitte überschreiben.

Ruf deine Coppermine Gallery über die ganze Url auf und melde dich als Admin an. Unter Admin Werkzeuge findest du ganz unten den Bridge-Assistent.

Klicke den Titel an.

Starte den Bridge Assistenten

Hier wählst du natürlich Joomla aus.

Mit Forum Url ist der Livesite Pfad von Joomla gemeint. Also wenn du Joomla über http://www.meineseite.de aufrufst musst du genau diesen Pfad dort eintragen. Wenn Coppermine in einem Ordner im Joomlaroot installiert ist (http://www.meineseite.de/cpg), muss auch beim relativen Pfad zum "Forum" nur ein Slash (/) eingetragen werden. In diesem Beispiel oben liegt meine Joomlainstallation im Ordner copperminedemo . Coppermine liegt im Ordner cpg.

Hier würde ich Nein wählen für eine einfachere Administration.

Nun kannst du über den bereits erstellten Menüpunkt in Joomla die Coppermine Gallery starten. Die Darstellung wird nicht optimal sein weil sich die CSS Dateien des Joomla Templates und des Coppermine Themes ins Gehege kommen.

Für das Classic Theme hat Mehdi freundlicherweise der Bridge bereits eine geänderte CSS Datei beigelegt. Kopiere die Datei style2.css in den Ordner des Classicthemes.

So sieht das doch besser aus. Falls du einen anderen Coppermine Style (Theme) verwenden möchtest musst du die style.css Datei des jeweiligen Themes manuell ändern damit sie das Joomla Design nicht mehr zerschiesst. Sehr hilfreich hierbei ist das Webdeveloper Plugin für den Firefox. Damit findest du im Nu heraus welche Klasse in der CSS Datei geändert werden muss. Coppermine ist so fertig installiert und einsatzbereit.

Erstes Album erstellen und Fotos hochladen

Eine ausführliche Coppermine Doku würde an dieser Stelle sicher zu weit führen, aber ich erkläre gerne wie ihr euer erstes Album erstellen und dieses dann mit Bildern bestücken könnt. Den Rest findet ihr mit ausprobieren sicher schnell heraus wenn ihr das Adminmenü der Galerie ein wenig genauer anschaut.

Melde dich in Joomla an und öffne die Coppermine Gallery. Klick auf Kategorien.

Hier erstellst du eine oder gleich mehrere Kategorien. Falls du nur wenige Bilder hast kannst du auch direkt zur Albenverwaltung gehen und auf die Kategorienerstellung verzichten.

Nachher öffnest du die Albenverwaltung.

Wähle oben die soeben erstellte Kategorie aus und klicke unten rechts auf Neu.

Ändere jetzt den Namen des Albums und übernimm die Änderung.

Die Frontseite von Coppermine sieht dann so aus. Jetzt muss das Album noch mit Bildern gefüllt werden.

Falls du nur einige wenige Bilder zum hochladen hast kannst du auf der Startseite auf Datei hochladen klicken und hier angeben welche Bilder du gerne im Album hättest.

Falls du mehrere Bilder hast was ja meistens der Fall ist klickst du auf der Frontseite auf Batch hinzufügen.

Coppermine sagt mir hier, dass ich ein Unterverzeichnis anlegen muss.

Lege bitte mit deinem FTP Client einen Unterordner im Ordner Albums deiner Coppermine Galerie an. In diesem Beispiel habe ich den Ordner usa99 angelegt. Es ist empfehlenswert einen sprechenden Namen zu verwenden. Lade dann deine Bilder in dieses neue Verzeichnis hoch.

Anschliessend bitte nochmals den Button Batch-hinzufügen auf der Startseite anklicken. Wähle unten auch gleich noch bei durchsuchbare Oberfläche die Option Nein falls der Ordner nicht sichtbar ist.

Klicke auf den Ordner und warte bis die Thumbnails erstellt werden. Oben rechts wählst du das Album in das die Bilder abgelegt werden sollen.

Wenn alle Thumbnails erstellt wurden kannst du einfach auf markierte Dateien einfügen klicken. Entferne vorher bitte noch den Haken bei Bildern die du nicht einfügen möchtest.

Es dauert eine Weile bis alle Bilder eingefügt sind und der Ok Button bei allen erscheint.

Erklärungen findest du ganz unten. In dieser Beziehung ist Coppermine wirklich vorbildlich. Wenn das Skript alle Bilder eingefügt hat, kannst du wenn du willst alle Bilder noch mit Titeln und Beschreibungen versehen. Dazu brauchst du unten nur auf Dateien bearbeiten zu klicken.

Hier kannst du Titel und Beschreibungen sowie Stichwörter eintragen. Zuunterst gibts den Button Änderungen ausführen. Diesen bitte anklicken um die Änderungen zu speichern.

Auf der Startseite erscheinen nun die zuletzt hinzugefügten Bilder und auch die Zufallsbilder automatisch.

Menüpunkt umstellen

Da der Menüeintrag zu Coppermine kein Komponentenlink ist, sondern nur ein Link - Url gibts unangenehme Einschränkungen. Module können solchen Link Urls nicht zugewiesen werden. Untermenüs werden nicht angezeigt usw. Um das zu ändern öffne bitte die Datei joomla.inc.php im Bridge Ordner der Coppermine wo du bei ca. Zeile 30 folgendes finden solltest:

Bitte die Zahl 88888888 durch die Item ID des Coppermine Menüeintrages ersetzen. Anschliessend verhält sich der Menüpunkt wie ein normaler Komponentenlink.