Drupal und die Bildergalerie Gallery2 Mi, Mär 3. 2010

1) Installation der eigenständigen Menalto Gallery2

Wichtig: Aktuell gibt es dort auch die Gallery3, eine komplett überarbeitete Weiterentwicklung der Gallery2. Für die Integration in Drupal gibt es aber im Moment nur ein Modul ("gallery") [1], das die alte Gallery2 integriert. [2]. Daher auf der Menalto-Website das richtige Paket G2 Gallery 2.x (hier Gallery 2.3.1) runterladen. Die Gallery gibt es in verschiedenen Versionen (minimal/typical/full etc.), wählt am besten die Full-Version, dann lassen sich die später benötigten Gallery2-Erweiterungen besser aktivieren.

Die Installation sollte anhand dieser Schritt-für-Schritt-Anleitung für die Menalto-Gallery2 durchgeführt werden.

Wichtig in dem Zusammenhang ist die Installation in das Unterverzeichnis "gallery2" direkt innerhalb der Drupal-Installation:

/pfad/zur/drupal/installation/gallery2/

2) Download des Moduls "gallery" für Drupal

Auf der Drupal-Websitefindet Ihr das Modul unter [1].

3) Drupal-Modul "gallery" Installation

Entpacken der zip-Datei und Upload der Inhalte in das Drupal-Modul-Verzeichnis
/pfad/zur/drupal/installation/modules/

Die Verzeichnisstruktur sieht dann so aus:
/pfad/zur/drupal/installation/modules/gallery/

4) Aktivieren des Drupal-Moduls "gallery"

In der Drupal-Administrationsoberfläche unter

Verwalten > Strukturierung > Module (/admin/build/modules)
(engl. Administer > Site building > Modules)

Dort aktivieren wir die 4 Untermodule im Bereich "Gallery2" und klicken danach auf "Save configuration"

5) Drupal Gallery Modul-Konfiguration

In der Drupal-Administrationsoberfläche unter

Verwalten > Einstellungen > Einstellungen für Galerien (/admin/settings/gallery)
(engl. Administer > Site configuration > Gallery settings)

Hier werden erstmal einige Fehler und Warnmeldungen ausgegeben:

Nach der Anpassung an die eigenen Pfade im Bereich Step2:

Kann dort eine Absolute URL angegeben werden. Wir haben es mit den Standardeinstellungen getestet und bekamen einen Fehler:

Errors in your current Gallery2 location settings:
URI of Gallery2: file /var/www/html/gallery2/embed.php does not exist does not exist [Error]

Dieser Fehler kann verschiedene Ursachen haben:

1. Die Gallery ist nicht in einem Unterverzeichnis der Drupal-Installation installiert worden.
2. Es wurde die neuere Gallery3 installiert. Dieses ist nicht kompatibel und einbettungsfähig im Drupal-Modul "gallery"
3. es wurde ein falscher Pfad im Feld "Gallery2 URL" angegeben.
   

Wir korrigieren den Pfad auf die korrekte URL (hier relativ):

Bitte auch den "Gallery base" auf gallery setzen. Dies ist unsere URL für den späteren Aufruf der Gallery innerhalb von Drupal:

www.drupalsite.de/gallery/

Alles okay? Weiter geht´s:

Als nächstes bekommen wir eine Fehlermeldung zu den Gallery2-Plugins und dem Clean URL/URL Rewrite Feature der Gallery2:

Es sind noch zwei Korrekturen notwendig:

Zum ersten Fehler kommen wir später. Die URL-Rewrite-Meldung sollte verschwinden, wenn wir diese Meldung beherzigen:
Clean URLs are enabled in Drupal and the Gallery2 URL Rewrite plugin is activated. It is possible to automatically configure the URL Rewrite plugin. The configuration assumes that the rules should be placed in your Drupal .htaccess file (it will add them to the beginning) which works in most applications. If you need a special configuration, enter the desired values manually.

Zuerst sollte man sich vergewissern, ob das URL-Rewriting in der Gallery-Standalone aktiviert ist. Dazu als Administrator in Gallery2 einloggen (s. Gallery2-Installation).
Danach unter Erweiterungen > Kurze URLs > konfigurieren

