XT-Commerce to Magento migration and Gallery2 Plugin for WBB 3.0 and WCF 1.0

Hi,
eine Bitte habe ich an euch: meldet Bugs (also Fehler) bitte über den Bugtracker , das macht es mir und euch leichter Probleme zu lösen. In diesem Thread kann es leicht passieren, dass ein Problem untergeht. Danke euch.

Ich hab schon lange die Gallery2 über eine Joomla Installation eingebunden und bin von der irre begeistert. Da ich mit dem WBB3 auch wieder ein neues Photoalbum brauche, habe ich mich mal an ein Plugin dafür gemacht. Die Bildergelerie ist eine eigene Application, die man seperat installieren muss. Um die Gallery2 ins WBB einzubinden, muss man "nur" die dafür vorgesehene EMBED Klasse implementieren und ganau das habe ich jetzt über ein Plugin realisiert.

Es gibt ein englisches und ein Deutsches (Sie und Du) Sprachpaket in UTF-8 und ISO.
Getestet habe ich das ganze mit dem WBB3 3.0.3 PL1 und der Gallery 2.2.4 . Mit der Version 2.3 RC1 der Gallery2 funktioniert das Plugin auch.

Wiki (only ENGLISH): http://codex.gallery2.org/Integration:WBB3
Wiki (nur Deutsch): http://www.woltlab-wiki.de/index.php/Gallery2_Plugin
WCom Support: http://community.woltlab.com/db/index.ph…rt&projectID=41

Gallery Homepage http://gallery.menalto.com

Demo Embed: http://www.rettungshundeforum.de/portal/…p?page=Gallery2
Demo Gallery2: http://gallery2.rettungshundeforum.de/
PHPDoc: http://phpdoc.bessieundmarkus.de/de.bessieundmarkus.gallery2
Bugs: http://bugs.rescue-dogs.de
Subversion Repository Webbrowser: http://websvn.bessieundmarkus.de/

Wo findet ihr dieses Addin?:
Entweder in den Foren fürs WBB oder auf meiner Website im Download Bereich: http://www.bessieundmarkus.de
Aktuelle Entwicklungsversionen könnt ihr auch über mein Subversion Repository erhalten mit einem Gast Account:
Username: gast
Passwort: gast

1. Ongoing Developments: svn://www.bessieundmarkus.de/wcf/trunk/de.bessieundmarkus.gallery2
   
2. Released Versions: svn://www.bessieundmarkus.de/wcf/tags/
   

Open Items:
Was ist noch nicht umgesetzt bzw. steht als Idee noch vor der Planung?

1. Portal Box (Erledigt mit Version V1.1.0 RC1)
   
2. Umzug des Plugins ins WCF (Erledigt mit Version V1.1.0 RC1)
   
3. Verschiedenen andere Änderungen
   

Gallery2 ist ein Open Source Projekt, dass eine außergewöhnliche Photogalerie entwickelt mit einer beeindruckenden Anzahl an Features. Aufgrund der vielen Features und Einstellungsmöglichkeiten ist es zu empfehlen, sich vor der Installation dieses Addons mit der Gallery2 außeinanderzusetzen und alle Einstellungen so vorzunehmen, wie man sie später haben möchte, insbesondere die Einstellungen zu den Useralben! Um mehr über die Gallery2 und Gallery2 embed zu erfahren könnt ihr euch auf der englischsprachigen Website informieren: http://codex.gallery2.org/Gallery2:Embedding
Gallery2 Webseite: http://gallery.menalto.com/

Hier eine kleine installationshilfe für die Gallery2, das ganze ist zwar hervoragend beschrieben aber vielleicht ist das hier als Schnelleinstieg nicht schlecht.

1. Hochladen der Gallery Dateien auf den Webserver, dabei spielt es keine Rolle in welches Verzeichnis ihr die Dateien kopiert. Außer, dass die Dateien via http://DEINE.DOMAIN.DE/GALLERY/PFAD/main.php erreichbar sein müssen. (Die Dateien müssen entpackt sein)
   
2. Das Installationsscript ist selbserklärend.
   
3. Es ist egal in welche Datenbank ihr die Gallery2 installiert, ob in die gleiche oder eine andere als das WCF/WBB.
   
4. Es ist egal über welche Domain die Gallery2 aufgerufen wird.
   
