Galerie #

Die Galerie zeigt die Bilder eines Ordners als Album in einer Rasteransicht. Ein Klick auf ein Bild öffnet eine Diashow mit Vollbild und Zoom. Alben lassen sich über einen öffentlichen Link teilen; Empfänger sehen sie ohne Konto in derselben Ansicht.

Voraussetzungen #

Installation #

Im App-Menü Markt öffnen, Gallery suchen und Installieren wählen. Auf der Kommandozeile:

# App aus dem Marktplatz installieren, dabei wird sie eingeschaltet
sudo -u www-data php8.4 occ market:install gallery

# nur nötig, wenn die App schon vorhanden, aber ausgeschaltet ist
sudo -u www-data php8.4 occ app:enable gallery

Einrichtung #

Die App hat keine eigene Einstellungsseite. Sie richtet sich nach Einstellungen des Servers und nach einer Datei gallery.cnf je Album.

Einstellungen des Servers #

Welche Bildtypen die Galerie zeigt, hängt von den Vorschau-Anbietern des Servers ab:

Setzen Sie enabledPreviewProviders selbst, ersetzt Ihre Liste die Vorgabe vollständig. Nehmen Sie deshalb auch die Anbieter auf, die Sie behalten wollen. Dieses Beispiel behält alle Anbieter der Vorgabe und ergänzt TIFF, Photoshop, Illustrator, PostScript und SVG:

'enabledPreviewProviders' => [
    'OC\\Preview\\MarkDown',
    'OC\\Preview\\MP3',
    'OC\\Preview\\TXT',
    'OC\\Preview\\PNG',
    'OC\\Preview\\JPEG',
    'OC\\Preview\\WEBP',
    'OC\\Preview\\GIF',
    'OC\\Preview\\BMP',
    'OC\\Preview\\Heic',
    'OC\\Preview\\XBitmap',
    'OC\\Preview\\SGI',
    'OC\\Preview\\TIFF',
    'OC\\Preview\\Photoshop',
    'OC\\Preview\\Illustrator',
    'OC\\Preview\\Postscript',
    'OC\\Preview\\SVG',
],

Album-Konfiguration gallery.cnf #

gallery.cnf ist eine YAML-Datei im Ordner des Albums. Die Galerie liest sie beim Öffnen des Albums. Abschnitte mit inherit: yes gelten auch für Unteralben. Den Abschnitt features wertet sie nur im obersten Ordner aus.

features:
  native_svg: yes
  external_shares: yes
  background_colour_toggle: yes

sorting:
  type: date
  order: des
  inherit: yes

design:
  background: "#ffffff"
  inherit: yes

information:
  description: "Aufnahmen der Werksführung"
  description_link: liesmich.md
  copyright: "© Beispiel GmbH"
  copyright_link: copyright.md
  inherit: yes

Ungültige Werte verwirft die Galerie. Ist die Datei kein gültiges YAML, erscheint Konfigurationsfehler, die Fundstelle steht im Serverprotokoll.

Nutzung #

• Öffnen: im App-Menü Galerie. Jeder Ordner mit Bildern erscheint als Album, Unteralben erreichen Sie über die Pfadleiste.
• Sortieren: Nach Name ordnen und Nach Datum ordnen wechseln Feld und Richtung.
• Wechseln: Dateiliste springt in denselben Ordner der Dateien-App, Gallerieansicht von dort zurück.
• Diashow: Ein Klick auf ein Bild öffnet sie mit Weiter, Zurück, Abspielen, Anhalten, Herunterladen und Schließen. Löschen und Drehen gibt es nur außerhalb öffentlicher Galerien und nur, wenn Sie die Datei löschen dürfen.
• Albuminformation: erscheint, wenn das Album eine gallery.cnf mit Beschreibung oder Copyright enthält.
• Ordner ausblenden: Album ausblenden im Menü + legt im Ordner eine Datei .nomedia an. Die Galerie überspringt Ordner mit dieser Datei.
• Teilen: Teilen oben rechts öffnet den Freigabedialog. Ein dort angelegter öffentlicher Link führt auf https://<instanz>/index.php/apps/gallery/s/<token>. Passwort, Ablaufdatum und Hochladen stellen Sie im Freigabedialog ein.

Die Galerie zeigt alle Bilder eines Ordners als Album. Das Teilen-Symbol oben rechts gibt das Album frei.

Grenzen und Hinweise #

• Zusammen mit dem Media Viewer: Galerie und Media Viewer tragen sich beide als Standardaktion für Bilder in der Dateiliste ein. In der Regel gewinnt die Galerie. Den Media Viewer erreichen Anwender dann über … und Mit Media Viewer öffnen.
• Ohne passenden Vorschau-Anbieter bleibt ein Album leer, auch wenn Bilder darin liegen.
• WebP- und SGI-Bilder nimmt die Galerie nicht auf, auch wenn der Server dafür Vorschauen erzeugt. In der Dateiliste öffnet sie der Media Viewer, sofern er eingeschaltet ist.
• Bilder über 50 MB (preview_max_filesize_image) bekommen keine Vorschau und erscheinen in der Galerie nur als graue Kachel.
• Der Token im Galerie-Link ist derselbe wie in der normalen Link-Freigabe. Wird die Galerie ausgeschaltet, laufen Galerie-Links ins Leere. Derselbe Inhalt bleibt unter https://<instanz>/s/<token> in der normalen Dateiansicht erreichbar.
• In freigegebenen Ordnern übernimmt die Galerie keine Verweise (description_link, copyright_link) aus einer gallery.cnf, die oberhalb des freigegebenen Ordners liegt.

Fehlersuche #