V5 CPLcommun - Insertion variables dans champs de formulaires
V5 CPLcommun - Insertion variables dans champs
depuis la version 6.00.09, j'ai développé un mécanisme qui permet d'insérer des "variables" dans certains champs de certains formulaires de mes plugins. Cela se passe en 3 étapes :
- développement dans CPLcommun des fonctions nécessaires. Ca c'est fait.
- inclusion dans /perso/plugins/CPL_commun d'un fichier "CPL-fonctions-perso.inc", contenant la fonction "convertVariable"; Ceci est à faire par vous et cette fonction doit contenir la transposition de toutes les variables dont vous avez envie. Pour vous aider, un fichier "CPL-fonctions-perso-exemple.inc" est fourni dans le paquet d'installation. A la première installation, il vous suffit de le renommer. Nativement, le plugin fournit des variables "universelles" (voir la liste plus bas).
- modifier les formulaires des plugins pour prendre en compte l'acceptation des variables dans les champs qui le nécessite. Voir la liste plus bas et la documentation des plugins.
Utilisation
Dans les champs où c'est autorisé, plus exactement où ça a été prévu, vous mettez §§votre_variable§§ parmi d'autres textes, et elle sera remplacée par le résultat de la fonction que vous avez écrite. Rien n'interdit de mettre plusieurs variables, seules vos fonctions feront la cohérence.
S'il n'y a pas de fonction d'interprétation de la variable ou si le champ n'a pas été prévu pour accueillir des variables, elle reste affichée comme vous l'avez écrite. ATTENTION aux fautes de frappes !
Variables fournies par le plugin
- pseudo : donne le pseudo connecté, ou "visiteur" si personne n'est connecté.
- horlogeanalogique : dessine horloge à aiguille. A priori à mettre dans une affichette sans autre texte, soit dans le bandeau haut, soit dans une colonne latérale.
Plugins supportant les variables
- formulaire
- Dans les champs haut et bas du formulaire
- Dans les champs haut et bas de la page
- editoPlus
- Dans le contenu d'une affichette
Démonstration
Sur le site de test, tout en haut, à coté du logo, vous avez une magnifique horloge. Elle est produite par une fonction en javascript qui est appelée par la variable §§horlogeanalogique§§, mise dans une affichette du plugin editoPlus. Cette affichette ne contient que ça.