DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:plugin_installation_instructions

Comment installer un plug-in ?

Trouver le plug in que vous voulez installer dans la liste des plugins et lisez la description attentivement. Ensuite, référez vous aux details ci-dessous pour l'installer.

Installation Automatique

La plupart des plug-in peuvent être installés de manière automatique en utilisant le Gestionnaire d'Extensions. Regardez Installation instructions using the extension manager. C'est de loin la façon la plus rapide et la plus sur d'installer un plugin.

Dans certains cas, il n'est pas possible d'utiliser le Gestionnaire de extensions :

  • La Liste des contrôles d'accès (ACL) n'est pas activée. Comme le Gestionnaire de extensions n'est accessible qu'à partir du panneau d'administration, il faut activer la Liste des contrôles d'accès (ACL) pour y accéder. Même sur un wiki complètement public, il vaut mieux activer l'ACL pour accéder aux fonctions d'administration, comme le Gestionnaire de extensions.
  • No plugin package. The extension manager requires a specially prepared archive containing the plugin files.
  • The webserver doesn't have write access to DokuWiki's lib/plugins directory. The extension manager needs to be able to add the new plugin to this directory.
  • Developers building their own plugins from scratch. Developers should read about plugin file structure.

In these circumstances its necessary to install plugins manually.

Installation Manuelle

These instructions assume that you don't have console access to your server and will need to upload the files using FTP or the file manager in your server's control panel.

En utilisant le fichier archive

  1. If the plugin has a package file, download that file to your computer. If the plugin comes in different formats, choose the one that fits you best (Windows user will prefer zip).
  2. Expand (i.e. unzip) the package (See unpacking for some help and utilities). That should give you a directory named after the plugin. Inside that directory you will see files or directories named for the type of plugin (e.g. syntax.php or /syntax/). Note: some decompression software will place all the decompressed files in a directory named after the original archive file. If that is the case you will need to move up one directory to find the directory named for the plugin. This could get confusing if the archive file is actually has the same name as the plugin too!
  3. Using your file uploader (e.g. FTP or your Control Panel File Manager), on the server navigate to DokuWiki's lib/plugins directory and upload the plugin directory you just created (on your computer) along with all its contents. The end result should be a new directory on the server, lib/plugins/<new-plugin-name>, containing the files and directories of the plugin.

The plugin is now installed.

Sans utiliser le fichier archive

Installing a plugin without a package is still quite straightforward, especially for simple plugins that consist of only a few files. However there are more ifs and buts and greater familiarity with DokuWiki and PHP maybe required if some crucial information is not clear from the plugin documentation. Actually making a plugin package is very easy, so if you are totally unfamiliar with PHP it may be worth dropping the plugin author an email politely asking if they can email you the plugin package or at least clarifying the exact name to use for the plugin.

For those familiar with PHP, check out the plugin pages in the developer section, in particular the plugin file structure.

These instructions assume the author has pasted the code required for the plugin on a web page, where the code for each file is clearly identifiable along with the name for each file.

  1. Create a directory on your computer and name it after your plugin. The name is important, it should match part of the “class” name used in the plugins files.
  2. For each file used by the plugin, start a new file in a plain text editor (e.g. notepad), copy the contents from the web page and paste them into the editor ensuring there are no additional blank lines at either the top or the bottom (this can be quite important for .php files) and save the file with the appropriate name in the plugin's directory. If the author has indicated a file needs to be in a sub-directory, create that sub-directory before saving the file.
  3. After all the files are created, using your file uploader (e.g. FTP or your Control Panel File Manager), on the server navigate to DokuWiki's lib/plugins directory and upload the plugin directory you just created (on your computer) along with all its contents. The end result should be a new directory on the server, lib/plugins/<new-plugin-name>, containing the files and directories of the plugin.

The plugin is now installed.

fr/plugin_installation_instructions.txt · Dernière modification : 2020-03-29 19:28 de Digitalin

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki