Date: Sun, 5 Jul 2009 16:46:45 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.3.10)
X-Rcs-Id: $Id$
Content-Type: application/x-phpwiki;
pagename=Aide%2FPluginWiki;
flags="";
markup=2;
charset=utf-8
Content-Transfer-Encoding: binary
PhpWiki supporte les plugins depuis 1.3.x
~Les plugins Wiki permettent à chacun d'ajouter un nouveau type de contenu
dynamique (ou autre fonctionnalité) aux pages wiki avec PhpWiki. Par exemple,
dans ce wiki, les DernièresModifs, RétroLiens, PagesSemblables et la plupart
des autres pages indexées sont toutes implémentées en utilisant les plugins.
À plus ou moins court terme, l'ancien style phpwiki [URLMagiquesPhpWiki] sera
remplacé par des plugins également.
!!!Exemple
Habituellement, on appelle un plugin en écrivant quelque chose comme ceci :
<>
dans une page wiki classique. Cet exemple particulier génère une liste des
pages qui sont liées à la page courante. Ici on a :
<>
(C'est intéressant pour les pages Catégorie ou Sujets. Vous pouvez l'utiliser
pour en obtenir une liste automatique)
!!!Détails
Les plugins peuvent être utilisés avec une liste d'arguments. Il existe
quatre moyens pour spécifier leur valeur. Dans l'ordre de priorité :
# L'appel du plugin peut spécifier la valeur d'un argument comme ceci :
<>
# L'arguement peut être spécifié via l'argument d'une requête HTTP. Ceci ne
devrait pas se produire (ce n'est pas permis) à moins que l'argument soit
mentionné dans l'appel du plugin :
<>
# Valeurs par défaut spécifiées dans l'appel du plugin :
<>
# Le plugin remplace les valeurs par défaut pour chaque argument utilisé
par des arguments d'URL comme ceci :
BackLinks?page=ThisPage&sortby=-mtime
(Le plugin RétroLiens utilise la page courante comme valeur par défaut
pour l'argument ''page'')
!!! Il y a quatre types de base pour les plugins :
Tous les plugins viennent de la classe PluginWiki étendant la méthode run
qui retourne un objet arbre des objets HTML, et doivent réagir sur chaque
arguments fournit depuis une ~WikiPage (voir les arguments plus loin) ou
passé par l'URL (arguments GET et POST définit via '||=').
*plugin-form* est utilisé pour afficher une boîte input type=text box
comme argument par défaut.
*plugin-head* n'existe plus !
*plugin-link* peut être utilisé pour changer les liens sortants pour
cette page.
<>
;:Ce n'est pas utilisé.
;:Ce n'est plus utilisé.
!!!Plugins existants :
Voir GestionDesPlugins pour la liste actuelle. La plupart des plugins ont leur
propre page de documentation avec le mot *Plugin* ajouté.
-----
Pages dans cette catégorie :
<>
* RechercheEnTexteIntégral : ChercherUnePage
* RechercheParTitre : PagesSemblables (match_head, match_tail).
-----
[DocumentationDePhpWiki]