Dokumentation PHP-Galerie 2.0

Dokumentation PHP-Galerie 2.0 Fa. KADIBA 31.08.2007, Enrico Bär

Anleitung zur PHP-Galerie Die Fotogalerie basiert auf PHP und einer MySQL-Datenbank. Die serverseitige Vorraussetzung für die Installation ist PHP 4.x und eine MySQL-Datenbank 4.x oder höher. Eine weitere Vorraussetzung ist ein javascriptfähiger Browser (optional Java-Runtime 1.4 für einen komfortableren Foto-Upload).

Installation mit Installationsroutine: Entpacken Sie die Zip-Datei lokal in ein Verzeichnis (Pfadangaben verwenden). Laden Sie das galerie-verzeichnis mit dessen Inhalt komplett auf den Webserver Setzen Sie auf die Verzeichnisse pics, thumbs Schreibrechte, CHMOD 775 Rufen Sie über den Browser das install-verzeichnis auf. Geben Sie die Datenbankzugangsdaten ein. Es gibt 3 Möglichkeiten bezüglich der Datenbank: 1) Sie können die Tabellen in eine bestehende DB integrieren 2) Sie können dafür eine neue DB erstellen 3) Sie können Ihre Vorgängerversion updaten (z.b. Version 1.8) Starten Sie die Installation Löschen Sie das install-verzeichnis manuell: Entpacken Sie die Zip-Datei lokal in ein Verzeichnis (Pfadangaben verwenden). Passen Sie die Konfiguration in der Datei inc_config.php.default (im install-verzeichnis) nach Ihren Wünschen an (inclusive MySQL-Datenbankzugangsdaten) und kopieren Sie diese als inc_config.php in das Hauptverzeichniss. Laden Sie das galerie-verzeichnis mit dessen Inhalt komplett auf den Webserver Setzen Sie auf die Verzeichnisse pics, thumbs Schreibrechte, CHMOD 775 Laden Sie über ein MySQL-Client (z.b. PHPMyAdmin) die create_db.sql (im install- Verzeichnis ) und führen sie aus create_db.sql für ein Neuanlegen update_db.sql für ein Updaten der Vorgängerversion Löschen Sie das install-verzeichnis Galeriebenutzer ( Frontend ) Zuerst wählen Sie anhand der Ländersymbole Ihre Sprache aus. Derzeit steht Ihnen Deutsch und Englisch zur Verfügung. Mit einem Klick auf das Eröffnungsbild in der Mitte gelangen Sie zur Albumübersicht. Sie finden die angelegten Alben auch jederzeit in der Combo-Box. Wählen Sie mit einem Klick in der Übersicht bzw. in der Combo-Box ein Album aus. Anhand der Symbole unter bzw. neben der Combo-Box können Sie eine Ansicht auswählen. Dazu gibt es 4 Möglichkeiten. Der Movielook ist die Standardansicht, die für normale Fotos und eine durchschnittliche Bildschirmauflösung gut geeignet ist. Sie können jedes Foto in der rechten Filmleiste mit einem Klick zur Ansicht auswählen. Es ist nur in dieser Ansicht möglich, die Sortierung der Fotos nach Uploaddatum, nach EXIF-Aufnahmedatum, nach Benutzer oder nach Foto-ID zu ändern. Benutzen Sie dafür die vier Symbole über der Filmleiste.

