Inhaltsverzeichnis 1. Wichtige Informationen 1.1. Vorrausetzungen 1.2. Zusätzliche Sprachdateien 1.3. Thumbnail-Erstellung und Verkleinerung der Bilder 1.4. Schutz Ihrer Daten und Shop Sicherheit 2. Installation 2.1. FTP Upload 2.2. Rechte setzen 2.3. MySQL Datenbank installieren 2.4. Administrations-Zentrum 2.5. Graphik-Bibliothek einstellen 2.6. Medien/Bilder hochladen 2.7. Konfigurations-Hilfen 3. Mögliche Probleme
1. Wichtige Hinweise 1.1 Vorrausetzungen PHP 4.3.0+ (5.2.1 empfohlen) MySQL 3.23+ (MySQL 4 oder 5 empfohlen) GD 2.x.x oder ImageMagick PHP Konfiguration: Safe_mode muss OFF sein, sonst kann photokorn keine Ordner erstellen. Wenn Sie Probleme haben mit dem Upload Ihrer Bilder, dann ist safe_mode wahrscheinlich angeschaltet. Bitten Sie Ihren Provider dies abzuschalten oder tun Sie dies selbst, indem Sie die php.ini Ihres Servers entsprechend ändern, insofern Sie Zugriff darauf haben. o Max. ausführbare Zeit: min. 30 Sek. (90 Sek. oder höher empfohlen) o Memory limit: min. 8 MB (40 MB oder höher empfohlen) o PHP sollte mit MySQL, Sessions und GD Unterstützung kompiliert sein o Optional: ZLib (gzip) 1.2 Zusätzliche Sprachdateien Wenn Sie selbst eine Sprache übersetzen möchten gehen Sie folgendermaßen vor: Kopieren Sie z.b. die Datei german.php oder english.php im Ordner languages. Benennen Sie diese Datei in die neue Sprache um, z.b. french.php. Öffnen Sie nun die Datei french.php mit einem Text-Editor und übersetzen Sie die einzelnen Texte in den Variablen. Sie können die Hilfe Dateien und andere Sprachdateien ebenfalls übersetzen. Achtung Sie dürfen auf keinen Fall die Namen der Variablen ändern. Bitte immer nur den Text innerhalb der Anführungszeichen. Achten Sie darauf Umlaute in HTML entities zu konvertieren. Wenn Sie die Kodierung UTF-8 verwenden möchten, müssen Sie die Sprachdatei auch in diesem Modus abspeichern, dies ist z.b. mit Adobe Dreamweaver oder ähnlichen HTML Editoren möglich. 1.3 Thumbnail-Erstellung und Verkleinerung der Bilder Damit die automatische Erstellung von Thumbnails und mittelgroßen Bildern funktioniert, muss PHP mit GD kompiliert sein. Alternativ können Sie ImageMagick verwenden, sofern dies auf Ihrem Server installiert ist. Für das Erstellen von Thumbnails aus Videos muss ffmpeg installiert sein. Informieren Sie sich bei Ihrem Provider, wenn Sie die Pfade zu ImageMagick oder ffmpeg nicht kennen. Auf den meisten Standardservern ist ffmpeg nicht installiert. Sofern Sie root Zugriff haben, und sich gut im Umgang mit der Serververwaltung auskennen, können Sie die Installation selbst ausführen.
Vergessen Sie nicht die Pfade zu ImageMagick und/oder ffmpeg im Admin-Center anzupassen, falls zutreffend. 1.4 Schutz Ihrer Daten und Shop-Sicherheit Wir empfehlen, dass Sie keine Originaldaten, die Sie über das Shop-System verkaufen auf Ihren Server oder in die Galerie hochladen. Laden Sie nur Daten mit geringer Auflösung / Größe in die Galerie und/oder benutzen Sie die Wasserzeichen-Funktion, um diese Daten zusätzlich zu schützen. Die einzige Möglichkeit Ihre Originaldaten so wie möglich zu sichern, besteht darin eine so genannte.htaccess Datei in den automatisch generierten, zufällig benannten Originalordner jeder Kategorie zu legen. Dann werden Besucher aufgefordert einen Benutzernamen und ein Passwort vor dem Zugriff auf die Originaldatei einzugeben. Bei Windows Server mit IIS müssen Sie die Rechte des Ordners über das Konfigurationsprogramm des Servers ändern, um einen ähnlichen Schutz einzustellen. Sie können aber auch über das Admin-Zentrum, eine.htaccess Datei mit mehreren Benutzern für jede Kategorie anlegen. Vergessen Sie nicht, im Internet gibt es niemals 100% Sicherheit. Wir haften unter keinen Umständen für evtl. auftretenden finanziellen, materiellen oder ideellen Schaden, der trotz großer Sorgfalt in der Programmierung durch mangelnde Sicherheit diesbezüglich entstehen könnte.
2. Installation 2.1 FTP Upload Laden Sie alle Ordner im Verzeichnis "photokorn", außer die Ordner doc und update mit einem FTP-Programm (wie z.b. FileZilla) auf Ihren Server. Sie können den Ordner photokorn ruhig in einen anderen Namen ändern (z.b. galerie oder fotos). Achten Sie darauf, dass Sie Bilder im Binary-Modus und PHP- und HTML-Dateien im ASCII-Modus hochladen. Wenn Ihr FTP Programm richtig konfiguriert ist, wird dies den richtigen Upload-Modus selbst erkennen. 2.2 Rechte vergeben Die chmod Funktion ist bei Windows-Server nicht verfügbar. Stellen Sie sicher, dass die unten gelisteten Ordner und Dateien schreibbar sind (IIS oder Apache Einstellungen). Normalerweise müssen Sie bei Windows Servern jedoch nichts ändern. Für Unix Server: Vergeben Sie die Rechte für folgende Dateien und Ordner mit Ihrem FTP- Programm. Markieren Sie den enstprechenden Ordner oder die entspechende Datei und klicken Sie anschließen mit der Rechten Maustaste auf die markierte Datei. Wählen Sie im erscheinenden Dialogfeld Dateiattribute oder chmod aus. Markieren Sie nun die verfügbaren Kästchen, so dass die Rechte wie unten aufgelistet vergeben werden. Abbildung 1: Screenshot FileZilla FTP Client, Rechte Einstellen
backups chmod 777 (Ordner für Datenbank-Backups) backups/orders chmod 777 (Ordner für Backups der Bestellungen) mediatemp chmod 777 (Ordner für Streaming-Dateien) photos chmod 777 (Medien Ordner) footer.php chmod 666 (Fußdatei im Hauptordner) header.php chmod 666 (Kopfdatei im Hauptordner) includes/mysql.inc.php chmod 666 (MySQL Login und Pfade) photokorn.css chmod 666 (Style sheet im Hauptordner) FileZilla ist ein kostenloser Open Source FTP-Client für Windows und Linux Diesen können Sie über http://www.filezilla.de herunterladen. Rechte: Vergleichstabelle R = read (lesen), W = write (schreiben), E = execute (ausführen) chmod Besitzer Gruppe Andere 777 RWE RWE RWE 666 RW RW RW 2.3 MySQL Datenbanktabellen Damit Sie photokorn installieren können, müssen Sie eine Datenbank zur Verfügung haben. Wir setzen voraus das Ihr Webspace bereits über eine MySQL-Datenbank verfügt oder das Sie selbst eine Datenbank erstellen (z.b. über phpmyadmin) können. Zu solch einer Datenbank gehört ein Benutzername, ein Passwort und ein Hostname. Diese müssen Sie für die Installation kennen. Wenn nicht, kontaktieren Sie Ihren Provider. Rufen Sie das Installationsscript in Ihrem Browser auf: z.b. http://ihre.domain.de/photokorn/install/index.php Geben Sie nun Ihre MySQL Datenbank-Details ein. Die Installationsroutine erstellt 13 Tabellen in Ihrer Datenbank, die mit dem von Ihnen definiert Präfix benannt werden.
SEHR WICHTIG: Nach erfolgreicher Installation löschen Sie unbedingt das install Verzeichnis von Ihrem Server! Falls Sie den Ordner update oder doc hochgeladen haben, löschen Sie diese ebenfalls. 2.4 Admin-Zentrum - Login Daten Der vordefinierte Benutzername und das dazugehörige Passwort lauten: Benutzername: Passwort: admin admin Gehen Sie nun zum photokorn Administrations-Bereich und ändern Sie Ihren Login Benutzernamen und Passwort. Die Einstellungen hierfür finden Sie im Menü Konfiguration -> Administration. Den Administrationsbereich erreichen Sie unter http://ihre.domain.de/photokorn/admin/index.php 2.5 Grafik-Bibliothek einstellen Im Administrationsbereich klicken Sie auf den Link "Konfiguration" und definieren Sie welche GD oder ImageMagick Version Sie installiert bzw. benutzen möchten. Die Vorsteinstellung ist GD 2.x.x. Falls Sie ImageMagick verwenden möchten, müssen Sie den korrekten Pfad manuell eingeben, falls dieser vom Installationskript nicht automatisch erkannt wurde. Falls Ihnen dieser nicht bekannt ist, fragen Sie bei Ihrem Provider nach. Für Unix-Systeme z.b. Für Windows-Systeme z.b. /usr/bin/local/convert oder /usr/bin/convert c:/imagemagick/convert.exe 2.6 Medien/Bilder hochladen Während der Installationsroutine wurde bereits eine Test-Kategorie für Sie angelegt. Sie können die Details dieser Kategorie im Administrationsbereich ändern. Um ein Datei in eine Kategorie hochzuladen, klicken Sie auf den Link "Datei hochladen" im Administrations-Menü und laden Sie ihr Bild hoch. 2.7 Konfigurations-Hilfen Unter dem Menüpunkt Hilfe finden viele Informationen über photokorn. Sollten dort keine passende Antwort finden, schauen Sie im Supportbereich auf unserer Homepage nach.
3. Mögliche Probleme Falls Sie eine weiße Seite nach der Installation bekommen oder nur Platzhalter für die Bilder erscheinen, prüfen Sie ob die Pfade in der Datei mysql.inc.php (im includes Ordner) richtig eingetragen wurden! Korrigieren Sie diese evtl. manuell. Wenn Sie Login-Probleme haben, prüfen Sie, ob Ihr Server "Sessions" unterstüzt und das der Sessions-Ordner vorhanden und beschreibar ist! Der Pfad wird in der phpinfo angezeigt. Falls Sie openbase_dir oder safe_mode Fehlermeldungen beim Hochladen oder Verwalten der Kategorien oder Bilder bekommen, dann ist auf Ihrem Server wahrscheinlich safe_mode angeschaltet. Sie können dies in der phpinfo prüfen. Falls ja, müssen Ihren Provider bitten, dies für Sie abzustellen. safe_mode muss OFF sein, damit die Galerie richtig funktioniert. Falls Sie Probleme bei der Installation haben, besuchen Sie unser Supportbereich auf unserer Homepage. Wenn Sie dort keine Antwort finden, das Ihr Problem behebt oder erklärt, kontaktieren Sie uns und geben Sie bei die genaue Fehlermeldung an und so viele weitere Informationen wie möglich. Dann können wir Ihnen ohne langes Nachfragen schnell helfen. Falls Sie memory exhausted Fehlermeldungen nach dem Hochladen eines Bildes bekommen, dann hat Ihr Server oder Webspace nicht ausreichend Speicher (memory_limit), um das Bild mit GD zu bearbeiten. Je nach Bildgröße benötigt GD mehr oder weniger Speicher. Ein Bild mit 800x600 Pixel braucht ca. 4.8 MB Speicher, ein Bild mit 3000 x 2000 Pixel dagegen fast das 10 fache, sprich über 40 MB. Weniger Speicherintesiv und evtl. schneller ist ImageMagick.