Les "Actions" sont des raccourcis qui servent à l'utilisateur final pour générer automatiquement du contenu à l'intérieur de la zone de contenu d'une page WikiNi. Elles peuvent être utilisées facilement dans n'importe quelle page et par n'importe qui et décuplent ainsi les possibilités techniques du WiKi,
La ListeDesActionsWikiNi répertorie l'ensemble des Actions actuellement disponible dans la version stable de WikiNi.
Par exemple sur ce site la page DerniersChangements contient l'ActionRecentChanges qui affiche la liste des pages modifiées récemment. Vous pouvez aller voir la page et l'éditer pour observer comment {{RecentChanges}} est utilisé. N'hésitez pas à vous entraîner sur le BacASable !
Comment on s'en sert ?
Une Action se met en oeuvre très simplement, en éditant une page et en plaçant n'importe où dans le texte le nom de l'action à l'intérieur d'une paire d'accolades doubles.
La syntaxe pour utiliser une Action est toujours la même : {{nomdelaction param1="valeur1" param2="valeur2"}}
Le résultat éventuel s'affiche alors à l'endroit où elle a été appelée.
Certaines Actions peuvent accepter des paramètres, permettant ainsi de modifier légèrement leur comportement. Les valeurs des paramètres sont toujours entre guillemets.
Les Actions s'utilisent donc comme n'importe quel autre contenu :
On peut utiliser plusieurs Actions par page.
On peut utiliser la même Action dans plusieurs pages différentes.
On peut utiliser la même Action plusieurs fois dans la même page.
Comment ça marche ?
Techniquement lorsque le formateur WikiNi qui traduit le texte avec les balises WikiNi en HTML rencontre la balise {{ ..... }} il appelle la méthode Action() de l'objet $wiki. Cette méthode récupère les paramètres de l'action puis inclus le code de l'action dans le code php courant pour l'exécuter. Le code de l'Action devient donc une partie du code de la classe Wiki et peut donc accéder à ses méthodes en utilisant la variable $this.
J'en veux encore !
En réalité les Actions sont des sortes de macros ou plug-in dont la fabrication est à la portée d'un programmeur débutant. Si vous voulez essayer, consultez les règles pour EcrireUneAction et n'oubliez pas d'inscrire votre contribution dans la liste des ActionsEnCoursDeDiscussion !
Si vous avez une remarque ou une idée sur les Actions, vous pouvez également participer aux DiscussionsSurLesActions