Die Vollbildansicht oder auch Fullsizelook ist für große Fotos oder kleine Bildschirmauflösungen gedacht. Sie können mit dem Vor- und Zurück-Button navigieren. Eine Erweiterung dieser Ansicht ist die Diashow, bei der lediglich das nächste Bild in einem Zeitintervall (Standard 6s) aufgerufen wird. Als vierte Ansicht gibt es den Albumlook, bei der Sie eine Übersicht der Dia in Blockseiten angezeigt bekommen. Sie können mit dem Vor- und Zurück-Button seitenweise navigieren. Mit einem Klick auf ein Dia gelangen Sie zur Vollbildansicht. Sollte eine Seite mit Vorschaubildern beim Aufruf etwas länger dauern, existieren zu den Bildern noch keine Dia und werden Just-in-Time erstellt. Dies geschieht jedoch in der Regel nur beim ersten Mal. Beachten Sie, dass Sie keine geschützten Alben auswählen können, wenn Sie nicht eingeloggt sind. Wenn Sie von Ihrem Galerieadminstrator ein Benutzernamen mit Passwort bekommen haben, klicken Sie auf das Loginsymbol und melden sich an. Anschliessend können Sie alle Alben auswählen, die Ihnen zugeteilt wurden. Neben jedem Foto sind (je nach Konfiguration) mehrere Symbole vorhanden. Es gibt maximal 3 Funktionen zu einem Bild: Sie können sich die Bildinformationen, wenn vorhanden auch EXIF-Daten, anzeigen lassen. EXIF-Daten sind u.a. Einstellungen der Digitalkamera, mit der das Bild gemacht wurde ( z.b. das Datum des Fotos, Blendenwert, ISO-Film-Norm etc. ) Sie können einen Fotolink einem Freund oder Bekannten versenden. Nach dem jeweiligen Symbolklick erscheint ein Popup-Fenster, in dem Sie die E-Mail-Adresse des Freundes mit einem Kurztext eingeben. Anschliessend versenden Sie die Nachricht. Die E-Mail-Adressen werden natürlich nicht zentral gespeichert, sondern für eine weitere Nutzung als Cookie lokal abgelegt. Eine weitere Funktion ist das Lesen und Schreiben von Bildkommentaren. Nach dem jeweiligen Symbolklick erscheint ein Popup-Fenster, in dem Sie alle Bildkommentare lesen können. Für einen weiteren Kommentar von Ihnen, geben Sie einfach Ihren Namen und Ihren Text ganz unten ein und klicken auf versenden. Sind Sie als Administator angemeldet, erscheint neben jedem Kommentar ein Löschbutton. Damit können Sie direkt beim Anschauen unsittliche Bemerkungen löschen. Hinweis: Für das Abspielen von Flashanimationen, Video- oder Audiodateien benötigen Sie ggf. das zugehörige Browserplugin.

Album-Administration Zum Administratorbereich gelangen Sie mit Version 1.7 nur über die Anmeldungsmaske oder einem gesetzten Bookmark. Die Standardanmeldung für den Administrator ist: Benutzer: admin / Passwort: keines. Der Administratorbereich ist in Login, Profil, Galerieverwaltung, Albumverwaltung, Bilderverwaltung, Javauploader und Benutzerverwaltung unterteilt. Ändern Sie zunächst das Passwort unter Profil. Galerieverwaltung Änderung in der Begriffserklärung: Bis zur Version 1.8 war eine Zusammenfassung von Fotos eine Galerie. Mit Version 1.9 ist das hingegen ein Album. Eine Galerie ist nun die Zusammenfassung von Alben, wobei jede in Farbe und Form völlig anders gestaltet werden kann. Hier können Sie alle Voreinstellungen für eine Galerie treffen, welche in den Vorgängerversionen noch in der inc_config.php-datei gemacht wurden. Das Betrifft Attribute für die Gestaltung und Formatierung der Galerie. So können Sie z.b. für Galerie A ganz andere Verzeichnisse für Fotos und Vorschaubilder definieren, wie für Galerie B. neue Galerie anlegen Es gibt nach der Installation schon eine Standardgalerie in der Sie Ihre Alben anlegen können. In diese kommen Sie automatisch mit dem Aufruf aus dem Browser http://domain/galeriexx. Um eine weitere Galerie anzulegen, wählen Sie in der Combo-Box Neu aus. Die Felder werden nun mit den Standardwerten gefüllt und können nach Belieben verändert werden. Speichern Sie mit Click auf die Diskette alle Werte. Sollten Sie die Verzeichnisse für die Fotos bei einer bestehenden Galerie ändern, müssen Sie die Fotos ebenfalls dem neuen Pfad entsprechend verschieben. Geben Sie dem PHP-User auch die nötigen Schreibrechte (CHMOD 775 oder 777). Zusätzlich angelegte Galerien erreichen Sie nur über einen speziellen Link. Wählen Sie dazu die jeweilige Galerie in der Combo-Box aus und kopieren Sie sich den Link aus dem Feld Galerie-Link. Es ist z.b. sinnvoll, den kopierten Link für das Anlegen einer neuen Domain bzw. Subdomain zu nutzen. Entscheidend in der URL ist die Galerie-ID galid.

