Estructura de modulos

 

En las sub-secciones de la guía después de éste, construiremos diferentes cosas.

 

 

Una página personalizada, bloque, entidad, campo, etc.

 

 

Sin embargo, todos los ejemplos se iniciarán con una carpeta de módulo y un archivo .info.yml.

 

 

Con esas dos cosas, puedes ver el módulo en la página de administración Extend en Drupal 8, o activarla directamente con drush.

 

 

Así que esta sub-sección te guiará a través del proceso de iniciar uno nombrando y colocando el .info.yml que es el punto de partida para cualquier módulo nuevo que vas a crear.

 

Si deseas clonar el repositorio git del código de ejemplo que figura en esta sección, debes tener instalado git y sigue las instrucciones.

 

El código de esta primera sección se encuentra en la rama "estructura". Para comprobarlo, ejecuta el siguiente comando:

 

git checkout skeleton

 

El resto de las ramas deben alinearse con las siguientes sub-secciones de esta guía, y están diseñados para encajar en sus contrapartes más completas en el módulo Ejemplos Para desarrolladores encontrado aquí.

 

 

Nombrar y situar tu módulo de Drupal 8

 

Tema principal descrito: nomenclatura módulo y la ubicación

 

Antes de comenzar

 

Si deseas que PHP te ayude a identificar tus errores en tu sitio de prueba, intenta los ajustes que se describen aquí: Mostrando todos los errores durante el desarrollo.

 

El nombre de tu módulo

 

El primer paso en la creación de un módulo es elegir un "nombre corto", o el nombre de la máquina, para ello.

 

 

Este nombre de la máquina se utiliza en diferentes archivos y nombres de funciones en tu módulo, y lo utiliza el núcleo de Drupal mediante programación para hacer referencia a tu módulo.

 

 

cd3y4.jpg

 

 

Hay algunas reglas importantes a seguir al seleccionar un nombre de la máquina:

 

  • Debe comenzar con una letra.
     

  • Debe contener sólo letras minúsculas y caracteres de subrayado.
     

  • Debe ser único. Tu módulo no puede tener el mismo nombre corto que cualquier otro módulo, tema o perfil de instalación que va a utilizar en el sitio.
     

  • No puede ser ninguno de los términos reservados: src, lib, vendor, assets, css, files, images, js, misc, templates, includes, fixtures, Drupal

 

 

 

Para este caso, vamos a elegir "hola_mundo" como el nombre de la máquina.

 

Nota IMPORTANTE: Asegúrate de no usar letras mayúsculas en el nombre de la máquina de tu módulo ya que Drupal no reconocerá sus implementaciones de enlace.


Ver
Comprender el sistema de enlace para los módulos de Drupal.

 

Crear una carpeta para tu módulo



Teniendo en cuenta que nuestra elección de nombre del equipo es "hola_mundo", inicia el módulo mediante la creación de una carpeta dentro de tu instalación de Drupal en la ruta: /modules/custom/hola_mundo o /sites/all/modules/custom/hola_mundo.


Ten en cuenta que no es necesario utilizar el mismo nombre para la carpeta de tu módulo y el nombre del equipo.


Podrías, por ejemplo, utilizar el nombre de la carpeta HolaMundo en lugar.


Sin embargo, has de acordarte de usar el nombre de la máquina de forma programática con los archivos y contraseñas de tu módulo.

 

 

Anteriores versiones de Drupal exigieron módulos personalizados que se encuentran en /sites/all/modules como los módulos principales se encuentran en /modules.

 

Sin embargo, en Drupal 8 /modules ahora está liberado a tu medida y módulos de terceros.

 

Todos los módulos del núcleo y archivos de librerías están localizados ahora en el directorio /core.

 

En Drupal 8, aún puedes utilizar la mejor práctica de Drupal 7/6 de poner tus módulos a la medida y Drupal.org contribuidos (descargado) en /sites/all/modules pero también puedes simplemente ponerlos en el directorio /modules, que tiene el mismo efecto.

 

 

Nuestro módulo de ejemplo no está aún operativo, vamos a necesitar un archivo .info.yml. Lee más sobre cómo Dejar que Drupal 8 sepa sobre tu módulo con un archivo .info.yml. Vamos a activar el módulo más adelante en el tutorial.
 

Estilo de programación
 

Es muy recomendable que sigas las normas de codificación de Drupal al escribir tus propios módulos, personalizados.

Es un requisito para cualquier sugerencia de cambio a código del núcleo de Drupal y también una mejor práctica para el código alojado en drupal.org.

 

Véase también
 

 

Esto es todo de momento, puedes seguir la guía desde aquí.

 

Un saludo.

Total de votos: 265

Entradas relacionadas

Comentarios (0)

Deja un comentario