locale/fr/pgsrc/PluginWiki

   1 Date: Sat, 5 Jun 2004 16:49:57 +0200
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.10)
   3 X-Rcs-Id: $Id: PluginWiki,v 1.3 2004-06-08 14:19:04 rurban Exp $
   4 Content-Type: application/x-phpwiki;
   5   pagename=PluginWiki;
   6   pgsrc_version="3 $Revision: 1.3 $";
   7   flags="";
   8   markup=2;
   9   charset=iso-8859-1
  10 Content-Transfer-Encoding: binary
  11
  12 PhpWiki supporte les plugins depuis 1.3.x
  13
  14 ~Les plugins Wiki permettent à chacun d'ajouter un nouveau type de contenu
  15 dynamique (ou autre fonctionnalité) aux pages wiki avec PhpWiki. Par exemple,
  16 dans ce wiki, les DernièresModifs, RétroLiens, PagesSemblables et la plupart
  17 des autres pages indexées sont toutes implémentées en utilisant les plugins.
  18
  19 À plus ou moins court terme, l'ancien style phpwiki [URLMagiquesPhpWiki] sera
  20 remplacé par des plugins également.
  21
  22 !!!Exemple
  23
  24 Habituellement, on appelle un plugin en écrivant quelque chose comme ceci :
  25
  26 <verbatim>
  27 <?plugin BackLinks?>
  28 </verbatim>
  29
  30 dans une page wiki classique. Cet exemple particulier génère une liste des
  31 pages qui sont liées à la page courante. Ici on a :
  32
  33 <?plugin BackLinks?>
  34
  35 (C'est intéressant pour les pages Catégorie ou Sujets. Vous pouvez l'utiliser
  36 pour en obtenir une liste automatique)
  37
  38 !!!Détails
  39
  40 Les plugins peuvent être utilisés avec une liste d'arguments. Il existe
  41 quatre moyens pour spécifier leur valeur. Dans l'ordre de priorité :
  42
  43 # L'appel du plugin peut spécifier la valeur d'un argument comme ceci :
  44   <verbatim>
  45   <?plugin BackLinks page=OtherPage ?>
  46   </verbatim>
  47
  48 # L'arguement peut être spécifié via l'argument d'une requête HTTP. Ceci ne
  49   devrait pas se produire (ce n'est pas permis) à moins que l'argument soit
  50   mentionné dans l'appel du plugin :
  51
  52   <verbatim>
  53   <?plugin BackLinks page ?>
  54   </verbatim>
  55
  56 # Valeurs par défaut spécifiées dans l'appel du plugin :
  57
  58   <verbatim>
  59   <?plugin BackLinks page||=OtherPage ?>
  60   </verbatim>
  61
  62 # Le plugin remplace les valeurs par défaut pour chaque argument utilisé
  63   par des arguments d'URL comme ceci :
  64   <verbatim>
  65     BackLinks?page=ThisPage&sortby=-mtime
  66   </verbatim>
  67   (Le plugin RétroLiens utilise la page courante comme valeur par défaut
  68   pour l'argument ''page'')
  69
  70 !!! Il y a quatre types de base pour les plugins :
  71
  72 Tous les plugins viennent de la classe PluginWiki étendant la méthode run
  73 qui retourne un objet arbre des objets HTML, et doivent réagir sur chaque
  74 arguments fournit depuis une ~WikiPage (voir les arguments plus loin) ou
  75 passé par l'URL (arguments GET et POST définit via '||=').
  76
  77   *plugin-form* est utilisé pour afficher une boîte input type=text box
  78    comme argument par défaut.
  79
  80   *plugin-head* n'existe plus !
  81
  82   *plugin-link* peut être utilisé pour changer les liens sortants pour
  83   cette page.
  84
  85 <verbatim>
  86 <?plugin PluginName [args...] ?>
  87 </verbatim>
  88
  89 <verbatim>
  90 <?plugin-form PluginName [args...] ?>
  91 </verbatim>
  92
  93 <verbatim>
  94 <?plugin-link PluginName [args...] ?>
  95 </verbatim>
  96 ;:Ce n'est pas utilisé.
  97
  98 <verbatim>
  99 <?plugin-head PluginName [args...] ?>
 100 </verbatim>
 101 ;:Ce n'est plus utilisé.
 102
 103
 104 !!!Plugins existants :
 105
 106 Voir GestionDesPlugins pour la liste actuelle. La plupart des plugins ont leur
 107 propre page de documentation avec le mot *Plugin* ajouté.
 108
 109 -----
 110
 111 Pages dans cette catégorie :
 112
 113 <?plugin BackLinks page=[pagename] noheader=1?>
 114
 115 * RechercheEnTexteIntégral : ChercherUnePage
 116 * RechercheParTitre : PagesSemblables (match_head, match_tail).
 117
 118 -----
 119
 120 DocumentationDePhpWiki