Albumverwaltung Album anlegen Als nächstes legen Sie in der Albumverwaltung ein neues Album an. Setzen Sie dazu im oberen Bereich die Combo-Box auf Neu und geben rechts daneben einen Albumnamen ein. Zusätzlich ist noch eine Beschreibung zum Album möglich, die auch auf der Albumübersicht zu sehen ist. Möchten Sie das Album nur bestimmten Personen (mit Login) zugänglich machen, müssen Sie zunächst in der Benutzerverwaltung die Personen anlegen. Ist das erfolgt, können Sie beim Anlegen des Albums den Haken geschützer Bereich anwählen und die Benutzerkonten dem Album zuordnen. Dazu wählen Sie die Benutzer aus und klicken auf den >> Button. Bestätigen Sie Ihre Aktion mit dem Speicherbutton (Diskette). Album ändern Wählen Sie im oberen Bereich ein Album in der Combo-Box aus und ändern Sie die Einstellungen, den Namen oder die Beschreibung. Bestätigen Sie die Aktion mit dem Speicherbutton. Album löschen Falls Sie alle Bilder eines Albums löschen möchten, ist diese Funktion genau richtig. Wählen Sie im mittleren Bereich ein Album in der Combo-Box aus und bestätigen diese Aktion mit dem Löschbutton (Kreuz). Der Albumeintrag wird dabei ebenfalls gelöscht. Album verschieben Möchten Sie alle Bilder eines Albums in ein anderes bereits vorhandenes Album verschieben, benutzen Sie diese Funktion. Wählen Sie im unteren Teil jeweils das Quell- und Zielalbum in den Combo-Boxen aus und bestätigen Sie Ihre Aktion mit dem Verschiebebutton. Die Alben sollten jedoch nicht identisch sein. Bilderverwaltung Es gibt mehrere Möglichkeiten Bilder bzw. Videos einem Album hinzuzufügen. Die komfortabelste Methode ist der Java-Upload (siehe Java-Upload). Dazu benötigen Sie die Java-Runtime 1.4 oder höher auf Ihrem Computer. Für einzelne Fotos verwenden Sie die Funktionen der Bilderverwaltung. Zusätzlich ist es möglich, Fotos die via FTP ins Bilderverzeichnis pics hochgeladen wurden, in einem Album aufzunehmen. Bilder hinzufügen Wechseln Sie zunächst in die Bilderverwaltung. Im oberen Bereich können Sie Bild für Bild einzeln hochladen. Wählen Sie dazu unter JPEG-Bild hinzufügen eine Datei aus. Das können derzeit auch andere Dateiformate ausser JPEG sein (siehe Dateitypenunterstützung). Geben Sie ggf. noch eine Bildbeschreibung ein und wählen das Album aus, in das dass Bild eingefügt werden soll. Bestätigen Sie den Vorgang mit dem Speicherbutton. Beim Einzelupload gibt es noch 2 Optionen. Mit dem Abwählen des Hakens Größen einhalten, können Sie die Grössenvorgaben der Konfiguration umgehen, so dass das Foto keinem Resize-Verfahren unterzogen wird. Mit der Qualitätseinstellung können Sie bei JPEG-Dateien die Qualität zusätzlich beeinflussen. Sinnvolle Werte sind 50%-100%. Beachten Sie die maximale Uploadgröße je Datei in der Galerieverwaltung.

