Google translator »

(Opens in a new window - öffnet in einem neuen Fenster)

# Kurz-Dokumentation Plugin "FotoGalerie XH"

Version FotoGalerie XH 6.5 - released 07/2012

FotoGalerie_XH ist ein Galerie-Plugin für mehrere einfache, kleine Fotogalerien auf CMSimple_XH Seiten. Jede Galerie kann ihr eigenes Layout und verschiedene Funktionen haben.

## 1. Systemvoraussetzungen

Voraussetzung ist eine funktionierende Installation von CMSimple_XH 1.2 utf-8 oder höher.

Das Plugin "FotoGalerie XH" wird nur utf-8 codiert bereitgestellt.

## 2. Installation

1. zip-Datei herunterladen und mit einem geeigneten Programm entpacken
2. - Laden Sie die komplette Ordner-Struktur des Verzeichnisses "CMSimpleRoot" (die Verzeichnisse "plugins" und "content") in das Installationsverzeichnis von CMSimple_XH hoch.
   - Ihr ftp Programm wird merken, dass es diese Verzeichnisse bereits gibt, und Sie fragen, ob Sie das wirklich tun wollen. Beantworten Sie diese Frage einfach mit "ja", "ok" oder was immer Ihr ftp Programm anbietet.
   - Bei einem Update laden Sie einfach das Verzeichnis "content" nicht mit hoch.
3. Vergeben mit Ihrem ftp-Programm die erforderlichen Lese- und Schreibrechte für Ordner und Dateien.

## 3. Datei- und Ordnerrechte

Damit das Programm funktioniert und arbeiten kann (bzw. administrierbar ist), müssen für bestimmte Dateien und Ordner bestimmte Schreib- und Leserechte vergeben werden.

### Dateien: chmod 666

- ./plugins/fotogalerie/languages/alle Dateien
- ./plugins/fotogalerie/config/config.php
- ./plugins/fotogalerie/css/stylesheet.css
- ./content/plugins/fotogalerie/images/alle .jpg Dateien
- ./content/plugins/fotogalerie/images/thumbs/alle .jpg Dateien
- ./content/plugins/fotogalerie/data/alle .txt Dateien

### Ordner: chmod 777

- ./plugins/fotogalerie/uploads/
- ./plugins/fotogalerie/languages/
- ./content/plugins/fotogalerie/data/
- ./content/plugins/fotogalerie/images/
- ./content/plugins/fotogalerie/images/thumbs/

## 4. Plugin-Aufruf

### 4.1 Im Inhalt

Fügen Sie folgenden Plugin-Aufruf in Ihre CMSimple_XH Seite ein, an der Stelle, an der die Galerie zu sehen sein soll:

{{{PLUGIN:FotoGalerie('Galerie ID');}}}

An Stelle von "Galerie ID" tragen Sie die ID der Galerie ein, die angezeigt werden soll.

Wenn Sie hier '0' (Null) eintragen, werden alle Bilder angezeigt, im float Layout und mit einer Lightbox beim anklicken.

Da die Editoren gerne automatich ein <p> ... </p> um den Plugin Aufruf setzen, empfiehlt es sich, den Plugin Aufruf in ein <div> ... </div> zu packen, damit die Seite validiert.

Hinweis: Bitte fügen Sie den Plugin Aufruf immer in der Quelltext Ansicht ein.

### 4.2 In Newsboxen

Für Galerien in Newsboxen muss in der Plugin Konfiguration "activate lightbox global:" auf "true" gesetzt werden.

### 4.3 Lightbox für Einzelbilder

Ab Version 6.0 können einzelne Bilder in einer Lightbox präsentiert werden. Dazu muss lediglich ein Link auf das Bild gesetzt werden:

<a href="Pfad_zum_Bild/bildname.jpg">Vorschaubild oder Linktext</a>

Für diese Funktion muss in der Plugin Konfiguration "activate lightbox global:" auf "true" gesetzt werden.

## 5. Konfiguration

Wenn Sie in CMSimple eingeloggt sind, finden Sie unterhalb des Edit Menüs eine Selectbox "Plugin wählen". Wählen Sie hier "Fotogalerie".

Jetzt öffnet sich das Plugin-Menü, wählen Sie hier "Plugin-Konfiguration".

In der Konfiguration können Sie Standardwerte festlegen, mit denen eine neue Galerie angelegt wird. Viele davon lassen sich im Menü "Galerie bearbeiten" für jede einzelne Galerie individuell bearbeiten.

Bei den verschiedenen Einstellungs-Möglichkeiten finden Sie jeweils ein kleines blaues Fragezeichen-Symbol. Gehen Sie mit der Maus auf das entsprechende Fragezeichen-Symbol, und Sie erhalten Informationen über die entsprechende Konfigurationsmöglichkeit.

## 6. Galerien anlegen und bearbeiten

Wenn Sie in CMSimple eingeloggt sind, finden Sie unterhalb des Edit Menüs eine Selectbox "Plugin wählen". Wählen Sie hier "Fotogalerie".

Jetzt öffnet sich das Plugin-Menü, wählen Sie hier "Galerien bearbeiten".

Mittels der Selectbox oben links können Sie die Galerie auswählen, die bearbeitet werden soll.

Unter "Galerie bearbeiten" können Sie für jede einzelne Galerie individuelle (von der Konfiguration abweichende) Werte einstellen, so kann jede Galerie etwas anders aussehen.

Die anderen Bearbeitungsmöglichkeiten erklären sich selbst.

Ganz unten finden Sie die Bilder, die in der ausgewählten Galerie angezeigt werden. Diese Bilder können Sie bearbeiten (laufende Nummer, Beschreibungstext usw.) und löschen.

## 7. MassenUpload von Bildern

Seit der Version 3.0 ist es möglich, ganze Bilderserien per ftp hochzuladen und mit FotoGalerie_XH einer Galerie hinzuzufügen bzw. in eine neue (leere) Galerie einzufügen. Gehen Sie wie folgt vor:

1. Wenn Sie eine neue Gelerie erstellen wollen, legen Sie die Galerie an.
2. Laden Sie die Bilder in das Verzeichnis "./plugins/fotogalerie/uploads/" hoch.
3. Gehen Sie zur Plugin Administration => "Galerien bearbeiten" und wählen Sie die Galerie aus, zu der die Bilder hinzugefügt werden sollen.
4. Klicken Sie auf "Bilder aus Upload Ordner hinzufügen". Die Bearbeitungsroutine für die Bilder beginnt, das kann einen Moment dauern. Anschliessend erhalten Sie die Meldungen über die ausgeführten Aktionen.

Im Laufe der Bearbeitungsroutine wird jedes einzelne Ursprungsbild gelöscht, am Ende ist der Upload-Ordner wieder leer, für die nächste Aktion.

## 8. Demo Galerie

Im Download ist eine Demo Galerie mit der ID "1" enthalten. Die können Sie wie folgt aufrufen:

{{{PLUGIN:FotoGalerie('1');}}}