Habilite la configuración predeterminada en su módulo de Drupal 8

Tema principal: configuración predeterminada

Resumen

En Drupal 7, para la configuración predeterminada de módulos como tipos de contenido, configuración de campos, vistas, etc., se requería código PHP especial para la instalación y actualización. En Drupal 8, estas configuraciones se almacenan junto con el sistema de configuración en archivos de texto YAML.

Por ejemplo, el sistema de gestión de configuración se encarga de crear y administrar los tipos de contenido. Usted puede enviar un tipo de contenido junto con su módulo creando un archivo de configuración con el nombre y la estructura adecuados.

Ejemplo

Cree un archivo llamado node.type.example_mytype.yml y colóquelo en el directorio de su módulo dentro del subdirectorio config/install. Por ejemplo, este archivo podría estar en /modules/example/config/install/node.type.example_mytype.yml, si el módulo se encuentra en /modules/example.

Por favor, siga la convención de nombres, en la que se pone el prefijo de su tipo de contenido delante del nombre de su módulo, seguido de un guion bajo, para evitar conflictos con otros archivos de configuración.

Luego puede poner el siguiente código en ese archivo:

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

Consulte node.type.article.yml para un ejemplo en vivo.

Puede habilitar la configuración predeterminada para otras cosas, como la colocación de bloques, vistas, formatos de texto, configuración del editor, roles de usuario, etc., de la misma manera.

Puede establecer valores predeterminados para campos de formulario, como el autor de un nodo.

Si instaló el módulo antes de agregar este tipo de contenido, deberá desinstalarlo y volver a instalarlo para que la configuración tenga efecto.

Exportación de configuración

Puede crear estos archivos exportando la configuración desde Configuración > Desarrollo > Sincronización de configuración. Puede usar la función de “Importación/Exportación única” para exportar un fragmento de configuración, en cuyo caso se le proporciona un área de texto que contiene el código para copiar/pegar en el archivo de configuración. O puede realizar un “Exportar completo”, que le permitirá descargar un archivo tar.gz que contiene todos los archivos de configuración en una sola carpeta.

Al usar configuración exportada, es importante eliminar el UUID de la configuración. Cada fragmento de configuración es identificado de forma única por este identificador. Si incluye este UUID en su módulo, el identificador será el mismo para todos los sitios que usen su módulo, por lo que dejará de ser único. Si simplemente elimina esta línea de la configuración, Drupal generará nuevos UUID cuando se habilite su módulo, garantizando la unicidad.

uuid: 626187e6-2176-4a73-8900-c0912580e4a1 << ¡Eliminar esto!
langcode: en
status: true

Consola de Drupal

La utilidad Drupal Console proporciona el siguiente comando:

• config:export:content:type

Este comando realizará las siguientes tareas:

• Exportar todos los archivos de configuración relacionados con el tipo de contenido especificado (incluyendo sus archivos de configuración de campos).
• Colocarlos en el directorio de configuración del módulo correspondiente.

Así, ahorra mucho trabajo que de otro modo requeriría el proceso manual descrito anteriormente.

Véase también

• YAML
• Sistema de configuración de Drupal 8