Написать плагин DokuWiki очень просто. Перед тем, как написать свой собственный, не забудьте поискать похожие плагины среди уже написанных and read through рекомендации по безопасности для авторов плагинов .

DokuWiki имеет гибкий API-интерфейс плагина, который позволяет разработчикам расширять его функциональность, будь то дополнительные режимы синтаксиса , пользовательские режимы действий или новые форматы экспорта и многое другое. В зависимости от назначения плагина, он может состоять из одного или нескольких компонентов следующих типов плагинов.

На данный момент DokuWiki предлагает семь различных типов плагинов.

• Плагины синтаксиса расширяют базовый синтаксис DokuWiki.
• Плагины действий можно использовать для расширения или замены многих аспектов основных операций DokuWiki: от сохранения вики-страниц до добавления новых режимов действий.
• Плагины администратора могут обеспечить функциональные возможности администрирования DokuWiki — эти плагины доступны суперпользователям и менеджерам с помощью кнопки «Администратор».
• Вспомогательные плагины можно использовать для предоставления функциональности многим другим плагинам, поэтому каждому плагину не придется снова и снова реализовывать определенную функцию.
• renderer_plugins позволяют создавать новые режимы экспорта и заменять стандартный рендерер DokuWiki XHTML.
• Удаленные плагины позволяют добавлять веб-сервисы в ваш плагин.
• Плагины аутентификаци и добавляют в DokuWiki дополнительный бэкэнд аутентификации, который можно активировать через менеджер конфигурации.
• Плагины CLI добавляют инструменты командной строки в ваш плагин

Plugin types are not mutually exclusive, i.e. a plugin can also be assigned to several plugin types.

Типы плагинов не являются взаимоисключающими, т.е. плагин может быть отнесен к нескольким типам плагинов. плагин цвета, может состоять только из одного файла syntax.php. Более продвинутые плагины состоят из нескольких компонентов, например, плагин структурированных данных имеет обработку синтаксиса, разделенную на компоненты «ввод данных» и «табличное представление», компонент действия для специальной кнопки редактирования, прикрепленной к каждой записи данных, и интерфейс администратора для обслуживания базы данных.

There are a number of sources especially for plugin development:

• The plugin file structure gives overview of the naming convention and structure, and where you add JavaScript and CSS stylesheets, relevant for all plugin types
• There are some common plugin functions, available in all plugins types. Adds localisation, configuration and interspection.
• These security guidelines give some deeper understanding of common issues and presents some protection measures.
• Some general plugin programming tips are available, mostly good practices and pointers to handsome tools in DokuWiki.

A valid plugin name:

• Should only contain the characters a-z and 0-9.
• Underscore is NOT allowed as:
  • This is used to separate <plugin name> from <component name>.
  • Using underscore will also give a popularity rating of zero.
• If the same name is used by two different plugins
  • they are mutually excluding and inherently incompatible,
  • furthermore only one of them can have a plugin homepage on dokuwiki.org.

A Wizard to create the basic skeleton for a DokuWiki plugin can be found at http://pluginwizard.dokuwiki.org/ and is recommended to be used for starting the development. Alternatively use the command line dev Plugin.

If you later need to extend your plugin refer to the plugin file structure on how files are arranged in a plugin.

If you created a plugin, please share it with the community. Just create a page named after your plugin in the plugin namespace. E.g. if your pluginfolder is named sample create a page plugin:sample here in the wiki.

The page should contain all needed documentation on how to install and use the plugin and give users a pretty good idea what it does before installing the plugin. Adding screenshots might be a good idea as well. When creating the new page, a namespace template will prefill sections and tips for you.

At the top of the plugin page a few metadata fields have to be filled. A description of each field can be found on Repository Plugin page.

Users will see that an update is available in the extension manager. For this to work properly it is necessary that the date “Last updated on” at the Plugin wiki page equals the date in the file plugin.info.txt in the source tarball/zipfile. If this is not the case, available updates will not be shown or the “Update” signal will persist despite the plugin being up-to-date!

Uploads are not allowed on dokuwiki.org, so you need to host your plugin files somewhere else. We recommend to manage your source with a Revision Control System like git. If you do, it's easiest to use a public repository host like GitHub, GitLab or Bitbucket which offers also a bug tracker for your repository.

Plugin developers can check the bad extension page for differences in their github repository checkin, the plugin.info.txt and the respective page at dokuwiki.org.

Already more than 1400 plugins are written for DokuWiki. To learn how things are working, you might study some existing plugins that have some similarity with your ideas. At code­search.doku­wiki.org you can find all them in a browsable format.

Another way is to search the event list for a suitable event that may be used to implement the desired plugin function. The plugins that use this event can then be found using the code search mentioned above.

At the bottom of each event page, where the details of the event are listed, there is a link to a pre-filled code search. It provides specific examples of the function and application of the respective event.

см. также

• plugin_programming_tips
• Ссылки на источник статьи
• Пример разработки плагина иконок
• Пример разработки плагина ссылки