Het insluiten van standaard afbeeldingsstijlen met je thema

Drupal heeft een krachtig systeem voor beeldbeheer dat het mogelijk maakt om afbeeldingsstijlen te maken die verschillende effecten op een afbeelding kunnen toepassen en afgeleiden van de oorspronkelijke afbeelding kunnen genereren. Deze functionaliteit kan worden gebruikt in thema’s die een reeks standaard afbeeldingsstijlen willen insluiten, speciaal gemaakt om samen te werken met het thema, in plaats van te vertrouwen op die welke door de core worden geleverd.

Het proces om een afbeeldingsstijl in je thema in te sluiten is vergelijkbaar met het proces van het insluiten van standaardconfiguratie in een module.

• Maak de afbeeldingsstijl die je wilt insluiten met behulp van de gebruikersinterface
• Exporteer de afbeeldingsstijl als YAML
• Voeg de geëxporteerde YAML toe aan de map config/install van je thema, waarbij je de juiste naamgevingsregels volgt.

Begin met het maken van een afbeeldingsstijl via de admin-interface in het gedeelte «Configuratie» > «Media» > «Afbeeldingsstijlen» (admin/config/media/image-styles). Zodra de afbeeldingsstijl is aangemaakt en opgeslagen, wordt de configuratie die deze stijl vormt, opgeslagen in de actieve configuratie van je site.

Deze configuratie kan worden geëxporteerd met behulp van:

• het hulpmiddel Enkelvoudige import/export in «Configuratie» > «Configuratiebeheer» > «Enkelvoudige import/export» > «Export» (admin/config/development/configuration/single/export).
• kies «Afbeeldingsstijl» uit de lijst met configuratietypen
• selecteer vervolgens je afbeeldingsstijl uit de lijst met configuratienamen.

De YAML-weergave van de afbeeldingsstijl verschijnt in het tekstvak en kan worden gekopieerd en geplakt in een .yml-bestand in de map config/install van je thema. Configuratiebestanden volgen een specifieke naamgevingsconventie: image.style.{afbeeldingsstijlnaam}.yml. Als je niet zeker weet welke naam je bestand moet hebben, wordt dit onder het tekstvak met de geëxporteerde configuratie weergegeven.

Let erop dat de geëxporteerde configuratie een UUID-sleutel bevat als eerste regel. Deze UUID moet worden verwijderd voordat je de configuratie kopieert naar het nieuwe bestand image.style.{afbeeldingsstijlnaam}.yml.

Voorbeeld 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: { }

Je kunt zoveel afbeeldingsstijlen insluiten als je wilt met je thema. Al deze zullen in de actieve configuratie worden geïmporteerd wanneer het thema wordt geïnstalleerd.

Let op: na installatie van het thema heeft het bewerken van het YML-bestand van de afbeeldingsstijl in config/install geen enkel effect, evenmin als het toevoegen van een extra YML-bestand van een afbeeldingsstijl in config/install.