5. Es ist egal über welche Subdomain die Gallery2 aufgerufen wird.
   
6. Die Gallery2 muss auf dem gleichen Webserver installiert sein, wie das WCF/WBB.
   
7. Das Gallery2 Verzeichniss muss vom WCF/WBB erreichbar sein (Berechtigungen).

Die Gallery2 hat eine eigene Benutzerverwaltung, die es erforderlich macht, je nach Nutzung die User zu synchronieren.

1. Entscheidung: Wie sollen die Useralben erzeugt werden?
   1. Einstellung in der Gallery2: Useralben werden beim anlegen des Gallery2 Users erzeugt.
   2. Einstellung in der Gallery2: Useralben werden beim ersten anmelden des WBB Users in der Gallery erzeugt.
   Die Einstellung daz findet ihr in der Site-Administration der Gallery unter dem Menupunkt Benutzeralben.
   Als Anmerkung: Bei 2.1 habt ihr unter Umständen sehr viele Useralben angelegt, die keine Bilder beinhalten und auch nie welche beinhalten werden. Dadurch würde der Bereich der Useralben sehr unübersichtlich.
   
   
2. Entscheidung: Wie sollen die User synchronsiert werden?
   1. Alle WCF/WBB User werden per Cronjob in die Gallery2 synchronisiert.
   2. Es wird nur der User synchronisiert, der die Gallery2 nutzt und zwar genau in dem Moment, in dem er die Gallery2 das ersta Mal betritt.
   Bei 3.1 ist der Userstamm WCF/WBB und Gallery2 tagesaktuell (der Cronjob läuft nur einmal am Tag). Dadurch ist das Betreten der Gallery2 auch beim ersten Mal schnell. Denkt an den Zusammenhang mit den Useralben, wenn ihr dort "beim anlegen des Users" gewählt habt, gibt es sehr viele Useralben.
   Bei 3.2 ist das erste betreten der Gallery2 langsamer und es ist egal, welche Art der Useralbumerzeugung ihr gewählt habt.

Es macht Sinn, die Registrierung von Usern in der Gallery2 abzuschaltet, dann können die User des WCF/WBB sich nicht doppelt registrieren und es kann nicht zu Inkonsistenzen, doppelten Einträgen oder Problemen kommen.

Um im ACP die Gallery verwalten zu können müsst ihr die Gruppe(n) anpassen. Dann findet ihr unter "Inhalte - Gallery" einige Optionen und Einstellungsmöglichkeiten.
Gruppe ändern - administrative Rechte - Inhalte:

1. Ändern
2. Löschen
3. Einfügen
4. Snychronierieren der User- und Rollendaten aus dem WCF in die Gallery.

Gruppe ändern - allgemeine Rechte - Gallery:

1. Gallery Profil anzeigen
2. Eigenes Album anlegen
3. User wird syncronisiert

Das Problem mit dem gleichen Usernamen in der Gallery2 und dem WCF ist behoben.

Was passieren kann ist eine Weiße Seite. Diese wird aus der Gallery2 erzeugt, wenn ein schwerer Fehler aufgetreten ist. Um herauszufindetn, was der tatsächliche Fehler ist könnt ihr folgendes machen. Entfernt die beiden // in der entsprechenden Gallery2 Datei, wie z.B. unter /wcf/lib/page/Gallery2Page.class.php. Dann wird eine Log Datei in das WCF Installationsverzeichnis weggeschrieben, die die PHP Fehlerinformationen beinhalten. In Zukunft kann man das Debugging ein- und ausschalten, samt Mail Funktionalität.

