插件安装说明

找到您要安装的插件并仔细阅读插件的描述。然后参考以下详细信息进行安装。

自动安装

大多数插件可以使用扩展管理器自动安装（自Ponder Stibbons以来）。扩展管理器允许您通过点击“安装”按钮来搜索并直接安装插件。这是安装插件最快且最不容易出错的方法。请参阅使用扩展管理器的说明。

在某些情况下，无法使用扩展管理器安装插件:

未启用ACL. 扩展管理器通过 admin menu 访问，这使得它仅在启用了ACL的wiki上可用。即使在完全公开的wiki中，启用ACL以访问DokuWiki的管理功能（如扩展管理器）也是值得的。
没有插件包。扩展管理器需要一个专门准备的包含插件文件的存档。
Web服务器没有对DokuWiki的lib/plugins目录的写访问权限。扩展管理器需要能够将新插件添加到此目录。
从头开始构建自己插件的开发人员。开发人员应阅读 plugin file structure.

在这些情况下，有必要手动安装插件。

手动安装

直接访问服务器文件系统

下载扩展并将其解压到 lib/plugins/<base-plugin-name>.
插件的基本名称可以在plugin.info.txt中找到 plugin.info.txt
(e.g. 对于gallery插件，其由 base gallery行定义)

使用FTP

这些说明假设您没有服务器的控制台访问权限，并且需要使用FTP或服务器控制面板中的文件管理器上传文件。

有插件包文件

如果插件有包文件，请将该文件下载到您的计算机。如果插件有不同的格式，请选择最适合您的格式（Windows用户将更喜欢zip）。
解压包文件 (i.e. unzip) (请参阅 unpacking 以获取一些帮助和实用程序). 这应该会给您一个以插件命名的目录。在该目录中，您将看到以插件类型命名的文件或目录（例如syntax.php或/syntax/）。
- 注意： 某些解压软件会将所有解压文件放在一个以原始存档文件命名的目录中。如果是这种情况，您需要向上移动一个目录以找到以插件命名的目录。如果存档文件实际上与插件同名，这可能会令人困惑！
- 注意： 许多插件作者将他们的插件托管在github上，并让github自动从最新的签入创建一个ZIP文件。这些自动创建的存档通常包含错误的文件夹名称。您需要将文件夹重命名为正确的名称。
  示例: 解压 Gallery Plugin 插件将导致文件夹名称类似于splitbrain-dokuwiki-plugin-gallery-169c0bb – 您需要将其重命名为 gallery.
  提示: 在 plugin.info.txt 文件中，您可以找到基本名称 (e.g. base gallery)。
使用您的文件上传器（例如FTP或控制面板文件管理器），在服务器上导航到DokuWiki的“lib/plugins”目录，并上传您刚刚创建的插件目录（在您的计算机上）及其所有内容。最终结果应该是在服务器上的“lib/plugins/<new-plugin-name>“目录中包含插件的文件和目录。

插件现已安装。

没有插件包文件

安装没有包的插件仍然相当简单，特别是对于仅包含几个文件的简单插件。然而，如果某些关键信息在插件文档中不清楚，则可能需要更多的DokuWiki和PHP知识。实际上制作插件包非常容易，因此如果您完全不熟悉PHP，可能值得给插件作者发送电子邮件，礼貌地询问他们是否可以通过电子邮件发送插件包，或至少澄清使用插件的确切名称。

对于熟悉PHP的人，请查看开发人员部分的插件页面，特别是 plugin file structure。

这些说明假设作者已将插件所需的代码粘贴在网页上，其中每个文件的代码以及每个文件的名称都清晰可见。

在您的计算机上创建一个目录并以您的插件命名。名称很重要，它应与插件文件中使用的“类”名称部分匹配。
对于插件使用的每个文件，在纯文本编辑器（例如记事本）中启动一个新文件，从网页上复制内容并将其粘贴到编辑器中，确保顶部或底部没有额外的空行（这对于.php文件非常重要），并将文件保存到插件目录中。如果作者已指示某个文件需要在子目录中，请在保存文件之前创建该子目录。
在创建所有文件后，使用您的文件上传器（例如FTP或控制面板文件管理器），在服务器上导航到DokuWiki的“lib/plugins”目录，并上传您刚刚创建的插件目录（在您的计算机上）及其所有内容。最终结果应该是在服务器上的”lib/plugins/<new-plugin-name>“目录中包含插件的文件和目录。