Guía rápida: configuración de Drupal 10 en un entorno local con Docker y DDEV
En esta sesión, aprenderás cómo instalar y gestionar módulos y temas en Drupal utilizando Composer y Drush dentro de tu entorno DDEV. La instalación de módulos y temas es esencial para personalizar y extender las funcionalidades de Drupal según las necesidades de tu proyecto.
Objetivo de la sesión
El objetivo de esta sesión es que aprendas a instalar y activar módulos y temas en tu sitio Drupal, utilizando Composer para gestionar las dependencias de manera profesional. Esto te permitirá añadir características adicionales y ajustar la apariencia del sitio.
Paso a Paso: Instalación de módulos y temas en Drupal
Paso 1: Introducción a los módulos y temas en Drupal
- ¿Qué son los módulos y los temas?
- Los módulos en Drupal son componentes adicionales que extienden las funcionalidades del sistema, desde módulos de SEO y seguridad hasta herramientas de administración y personalización.
- Los temas controlan la apariencia de tu sitio, permitiéndote personalizar el diseño y la experiencia visual para los usuarios.
- Uso de Composer para gestionar módulos y temas
- Composer facilita la instalación y actualización de módulos y temas en Drupal, asegurando que todas las dependencias estén gestionadas automáticamente.
Paso 2: Instalación de un módulo con Composer
- Elegir un módulo para instalar
- Busca un módulo en Drupal.org o selecciona uno que cumpla con los requisitos de tu proyecto.
- Por ejemplo, el módulo «Admin Toolbar» mejora la barra de herramientas de administración, haciéndola más amigable para los usuarios.
- Instalar el módulo usando Composer
- Navega al directorio de tu proyecto y ejecuta el siguiente comando para instalar el módulo:
ddev composer require drupal/admin_toolbar
- Este comando descarga e instala el módulo y sus dependencias en tu entorno de Drupal.
- Navega al directorio de tu proyecto y ejecuta el siguiente comando para instalar el módulo:
- Activar el módulo con Drush
- Una vez instalado el módulo, actívalo usando Drush con el siguiente comando:
ddev drush en admin_toolbar
- Este comando habilita el módulo en tu sitio y lo hace funcional para que puedas empezar a usarlo.
- Una vez instalado el módulo, actívalo usando Drush con el siguiente comando:
- Verificar la instalación
- Accede a la interfaz de administración de Drupal en tu navegador, navega a
Extend
oExtender
, y verifica que el módulo esté activo. También puedes ver el nuevo menú de herramientas en la barra de administración si instalaste «Admin Toolbar».
- Accede a la interfaz de administración de Drupal en tu navegador, navega a
Paso 3: Instalación de un tema con Composer
- Seleccionar un tema
- Visita Drupal Themes para elegir un tema adecuado para tu sitio.
- Por ejemplo, el tema «Claro» es un tema administrativo moderno que puedes activar para mejorar la interfaz de administración.
- Instalar el tema con Composer
- Utiliza el siguiente comando para instalar el tema:
ddev composer require drupal/claro
- Este comando descargará el tema en tu entorno de desarrollo de Drupal.
- Utiliza el siguiente comando para instalar el tema:
- Activar el tema
- Para activar el tema como tema administrativo (o de usuario), ejecuta:
ddev drush then claro
- Luego, configura el tema como el tema administrativo predeterminado (si deseas que afecte solo a la administración):
ddev drush config-set system.theme admin claro
- Para activar el tema como tema administrativo (o de usuario), ejecuta:
- Verificar el tema en Drupal
- Ve a
Appearance
oApariencia
en la interfaz de Drupal y confirma que el tema está activo. Deberías ver los cambios en el diseño administrativo si instalaste «Claro».
- Ve a
Tareas
- Instalar y activar un módulo:
- Elige un módulo de Drupal.org, instala y activa el módulo utilizando los comandos
ddev composer require
yddev drush en
. Verifica su correcta instalación y activa cualquier configuración que sea necesaria en la interfaz de administración.
- Elige un módulo de Drupal.org, instala y activa el módulo utilizando los comandos
- Instalar y activar un tema:
- Selecciona un tema que te gustaría aplicar en el entorno administrativo o de usuario. Instálalo y actívalo con los comandos mencionados, y configura el tema como el predeterminado si es necesario.
Resumen de comandos
- Instalar un módulo con Composer:
ddev composer require drupal/[nombre_del_módulo]
- Activar un módulo con Drush:
ddev drush en [nombre_del_módulo]
- Instalar un tema con Composer:
ddev composer require drupal/[nombre_del_tema]
- Activar un tema con Drush:
ddev drush then [nombre_del_tema]
- Configurar tema administrativo:
ddev drush config-set system.theme admin [nombre_del_tema]
Conclusión
En esta sesión, has aprendido cómo instalar y gestionar módulos y temas en Drupal, usando Composer y Drush dentro del entorno DDEV. Esto te permite personalizar tanto las funcionalidades como la apariencia de tu sitio de manera controlada y profesional. Con estos conocimientos, puedes explorar más módulos y temas en Drupal.org para adaptar tu proyecto a tus necesidades.