Découvrir DokuWiki
Options avancées
Pour les entreprises
Notre Communautée
Suivez-nous sur Facebook, Twitter et les autres résaux sociaux.
Compatible avec DokuWiki
(bundled)
Installer et gérer les extensions et thèmes (intégré à DokuWiki)
This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.
Le gestionnaire d'extensions permet aux super utilisateurs d'administrer les extensions et thèmes installés et d'en installer de nouveaux.
Le gestionnaire d'extension est accessible depuis le panneau d’administration (identifié comme Admin, cliquer sur «Administrer» et choisir «Gestionnaire d'extensions»).
La liste des plugins installés est l'action par défaut du gestionnaire d'extensions. Le deuxième onglet liste les thèmes installés. Chaque greffon ou thème est affiché dans sa propre ligne. La colonne de droite contient des boutons d'action comme Désactiver/Activer, Installer/Désinstaller/Réinstaller et Mettre à jour.
Les greffons et les thèmes avec une police grise sont actuellement désactivés.
Pour activer ou désactiver un greffon, utilisez les boutons adéquats sur la droite. Les greffons désactivés ne seront plus chargés par DokuWiki et par conséquent leurs fonctions seront inactives.
En appuyant sur le bouton grisé flèche dans le coin inférieur droit, vous obtiendrez des informations de base sur l'extension choisie, lues à partir de deux sources, à savoir
Les informations du dépôt sont d'abord affichées, puis complétées par quelques informations du fichier d'information local. Ces informations locales peuvent être obsolètes.
Les extensions peuvent être d'une aide précieuse mais veuillez considérer qu'installer un code tiers peut poser une risque de sécurité.
Dans le troisième onglet «Rechercher et installer» du gestionnaire d'extensions, vous pouvez chercher une extension un greffon ou un thème sur le dépôt dokuwiki.org et l'installer en cliquant sur le bouton «Installer».
Les greffons et thèmes non proposés via le dépôt en ligne ou d'une version provenant d'un autre lieu de téléchargement peuvent être installés via le quatrième onglet «Installation manuelle». Vous pouvez fournir une URL ou choisir une archive à partir de votre ordinateur.
En fonction des informations recueillies automatiquement concernant les extensions installées, vous pouvez voir un bouton supplémentaire pour «Réinstaller» ou «Mettre à jour».
Si vous avez installé une extension qui porte le même nom que celle du dépôt en ligne mais qui est différente, n'utilisez pas cette fonction.
Vous ne verrez pas ce bouton pour les extensions qui ne sont pas disponibles dans le référentiel en ligne. Cela peut être dû à la fin de l'assistance, au fait que l'extension n'a jamais été ajoutée au dépôt ou à l'utilisation d'une autre source d'installation. Ce dernier cas de figure concerne surtout les extensions qui sont installées à l'aide de Git.
La réinstallation peut être utile si vous pensez que quelque chose a pu altérer votre extension.
Lorsque vous appuyez sur «Mettre à jour», le gestionnaire de l'extension utilise l'URL de téléchargement fournie par le dépôt en ligne pour récupérer les mises à jour. Le gestionnaire d'extension va re-télécharger l'extension et l'installer à nouveau, en écrasant l'ancienne version.
Pour que le processus de mise à jour fonctionne correctement, il est nécessaire que la date «Dernière mise à jour le» dans le dépôt de l'extension Dokuwiki soit égale à la date dans le fichier plugin.info.txt pour les greffons et template.info.txt pour les thèmes dans le fichier source tarbal/zip. Si ce n'est pas le cas : la mise à jour n'aura pas lieu ou l'alerte «Mettre à jour» persistera.
Si une extension est mise à jour, le gestionnaire d'extension supprime tous les fichiers énumérés dans le fichier deleted.files si un tel fichier est ajouté à l'extension.
Chaque extension installée a un bouton «Désinstaller».
Si l'installation d'une extension défectueuse ou en conflit a brisée le bouton «Désinstaller» ou rendu l'ensemble de votre wiki indisponible, vous pouvez la supprimer en supprimant le répertoire de l'extension (ou demandez à votre administrateur de le faire) :
/lib/tpl (pour un thème) ou /lib/plugins pour un greffon.L'extension installe aussi une extension d'outils en ligne de commande qui permet de faire toutes les actions mentionnées ci-dessus à partir de la ligne de commande. Ceci est particulièrement utile si vous souhaitez automatiser la configuration de votre DokuWiki. Par exemple, en utilisant salt ou ansible.
Exécutez la commande suivante dans votre répertoire DokuWiki pour obtenir une liste des commandes et des options :
./bin/plugin.php extension --help
Pour pouvoir installer et modifier vos extensions, le serveur web doit pouvoir écrire dans le répertoire lib/plugins ou lib/tpl et tous les fichiers dans l'arborescence du répertoire. Reportez-vous à la configuration des droits d'accès aux fichiers et répertoires pour savoir comment définir les permissions des fichiers sur les différents systèmes.
Le gestionnaire d'extension détectera les permissions de fichiers manquantes et vous avertira lorsqu'un greffon ou un thème ne peut pas être installé. Dans ce cas, vous devez installer les extensions manuellement, en les téléchargeant et en les décompactant vous-même dans lib/plugins ou lib/tpl.
Si vous essayez d'installer des extensions en utilisant l'outil de téléchargement et d'installation automatique et que vous obtenez le message d'erreur «Pas d'extension trouvé, ou il y a eu un problème inconnu durant le téléversement ou l'installation.», alors vous devez vérifier :
php-zlib.La réécriture du premier gestionnaire d'extensions de DokuWiki a fait partie du programme Google Summer of Code 2011 avec Piyush Mishra comme développeur. Avant d'être inclus, il est réécrit par Michitux et Andi.
Veuillez vous référer au suivi de bogues pour signaler des bogues ou des demandes de fonctionnalités.
Traduction : — Digitalin 2020-03-29 17:14
