Drupal 8: Guía de referencia

Drupal 8: Guía de referencia

Índice de contenidos sobre la instalación, configuración y uso del CMS Drupal 8. No pretende ser un tutorial paso a paso de cómo aprender Drupal, es sólo un guión que utilizo en mis clases para enseñar Drupal, de ahí que falten bastantes enlaces aún. Está dividido en dos secciones:

  • Básico: contenidos mínimos que considero necesarios conocer de Drupal.
  • Avanzado: contenidos para diseñar un sitio Drupal con mayor funcionalidad.

 

Drupal básico

Introducción

 

Instalación del servidor web y de la base de datos

 

Instalación del núcleo con Composer

  • Instalar y actualizar Composer (Windows):
    • Crear fichero CMD con lectura de parámetros para ejecutar Composer (composer.cmd):
    • /ruta/php.exe /ruta/composer.phar %1 %2 %3 %4 %5 %6
    • Incluir el directorio de Composer en la variable de entorno PATH del usuario.
    • Actualizar Composer:
    • composer selfupdate
  • Instalar y actualizar Composer (Linux):
    • Crear alias para ejecutar Composer:
    • alias composer = '/ruta/php7.2-cli /ruta/composer.phar'
    • Actualizar Composer:
    • composer selfupdate
  • Instalar Git
  • Crear proyecto Drupal con Composer:
    • composer create-project drupal-composer/drupal-project:8.x-dev nombre-del-proyecto --stability dev --no-interaction
  • Crear alias en Apache apuntando al directorio "web" del proyecto composer: (Configurar httpd.conf)
    • Alias /drupal8 "C:\xampp\drupal8\web" 
      <Directory "C:\xampp\drupal8\web">
       Require all granted
       RewriteEngine on
       RewriteBase /drupal8
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteCond %{REQUEST_FILENAME} !-d
       RewriteRule ^ index.php [L]
      </Directory>
  • (Pendiente) Asignar permisos de escritura para el usuario Apache en:
    • Carpeta proyecto de Composer.
    • Carpeta Sites de Drupal.
  • Configurar web/.htaccess:
    • RewriteBase /drupal8
  • Iniciar la instalación de Drupal
  • Visitar el sitio e iniciar sesión

 

Configuración básica

  • Conocer la estructura de carpetas y archivos del núcleo
  • Crear carpetas del sitio, con permisos de escritura para "others":
    • sites_public
    • sites_private
    • sites_tmp
  • Configuración del sitio web: settings.php
  • Configuración -> Multimedia -> Sistema de archivos:
    • Ruta pública, privada, temporal y traducciones.
  • Configuración -> Desarrollo -> Rendimiento
  • Configuración -> Sistema -> Configuraciones básicas del sitio
  • Configuración -> Regional e idioma -> Opciones regionales
  • Configuración -> Regional e idioma -> Fecha y hora: nuevo formato y nuevo tipo de fecha
  • Configuración -> Regional e idioma -> Idiomas
  • Configuración -> Regional e idioma -> Traducción de la interfaz de usuario
  • Ampliar

 

Informes

  • Informes -> Informe de estado
  • Informes -> Mensajes recientes de registro

 

Exportación y restauración del sitio

  • Exportación
    • Configuración -> Desarrollo -> Modo de mantenimiento: Activar
    • Exportar base de datos dentro de la carpeta del proyecto Composer
    • Copiar carpeta del proyecto Composer
    • Configuración -> Desarrollo -> Modo de mantenimiento: Desactivar
  • Restauración
    • Copiar carpeta del proyecto Composer
    • Permisos en carpeta web Composer
    • Restaurar base de datos
    • Configuración de settings.php (base de datos)
    • Configuración de .htaccess (en carpeta web y en alias)
    • Configuración -> Desarrollo -> Rendimiento: vaciar cachés
    • Configuración -> Desarrollo -> Modo de mantenimiento: Desactivar

 

