Site de documentation destiné aux développeurs de plugins pour SPIP.
Ce site est né de la rencontre entre :
- Marcimat, ayant envie d’écrire cette documentation, mais n’en ayant pas les moyens financiers
- Jacques Pyrat, qui avait les moyens de financer cette entreprise
- Pascal qui a lui aussi contribué
N’hésitez pas à contribuer vous aussi !
Articles syndiqués tirés de ce site
- Autres options de chargement
-
Août 2009, par Matthieu Marcillaud
Différents autres paramètres spéciaux peuvent être envoyés dans le formulaire lors de son chargement pour modifier son comportement d’origine : message_ok, message_erreur Le message de succès est en principe fournit par la fonction traiter ; le message d’erreur par la fonction verifier ou (…)
- formulaire_charger
-
Août 2009, par Matthieu Marcillaud
Le pipeline formulaire_charger permet de modifier le tableau de valeurs envoyé par la fonction charger d’un formulaire CVT. Il reçoit en argument le nom du formulaire ainsi que les paramètres transmis au formulaire dans les fonctions charger, verifier et traiter. Il retourne le tableau des (…)
- Autoriser ou non l’affichage du formulaire
-
Août 2009, par Matthieu Marcillaud
Le formulaire est affiché par défaut, cependant il est possible de restreindre cet affichage en fonction d’autorisations données. Deux possibilités : soit on ne veut pas du tout afficher le formulaire, on retourne alors false : /** * GeSHi (c) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann * (…)
- Charger les valeurs du formulaire
-
Août 2009, par Matthieu Marcillaud
La fonction charger() permet d’indiquer quels champs doivent être récupérés lorsque le formulaire est soumis et permet aussi de définir les valeurs par défaut de ces champs. Cette fonction renvoie tout simplement un tableau associatif « nom du champ » / « valeur par défaut » : /** * GeSHi (c) (…)
- Passage d’arguments aux fonctions CVT
-
Août 2009, par Matthieu Marcillaud
Les fonctions charger(), verifier() et traiter() ne reçoivent par défaut aucun argument. /** * GeSHi (c) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann * (http://qbnz.com/highlighter/ and http://geshi.org/) */ .php.php .imp font-weight : bold ; color : red ; .php.php .kw1 color : #b1b100 ; (…)
- Affichage conditionnel
-
Avril 2009, par Matthieu Marcillaud
Les fonctions charger() ou traiter() peuvent indiquer dans leur réponse que le formulaire est éditable ou non. Cela se traduit par la réception d’un paramètre editable dans le squelette, qui peut servir à masquer ou non le formulaire (mais pas les messages d’erreur ou de réussite). Il s’utilise (…)
- Expliquer les saisies
-
Avril 2009, par Matthieu Marcillaud
Il est souvent nécessaire de donner une explication pour remplir correctement une saisie de formulaire. SPIP propose une écriture pour cela, à insérer comme classe CSS dans une balise : explication permet d’écrire une explication plus détaillée que le label du champ souhaité attention met en (…)
- Champs radio et checkbox
-
Avril 2009, par Matthieu Marcillaud
Pour afficher des listes d’éléments de type radio ou checkbox, une syntaxe est proposée en encadrant les éléments d’une . Cette écriture permet d’avoir le bouton avant le label, d’avoir la liste radio en horizontal (via CSS). /** * GeSHi (c) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann * (…)
- Séparations par fieldset
-
Avril 2009, par Matthieu Marcillaud
Lorsqu’un formulaire possède de nombreux champs, on sépare généralement celui-ci en différents blocs nommés fieldset en HTML. Comme précédemment, une écriture est proposée pour de tels blocs, toujours s’appuyant sur des listes ul/li : /** * GeSHi (c) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny (…)
- Gerer le retour d’erreurs
-
Avril 2009, par Matthieu Marcillaud
La fonction verifier() du formulaire peut retourner des erreurs si les champs soumis ne sont pas corrects ; nous le verrons plus tard. Pour afficher ces erreurs dans le HTML du formulaire, des classes CSS et un nommage est proposé : En tête du formulaire, des erreurs (ou des messages de (…)