🇬🇧 English
Features Showcase Performance PhotoFlow erhalten
Installationsanleitung

Erste Schritte mit PhotoFlow Gallery

Folgen Sie dieser umfassenden Anleitung, um PhotoFlow Gallery in wenigen Minuten auf Ihrer Joomla-Website zu installieren und zu konfigurieren.

1

Systemvoraussetzungen

Stellen Sie sicher, dass Ihr Server diese Voraussetzungen vor der Installation erfüllt

Joomla-Version

Joomla 4.0+, 5.x oder 6.x

PHP-Version

PHP 8.0 oder höher

Datenbank

MySQL 5.7+ oder MariaDB 10.3+

PHP-Erweiterungen

GD oder Imagick für Bildverarbeitung

Speicherlimit

128MB Minimum (256MB empfohlen)

Upload-Limit

16MB Minimum (64MB empfohlen)

Native Joomla 4/5/6 Unterstützung

PhotoFlow Gallery wurde nativ für Joomla 4+ entwickelt. Kein Legacy-Kompatibilitäts-Plugin erforderlich! Die Erweiterung nutzt moderne Joomla-Architektur mit Namespaced-Klassen und folgt allen aktuellen Best Practices.

2

Herunterladen & Kaufen

Holen Sie sich Ihr PhotoFlow Gallery Paket

Komplettes Paket enthalten

Ihr Kauf beinhaltet die Komponente (com_photoflow), das Modul (mod_photoflow) und das Plugin (plg_photoflow) in einem einzigen installierbaren Paket. Einmalige Zahlung von 20 EUR mit lebenslangen Updates.

  1. Besuchen Sie die Download-Seite

    Navigieren Sie zur PhotoFlow Gallery Kaufseite und klicken Sie auf den Button "Jetzt kaufen - 20 EUR".

  2. Schließen Sie den Kauf ab

    Folgen Sie dem Checkout-Prozess, um Ihren Kauf abzuschließen. Sie erhalten eine Bestätigungs-E-Mail mit Ihrem Download-Link.

  3. Laden Sie das Paket herunter

    Verwenden Sie den Download-Link aus Ihrer Bestätigungs-E-Mail, um die Datei com_photoflow_X.X.X.zip herunterzuladen. Speichern Sie sie auf Ihrem Computer - Sie benötigen sie für den nächsten Schritt.

Bewahren Sie Ihren Download-Link sicher auf

Speichern Sie Ihren Download-Link und Ihre Lizenzinformationen sicher. Sie benötigen diese für zukünftige Updates und Support-Anfragen. Der Download-Link enthält Ihren Lizenzschlüssel für automatische Update-Benachrichtigungen.

3

Installation über den Extension Manager

Installieren Sie PhotoFlow Gallery über Joomlas Extension Manager

  1. Melden Sie sich im Joomla Administrator an

    Greifen Sie auf Ihr Joomla-Backend zu, indem Sie zu ihreseite.de/administrator navigieren und sich mit Ihren Administrator-Zugangsdaten anmelden.

  2. Öffnen Sie den Extension Manager

    Gehen Sie im oberen Menü zu System → Installieren → Erweiterungen (oder System → Erweiterungen → Installieren in einigen Joomla-Versionen).

  3. Laden Sie die Paketdatei hoch

    Klicken Sie im Tab "Paketdatei hochladen" (sollte standardmäßig ausgewählt sein) auf "Durchsuchen" oder ziehen Sie die Datei com_photoflow_X.X.X.zip per Drag & Drop hinein.

  4. Installieren Sie die Erweiterung

    Klicken Sie auf den Button "Hochladen & Installieren". Joomla wird das Paket verarbeiten und alle drei Erweiterungen (Komponente, Modul und Plugin) automatisch installieren.

  5. Überprüfen Sie die erfolgreiche Installation

    Sie sollten eine Erfolgsmeldung sehen, die bestätigt, dass PhotoFlow Gallery installiert wurde. Falls Sie Fehlermeldungen sehen, konsultieren Sie den Abschnitt Fehlerbehebung unten.