Fals Ihre Gallery in eine andere Anwendung eingebettet ist und Sie die folgenden Felder leer lassen, dann haben alle DownloadItem-Verweise (die URLs der Bilder und anderer Elemente) in der eingebetteten Gallery einen angehängten GALLERYSID-String in der URL, welcher ein g eringfügiges Sicherheitsrisiko darstellt, falls Ihre Gallery-Benutzer anfangen, Bilder-URLs in Foren, Gästebücher, etc. reinzukopieren. Die Alternative ist, den Cookie-Pfad einzustellen. Gallery wird dann keine GALLERYSID an die eingebetteten DownloadItem-URLs anfügen. Wenn z.B. die Gallery unter http://www.beispiel.de/anwendung/gallery2/ liegt und die einbettende Anwendung unter http://www.beispiel.de/anwendung/, dann müssen Sie den Pfad /anwendung/gallery2/ mit /anwendung/ vergleichen. Der Cookie-Pfad ist der Teil der Pfade, welcher identisch ist, in diesem Fall ist es '/anwendung/'. Meistens ist es einfach '/'.
Die Cookie-Domäne wird ebenfalls nur bei eingebettenten Gallery-Installationen gebraucht, und auch nur dann, wenn Sie den GALLERYSID-String in den eingebetteten DownloadItem-URLs loswerden wollen. In den meisten Fällen, kann die Cookie-Domäne leer gelassen werden. Stellen Sie sie nur ein, wenn die Gallery und die einbettende Anwendung ausschließlich über unterschiedliche Subdomänen erreichbar sind, z.B. wenn die Gallery unter http://photos.beispiel.de/ liegt und die Anwendung unter http://www.beispiel.de/. In diesem Fall müssen Sie die Cookie-Domäne beispiel.de einstellen (der Teil der Adressen, welcher in beiden enthalten ist, sowohl bei der Gallery als auch der einbettenden Anwendung).
Sobald Sie die Cookie-Einstellungen geändert haben, müssen alle registrierten Benutzer Ihrer Gallery ihren Cookie-Cache im Browser leeren. Wenn sie das nicht tun, werden sie Probleme beim Ein-/Ausloggen oder während des Nutzungsvorgangs haben.

Dazu sollte man wissem, dass die Gallery2 eine Schnittstelle zur Verfügung stellt, mit der sie in andere Applikationen eingebunden werden kann. Diese Schnittstelle wird "embed" genannt und beinhaltet hervoragende technischen Möglichkeiten. Durch Embed ist es möglich die Gallery2 über das WCF/WBB zu betreten und über die Gallery2 Seite selber.

1. Gallery2 Embed ins WBB 3 einbinden.
2. User des WBB in Richtung Gallery2 Syncronisieren (nur in diese eine Richtung).
3. Gruppen des WBB in Richtung Gallery2 Syncronisieren (nur in diese eine Richtung).
4. User in der Gallery2 anlegen, falls sie noch nicht syncronisiert sind.
5. Ihr dürft keinen User in der Gallery2 Administration löschen!!!!! Dies könnt ihr übers ACP des WBB umsetzen.

So, jetzt könnt ihr dieses Addin installieren. Nach der Addin Installation müssen noch ein paar Einstellungen über das ACP vorgenommen werden: System - Optionen - Bildergalerie

Ich hab beim testen immer mal wieder Probleme mit dem Templates patchen gehabt, aus diesem Grund biete ich euch zwei Packages an, eines mit Templates und eines mit einer Anleitung wie man die templates manuell abändert. Was müsst ihr bei der manuellen Version ändern:

1. userProfile.tpl: Suche nach {if $user->getAvatar()} und füge in der Zeile darüber folgenden HTML Code davor ein:
   

See http://codex.gallery2.org/Gallery2:Modul…ewrite_Embedded for general Dokumentation.

You have to proceed as follows:
1. Logon to WBB and go to your Gallery e.g. http://www.rettungshundeforum.de/portal/…p?page=Gallery2
2. Go to the Gallery Administration page (Inside WBB, not inside Gallery standalone).
3. Activate Short URL (Mod Rewrite) on the plugin page
4. Go to configuration of Mod Rewrite
5. Enter Path to WBB .htaccess, e.g. /your/path/to/wbb/installation/ (not the wcf path) when your WBB installation is stored in installation folder
6. Enter URL to your WBB, e.g. /portal/ when your wbb is running in http://www.rettungshundeforum.de/portal/ like mine.
7. Activate Plugin
8. Finished

You can see an example on the demo page: http://www.rettungshundeforum.de/portal/updates or http://www.rettungshundeforum.de/portal/v/user/bessie/

Hi,
beim Wechseln von der Version 1.0.x auf die Version 1.1.x muss das Plugin vorher deinstalliert werden. Das liegt daran, dass das Plugin jetzt unter dem WCF hängt und nicht mehr unter dem WBB.
Details zum Upgrade von Version 1.0.x auf 1.1.x findet ihr hier: Gallery2 Plugin V1.1.0 RC1