Bild löschen/bearbeiten/verschieben Im mittleren Teil können Sie Bilder bearbeiten, löschen und verschieben. Mit Bearbeiten ist das Hinzufügen bzw. Ändern der Bildbeschreibung gemeint. Mit Version 1.8 ist erstmalig auch eine Mehrfachauswahl von Bildern möglich. Benutzen Sie die STRG-Taste, um mehrere Bilder auszuwählen. Es gibt unter der Vorschau zusätzlich noch zwei Funktionen, um alle oder keine Bilder zu selektieren. Wählen Sie zunächst in der linken Combo-Box das Album aus. Nun markieren Sie ein oder mehrere Bilder, für die die nachfolgende Aktion ausgeführt werden soll. Jetzt können Sie den Text eingeben bzw. ändern und die Aktion mit dem Speicherbutton abschliessen. Dabei werden ggf. auch vorhandene Bildtexte überschrieben. Eine weitere Aktion ist das Löschen von Bildern. Benutzen Sie dafür den Löschbutton. Es werden alle markierten Bilder (auch physikalisch) gelöscht. Um nur die Bildkommentare von Gästen zu löschen, benutzen Sie den Kommentar-Löschbutton darunter. Dabei werden alle Kommentare der ausgewählten Bilder gelöscht. Die vierte Option nach der Auswahl von Bildern ist das Verschieben in ein anderes Album.Wählen Sie dazu rechts unten ein Zielalbum in der Combo-Box aus und benutzen Sie den Verschiebebutton (Pfeil). neue Bilder aufnehmen Sie können mit dieser Funktion schon hochgeladene Bilder aus dem Bilderverzeichnis pics aufnehmen und einem Album hinzufügen. Dazu müssen Sie ein Zielalbum auswählen und die Aktion mit dem Speicherbutton abschliessen. Es gibt hier ebenfalls noch 2 Optionen (siehe Bild hinzufügen). Da durch mögliche Grössenanpassungen bei vielen Fotos einige Zeit (je nach

Serverleistung) benötigt wird, kann es zu vorzeitigen Scriptabbrüchen kommen. Die meisten Provider haben in PHP eine maximale Laufzeit von 30 Sekunden eingestellt, um Ihre Server nicht zu überlasten. Starten Sie dann die Funktion mehrmals an. Java-Upload Der Java-Upload ist die einfachste Methode. Dazu müssen Sie der Ausführung des Applets zustimmen, so dass es Zugriff auf Ihre Bilddateien hat. Wählen Sie zunächst ein Zielalbum in der Combo-Box aus. Mit dem Hinzufügen können Sie Dateien (auch Mehrfachauswahl) für den Upload auswählen. Mit einem Klick auf ein Bildeintrag in der Liste, haben Sie auch eine schnelle Vorschau. Sind alle Bilder ausgewählt, können Sie den Upload starten, Button: Hochladen. Die Anzahl ist pro Upload auf 100 Bilder limitiert. Sollten Sie Probleme mit dem Applet haben, überprüfen Sie zuerst die ordnungsgemäße Installation der JavaRuntime 1.4 oder höher. Beachten Sie die maximale Uploadgröße je Datei in der Galerieverwaltung. EXIF-Daten bei Bildern Werden Bilder vom Server in der Größe geändert bzw. Signaturen hinzugefügt, gehen die EXIF- Daten verloren. Nutzen Sie jedoch den Java-Upload, wird dort schon die Größenänderung vorgenommen und die EXIF-Daten bleiben vorhanden. Nur bei einem Hinzufügen einer Signatur (wird vom Server übernommen) gehen die EXIF-Daten dennoch verloren. Video-Vorschaubilder Es gibt zwei Möglichkeiten, Vorschaubilder von Videos zu erstellen. Man benötigt dazu die exec()- Funktion von PHP, was jedoch nicht alle Provider im Safe-Mode anbieten (siehe phpinfo: disable_functions). Entweder benutzt man das Open-Source-Programm FFMpeg oder MPlayer. Folgende Dinge müssen zusätzlich vorgenommen werden: das BIN-Verzeichnis der PHP-Galerie muss Schreibrechte und Executerechte für die Programme haben (CHMOD 774, PHP muss Verzeichnisse im BIN-Verzeichnis der PHP- Galerie anlegen können). Sie müssen das Programm FFMpeg oder MPlayer für die Zielplattform (wenn nicht mitgeliefert) downloaden, in das BIN-Verzeichnis der PHP-Galerie kopieren und Executerechte für das Programm vergeben (CHMOD 774). Lesen Sie dazu auch die Datei todo_for_videothumbs.txt im BIN-Verzeichnis. Setzen Sie entweder das Flag MPLAYER_BIN_SUPPORT oder FFMPEG_BIN_SUPPORT in der inc_config.php auf TRUE Mehr zu den Programmen auf http://www.mplayerhq.hu/ und http://ffmpeg.mplayerhq.hu/. Eine genauere Fehlermeldung ist im Adminbereich unter Galerieverwaltung ersichtlich.

