Bilder und Bildvarianten
Diese Seite richtet sich an Entwickler, die entscheiden, wo Bilder im Inhaltsmodell liegen und in welchen Größen die Website sie zeigt. Exponential speichert das Original einmal und erzeugt jede Größe bei Bedarf aus benannten Bildvarianten (Image Aliases); ein Redesign ändert also Einstellungen, keine Uploads.
Inhalt
- Bildattribut oder Bildobjekt
- Die Medienbibliothek
- Bildvarianten
- Eine Variante für Ihr Design festlegen
- Bilder in Templates
- Alternativtext
- Fokuspunkt und Zuschnitt
- Konverter: GD und ImageMagick
- Nach einer Änderung
Bildattribut oder Bildobjekt
| Modell | Wie | Verwenden Sie es für |
|---|---|---|
Ein ezimage-Attribut am Element | die Artikelklasse hat ein Attribut image | ein Bild, das zu genau diesem Element gehört: ein Porträt, ein Produktfoto |
| Ein Bildobjekt, verknüpft | ein image-Objekt in der Medienbibliothek, referenziert über ein ezobjectrelationlist-Attribut | ein Bild, das mehrere Elemente verwenden und das einmal für alle ersetzt wird |
| Ein Bildobjekt, eingebettet | dasselbe Objekt, in Rich Text eingebettet | Bilder im Fluss des Textes |
Bildobjekte haben einen eigenen Namen, eine Bildunterschrift und einen Alternativtext, erscheinen in der Medienbibliothek und haben eigene Berechtigungen. Die Wahl zwischen beiden ist eine der Entscheidungen unter Datentypen wählen.
Die Medienbibliothek
Die Medienbibliothek ist der Teilbaum unter Knoten 43 (settings/content.ini [NodeSettings] MediaRootNode), in der
Sektion Media. Bilder und Dateien dort sind nicht Teil der Navigation der Website. Die Rolle Anonymous einer neuen
Installation liest nur die Sektion Standard
(Sektionen); prüfen Sie also Ihre Rollen, wenn
Besucher Medienobjekte direkt öffnen sollen. Ordnen Sie die Bibliothek in Ordnern nach Thema oder Website, nicht nach
Datum. Das Hochladen vieler Dateien auf einmal übernimmt die Upload-Seite von ezmultiupload
(Medien und Uploads).
Bildvarianten
Eine Variante ist eine benannte Größe und Behandlung, festgelegt in image.ini. Die mitgelieferte Liste
([AliasSettings] AliasList[]) ist reference, small, tiny, medium, large und rss:
[reference]
Filters[]
Filters[]=geometry/scaledownonly=600;600
[medium]
Reference=reference
Filters[]=geometry/scaledownonly=200;200Reference nennt die Variante, von der die Skalierung ausgeht (hier die 600 Pixel große reference statt eines
Kameraoriginals), und Filters[] listet die Operationen der Reihe nach. scaledownonly vergrößert ein kleines Bild
nie. Jede Variante wird erzeugt, wenn eine Seite sie zum ersten Mal anfordert, und als Datei im Speicherverzeichnis
aufbewahrt.
Eine Variante für Ihr Design festlegen
Legen Sie Ihre Varianten in Ihrer Design-Erweiterung ab, mit deren Namen als Präfix, damit sie nie mit mitgelieferten kollidieren:
# extension/exp_mysite/settings/image.ini.append.php
[AliasSettings]
AliasList[]=exp_mysite_card
AliasList[]=exp_mysite_hero
[exp_mysite_card]
Reference=reference
Filters[]=geometry/scaledownonly=480;320
[exp_mysite_hero]
Filters[]=geometry/scaledownonly=1600;900
*/ ?>Die Hero-Variante hat kein Reference, sie skaliert also vom Original: Ein Hero-Bild, das größer als 600 Pixel ist,
darf nicht von reference ausgehen. Designer haben dasselbe Rezept mit responsiver Ausgabe:
Bildvarianten.
Bilder in Templates
Das Template des Datentyps gibt ein vollständiges <img> für eine Variante aus:
attribute_view_gui attribute=$node.data_map.image image_class='exp_mysite_card'Für eigenes Markup lesen Sie die Variante aus dem Inhalt des Attributs:
def $img = $node.data_map.image.content['exp_mysite_card']
<img src=$img.url|ezroot width="$img.width" height="$img.height"
alt="$img.alternative_text|wash" loading="lazy">
undef $imgGeben Sie immer width und height aus, damit die Seite beim Laden der Bilder nicht springt
(Bildleistung). Jede Variante, die eine Seite nennt, wird bei der
ersten Verwendung erzeugt; nennen Sie also keine Varianten, die Sie nicht zeigen.
Alternativtext
Ein ezimage-Attribut speichert mit dem Bild einen Alternativtext. Eine Klasse kann ihn verpflichtend machen: Setzen
Sie im Klasseneditor beim Bildattribut das Häkchen bei Alternativtext ist erforderlich; Redakteure können dann
kein Bild ohne ihn speichern. Importe und Massen-Uploads fragen nicht danach; füllen Sie ihn also nachträglich
(Alternativtext ist erforderlich).
Ein dekoratives Bild erhält im Template absichtlich ein leeres alt.
Fokuspunkt und Zuschnitt
Ein Bild kann je Attributversion einen Fokuspunkt und ein Zuschnittsrechteck tragen (Anteile am Original, im XML des
Attributs gespeichert). Das Zuschnittsrechteck wird vor den Filtern einer Variante ausgeschnitten, und jeder Filter
geometry/crop legt sein Fenster um den Fokuspunkt statt an sein eigenes x;y; eine Variante, die skaliert und
zuschneidet, behält so das Wesentliche im Bild. Bilder ohne sie werden genau wie bisher umgerechnet. Templates lesen
focal_point (mit position, fertig für CSS object-position) und crop_rectangle. Code setzt sie mit
setFocalPoint() in einem Entwurf, wodurch die bisher erzeugten Varianten entfallen. Einzelheiten:
Fokuspunkt und Zuschnitt von Bildern.
Konverter: GD und ImageMagick
image.ini [ImageConverterSettings] ImageConverters[] listet die Konverter der Reihe nach: GD (die PHP-Erweiterung)
und ImageMagick (das Programm convert). Die Composer-Metadaten von Exponential sagen, dass GD erforderlich ist,
sofern ImageMagick nicht installiert ist. Prüfen Sie auf einem Host, welcher vorhanden ist, bevor Sie sich auf Filter
verlassen, die nur einer von beiden unterstützt
(Bildverarbeitung und Medien).
Nach einer Änderung
Eine Änderung der Filter einer vorhandenen Variante erzeugt die bereits angelegten Dateien nicht neu. Leeren Sie sie und für eine neue oder geänderte Variante den INI-Cache:
php bin/php/ezcache.php --clear-tag=ini --allow-root-user
php bin/php/ezcache.php --clear-id=imagealias --allow-root-userDie ersten Aufrufe danach sind langsamer, während die skalierten Dateien neu entstehen; tun Sie es auf einer großen Website in einer ruhigen Stunde.
Verwandte Seiten
- Relationen und Einbettungen
- Bilder in einem Design
- Caching für CMS-Entwickler
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.