Standard-Bildstile mit Ihrem Theme einbinden

Drupal verfügt über ein leistungsfähiges Bildverwaltungssystem, das es ermöglicht, Bildstile zu erstellen, die verschiedene Effekte auf Bilder anwenden und Ableitungen des Originalbildes erzeugen können. Diese Funktionalität kann in Themes genutzt werden, die ein Set von Bildstilen standardmäßig mitliefern möchten, das speziell für das betreffende Theme erstellt wurde, anstatt sich auf die vom Core bereitgestellten Stile zu verlassen.

Der Prozess zum Einbinden eines Bildstils in Ihr Theme ähnelt dem Einbinden von Standardkonfigurationen in ein Modul.

• Erstellen Sie den gewünschten Bildstil über die Benutzeroberfläche.
• Exportieren Sie den Bildstil als YAML-Datei.
• Binden Sie die exportierte YAML-Datei in das Verzeichnis config/install Ihres Themes ein, unter Beachtung der korrekten Benennung.

Beginnen Sie damit, den Bildstil über die Admin-Oberfläche unter „Konfiguration“ > „Medien“ > „Bildstile“ (admin/config/media/image-styles) zu erstellen. Sobald der Bildstil erstellt und gespeichert ist, wird seine Konfiguration in der aktiven Konfiguration Ihrer Website gespeichert.

Diese Konfiguration können Sie exportieren über:

• Das Single-Export-/Import-Tool unter Konfiguration > Konfigurationsmanagement > Einzelimport/-export > Export (admin/config/development/configuration/single/export).
• Wählen Sie als Konfigurationstyp „Bildstil“ aus.
• Wählen Sie dann Ihren Bildstil aus der Liste der Konfigurationsnamen.

Die YAML-Darstellung des Bildstils wird im Textfeld angezeigt und kann kopiert und in eine .yml-Datei im Verzeichnis config/install Ihres Themes eingefügt werden. Konfigurationsdateien folgen einem bestimmten Benennungsschema: image.style.{image style name}.yml. Falls Sie unsicher sind, welcher Name zu verwenden ist, wird dieser unter dem Textfeld der exportierten Konfiguration angezeigt.

Beachten Sie, dass die exportierte Konfiguration einen UUID-Schlüssel in der ersten Zeile enthält. Dieser UUID-Eintrag muss vor dem Kopieren in die neue Datei image.style.{image style name}.yml entfernt werden.

Beispiel THEMENAME/config/install/image.style.black_white.yml

langcode: en
status: true
dependencies: { }
name: black_white
label: 'black & white'
effects:
  8d4f85cc-9a2d-4a30-af15-21b0833dc06d:
    uuid: 8d4f85cc-9a2d-4a30-af15-21b0833dc06d
    id: image_desaturate
    weight: 1
    data: { }
    third_party_settings: { }

Sie können beliebig viele Bildstile mit Ihrem Theme mitliefern. Sie werden alle beim Installieren des Themes in die aktive Konfiguration importiert.

Beachten Sie, dass Änderungen an den YAML-Dateien der Bildstile im config/install-Verzeichnis nach der Theme-Installation keine Wirkung mehr haben, ebenso wenig wie das Hinzufügen weiterer YAML-Dateien für Bildstile in diesem Verzeichnis.