Les plugiciels wiki 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 !
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 !
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.
Liste des plugiciels inclus par défaut
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 (
) 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 :
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 (
) ou cacher (
) 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 :
Depuis 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 : Mods Type Wikiplugins et la documentation concernant leur installation là : 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 :
{NOM_DU_PLUGICIEL(paramètre1=valeur1|valeur2, paramètre2=valeur)} contenu du plugiciel, appalé aussi corps (''body'') ou donnée (''data'') {NOM_DU_PLUGICIEL}
- Évitez les espaces : Pas d'espace dans ou autour des valeurs ou du nom du plugiciel
- Sensibilité à la casse : Le nom du plugiciel doit être en majuscules
- Balise de fin : Pour les plugiciels qui n'ont pas de contenu (corps), la balise de fin peut être évitée par la syntaxe suivante :
{AGENTINFO(info=>IP) /} à la place de {AGENTINFO(info=>IP)}{AGENTINFO}
- Paramètres:
- Pour les plugiciels en majuscules, les parentèses sont obligatoire, même si aucun paramètre n'est défini. Par exemple {CODE()}
- 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 = ou =>
- Les valeurs peuvent être entourées de guillemets simples ou doubles, mais ce n'est pas obligatoire. Par exemple : {CODE(wrap="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 :
- Une balise de début en minuscules et pas de balise de fin
- Pas de parenthèse pour les paramètres
- Exemple :
{toc} à la place de {TOC()}{TOC}
{toc type=fancy} à la place de {TOC(type=fancy)}{TOC}
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 :: Créer un plugiciel, Hello World#To_create_a_plugin