Revision history for ActionInfoFR


Revision [22803]

Last edited on 2016-05-20 07:38:42 by SamuelDr [Replaces old-style internal links with new pipe-split links.]
Additions:
This page can now be found on the [[Docs:ActionInfoFR | Wikka Documentation Server]].
An archive of [[http://wikkawiki.org/ActionInfoFR/revisions | old revisions of this page]] is still available for reference.<<
Deletions:
This page can now be found on the [[Docs:ActionInfoFR Wikka Documentation Server]].
An archive of [[http://wikkawiki.org/ActionInfoFR/revisions
old revisions of this page]] is still available for reference.<<


Revision [18007]

Edited on 2008-01-27 02:34:53 by SamuelDr [Migrated to doc server]
Additions:
<<===This page has moved===
This page can now be found on the [[Docs:ActionInfoFR Wikka Documentation Server]].
Thanks for updating your bookmarks!
An archive of [[http://wikkawiki.org/ActionInfoFR/revisions
old revisions of this page]] is still available for reference.<<
::c::
CategoryMigratedDocs
Deletions:
[[WikkaDocumentationFR Documentation de Wikka]]
====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]]
>>
Techniquement, les actions ne sont rien de plus que des scripts PHP inclus par le moteur wiki lors de l'exécution:
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 Wikka
==Action vs. Handler==
La plupart du temps, vous aurez à choisir sous quelle forme coder votre idée: action ou //handler//. Vous pouvez facilement déterminer quel format choisir en vous posant cette question: "Mon code ajoute-t-il une fonctionnalité à la page ou modifie-t-il le contenu de la page?"
a) Si vous **ajoutez une fonctionnalité** à la page (le google-form, des prévisions météo, un tableau...), le meilleur format est //l'action//.
a) Si vous **modifiez le contenu** de la page (clonage, suppression, édition...), le meilleur format est le //handler//.
==Laissez les autres travailler pour vous... ;-)==
Comme vous n'êtes pas le seul à coder en PHP, il est plus que probable que quelqu'un ait déjà écrit le code dont vous avez besoin. Et comme vous êtes un assidu de WIkkaWiki, vous avez déjà regardé dans les WikkaFeatures (officielles) et Development-Category, ainsi que dans les CodeContributions (non-officielles), non?
Cela peut prendre du temps à rechercher dans toutes ces pages, mais c'est toujours préférable au recodage d'un script déjà existant.
==... ou, au moins, vous aider==
Quand vous aurez commencé à écrire votre action, n'hésitez pas à l'annoncer sur PluginsInDevelopment, peut-être quelqu'un sera-t-il motivé pour vous aider.
===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)
<?php
//* 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)
<?php
//* Code pour récupérer les paramètres d'une action.
?>
%%
//a compléter//
CategoryDocumentationFR


Revision [9635]

Edited on 2005-06-26 03:25:15 by SamuelDr [Typo... they are EVERYWHERE]
Additions:
Techniquement, les actions ne sont rien de plus que des scripts PHP inclus par le moteur wiki lors de l'exécution:
Deletions:
Techniquement, les actions ne sont rien de plus que des scripts PHP inclus par le moteur wiki lors de l'exéction:


Revision [8405]

Edited on 2005-05-23 17:33:41 by PivWan [Finalize]
Additions:
La plupart du temps, vous aurez à choisir sous quelle forme coder votre idée: action ou //handler//. Vous pouvez facilement déterminer quel format choisir en vous posant cette question: "Mon code ajoute-t-il une fonctionnalité à la page ou modifie-t-il le contenu de la page?"
a) Si vous **ajoutez une fonctionnalité** à la page (le google-form, des prévisions météo, un tableau...), le meilleur format est //l'action//.
a) Si vous **modifiez le contenu** de la page (clonage, suppression, édition...), le meilleur format est le //handler//.
==Laissez les autres travailler pour vous... ;-)==
Comme vous n'êtes pas le seul à coder en PHP, il est plus que probable que quelqu'un ait déjà écrit le code dont vous avez besoin. Et comme vous êtes un assidu de WIkkaWiki, vous avez déjà regardé dans les WikkaFeatures (officielles) et Development-Category, ainsi que dans les CodeContributions (non-officielles), non?
Cela peut prendre du temps à rechercher dans toutes ces pages, mais c'est toujours préférable au recodage d'un script déjà existant.
==... ou, au moins, vous aider==
Quand vous aurez commencé à écrire votre action, n'hésitez pas à l'annoncer sur PluginsInDevelopment, peut-être quelqu'un sera-t-il motivé pour vous aider.
Deletions:
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?
a)for an **addition to** a page (the google-form, a weather-forecast, a table), an action should be your choise
a)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.


Revision [8387]

Edited on 2005-05-22 21:17:11 by PivWan [Draft]
Additions:
[[WikkaDocumentationFR Documentation de Wikka]]
====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]]
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.
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 Wikka
===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)
<?php
//* 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)
<?php
//* Code pour récupérer les paramètres d'une action.
?>
%%
//a compléter//
CategoryDocumentationFR
Deletions:
[[WikkaDocumentation Wikka Documentation]]
====How actions work and why it is easy to write your own====
>>**See also**
[[UsingActions Using actions in Wikka pages]]
This Page is also avaible in [[ActionInfoDE German]]
Technically, actions are nothing else then normal php-files, which are included through the wikka-engine:
As you know from [[UsingActions Using actions in Wikka pages]], you simply put the name of an action (and parameters if necessary) between ""{{ and }}"". The wikka-formatter then sends the text between the two brackets to the //function Action($action, $forceLinkTracking = 0)// in the ##wikka.php## . If you take a closer look at it, you will see that everything after the first word is treated as a parameter of the action. If the action-file is found, the parameters are given to it in form of an array.
You can easily extend wikkas functionality by writing your own actions and saving them under a name in the actions directory. This page intends to give you some help with it.
At first, you should think about what you want to do and if an action is the best choice for it.
===2.Security===
You should always keep in mind that every user, who has write-access to your pages, can use an action by default. That means if you want your action beeing limited to admins or registered users, you have to take care of it in the action itself, because wikka won't!
//code for restricting access//
==Parameters==
As said above, paramters are given as an array to the action. You can use the following code to get their values:
//code for getting params//
//will be continued//
CategoryDocumentation


Revision [8386]

The oldest known version of this page was created on 2005-05-22 20:57:57 by PivWan [Draft]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki