PhotoFlow Gallery Dokumentation

Erste Schritte

PhotoFlow Gallery ist eine moderne, hochleistungsfähige Bildergalerie-Erweiterung für Joomla 4, 5 & 6. Sie bietet automatische Bildoptimierung, mehrere Anzeigemodi und erweiterte Sicherheitsfunktionen direkt ab Werk.

Systemanforderungen

Hauptfunktionen

Installation

Die Installation von PhotoFlow Gallery ist mit dem Joomla-Erweiterungs-Installer unkompliziert.

Standard-Installation

1. Laden Sie das PhotoFlow Gallery-Paket herunter (pkg_photoflow_X.X.X.zip)
2. Melden Sie sich in Ihrem Joomla-Administratorbereich an
3. Navigieren Sie zu System → Installieren → Erweiterungen
4. Klicken Sie auf den Tab Paket-Datei hochladen
5. Wählen Sie die heruntergeladene ZIP-Datei aus und klicken Sie auf Hochladen & Installieren
6. Warten Sie, bis die Installation abgeschlossen ist

Schritte nach der Installation

1. Bildverzeichnisse erstellen: PhotoFlow erstellt automatisch:
   • images/photoflow/originals/ - Original-hochgeladene Bilder
   • images/photoflow/detail/ - Detailansicht-Bilder
   • images/photoflow/thumbs/ - Vorschaubilder
2. Berechtigungen konfigurieren: Stellen Sie sicher, dass Verzeichnisse beschreibbar sind (755 oder 775)
3. Plugin aktivieren: Navigieren Sie zu System → Plugins und aktivieren Sie das PhotoFlow-Plugin
4. Menüpunkt erstellen: Richten Sie einen Menüpunkt ein, der auf die PhotoFlow-Galerie zeigt

Aktualisierung von einer Vorversion

Um PhotoFlow zu aktualisieren, installieren Sie einfach die neue Version über der bestehenden Installation. Joomla übernimmt automatisch den Upgrade-Prozess und führt alle erforderlichen Datenbank-Updates durch.

// Datenbank-Updates sind automatisch
// Alte Bilder und Einstellungen bleiben erhalten
// Keine manuelle Migration erforderlich

Konfiguration

PhotoFlow bietet umfassende Konfigurationsoptionen, die über Komponenten → PhotoFlow → Optionen zugänglich sind.

Galerie-Anzeigeeinstellungen

Karten-Stil-Einstellungen

Passen Sie das Erscheinungsbild von Bildkarten in Ihrer Galerie an:

• Hover-Effekt: Keiner, Zoom, Anheben oder Overlay
• Titel anzeigen: Bildtitel auf Karten anzeigen
• Beschreibung anzeigen: Beschreibungen beim Hovern anzeigen
• Statistiken anzeigen: Ansichten und Download-Anzahlen anzeigen
• Eckenradius: Randradius für Karten (0-32px)
• Schattenintensität: Kartenschattenstärke

Kategorien & Alben

Kategoriekonfiguration

• Kategorie-Layout: Globalen Anzeigemodus pro Kategorie überschreiben
• Kategoriebeschreibung anzeigen: Kategoriebeschreibung über Bildern anzeigen
• Unterkategorien anzeigen: Untergeordnete Kategorien anzeigen
• Unterkategorie-Stil: Karten oder kompakte Liste
• Sortierung: Benutzerdefiniert, alphabetisch, Erstellungsdatum oder Änderungsdatum

Upload-Einstellungen

Sicherheitskonfiguration

Passwortschutz

• Globales Passwort: Ein Passwort für alle Bilder festlegen
• Bildspezifische Passwörter: Individuelle Passwörter für bestimmte Bilder
• Musterbasierte Passwörter: Dynamische Passwörter mit Datums-/Zeitmustern
• Sperrschutz: Fehlgeschlagene Passwortversuche begrenzen (Standard: 5)
• Sperrdauer: Wie lange Benutzer gesperrt werden (Minuten)

Zugriffskontrolle

Leistungsoptimierung

CDN-Einstellungen

Content Delivery Network-Integration für schnellere Bildauslieferung konfigurieren:

• CDN aktivieren: CDN für Bildauslieferung verwenden
• CDN-URL: Ihre CDN-Basis-URL
• CDN-Pfad: Pfad zu PhotoFlow-Bildern im CDN
• Für Vorschaubilder verwenden: Vorschaubilder über CDN bereitstellen
• Für Detailbilder verwenden: Detailbilder über CDN bereitstellen
• Für Originale verwenden: Original-Bilder über CDN bereitstellen

