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 :

<?plugin BackLinks?>

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é :

  1. L'appel du plugin peut spécifier la valeur d'un argument comme ceci :

    <?plugin BackLinks page=OtherPage ?>

  2. 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 :

    <?plugin BackLinks page ?>

  3. Valeurs par défaut spécifiées dans l'appel du plugin :

    <?plugin BackLinks page||=OtherPage ?>

  4. 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.

<?plugin PluginName [args...] ?>
<?plugin-form PluginName [args...] ?>
<?plugin-link PluginName [args...] ?>
Ce n'est pas utilisé.
<?plugin-head PluginName [args...] ?>
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 :

DocumentationDePhpWiki