Complément à {{{#FORMULAIRE_CONFIGURER_PLUGIN}}}, qui maintenant sait...

Complément à {{{#FORMULAIRE_CONFIGURER_PLUGIN}}}, qui maintenant sait retrouver la fonction {{{_verifier}}} propre à un squelette (cf [15759] [15726] et [15753]). Je réexpose le tout vu les incompréhensions que ça a amené sur spip-dev.

Cette balise admet deux arguments, un nom du plugin (autrement dit le nom d'un sous-répertoire de DIR_PLUGINS) et un nom de squelette dans le sous-répertoire {{{formulaires}}} de ce plugin. Si ce deuxième argument est absent, il est pris conventionnellement égal à {{{configurer_}}}''préfixe_du_plugin''.

Le contexte de ce squelette est égal à la table des métas associée à ce plugin le nom de cette table étant calculé par la fonction {{{formulaires_configurer_plugin_charger_dist}}}.

Le traitement des saisies  consiste à écrire dans cette table des metas les valeurs (chaîne vide si abstentes) que {{{$_POST}}} indique pour tous les noms trouvés dans le formulaire, à l'aide d'une RegExp (pas totalement fiable) repérant les attributs {{{name}}} dans le formulaire. Ce traitement est assuré par la fonction {{{formulaires_configurer_plugin_traiter_dist}}}.

Pour la vérification, la fonction {{{formulaires_configurer_plugin_traiter_dist}}} délègue le travail à la fonction {{{formulaires}}}''_nom_du_squelette''{{{_verifier}}} si elle existe, et sinon ne fait rien.

Ces trois fonctions sont donc communes à tous les formulaires de configuration de tous les plugins voulant les utiliser, ainsi que leurs fonctions auxilaires (nomenclatures des saisies notamment). Elles peuvent évidemment être surchargées.

Pour fonctionner correctement, les formulaires référencés (implicitement ou non) par cette balise doivent utiliser {{{#ACTION_FORMULAIRE}}} avec comme deuxième argument {{{configurer_plugin}}}, afin que le trio de fonctions ci-dessus décrit soit effectivement utilisé. Voir un exemple dans le [http://zone.spip.org/trac/spip-zone/changeset/38755 plugin Association 2].