Bildverwaltung

PhotoFlow bietet leistungsstarke Tools für die effiziente Verwaltung Ihrer Bildbibliothek.

Bilder hochladen

Einzelbildupload

1. Navigieren Sie zu Komponenten → PhotoFlow → Bilder
2. Klicken Sie auf die Schaltfläche Neu
3. Füllen Sie die Bilddetails aus:
   • Titel: Bildtitel (erforderlich)
   • Alias: URL-freundlicher Name (wird automatisch generiert, falls leer)
   • Beschreibung: Bildbeschreibung
   • Kategorie: Eine Kategorie auswählen
   • Zugriffsebene: Wer dieses Bild sehen kann
4. Wählen Sie die Bilddatei mit dem Dateiauswahl-Tool aus
5. Klicken Sie auf Speichern & Schließen

Massenimport

Importieren Sie Tausende von Bildern aus einem vorhandenen Verzeichnis auf Ihrem Server.

1. Laden Sie Bilder in ein Verzeichnis auf Ihrem Server hoch (z.B. images/import/)
2. Gehen Sie zu Komponenten → PhotoFlow → Import
3. Geben Sie den Quellverzeichnispfad ein
4. Konfigurieren Sie die Importeinstellungen:
   • Zielkategorie: Kategorie für importierte Bilder
   • Standardzugriff: Zugriffsebene für alle Importe
   • Dateiname als Titel verwenden: Titel automatisch generieren
   • Duplikate überspringen: Auf vorhandene Dateien prüfen
   • Nach Import löschen: Quelldateien entfernen
5. Klicken Sie auf Import starten
6. Überwachen Sie den Fortschrittsbalken

// Beispiel für Import-Verzeichnisstruktur
images/import/
├── urlaub-2024/
│   ├── strand-sonnenuntergang.jpg
│   ├── bergblick.jpg
│   └── stadtlichter.jpg
└── portfolio/
    ├── portrait-1.jpg
    └── landschaft-1.jpg

Vorschaubild-Verwaltung

PhotoFlow verwaltet Bildversionen automatisch, aber Sie können sie auch manuell neu generieren:

Einzelnes Bild regenerieren

1. Gehen Sie zu Komponenten → PhotoFlow → Bilder
2. Wählen Sie das Bild aus
3. Klicken Sie auf Aktionen → Vorschaubilder regenerieren

Alle Bilder regenerieren

1. Navigieren Sie zu Komponenten → PhotoFlow → Wartung
2. Klicken Sie auf Alle Vorschaubilder regenerieren
3. Bestätigen Sie die Aktion
4. Warten Sie, bis die Stapelverarbeitung abgeschlossen ist

Bild-Metadaten

PhotoFlow verfolgt automatisch wichtige Metadaten für jedes Bild:

• Dateiinformationen: Dateiname, Größe, Abmessungen, MIME-Typ
• Statistiken: Anzahl der Aufrufe, Anzahl der Downloads
• Zeitstempel: Upload-Datum, letztes Änderungsdatum
• Benutzerdaten: Hochgeladen von, geändert von
• EXIF-Daten: Kamerainfo, GPS-Koordinaten (falls verfügbar)

Wartungswerkzeuge

Halten Sie Ihre Galerie mit integrierten Wartungswerkzeugen optimiert:

Anzeigemodi

PhotoFlow bietet vier verschiedene Anzeigemodi, die jeweils für unterschiedliche Anwendungsfälle und Ästhetiken optimiert sind.

Raster-Modus

Klassisches Raster-Layout mit einheitlichen Bildkarten, die in responsiven Spalten angeordnet sind.

Raster-Konfiguration

Am besten für: Portfolio-Sites, Produktgalerien, allgemeine Bildsammlungen

Listen-Modus

Horizontales Layout, das Bilder in einer einzelnen Spalte mit Metadaten daneben zeigt.

Listen-Funktionen

• Vorschaubild links, Details rechts (oder umgekehrt)
• Vollständige Beschreibung und Metadatenanzeige
• Kompakte Ansicht für einfaches Durchsuchen
• Sortierbare Spalten

Am besten für: Dokumentenbibliotheken, Bildarchive, durchsuchbare Galerien

Masonry-Modus

Pinterest-ähnliches Layout, bei dem Bilder ihre Seitenverhältnisse in einem fließenden Raster beibehalten.

