# Gestore stati

È possibile modificare le opzioni di scelta per le picklist gestite dal gestore stati, nonché aggiungere messaggi al blocco “Gestore stati”, a destra del record. Per registrare tale funzionalità usare il metodo:

**SDK::setTransition($module, $fieldname, $file, $function);**  
*$module : il nome del modulo da gestire*  
*$fieldname : il nome del campo gestito dal gestore stati*  
*$file : percorso del file php che contiene la funzione da chiamare*  
*$function : nome della funzione da chiamare*

E per rimuoverlo:

**SDK::unsetTransition($module, $fieldname);**

La funzione richiamata dal gestore stati ha il seguente formato:

**function ($module, $fieldname, $record, $status, $values)**  
*$module : il modulo corrente*  
*$fieldname : il nome del campo gestito dal gestore stati*  
*$record : id del record visualizzato*  
*$status : valore del campo usato per lo stato del record corrente*  
*$values : array di valori ammissibili per il suddetto campo*

Deve restituire null nel caso non si voglia modificare il comportamento del gestore stati oppure un array con il seguente formato:

*array(*  
*'values' => array(..) // array con i valori ammissibili per lo stato*  
*'message' => '' // codice html da includere sotto al blocco gestore stati*  
*);*

<p class="callout info">**Hooks**  
modules/Transitions/Transitions.php  
modules/Transitions/Statusblock.php  
Smarty/templates/modules/Transitions/StatusBlock.tpl</p>