Actualización del núcleo y módulos contribuidos con Composer

  • Informes -> Actualizaciones disponibles
  • Informes -> Actualizaciones de traducción disponible
  • Configuración -> Desarrollo -> Modo de mantenimiento: Activar
  • Para que no actualice .htaccess y robots.txt:
    • "extra": {
         "drupal-scaffold": {
           "excludes": [ ".htaccess", "robots.txt" ]
      } }
  • Comprobar actualizaciones disponibles sin actualizar:
    • composer update --dry-run
  • Actualizar núcleo:
    • composer update --with-dependencies
  • Actualizar base de datos:
  • Configuración -> Desarrollo -> Modo de mantenimiento: Desactivar

 

Añadir y eliminar módulos contribuidos con Composer

  • Añadir módulos:
    • composer require drupal/<module>
    • Ampliar: Activar dicho módulo
  • Eliminar módulos:
    • Ampliar: Desactivar dicho módulo
    • composer remove drupal/<module>
  • Los módulos los instala Composer en la ruta:
    • <proyecto>/web/modules/contrib
  • Actualizar un módulo de una versión menor a otra superior, por ejemplo de v1.3 a v2.0:
    • composer require drupal/<module>

 

Admin Toolbar

 

Copias de seguridad

 

Entidades, formularios y visualización

 

Usuarios

  • Configuración -> Usuarios -> Configuración de la cuenta
    • Configurar opciones cuenta y contenido correos electrónicos.
    • Configurar campos, formulario y presentación.
  • Usuarios
  • Usuarios -> Roles
  • Usuarios -> Permisos

 

Formato y Editores de textos

  • Configuración -> Autoría del contenido -> Formato y Editores de textos
  • [Contrib] IMCE: Administrador de archivos en el editor de textos
    • Configuración -> Autoría del contenido -> Formato y Editores de textos: Arrastrar el nuevo botón Imagen a la barra de herramientas.
    • Configuración -> Multimedia -> IMCE File Manager: Configurar los perfiles de usuario.

 

Imágenes

  • Configuración -> Multimedia -> Juego de herramientas de imágenes
  • Configuración -> Multimedia -> Estilos de imagen

 

Taxonomías

  • Estructura -> Taxonomía
    • Vocabularios: Edición, campos, formulario y presentación.
    • Términos

 

Contenidos

  • Estructura -> Tipos de contenido
    • Edición, campos, formulario y presentación.
  • Contenido

 

Alias

 

Temas

  • Instalar:
    • Descomprimir tema en la ruta: <proyecto>/web/themes/contrib.
  • Apariencia:
    • Habilitar tema como predeterminado.
    • Configurar tema.

 

Bloques

  • Estructura -> Diseño de bloques

 

Menús

  • Estructura -> Menús
    • Añadir menú.
    • Añadir enlaces a un menú.
  • Estructura -> Diseño de bloques
    • Añadir el bloque del menú a una región del tema.

 

Vistas

  • Estructura -> Vistas (Pestaña Configuración)
    • Opciones de configuración generales.
    • Actualizar la vista previa automáticamente.
    • Mostrar la consulta SQL.
  • Estructura -> Vistas (Pestaña Lista)
    • Tipo de presentación: General, página, bloque, etc.
    • Vista de entidades / Vista de campos: Renderiza una entidad o lista una serie de campos de la entidad.
    • Formato: Diseño de los datos a mostrar.
    • Campos: Configuración de los campos a mostrar en la vista de campos.
    • Criterios de filtrado: Filtrado de los datos a mostrar. Puede exponerse el filtrado al usuario.
    • Criterios de ordenación: Orden de los datos a mostrar.
    • Opciones de página / Bloque / etc: Configuración del tipo de presentación.
    • Paginador.
    • Filtros contextuales: Filtrado de los datos a mostrar en función del contexto (usuario logueado, etc.).
    • Relaciones: Relación de la entidad con otras relaciones (como JOIN de SQL).
    • Formulario expuesto: Configuración del formulario de filtrado expuesto.
    • Usar Ajax: Utilizar Ajax para recargar los datos si se utiliza el formulario de filtrado expuesto.

 

Formularios web

 

Cron

 

Sistema de correo electrónico

 

Drupal avanzado

(Próximamente)

 

Licencia Creative Commons

Este artículo publicado en TicArte pertenece a Rafa Morales y está protegido bajo una Licencia Creative Commons.

Ir arriba