Masonry-Konfiguration

Am besten für: Fotografie-Portfolios, Inspirationsboards, Sammlungen mit gemischten Seitenverhältnissen

Karussell-Modus

Diashow-ähnliche Präsentation mit Navigationssteuerelementen und Autoplay-Optionen.

Karussell-Funktionen

• Navigation: Pfeilschaltflächen, Vorschaubilder oder Punkte
• Autoplay: Konfigurierbares Intervall und Pause beim Hovern
• Übergänge: Gleiten, Überblenden oder Zoom-Effekte
• Schleife: Unendliches oder einmaliges Durchlaufen
• Vorschaubilder: Optionale Vorschaubildleiste
• Tastatur: Unterstützung für Pfeiltastennavigation
• Touch: Wischgesten auf Mobilgeräten

Karussell-Konfiguration

Am besten für: Featured-Bilder, Hero-Bereiche, Produkt-Showcases

Sicherheitsfunktionen

PhotoFlow umfasst Sicherheitsfunktionen auf Unternehmensniveau zum Schutz Ihrer Bilder und zur Kontrolle des Zugriffs.

Passwortschutz

Schützen Sie einzelne Bilder oder ganze Kategorien mit Passwörtern.

Einrichten von Bildpasswörtern

1. Bearbeiten Sie ein Bild oder eine Kategorie
2. Aktivieren Sie Passwortgeschützt
3. Geben Sie ein Passwort ein
4. Speichern Sie die Änderungen

Passworttypen

Muster-Passwort-Beispiele

// Datumsbasierte Muster
{Y}{m}{d}        → 20240315 (ändert sich täglich)
{Y}{W}           → 202411 (ändert sich wöchentlich)
woche{W}         → woche11 (lesbares Format)

// Zeitbasierte Muster
{Y}{m}{d}{H}     → 2024031514 (ändert sich stündlich)
tag{d}stunde{H}  → tag15stunde14

// Benutzerdefinierte Muster
foto{Y}{m}       → foto202403
galerie_{W}      → galerie_11

Zugriffskontrolllisten (ACL)

PhotoFlow integriert sich vollständig in Joomlas ACL-System für granulare Berechtigungskontrolle.

Verfügbare Berechtigungen

Nur-Direktlink-Modus

Blenden Sie Bilder aus Galerielisten aus, sodass sie nur über direkte URL zugänglich sind.

Anwendungsfälle

• Privates Teilen: Bestimmte Bilder teilen, ohne die gesamte Galerie offenzulegen
• E-Mail-Kampagnen: Eindeutige Bildlinks in E-Mails einfügen
• API-Integration: Bilder an externe Anwendungen bereitstellen
• Zeitlich begrenzter Zugriff: Begrenzten Zugriff über URL gewähren

Sperrschutz

Verhindern Sie Brute-Force-Passwortangriffe mit automatischer Sperrung nach fehlgeschlagenen Versuchen.

Sperrkonfiguration

• Maximale Versuche: Anzahl fehlgeschlagener Versuche vor Sperrung (Standard: 5)
• Sperrdauer: Wie lange der Zugriff blockiert wird (Standard: 30 Minuten)
• Verfolgen nach: IP-Adresse oder Sitzung
• Admin-Benachrichtigung: E-Mail-Benachrichtigungen bei Sperrereignissen

Download-Sicherheit

Kontrollieren Sie, wie Benutzer Ihre Bilder herunterladen können:

• Rechtsklick deaktivieren: Kontextmenü-Zugriff verhindern
• Wasserzeichen: Wasserzeichen zu heruntergeladenen Bildern hinzufügen
• Download-Verfolgung: Alle Download-Aktivitäten protokollieren
• Ratenbegrenzung: Downloads pro Benutzer/IP begrenzen
• Hotlink-Schutz: Einbettung auf externen Websites verhindern

API-Referenz

PhotoFlow bietet eine RESTful JSON-API für programmatischen Zugriff auf Galeriedaten.

Authentifizierung

API-Anfragen verwenden Joomlas Standard-Authentifizierungssystem:

// Mit Joomla API-Token
GET /index.php?option=com_photoflow&view=gallery&format=json
Authorization: Bearer IHR_JOOMLA_API_TOKEN

// Für öffentliche Endpunkte (keine Authentifizierung erforderlich)
GET /index.php?option=com_photoflow&view=gallery&format=json

Endpunkte

Galeriebilder abrufen

Liste der Bilder aus der Galerie abrufen.

