CFG permette di realizzare form pubblici, che si basano sui form CFG.
Nota : Questa funzione è disponibile solo a partire da una versione SPIP 1.9.3 di SVN recente. Questa versione di SPIP è in sviluppo e non è ancora stabile. Quest’API è dunque ancora suscettibile d’évolvere.
SPIP ed i form pubblici
Una nuova API per realizzare form pubblici è stata introdotta nella versione di SPIP in sviluppo. Realizzare un form pubblico richiede ora 4 file :
- formulaires/x.html contiene il form
- formulaires/x/charger.php carica i valori di default
- formulaires/x/verifier.php verifica i valori inviati dal form
- formulaires/x/traiter.php effettua i trattamenti dei dati se i valori inviati sono validi.
Questi form presentano di default una chiamata ajax, vale a dire che solo la parte di codice che contiene il form è aggiornata, e non tutta la pagina. Per non utilizzare ajax, occorre mettere la classe css noajax nel tag <form>
CFG ed i suoi form pubblici
Appoggiandosi su questa API, CFG possiede, dalla versione 1.4, un segnaposto #FORMULAIRE_CFG :
#FORMULAIRE_CFG{cfg_fond, cfg_id=""}
- cfg_fond : il nome del form CFG (senza il prefisso ’cfg_’)
- cfg_id : l’identificativo passato a CFG, di rado necessario.
Adattare il fond CFG
Per permettere al vostro form CFG d’essere letto da questo segnaposto, occorre che contenga il segnale #ACTION_FORMULAIRE e che il campo action del form sia riempito. Generalmente si ottiene dunque:
Pubblicare i messaggi di successo o d’errore
l’API dei form SPIP ritorna molti tipi di messaggio che sono trasmessi all’ambiente :
message_ok, message_erreur
nonché una tabella errori che contiene informazioni d’errore per ogni campo.
L’utilizzo è il seguente:
Form minimale
Sia il form fonds/cfg_z.html che contiene :
Può essere richiamato da #FORMULAIRE_CFG{z}.
Rispondere all'articolo