locale/fr/pgsrc/Aide%2FPluginWiki

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