GET /index.php?option=com_photoflow&view=gallery&format=json

// Parameter
?limit=12           // Bilder pro Seite
&offset=0           // Paginierungs-Offset
&category=5         // Nach Kategorie-ID filtern
&ordering=created   // Sortierfeld (created, title, hits, downloads)
&direction=DESC     // Sortierrichtung (ASC oder DESC)

Antwortformat

{
  "success": true,
  "data": {
    "images": [
      {
        "id": 1,
        "title": "Sonnenuntergang am Strand",
        "alias": "sonnenuntergang-am-strand",
        "description": "Wunderschöner Sonnenuntergang...",
        "filename": "sonnenuntergang-am-strand.jpg",
        "thumbnail": "/images/photoflow/thumbs/sonnenuntergang-am-strand.jpg",
        "detail": "/images/photoflow/detail/sonnenuntergang-am-strand.jpg",
        "hits": 142,
        "downloads": 23,
        "created": "2024-03-15 14:30:00",
        "category_id": 5,
        "category_title": "Landschaften"
      }
    ],
    "pagination": {
      "total": 48,
      "limit": 12,
      "offset": 0,
      "pages": 4
    }
  }
}

Einzelnes Bild abrufen

GET /index.php?option=com_photoflow&view=image&id=1&format=json

// Antwort
{
  "success": true,
  "data": {
    "id": 1,
    "title": "Sonnenuntergang am Strand",
    "alias": "sonnenuntergang-am-strand",
    "description": "Wunderschöner Sonnenuntergang über ruhigem Wasser",
    "filename": "sonnenuntergang-am-strand.jpg",
    "thumbnail": "/images/photoflow/thumbs/sonnenuntergang-am-strand.jpg",
    "detail": "/images/photoflow/detail/sonnenuntergang-am-strand.jpg",
    "original": "/images/photoflow/originals/sonnenuntergang-am-strand.jpg",
    "filesize": 2458624,
    "width": 1920,
    "height": 1080,
    "mime_type": "image/jpeg",
    "hits": 142,
    "downloads": 23,
    "created": "2024-03-15 14:30:00",
    "modified": "2024-03-15 14:30:00",
    "created_by": "Max Mustermann",
    "category": {
      "id": 5,
      "title": "Landschaften",
      "alias": "landschaften"
    }
  }
}

Kategorien abrufen

GET /index.php?option=com_photoflow&view=categories&format=json

// Antwort
{
  "success": true,
  "data": {
    "categories": [
      {
        "id": 1,
        "title": "Landschaften",
        "alias": "landschaften",
        "description": "Wunderschöne Landschaftsfotografie",
        "parent_id": 0,
        "image_count": 24,
        "path": "landschaften"
      }
    ]
  }
}

Bild herunterladen

GET /index.php?option=com_photoflow&task=image.download&id=1

// Gibt die Originalbild-Datei zurück
// Erhöht den Download-Zähler
// Erfordert Download-Berechtigung

Fehlerbehandlung

Alle API-Antworten enthalten ein success-Feld. Bei Fehlern:

{
  "success": false,
  "error": {
    "code": 404,
    "message": "Bild nicht gefunden"
  }
}

Häufige Fehlercodes

JavaScript-Integration

Beispiel mit fetch API:

// Galeriebilder abrufen
async function loadGallery() {
  try {
    const response = await fetch(
      '/index.php?option=com_photoflow&view=gallery&format=json&limit=12'
    );
    const data = await response.json();

    if (data.success) {
      displayImages(data.data.images);
    } else {
      console.error('API-Fehler:', data.error);
    }
  } catch (error) {
    console.error('Netzwerkfehler:', error);
  }
}

// Bilder anzeigen
function displayImages(images) {
  const gallery = document.getElementById('gallery');

  images.forEach(image => {
    const card = document.createElement('div');
    card.className = 'image-card';
    card.innerHTML = `
      <img src="${image.thumbnail}" alt="${image.title}">
      <h3>${image.title}</h3>
      <p>${image.description}</p>
    `;
    gallery.appendChild(card);
  });
}

Ratenbegrenzung

API-Anfragen sind ratenbegrenzt, um Missbrauch zu verhindern:

• Anonyme Benutzer: 60 Anfragen pro Stunde
• Authentifizierte Benutzer: 300 Anfragen pro Stunde
• API-Token: 1000 Anfragen pro Stunde

Ratenlimit-Header sind in Antworten enthalten:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1615825200

Support & Ressourcen