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"

La méthode sans jeu d'options

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
29-03-2024 06:11:14

Nous sommes le {up php=echo date('d-m-Y H:i:s'); | class="bd-violet tc display-inline"}
La méthode rapide

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
29-03-2024 06:11:14

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.

ico-info 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 
coucou

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.

  1. la valeur déclarée dans $options_def du script de l'action
  2. la valeur d'une option de même nom dans la section options du fichier custom/prefs.ini de l'action
  3. la valeur de l'option dans un prefset
  4. 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.