Screenshot: System → Installieren → Erweiterungen

Installation abgeschlossen!

Nach erfolgreicher Installation ist PhotoFlow Gallery bereit zur Konfiguration. Sie finden einen neuen Menüpunkt "PhotoFlow Gallery" im Komponenten-Menü in Ihrem Joomla-Administrator-Panel.

4

Grundkonfiguration

Konfigurieren Sie wesentliche Einstellungen für optimale Leistung

  1. Öffnen Sie die Komponenten-Einstellungen

    Navigieren Sie zu Komponenten → PhotoFlow Gallery → Optionen (Button in der oberen rechten Symbolleiste).

  2. Konfigurieren Sie die Galerie-Anzeigeeinstellungen

    Im Tab "Galerie-Anzeige" legen Sie Ihren bevorzugten Anzeigemodus fest (Raster, Liste, Masonry oder Karussell), Anzahl der Spalten und Bildseitenverhältnis. Dies sind globale Standardwerte, die pro Menüpunkt überschrieben werden können.

  3. Legen Sie Upload-Limits fest

    Im Tab "Upload" konfigurieren Sie die maximale Dateigröße und erlaubte Bildformate (JPEG, PNG, GIF, WebP, AVIF). Empfohlen: 10MB maximale Dateigröße für Originale.

  4. Konfigurieren Sie die Bildverarbeitung

    Aktivieren Sie die automatische WebP/AVIF-Konvertierung für bessere Performance. Legen Sie die Thumbnail-Größe fest (empfohlen: 400x400) und Detailbildgröße (empfohlen: 1920x1080).

  5. Aktivieren Sie Performance-Funktionen

    Im Tab "Performance" aktivieren Sie Query-Caching und Virtual Scroll für große Galerien. Legen Sie die Cache-Lebensdauer fest (empfohlen: 3600 Sekunden).

  6. Konfigurieren Sie Sicherheitseinstellungen (optional)

    Im Tab "Sicherheit" legen Sie Standard-Passwortschutz-Einstellungen, Sperrlimits und Zugriffskontroll-Präferenzen fest, falls benötigt.

  7. Speichern Sie die Konfiguration

    Klicken Sie auf "Speichern & Schließen", um Ihre Einstellungen anzuwenden.

Empfohlene Einstellungen
Anzeigemodus: Raster Spalten: 4 (Desktop), 2 (Tablet), 1 (Mobil) Seitenverhältnis: 1:1 (quadratisch) Thumbnail-Größe: 400x400 Detailgröße: 1920x1080 WebP-Konvertierung: Aktiviert Virtual Scroll: Aktiviert Cache-Lebensdauer: 3600 Sekunden
Konfigurations-Tipps

Diese Einstellungen sind globale Standardwerte und können bei einzelnen Menüpunkten überschrieben werden. Beginnen Sie mit diesen empfohlenen Einstellungen und passen Sie diese basierend auf Ihren spezifischen Anforderungen und Server-Kapazitäten an.

6

Fehlerbehebung häufiger Probleme

Lösungen für häufig auftretende Probleme

Installation schlägt fehl mit "Could not find installer" Fehler

Dies deutet normalerweise auf eine beschädigte ZIP-Datei hin. Laden Sie das Paket von Ihrem Download-Link erneut herunter und versuchen Sie es nochmal. Stellen Sie sicher, dass Sie die vollständige Datei ohne Unterbrechung herunterladen. Wenn das Problem weiterhin besteht, überprüfen Sie die Berechtigungen des tmp-Verzeichnisses Ihres Servers (sollte beschreibbar sein).

Bilder werden nicht angezeigt oder zeigen defekte Bild-Icons

