Revision [8387]
This is an old revision of ActionInfoFR made by PivWan on 2005-05-22 21:17:11.
Le fonctionnement des actions ou "Comment créer facilement son action"
Voir aussi
UsingActionsFR Utiliser des actions dans Wikka
Cette page est également disponible en ActionInfoDE Allemand
UsingActionsFR Utiliser des actions dans Wikka
Cette page est également disponible en ActionInfoDE Allemand
Techniquement, les actions ne sont rien de plus que des scripts PHP inclus par le moteur wiki lors de l'exéction:
Comme vous l'avez appris avec UsingActionsFR Utiliser des actions dans Wikka, l'utilisation d'une action se résume à mettre son nom entre {{ et }}. Le moteur wikka transfère le texte contenu entre ces accolades à la fonction Action($action, $forceLinkTracking=0) (située dans le fichier wikka.php). Un coup d'oeil plus appuyé vous fera remarquer que tous les mots, à l'exception du premier, sont traités comme paramètres de cette fonction. Si le fichier associé à l'action est trouvé, les paramètres lui sont transmis sous forme de tableau.
Vous pouvez très facilement augmenter les fonctionnalités de Wikka en ecrivant vos propres actions et en les sauvegardant sous ce nom dans le répertoire /actions/. Cette page a pour but de vous aider lors de la rédaction de vos actions.
1. Planning
La première étape est de savoir ce que devra faire votre plugin et de déterminer le meilleur moyen pour l'intégrer dans WikkaAction vs. Handler
Mostly you will have to choose between action and handler. You can easily seperate them with the following question:Do you add something to a page, or do you want to do something with the page?
- for an addition to a page (the google-form, a weather-forecast, a table), an action should be your choise
- for doing something to a page (like cloning, deleting, editing...), use a handler
Let others do your work... ;-)
Since there are many people working with php, it is highly possible that someone has already written the code you need. You surely have looked at the (offical) WikkaFeatures and the Development-Category, but have you also seen the (unoffical) CodeContributions and the UserContributions-category?It may take you some time to search all this places, but it is better than doing the same work twice.
... or at least help you
When you have started working on your action, announce this at PluginsInDevelopment, perhaps someone else wants to help you working on it.2.Sécurité
gardez toujours à l'esprit que n'importe quel utilisateur ayant les droits d'écriture sur une page peut utiliser votre action. En d'autres termes, si vous voulez restreindre l'usage de votre action aux utilisateurs enregistrés et/ou aux administrateurs, n'oubliez pas d'inclure le code pour le contrôle dans votre action: Wikka ne le fera pas pour vous!<?php
//* Code pour restreindre l'utilisation d'une action.
?>
//* Code pour restreindre l'utilisation d'une action.
?>
Paramètres
Comme dit plus tôt, les paramètres sont passés à la fonction sous la forme d'un tableau. Vous pouvez utiliser le code suivant pour récupérer les valeurs:<?php
//* Code pour récupérer les paramètres d'une action.
?>
//* Code pour récupérer les paramètres d'une action.
?>
a compléter
CategoryDocumentationFR
