History: Plugiciels Wiki

            Les __plugiciels wik__i de Tiki sont de puissantes extensions de la syntaxe de base wiki qui vous permettent d'incorporer des fonctionnalités et des données et fonctions interactives dans ''n'importe quelle'' zone de texte dans votre site Tiki. Ceci inclut les pages wiki, les blogues, les articles, les forums, et ainsi de suite... presque toutes les ((Fonctionnalités principales|fonctionnalités)) !

Par exemple, vous pouvez utiliser des plugiceils wiki pour :
* Afficher des images, jouer des vidéos ou des fichiers audio
* Arranger du contenu en lignes et colonnes et créer des tables et boites avec un format spécial
* Construire automatiquement une table des matières, afficher les liens retours, ou rediriger les visiteurs vers d'autres pages
* Afficher des diagrammes, barres de progression, dessins, et cartes 
* Afficher des informations utilisateur ou de formulaires, interroger des bases de données, ou afficher des données d'autres pages
* Et plus encore !

{REMARKSBOX(type=tip, title="À Noter")}Bien qu'ils soient appelés ''plugiciels'', presque tous sont inclus dans l'installation de base de Tiki. Il n'y a pas de "modules supplémentaires" à installer pour pouvoir utiliser des plugiciels.{REMARKSBOX}

La plupart sont activés par défaut. Pour les autres, activez les simplement depuis la page administrateur ((Text Area)). Depuis ((Tiki3)), quelques plugiciels nécessitent une approbation de niveau administrateur avant de devenir "en ligne" sur une page.


{REMARKSBOX(type=tip, title="Info !")}''Vous pouvez développer facilement des nouveaux plugiciels - voir ((dev:Create a Plugin)) pour quelques astuces et comment vous lancer dans ce travail.''{REMARKSBOX}


!Liste des plugiciels inclus par défaut
{toc type=fancy structId="2728"}

{REMARKSBOX(type=note, title=Note)}''Dans la fenêtre d'édition d'une page, cliquer sur l'icône {img src=img/icons/help.png} et ensuite cliquer sur 'Plugins help' pour une liste des plugiciels et leur description avec aussi des boutons pour insérer la syntaxe et accéder aux liens documentaires.''{REMARKSBOX}

! Réglages et sécurité
!! Activation
S'il n'est pas activé par défaut, l'administrateur du site doit activer un plugiciel afin qu'il puisse être utilisé (depuis 3.0) en allant dans ''Admin Home > Editing and Plugins > Plugins (onglet)'' et en cochant  la case "Activer" de ce plugiciel et en cliquant ensuite sur "Enregistrer les préférences."

!! Icônes d'édition
Dans une page wiki, les icones d'édition des plugiciels ({img src=img/icons/wiki_plugin_edit.png}) servent à les éditer individuellement sur une page, au moyen d'une fenêtre popup dédiée.
Celles-ci peuvent être activées/désactivées par l'administrateur via ''Admin Home > Editing and Plugins > Plugins (tab)''.

__Pour afficher les icônes d'édition des plugiciels~hs~:__
La fonctionnalité d'affichage des icônes d'éditions peut être activée par un administrateur via  ''Admin Home > Wiki > General Preferences (tab) > Edit (section)''.
Celle-ci apparait sous la forme d'une icone dans la bare d'icones en haut des pages wiki pour afficher ({img src=img/icons/wiki_plugin_edit_view.png}) ou cacher ({img src=img/icons/wiki_plugin_edit_hide.png} ) les icones d'édition à la lecture de la page wiki.

!! Sécurité et validation
Les plugiciels sont des risques potentiels de sécurité. Lorsque nécessaire, une confirmation par un adminisrateur sera demandée pour leur mise en place.