Überprüfen Sie, ob das Verzeichnis images/photoflow existiert und die richtigen Berechtigungen hat (755 für Verzeichnisse, 644 für Dateien). Stellen Sie sicher, dass die GD- oder Imagick-Erweiterung in PHP aktiviert ist. Löschen Sie den Joomla-Cache und Browser-Cache. Falls Sie CloudFlare oder ein CDN verwenden, leeren Sie auch den CDN-Cache.

Upload schlägt fehl mit "File too large" Fehler

Die Upload-Limits Ihres Servers sind zu niedrig. Kontaktieren Sie Ihren Hosting-Provider, um upload_max_filesize und post_max_size in der php.ini zu erhöhen (empfohlen: mindestens 64MB). Alternativ können Sie FTP verwenden, um große Bilder nach images/photoflow/originals/ hochzuladen und dann die Massen-Import-Funktion nutzen.

Galerie wird angezeigt, aber Bilder laden nicht (endloser Lade-Spinner)

Überprüfen Sie die Browser-Konsole auf JavaScript-Fehler. Stellen Sie sicher, dass jQuery geladen ist (Joomla 4+ lädt es standardmäßig). Überprüfen Sie, ob die JSON-API zugänglich ist, indem Sie besuchen: ihreseite.de/index.php?option=com_photoflow&view=gallery&format=json. Falls Sie "403 Forbidden" sehen, überprüfen Sie Ihre .htaccess-Regeln auf Konflikte.

WebP/AVIF-Konvertierung funktioniert nicht

Überprüfen Sie, ob die GD-Bibliothek WebP/AVIF unterstützt (PHP 8.1+ erforderlich für AVIF). Führen Sie phpinfo() aus, um dies zu überprüfen. Falls nicht unterstützt, wechseln Sie zu Imagick oder deaktivieren Sie die automatische Konvertierung und verwenden Sie ein Drittanbieter-Tool zur Konvertierung von Bildern vor dem Upload. Die meisten modernen Hosting-Provider unterstützen WebP.

Performance-Probleme mit großen Galerien (1000+ Bilder)

Aktivieren Sie Virtual Scrolling in den Performance-Einstellungen (sollte standardmäßig aktiviert sein). Erhöhen Sie die Query-Cache-Lebensdauer. Erwägen Sie die Verwendung von Kategorien, um große Galerien in kleinere Bereiche aufzuteilen. Aktivieren Sie Joomlas Seiten-Caching. Optimieren Sie Ihre Datenbanktabellen regelmäßig über phpMyAdmin oder Akeeba Admin Tools.

Komponente erscheint nicht im Komponenten-Menü

Gehen Sie zu System → Erweiterungen → Verwalten, suchen Sie nach "PhotoFlow" und stellen Sie sicher, dass der Komponenten-Status "Aktiviert" ist. Löschen Sie den Joomla-Cache (System → Cache leeren). Falls immer noch nicht sichtbar, überprüfen Sie Ihre Benutzerberechtigungen - Sie benötigen Super User- oder Administrator-Zugriff, um Komponenten zu sehen.

404-Fehler auf Galerie-Seiten

Stellen Sie sicher, dass URL-Rewriting in der globalen Joomla-Konfiguration aktiviert ist. Überprüfen Sie, ob die .htaccess-Datei im Joomla-Root existiert (kopieren Sie sie aus htaccess.txt, falls fehlend). Überprüfen Sie, dass mod_rewrite auf Ihrem Apache-Server aktiviert ist. Für NGINX stellen Sie sicher, dass die richtigen Rewrite-Regeln konfiguriert sind.

Haben Sie immer noch Probleme?

Falls Sie nach dem Ausprobieren dieser Lösungen weiterhin Probleme haben, kontaktieren Sie bitte den Support mit detaillierten Informationen: Joomla-Version, PHP-Version, genaue Fehlermeldungen und Schritte zur Reproduktion des Problems. Fügen Sie wenn möglich Ihre Server-Fehlerprotokolle bei.

Bereit, erstaunliche Galerien zu erstellen?

Beginnen Sie damit, Ihre Bilder professionell mit PhotoFlow Gallery zu präsentieren