Le principe d'une action YesWiki

Une action est une fonction cachée de yeswiki que l'on va solliciter par le biais d'un appel dans une page.
On dispose d'une syntaxe spéciale pour les actions

{{nomdelaction param1="valeurparam1"  param2="valeurparam2"}}


  • Si un message d'alerte de type Action inconnue "toto" apparaît c'est que soit vous avez mal orthographié votre action, soit le tools correspondant n'est pas installé.
  • Certaines actions sont réservées aux compte super administrateur.

Qu'est qu'une action ?

Une action exécute une série d'opérations et affiche le résultat obtenu à l'endroit où elle est décrite dans la page.
C'est utilisé par exemple pour afficher un calendrier, la liste des utilisateurs, un nuage de mots-clés.
Il est possible de spécifier des paramètres afin de personnaliser ce résultat (ordre du tri, nombre d'entrées, taille...).

La liste des paramètres est indiquée sur la page de documentation de chaque action :
cf. Liste des actions

Certains paramètres peuvent être obligatoires.

Syntaxe
Une action s'écrit avec 2 accolades ouvrantes, suivi du nom de l'action, suivi par des éventuels paramètres, puis fermée par 2 accolades fermantes :
{{nomaction param1="valeur1" param2="valeur2" ... paramN="valeurN"}}



Exemples
{{recentchanges}}

affiche la liste des pages récemment modifiées


{{attach file="paysage.jpg"}}

affiche l'image "paysage.jpg" sur la page, ou propose de la téléverser si elle n'existe pas encore
Le paramètre "file" de cette action est obligatoire.

{{attach file="paysage.jpg" width="200"}}

Le paramètre "width", non obligatoire, permet de spécifier la largeur d'affichage de l'image.