Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Bilder und Bildvarianten

Für CMS-Entwickler, wie Bilder modelliert, gespeichert und skaliert werden. Die Seite behandelt Bildattribute gegenüber Bildobjekten, die Medienbibliothek, Bildvarianten (Image Aliases) in image.ini, die Konverter…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/cms-developers/images-and-image-aliases.md

On this page

This page is a translation. Read the English original

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

  1. Bildattribut oder Bildobjekt
  2. Die Medienbibliothek
  3. Bildvarianten
  4. Eine Variante für Ihr Design festlegen
  5. Bilder in Templates
  6. Alternativtext
  7. Fokuspunkt und Zuschnitt
  8. Konverter: GD und ImageMagick
  9. Nach einer Änderung

Bildattribut oder Bildobjekt

ModellWieVerwenden Sie es für
Ein ezimage-Attribut am Elementdie Artikelklasse hat ein Attribut imageein Bild, das zu genau diesem Element gehört: ein Porträt, ein Produktfoto
Ein Bildobjekt, verknüpftein image-Objekt in der Medienbibliothek, referenziert über ein ezobjectrelationlist-Attributein Bild, das mehrere Elemente verwenden und das einmal für alle ersetzt wird
Ein Bildobjekt, eingebettetdasselbe Objekt, in Rich Text eingebettetBilder 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;200

Reference 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
<?php /* #?ini charset="utf-8"?

[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 $img}

Geben 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-user

Die 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

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x