Dort wird die Gallery2-Erweiterung konfiguriert:

Die Kurz-URLs"-Erweiterung muss noch konfiguriert werden. Die "Elemente zeigen" (engl. Show Item)-Regel setzen wir auf:

gallery/v/%path%

Auf dem Server sind einige Aufgaben auszuführen (.htaccess Datei anlegen, Rechte setzen).
Danach sollten 2 Erfolgsmeldungen kommen.

Nicht vergessen, nach Klick auf "Fertig" die Erweiterung zu aktivieren. Der Punkt "Kurze URLs" sollte ein grünes Häkchen bekommen.

Weiter gehts in Drupal:

In Step4 trägt man die Pfade ein:

Bei diesem Prozess wird in die Drupal-htaccess ein wichtiger Mod-Rewrite Teil geschrieben, der für die Kurz-URLs der Bildergalerie nötig ist. Dabei ist zu beachten, dass für das Script in diesem Moment die htaccess-Datei genügend Rechte (Schreibrechte) hat.

Bei Erfolg geht es weiter zu Step 5: Benutzer-Synchronisation:

Bis auf ein paar Plugin-Fehler ist es bis hierhin ganz gut gelungen:

Die Fehler werden wir in der erweiterten Modul-Konfiguration des Gallery-Moduls beheben.

6) Erweiterte Gallery-Modul-Konfiguration

Beim Klick auf die Links kommen wir wieder auf die Seite der Installation des Moduls in den Bereich "Drupal-Modules / Gallery2-Plugins".
Dort sehen wir, dass die Plugins "Image Block" und "ImageFrame" fehlen:

ImageBlock    Error (missing)    Allows images to be included in the Drupal sidebar or in nodes.
ImageFrame    Warning (missing)    Provides a variety of frames around the images.

Fehlerbehebung: fehlende Plugins für die Gallery nachinstallieren

Hierzu gehen wir in die Gallery2-Administration zurück, in den Bereich Erweiterungen, dort auf den register "Weitere Gallery Erweiterungen" und holen uns die Erweiterungs-Liste. Falls nicht schon vorher geschehen müssen die Gallery2-Unterordner "modules" und "themes" auf Schreibrechte gesetzt werden:

chmod -R 777 modules
chmod -R 777 themes

Eine lange Liste mit Erweiterungen wird angezeigt, in der wir auch die beiden Plugin wiederfinden. Diese mit Klick auf downloaden holen:

Die Pakete werden dabei geladen und aktualisiert.

ImageBlock Erweiterung aktualisiert.
ImageFrame Erweiterung aktualisiert.

ImageBlock und ImageFrame sollten als Erweiterung in der Liste nun vorhanden sein:

Wenn wir schon bei den Erweiterungen sind und Gallery komplett in Drupal integrieren, sollte das "Registration"-Plugin in Gallery2 entfernt werden, falls dies installiert sein sollte.
Drupal gibt hier diese Empfehlung, damit sich die Benutzer von Drupal und Gallery2 nicht in die Quere kommen:

Die Gallerie kann nun als Block in das eigene Drupal eingebaut werden:

Verwalten > Strukturierung > Blöcke (/admin/build/block)
(engl. Administer > Site building > Blocks)

Gallery2 ist nun mit der oder-Kennung "gallery" bereit zum einbau in Drupal. In der Navigation sollte bereits der Gallery-Menüpunkt aufgeführt sein. Die Gallery-Einstellungen laden ein, mehr über die Integration der Gallery2 zu erfahren. So kann man z.B. auch hier direkt das Theme ändern, oder die Anzahl der in der Navigation sichtbaren Alben und Unteralben festlegen.

Links und Verweise zum Thema "Integration Drupal und die Gallery 2"

[1] Drupal Modul Gallery
http://drupal.org/project/gallery

[2] Drupal und die Gallery3
http://drupal.org/node/526452

Handbuchseite zum Einbinden der Menalto Gallery (Gallery2)
http://www.drupalcenter.de/handbuch/6915

Gallery Modul für Drupal und Integration der Gallery
http://codex.gallery2.org/Integration:Drupal