Qual è il modulo valido più semplice che si può creare in Drupal?

Sarebbe utile avere a disposizione un semplice progetto, per chiunque abbia appena iniziato a usare Drupal.

Le istruzioni seguenti consentono di creare un modulo vuoto ed è utile per chiunque abbia appena iniziato a costruire il modulo. Se hai problemi a far funzionare il tuo primo modulo, o addirittura a mostrarti in Drupal, assicurati di aver letto tutte le istruzioni di seguito.

Drupal 8

projectAlmeno un must

1. Un nome di macchina.
2. Un file di informazioni yaml che prende il nome dal nome della macchina, nel modulo module-machine-name.info.ymlcon i seguenti attributi:
   1. name: Un nome umanamente leggibile
   2. type:Un tipo, che definisce essere a module.
   3. core:La principale versione principale di Drupal con cui il modulo è compatibile 8.x, in questo caso.
3. Un file di modulo vuoto, nome nel modulo module-machine-name.module

Drupal cerca i moduli in queste posizioni, come visto dalla radice del web:

1. /modules/
2. sites/[example.com]/modules
3. sites/default/modules
4. profiles/[install-profile]/modules

Tecnicamente, Drupal cerca anche i moduli core/modules, ma non si dovrebbe mai posizionare i moduli lì, quindi non è nell'elenco sopra.

Una struttura di modulo di esempio, per un modulo con il nome della macchina helloworld, sarebbe simile alla seguente:

/modules/helloworld/helloworld.info.yml

/modules/helloworld/helloworld.module

Si noti che sia le informazioni che il file del modulo sono identici al nome della macchina, il che è importante.

Il file del modulo può essere vuoto, ma il file di informazioni deve contenere alcuni valori minimi affinché Drupal lo riconosca come modulo. Per il nostro modulo di helloworld, potrebbe apparire come:

name: 'Hello world module to demonstrate module building'
core: 8.x
type: module

Se segui le istruzioni precedenti, dovresti essere in grado di ottenere un nuovo modulo elencato nel tuo sito Drupal, anche se in questo momento non farà nulla.

Drupal 7

Un modulo deve almeno avere

1. Un nome di macchina.
2. Un nome umanamente leggibile
3. Un file di informazioni che prende il nome dal nome della macchina.
4. Un file di modulo vuoto.

Per essere caricabile da Drupal, deve anche definire con quale versione core è compatibile.

Drupal cerca i moduli in queste posizioni:

1. sites/all/modules/
2. sites/[example.com]/modules
3. sites/default/modules
4. profiles/[install-profile]/modules

Tecnicamente, Drupal cerca anche i moduli modules, ma non si dovrebbe mai , posizionare i moduli lì, quindi non è nella lista.

Una struttura di modulo di esempio, per un modulo con il nome della macchina helloworld, sarebbe simile alla seguente:

sites/all/modules/helloworld/helloworld.info

sites/all/modules/helloworld/helloworld.module

Si noti che sia le informazioni che il file del modulo sono identici al nome della macchina, il che è importante.

Il file del modulo può essere vuoto, ma il file di informazioni deve contenere il nome del modulo leggibile umanamente e la versione principale con cui il modulo è compatibile.

Per il nostro modulo di helloworld, potrebbe apparire come:

name = Hello world module to demonstrate module building
core = 7.x

Se segui le istruzioni precedenti, dovresti essere in grado di ottenere un nuovo modulo elencato nel tuo sito Drupal, anche se in questo momento non farà nulla.

Per Drupal 8, poiché la domanda menzionava un progetto, immagino di menzionare il progetto Drupal Console .

Una volta installato, si può generare il codice del modulo (e altre cose come l'impalcatura per entità personalizzate, plugin, ecc.).

Per generare un modulo base dalla riga di comando: drupal generate:module. Uno viene quindi richiesto attraverso alcune raccolte di informazioni di base e lasciato con i file del modulo alla fine: