Come molti di voi già sapranno Drupal è molto flessibile grazie alla sua architettura a moduli, in particolare per crearne uno bisogna creare due file:
<modulo>.info
<modulo>.module
Nel file .info c'è la dichiarazione del modulo mentre nel .module abbiamo l'implementazione vera e propria.
Supponiamo di voler creare per il nostro cliente una pagina che permette agli utenti di scrivere dei feedback riguardo i servizi offerti. Come prima cosa bisogna creare una cartella in sites/all/module dal nome feedback.
Come detto in precedenza creiamo i file feedback.info e feedback.module.
In feedback.info
name = Feedback module
description = Permette agli utenti di lasciare dei feedback sui servizi offerti
package = feedback
core = 7.x
In feedback.module
Per prima cosa bisogna implemntare la funzione hook_menu() che permette al modulo di registrare dei path e le relative gestioni. Per il nostro modulo decidiamo di usare il path feedback/user, quindi:
<?php
function feedback_menu() {
$items = array();
$items['feedback/user'] = array(
'title' => t('Feedback user'),
'page callback' => 'feedback_form',
'access arguments' => array('access content'),
'description' => t('Inserimento di feedback sui servizi offerti'),
'type' => MENU_CALLBACK,
);
return $items;
}
- Definire la form attraverso degli array
- Trasformare l'array creato in codice HTML tramite la funzione drupal_get_form($form)
function feedback_form() {
return drupal_get_form('feedback_form_from_array');
}
In pratica demandiamo la creazione dell'array contente la form alla funzione feedback_form_from_array, che ci permetterà di definire una semplice textarea con un bottone per salvare i feedback degli utenti.
function feedback_form_from_array($form_state){
//definizione dell'array
$form = array();
//creazione dell'involucro della nostra form
$form['feedback_panel'] = array(
'#type' => 'fieldset',
'#title' => t('Feedback utenti'),
);
//definizione della textarea
$form['feedback_panel']['feedback_area'] = array(
'#type' => 'textarea',
'#description' => t('Scrivi le tue personali considerazioni sui servizi offerti.'),
);
//definizione del bottone per salvare il contenuto della textarea
$form['feedback_panel']['feedback_submit'] = array(
'#type' => 'submit',
'#value' => t('save feedback'),
);
return $form;
}
A questo punto dopo aver istallato il modulo vi compare la seguente schermata
Dopo aver costruito con successo la nostra form lo step successivo è gestire l'evento associato al click del tasto save feedback.
Per prima cosa dobbiamo validare il contenuto, nel nostro esempio non ci va che l'utente salvi feedback vuoti quindi andiamo ad effettuare questo semplice controllo. Il funzionamento di drupal fa si che al momento del click sul bottone venga richiamata prima la funzione <nome_modulo>_<nome_form>_validate e poi <nome_modulo>_<nome_form>_submit.
function feedback_form_from_array_validate($form, &$form_state){
$feedback = $form_state['values']['feedback_area'];
if( $feedback == ''){
form_set_error('feedback_area', 'Non puoi inviare il feedback senza scrivere nemmeno un carattere');
}
}
Dopo aver preso il valore del feedback controlliamo che non sia vuoto, in caso lanciamo un messaggio di errore e l'invio del feedback viene bloccato. Se l'input viene validato drupal lancia la funzione feedback_form_from_array_submit in cui scriveremo il codice per il salvataggio del feedback.
function feedback_form_from_array_submit($form, &$form_state){
global $user;
$uidUser = $user->uid;
$feedback = $form_state['values']['feedback_area'];
$isSend = saveFeedback($uidUser, $feedback);
if($isSend){
drupal_set_message(t("Feedback inviato per conto dell'utente $user->name"));
}else{
drupal_set_message(t("Feedback NON inviato :( "));
}
}
In particolare usiamo una particolarità di drupal, ovvero l'oggetto $user che è accessibile in ogni zona del modulo è contiene le informazioni sull'utente che appartiene a questa sessione, maggiori info le trovate qui.Il salvataggio del feedback viene demandato alla funzione saveFeedback($uidUser, $feedback):
function saveFeedback($uidUser, $feedback){
try{
$nid = db_insert('feedback')
->fields(array(
'feedback' => $feedback,
'uid' => $uidUser,
))
->execute();
return TRUE;
}catch(Exception $e){
return FALSE;
}
}
Sembra di aver finito, ma in realtà c'è qualcosa di strano, la tabella feedback nel nostro db non è presente, per ovviare a questo problema possiamo agire in due modi:
- Creare la tabella manualmente ma lo sconsiglio.
- Creare la tabella durante l'istallazione del modulo.
<?php
function feedback_install(){
//drupal_install_schema('feedback');
}
function feedback_uninstall(){
drupal_uninstall_schema('feedback');
variable_del('feedback_node_type');
}
function feedback_schema(){
$schema['feedback'] = array(
'description' => 'The base table for feedback.',
'fields' => array(
'fid' => array(
'description' => 'The primary identifier for a feedback.',
'type' => 'serial',
'unsigned' => TRUE,
'not null' => TRUE,
),
'uid' => array(
'description' => 'The identifier for user',
'type' => 'int',
'unsigned' => TRUE,
'not null' => TRUE,
'default' => 0,
),
'feed' => array(
'description' => 'the feedback',
'type' => 'varchar',
'length' => 255,
'not null' => TRUE,
'default' => '',
),
),
'primary key' => array('fid'),
);
return $schema;
}
Se installiamo il nostro modulo dobbiamo creare le tabelle, allo stesso modo per non lasciare sporco il db al momento della rimozione del modulo bisogna eliminare ogni traccia nel database tramite la funzione feedback_uninstall().
Considerazioni finali
Questo tutorial è molto semplice, ma serve per chi si avvicina per la prima volta a drupal.
Il prossimo step sarà la gestione dell'interfaccia tramite AJAX.
saluti
l
PS: il tag php è lasciato intenzionalmente aperto, non deve essere chiuso.
Per scaricare l'esempio e provarlo clicca qui