__Notification des plugiciels en attente de validation~hs~:__
Depuis ((Tiki7|Tiki 7.0)), il existe une option de ''Notification des plugiciels en attente de validation'' accessible via [[tiki-admin.php?page=textarea] (''Admin home > Editing and plugins > Plugins (tab)'') qui permet aux utilisateurs dotés de la permission ''tiki_p_plugin_approve'' de recevoir un couriel de notification à chaque fois qu'un nouveau plugiciel en attente de validation est ajouté dans une page wiki.

! Mods
Les plugiciels de la liste ci-dessus sont distribués avec tiki. La liste exacte varie en fonction de la version de tiki, voir ((All Plugins)) pour savoir lesquels sont disponibles à partir de la version 2.0 et suivantes.

Quelques plugiciels ne sont pas installé par défaut. Ils peuvent être installé séparément en tant que ((Mod)). Voir la liste des ''mods'' ici~hs~: ((Mods Type Wikiplugins)) et la documentation concernant leur installation là~hs~: ((Mods User)).

! Syntaxe des plugiciels
La syntaxe générale des plugiciels est exmpliquée ci-dessous. Vous trouverez aussi des détails et des exemples dans chaque page de documentation dédiée à un plugiciel.

!! Syntaxe en majuscules
La plupart des plugiciels ont une balise de début et une balise de fin et utilisent la syntaxe suivante~hs~:
{CODE(wrap=1)}
{NOM_DU_PLUGICIEL(paramètre1=valeur1|valeur2, paramètre2=valeur)} 
contenu du plugiciel, appalé aussi corps (''body'') ou donnée (''data'')
{NOM_DU_PLUGICIEL}
{CODE}
*__Évitez les espaces~hs~:__ Pas d'espace dans ou autour des valeurs ou du nom du plugiciel
+
*__Sensibilité à la casse~hs~:__ Le nom du plugiciel doit être en majuscules
+
*__Balise de fin~hs~:__ Pour les plugiciels qui n'ont pas de contenu (corps), la balise de fin peut être évitée par la syntaxe suivante~hs~:
+~~chocolate: ~np~{AGENTINFO(info=>IP) /}~/np~~~ à la place de ~~chocolate: ~np~{AGENTINFO(info=>IP)}{AGENTINFO}~/np~~~
+
* __Paramètres:__
**Pour les plugiciels en majuscules, les parentèses sont obligatoire, même si aucun paramètre n'est défini. Par exemple ~np~{CODE~/np~~~red:()~~}
**Les paramètres sont séparés par des virgules. Les valeurs multiples pour un paramètre unique sont séparées par une barre verticale, mais vérifiez la documentation du plugiciel visé pour être sûr.
**Les valeurs peuvent être séparées des paramètres par les syntaxes ~~chocolate:=~~ ou ~~chocolate:=>~~
**Les valeurs peuvent être entourées de guillemets simples ou doubles, mais ce n'est pas obligatoire. Par exemple~hs~: ~np~{CODE(wrap=~/np~~~red:"1"~~)}
**Les paramètres non-spécifiés seront définis par défaut. Regardez la documentation du plugiciel pour vérifier les valeurs par défaut.

!!Syntaxe en minuscules
Certains plugiciels suivent une syntaxe différente comme les plugiciels ((PluginBanner)), ((PluginContent)), ((PluginCookie)), ((PluginDraw)), ((PluginImg)), ((PluginMaketoc)), ((PluginRSS)), ((PluginTOC)).

Les différences sont~hs~:
*Une balise de début en minuscules et pas de balise de fin
*Pas de parenthèse pour les paramètres
*Exemple~hs~:
+ ~~chocolate:~np~{toc}~/np~~~ à la place de ~~chocolate:~np~{TOC()}{TOC}~/np~~~
+ ~~chocolate:~np~{toc type=fancy}~/np~~~ à la place de ~~chocolate:~np~{TOC(type=fancy)}{TOC}~/np~~~

!Page liées
* ((Plugin Security)) - activation et approuvation des plugiciels
* ((Plugin Help)) - un plugiciel d'aide à l'utilisation des plugiciels
* ((Plugin Alias)) - définir des paramètres par défaut pour ses plugiciels
* Pour les développeurs~hs~:: [http://dev.tiki.org/Create+a+Plugin|Créer un plugiciel], [http://dev.tiki.org/Hello+World#To_create_a_new_plugin|Hello World#To_create_a_plugin]

-=Aliases=-
(alias(Plugiciel Wiki)) | (alias(Plugiciel)) | (alias(Plugiciels))