Voeg de standaardconfiguratie toe aan je Drupal 8-module
Hoofdonderwerp: standaardconfiguratie
Overzicht
In Drupal 7 vereiste standaardconfiguratie voor modules zoals inhoudstypen, veldconfiguratie, weergaven enz. speciale PHP-code voor installatie en updates. In Drupal 8 worden ze samen met het configuratiesysteem opgeslagen in tekstbestanden in YAML-formaat.
Bijvoorbeeld: het configuratiebeheersysteem zorgt voor het aanmaken en beheren van inhoudstypen. Je kunt een inhoudstype samen met je module leveren door een configuratiebestand te maken met de juiste naam en structuur.
Voorbeeld
Maak een bestand met de naam node.type.example_mytype.yml en plaats het in de map van je module in de submap config/install. Bijvoorbeeld: dit bestand kan zich bevinden in /modules/example/config/install/node.type.example_mytype.yml als de module zich in /modules/example bevindt.
Houd je aan de naamgevingsconventie waarbij je het inhoudstype vooraf laat gaan door de naam van je module, gevolgd door een underscore, om conflicten met andere configuratiebestanden te voorkomen.
Vervolgens kun je de volgende code in dit bestand plaatsen:
type: example_mytype name: Example description: 'Use <em>example</em> content to get to Drupal 8 development better.' help: '' new_revision: false display_submitted: true preview_mode: 1 status: true langcode: en
Zie node.type.article.yml voor een levend voorbeeld.
Je kunt standaardconfiguratie opnemen voor andere zaken, zoals blokplaatsingen, weergaven, tekstformaten, editorconfiguratie, gebruikersrollen enz., op dezelfde manier.
Je kunt ook standaardwaarden instellen voor formuliervelden, zoals de auteur van de node.
Als je de module hebt geïnstalleerd voordat je dit inhoudstype hebt toegevoegd, moet je hem verwijderen en opnieuw installeren om de configuratie te laten gelden.
Configuratie exporteren
Je kunt deze bestanden maken door configuratie te exporteren via Configuratie > Ontwikkeling > Configuratiesynchronisatie. Je kunt de functie “Enkele import/export” gebruiken om één configuratiefragment te exporteren; in dat geval krijg je een tekstveld met code om te kopiëren/plakken in een configuratiebestand. Of je kunt een “Volledige export” uitvoeren, waarmee je een tar.gz-bestand kunt downloaden dat alle configuratiebestanden in één map bevat.
Bij gebruik van geëxporteerde configuratie is het belangrijk om de UUID uit de configuratie te verwijderen. Elk configuratiefragment wordt uniek geïdentificeerd met deze identifier. Als je die UUID in je module opneemt, zal de identifier op alle sites die jouw module gebruiken hetzelfde zijn, en dus niet langer uniek. Als je die regel gewoon verwijdert uit de configuratie, zal Drupal nieuwe UUID’s genereren zodra je module wordt ingeschakeld, waardoor de uniciteit wordt gegarandeerd.
uuid: 626187e6-2176-4a73-8900-c0912580e4a1 < < Verwijder dit! langcode: en status: true
Drupal Console
De tool Drupal Console biedt het volgende commando:
Dit zal de volgende taken uitvoeren:
- Exporteer alle configuratiebestanden die verband houden met het opgegeven inhoudstype (inclusief zijn veldconfiguratiebestanden).
- Plaats deze in de configuratiemap van de juiste module.
Hiermee bespaar je dus veel werk vergeleken met het hierboven beschreven handmatige proces.