Descripción general de la configuración (en comparación con otros tipos de información)

En Drupal 8 existen varios tipos de información:

• Contenido

Información destinada a mostrarse en su sitio y a ser editada por los usuarios: artículo, página básica, imágenes, archivos, etc.

• Sesión

Información sobre las interacciones de usuarios individuales con el sitio, por ejemplo, su selección actual para un filtro de vistas. Es efímera y personalizada para un solo usuario.

• Estado

Información que puede cambiar frecuentemente y/o sin intervención del usuario. Ejemplos: la hora de la última ejecución de Cron, necesidad de reconstrucción de permisos de nodo, etc.

• Configuración

Información sobre su sitio que no es contenido y que cambia poco frecuentemente, por ejemplo, el nombre de su sitio, los tipos de contenido y vistas que haya definido, etc.

• Cache

Información sobre su sitio que también se almacena en otro lugar. Las caches existen únicamente para acelerar la recuperación de datos. Nunca almacenan datos canónicos.

• Configuraciones

Información de solo lectura para su sitio, codificada rígidamente en el archivo settings.php.

Decidir cómo clasificar su información

No siempre es claro cómo decidir si una parte de la información que almacenará su módulo debe clasificarse como contenido, estado o configuración. Aquí algunas recomendaciones:

• Configuración y estado: si su información debe desplegarse desde su servidor de desarrollo a su servidor en producción, probablemente sea información de configuración, no de estado.
• Configuración y contenido: piense en un constructor o editor del sitio. Si el rol "editor del sitio" en el sitio necesita editar la información, probablemente sea contenido. Si solo el rol "creador del sitio" debe tener permiso para editarla, entonces probablemente sea configuración. Pero esto no es una regla absoluta.
• Configuración contra contenido: piense en números. Si tiene una gran cantidad de ítems, probablemente sea contenido. Si solo tiene unos pocos, probablemente sea configuración.
• Configuración contra contenido: la configuración tiende a definir "tipos de cosas", como tipos de contenido, vocabularios de taxonomía, etc. Luego cada "cosa" dentro del tipo es parte del contenido: nodo de contenido, término de taxonomía, etc.

Configuración simple vs objetos de configuración

Una de las primeras decisiones que tendrá que tomar al usar el sistema de gestión de configuración es qué tipo de configuración va a almacenar.

Configuración simple es un poco más fácil de implementar y por eso es ideal para configuraciones básicas que almacenan valores lógicos, enteros o cadenas de texto simples. Un buen ejemplo podría ser un valor para activar/desactivar cierta función en su módulo o el nombre del sitio configurado por el módulo del sistema. La configuración simple también incluye cualquier parámetro que su módulo requiera para funcionar correctamente. Por ejemplo, la agregación de JavaScript debe estar activada o desactivada. Si simplemente no existe, el módulo del sistema no podrá determinar el orden correcto de ejecución. La configuración simple solo puede depender del módulo que la provee. Por ejemplo, system.site depende del módulo system y nada más.

Los objetos de configuración almacenan listas informativas de cosas que los usuarios pueden crear y eliminar; su código seguirá funcionando bien ya sea que haya 0 o 100+. Ejemplos: estilos de imagen, vistas, etc. Los objetos de configuración también vienen con un conjunto completo de hooks CRUD que se disparan igual que cualquier otro objeto en Drupal, lo que los hace ideales para configuraciones que otros módulos podrían necesitar o a las que podrían reaccionar. Por ejemplo, Views usa objetos de configuración que permiten un escenario en tiempo de ejecución donde se disparan interceptores que permiten a cualquier otro módulo proporcionar configuración (vistas) para el módulo Views. Los objetos de configuración pueden tener dependencias dinámicas. Como la configuración simple, dependen del módulo que los provee. Por ejemplo, views.view.frontpage depende del módulo Views, pero como enumera nodos, también depende del módulo Node. Si luego se actualiza para mostrar solo nodos de tipo Artículo, también tendrá dependencia del objeto de configuración Article (node.type.article). Y así sucesivamente.