Fonctions avancées


Pour aller plus loin que de la simple mise en page, il existe des fonctions accessibles soit via le mode édition de la page (action), soit directement ajoutées à la fin d'une adresse url de la page (handler).


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.



Qu'est qu'un handler ?

Un handler permet de modifier la façon d'afficher la page en ajoutant derrière l'adresse URL le signe / suivi du nom du handler.

Exemples
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/raw

Ajouter /raw a la fin d'une adresse url de YesWiki (dans la barre d'url de votre navigateur), permet d'obtenir le contenu de la page sans interprétation, en syntaxe wiki.
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/edit

ajouter /edit a la fin d'une adresse url de YesWiki (dans la barre d'url de votre navigateur), permet d'afficher la page en mode édition

La liste des handlers existants est disponible sur la page Liste des handlers

En savoir plus