Benutzerverwaltung Benutzer verwalten Haben Sie das Recht der Benutzerverwaltung, können Sie andere Benutzer anlegen, löschen und bearbeiten. Angelegte Benutzer werden in 4 Kategorien eingeteilt. Kateg. 1 - Benutzer dürfen nur geschützte Alben anschauen Kateg. 2 - Benutzer dürfen Alben und Fotos anlegen, bearbeiten und löschen (Administrator) Kateg. 3 - Benutzer dürfen zusätzlich alle Benutzer bearbeiten, löschen und anlegen (Benutzerverwaltung) Kateg. 4 Benutzer dürfen zusätzlich Alben und Fotos anderer Benutzer bearbeiten und die Galerieeigenschaften ändern (Galerieverwaltung). Die Rechte auf Alben und Fotos von Benutzern ist von dem Flag ADMIN_RIGHTS_STRICT in der inc_config.php abhängig. Ist es auf TRUE darf nur der Besitzer (Anleger) eines Albums und der Galerieadministrator dasgleiche bearbeiten. Bei FALSE basiert das Verwalten von Alben wie bisher auf Vertrauen, also jeder Benutzer kann auch Bilder verwalten, die andere Benutzer angelegt haben. So kann ein Benutzer auch das Album inclusive Bilder eines anderen Benutzers löschen. Wechseln Sie auf die Benutzerverwaltung und klicken auf neuer Benutzer. Geben Sie einen Benutzernamen, einen Namen und ein Passwort ein. Die E-Mail-Adresse ist optional und wird derzeit nicht genutzt. Klicken Sie anschliessend auf den Speicherbutton. Möchten Sie einen Benutzer ändern, klicken Sie in der Benutzerliste auf den Namen. Sie können dann den Benutzer oben bearbeiten und speichern. Wollen Sie einen Benutzer löschen, wählen Sie dazu den Löschbutton des jeweiligen Benutzers aus und bestätigen die Löschaktion mit OK.

Dateitypenunterstützung Es können folgende Dateitypen hochgeladen und angezeigt werden: Bilder : gif, jpg, jpeg, bmp, png davon sind folgende Dateitypen in der Grösse änderbar: png, gif, jpg, jpeg Videos: avi, mpg, mpeg, wmv, swf Flash: swf Konfiguration und Customizing Sie können die PHP-Galerie in Form, Farbe und Design ganz Ihrer Webseite anpassen. Einige Hauptfunktionen werden in der inc_config.php Datei vorgenommen. Öffnen Sie die Datei in einem Editor und bearbeiten die define Definitionen. Alle Angaben sind im rechtsstehenden Kommentar beschrieben. Alle anderen Einstellungen sind für jede Galerie in der Galerieverwaltung. Darüber hinaus können Sie natürlich auch die Symbole, Buttons und Bilder im Verzeichnis images anpassen bzw. Ihre übernehmen. Achten Sie dabei auf die Einhaltung der vorhandenen Dateinamen (Sicherung des images-verzeichnis wird empfohlen). Wer einen Link, der gleichzeitig ein Benutzer-Login beinhaltet, versenden möchte, kann folgendes Beispiel abändern: http://domain/verzeichnis/index.php?xcurl=page:login.sort:0.offs:0.id:0.albid:0.user:0.langid:0.galid:1&fm_action=l ogin&user=benutzername&passwort=passwort Diese PHP-Foto-Galerie ist Freeware und kann für Weiterentwicklungen oder Anpassungen verändert werden, solange Sie dann nicht gegen Entgeld an Dritte weitergegeben wird! Für Feedback, mögliche Fehler oder Verbesserungsvorschläge senden Sie bitte ein E-Mail an: angebot@kadiba.de Viel Spass damit, Ihr Kadiba-Team PS: Wir suchen noch Personen, die uns gern gratis bei Übersetzungen in diverse Sprachen unterstützen, melden Sie sich bitte per E-Mail.