Introduit avec la version 1.7 de UP, les jeux d'options facilitent son utilisation en permettant au webmaster de préparer des réponses aux situations courantes sur le site.
Démonstration avec ces 3 shortcodes qui donnent le même résultat
Pour ces tests, le fichier custom/prefs.ini contient la section :
[date]
php = "echo date('d-m-Y H:i:s');"
class="bd-violet tc display-inline"
Juste pour mémoire, avant la version 1.7, le shortcode avait cette forme.
Outre la difficulté de mémoriser la syntaxe, l'unité graphique du site est délicate à maintenir.
Nous sommes le {up php=echo date('d-m-Y H:i:s'); | class="bd-violet tc display-inline"}
Le rédacteur indique le nom du jeu d'option directement commme argument du nom de l'action.
Si l'argument principal est le nom d'une section du fichier custom/prefs.ini, UP va remplacer les options par défaut par celles-ci.
Cette forme est possible seulement dans les cas où l'option principale n'est pas utilisée. Dans le cas contraire, voir les méthodes suivantes.
Nous sommes le {up php=date}
❸ La méthode complète
Dans les cas où l'option principale permet de fournir un argument à l'action, il faut indiquer le nom du jeu d'options comme argument de l'option prefset.
Une option argumentée par le rédacteur dans le shortcode sera toujours prioritaire.
En tant que programmeur, vous n'avez pas besoin de déclarer prefset dans l'objet $options_def. UP la déclare pour vous.
Nous sommes le {up php=echo 'coucou'; | prefset=date}
Priorités
La valeur d'une option peut-être surchargée de plusieurs façons. La liste ci-dessous montre l'ordre des surcharges.
- la valeur déclarée dans $options_def du script de l'action
- la valeur d'une option de même nom dans la section options du fichier custom/prefs.ini de l'action
- la valeur de l'option dans un prefset
- la valeur saisie par le rédacteur dans le shortcode
Si vous avez un doute sur la valeur retenue, il suffit d'ajouter une option debug au shortcode pour la connaitre.