manufakturGallery - Facebook Fotoalben in LEPTON oder WebsiteBaker integrieren

Fotogalerien gibt es wie Sand am Meer, für WebsiteBaker sind Dutzende verfügbar. Wozu also noch eine Bilderschleuder schreiben?

Der Anlaß war die Aktion "Die Farben meiner Stadt" des Vereins panke.info bei der hunderte Fotos geschossen wurden. Die schönsten Bilder wurden anschließend auf verschiedenen Accounts bei Facebook veröffentlicht und es war klar, das gefragt wurde: "Wie bekommen wir diese Fotos auf unsere Vereinsseite?". Die quick & dirty Lösung für panke.info machte jedoch rasch klar, dass hier eine Menge Potential schlummert:

• Fotoalben lassen sich auf Facebook sehr einfach anlegen und verwalten
• das Fotoalbum kann eine Beschreibung sowie eine Ortsangabe enthalten
• das Fotoalbum kann durch die Besucher bewertet und kommentiert werden
• die einzelnen Fotos der Alben können ebenfalls beschrieben und durch die Besucher bewertet sowie kommentiert werden

Der Test zeigte ausserdem, dass die Facebook Schnittstelle sehr leistungsfähig ist - ein Zwischenspeichern ist nicht erforderlich und die Abfrage kann in Echtzeit erfolgen. Hier schlummert also eine Menge Potential und es bietet sich an Fotos bequem auf Facebook zu verwalten und sie über ein WebsiteBaker Add-on auch auf der Website einzubinden. Genau dies tut manufakturGallery:

• Einbinden von öffentlichen Facebook Fotoalben (funktioniert nicht mit Fotoalben, die sich auf privaten Accounts befinden)
• Anzeige aller zusätzlich verfügbaren Informationen (Albumtitel, Albumbeschreibung, Ort, Fotobeschreibungen und Kommentare)
• frei gestaltbare Anzeige des Fotoalbum über Presets
• beliebige Unterstützung von zusätzlichen Effekten durch Tools wie Lightbox, Fancybox u.a.
• automatisches Setzen von Titel und Kurzbeschreibung auf der Seite, auf der manufakturGallery eingebunden ist
• Integration von manufakturGallery in die WebsiteBaker Suchfunktion - die Volltextsuche umfasst alle verfügbaren Informationen des Fotoalbums

Die manufakturGallery wird als Snippet installiert, der Zugriff erfolgt über das automatisch installierte Droplet [[manufaktur_gallery]].

Systemvoraussetzungen:

• WebsiteBaker 2.8.1
• PHP 5.2 oder höher
• UTF-8 Zeichensatz wird verwendet
• DropletsExtension installiert

Download:

• manufakturGallery

Die Anzeige der manufakturGallery erfolgt an der gewünschten Stelle:

Das Album können Sie auch im Original bei Facebook betrachten. Neue Kommentare, zusätzliche Bilder oder Änderungen in den Beschreibungen werden hier 1:1 wiedergeben sobald die Seite neu geladen wird.

Das Droplet [[manufaktur_gallery]] verfügt über mehrere Parameter über die es gesteuert und beeinflusst werden kann:

Â

Zunächst müssen Sie die ID des Albums herausbekommen, dass Sie anzeigen wollen. Es gibt zwei Möglichkeiten:

Wechseln Sie bei Facebook in das Album, das Sie anzeigen möchten. Sie sehen oben einen Link "Album bearbeiten". Zeigen Sie mit der Maus auf den Link. klicken Sie mit der rechten Maustaste und wählen Sie im Popup-Menu "Link-Adresse kopieren". Kopieren Sie den Link z.B. in Notepad. Sie sehen eine Adresse mit diesem Aufbau:

http://www.facebook.com/ajax/photos/album/edit/dialog/dialog.php?album_id=176239252391517

Kopieren Sie die vollständige album_id in den Aufruf des Droplets:

[[manufaktur_gallery?album_id=176239252391517]]

Speichern Sie die Seite und schon befindet sich das erste Facebook Album auf Ihrer Website.

Alternativ können Sie sich von manufakturGallery alle Alben eines bestimmten Accounts anzeigen lassen. Hierzu rufen Sie das Droplet mit dem Facebook Namen oder der ID auf und geben zusätzlich den Parameter action=list an. Für die Facebook Seite der phpManufaktur sieht der Aufruf so aus:

[[manufaktur_gallery?facebook_id=manufaktur.berlin&action=list]]

Als Resultat erhalten Sie eine Liste:

Wählen Sie die gewünschte Album ID aus, kopieren Sie in die Zwischenablage und fügen Sie sie als Parameter album_id in den Droplet Aufruf ein:

[[manufaktur_gallery?album_id=176239252391517]]

Über die zusätzlichen Parameter aus der o.a. Parameter-Liste können Sie das Droplet steuern. So legen Sie z.B. mit columns die Anzahl der Spalten und mit limit die Anzahl der Bilder pro Seite fest. Das Droplet blendet automatisch Links zum Blättern auf die nächste Seite und die vorherige Seite ein:

[[manufaktur_gallery?album_id=176239252391517&columns=4&limit=12]]

zeigt das Album mit jeweils 12 Bildern in 4 Spalten pro Seite an.

Die Anzeige der Kommentare steuern Sie mit den Parametern photo_comments, album_comments und merge_comments. Setzen Sie photo_comments=true werden Kommentare zu dem jeweiligen Bild direkt unter der Bildbeschreibung angezeigt. Mit album_comments=true (Voreinstellung) werden die Kommentare zu dem Album unterhalb des Albums angezeigt. Wenn Sie photo_comments=true und merge_comments=true setzen, werden Kommentare zu einzelnen Fotos mit den Kommentaren zu dem Album zusammengefasst und unterhalb des Albums angezeigt.

manufakturGallery verwendet Presets. Der Aufbau der Presets und die Verwendung geschieht analog zu der Beschreibung bei kitForm. Das Standard-Preset finden Sie im Verzeichnis /modules/manufaktur_gallery/htt/1/. Um ein neues Preset zu erstellen kopieren Sie am Besten das Preset 1 und fügen es z.B. als Preset 100 wieder in das Verzeichnis ein, bevor Sie Änderungen vornehmen: modules/manufaktur_gallery/htt/100/. Im Kopf der Template-Datei gallery.htt finden Sie eine Auflistung der zur Verfügung stehenden Variablen bzw. Platzhalter.

DropletsExtension ermöglicht es manufakturGallery sich in die LEPTON bzw. WebsiteBaker Suche zu integrieren. Die Volltextsuche umfasst die Albumbeschreibung, die Beschreibungen zu den einzelnen Bildern sowie sämtliche Kommentare. Als Suchergebnis werden die gefundenen Bilder angezeigt. Probieren Sie es einfach mal aus, für das Beispiel auf dieser Seite bietet sich Thorsten als Suchbegriff an:

Diese Beschreibung ist sicherlich noch nicht vollständig, bitte helfen Sie mit die Dokumentation zu ergänzen und manufakturGallery zu verbessern.