Per scrivere a mano delle porzioni di codice PHP in modo da aggiungere funzioni che mancano alla versione di base di Drupal 7, e che non si trovano in altri moduli già pronti, dovrete sapere come creare un modulo custom, cioè un modulo creato apposta per contenere le funzioni e gli hooks che volete inserire.
Creazione di un modulo
Un modulo è formato come minimo da una cartella contenente almeno 2 files: uno che descrive il modulo stesso (il file .info) e l’altro che contiene le funzioni e gli hooks (il file .module).
1. Scelta del nome
Prima di tutto bisogna scegliere un nome per il modulo, possibilmente diverso da qualsiasi altro modulo creato dalla community. Ad esempio: “pippo”.
Il nome del modulo deve essere usato per nominare files, cartelle e funzioni del vostro modulo.
2. La cartella che contiene il modulo
Creare la cartella “pippo” che andrà a contenere tutti i files del modulo.
3. File .info
Creare un file di testo e rinominarlo in “pippo.info”.
Questo file deve contenere varie informazioni sul modulo, di cui 3 obbligatorie:
name = Pippo
description = Questo modulo contiene alcune funzioni scritte per il mio sito
core = 7.x
Name: è il nome mostrato nel pannello di amministrazione e ovunque si renda necessario identificare il modulo.
Description: una descrizione del modulo, testo libero.
Core: indica per quale versione di Drupal è stato scritto il modulo. 7.x per Drupal 7, 6.x per Drupal 6 e così via.
Non si deve specificare la versione precisa, bensì lasciare il “.x”
4. File .module
Creare un file rinominarlo “pippo.module”.
Questo file contiene tutti gli hooks e le funzioni che si intende aggiungere al modulo.
// hook di esempio: form_alter
function pippo_form_alter(&$form, &$form_state, $form_id) {
// mio codice
}
Installazione e attivazione
Una volta creata la cartella e i relativi files bisogna caricare tutto in /sites/all/modules oppure, come qualcuno consiglia per separare i propri moduli da quelli della community, in una sottocartella, ad esempio: /sites/all/modules/custom.
A questo punto il vostro modulo si comporta come qualsiasi altro, dunque per attivarlo basta andare su “Moduli”, selezionarlo, e salvare.
Una volta attivato, il modulo entra a far parte del funzionamento di Drupal e viene chiamato insieme a tutte le altre funzioni standard, pronto ad interagire con esse attraverso gli hooks che eventualmente avete inserito nel modulo.