====== Плагины ======

В «ДокуВики» имеется гибкий API плагинов, который позволяет расширять их функциональность --- вводить дополнительные [[ru:wiki:syntax|синтаксические моды]], специальные [[action_modes|режимы действий]], новые форматы [[ru:export|экспорта]] и многое другое. В зависимости от предназначения плагина, плагин может состоять из одного или более [[#типы плагинов|типов плагинов]], представленных ниже.

===== Типы плагинов =====

В настоящее время «ДокуВики» содержит пять разных типов плагинов.

  * [[syntax_plugins|Синтаксические плагины]] расширяют базовый [[ru:wiki:syntax|синтаксис]] «ДокуВики».
  * [[action_plugins|Плагины действий]] могут быть использованы для расширения или изменения многих аспектов основных операци «ДокуВики»: от сохранения статей до введения новых  [[action modes|режимов действия]].
  * [[admin_plugins|Плагины администрирования]] могут предоставить функциональность администрирования  «ДокуВики» --- эти плагины доступны для суперпользователей и менеджеров через кнопку «Управление» (Admin).
  * [[helper_plugins|Вспомогательные плагины]] могут использоваться для обеспечения функциональности для многих других плагинов, чтобы не реализовывать в этих плагинах снова и снова одни и те же функции. 
  * [[renderer_plugins|Плагины рендеринга]] позволяют создавать новые режимы [[ru:export|экспорта]] и заменить стандартный для «ДокуВики» рендер xhtml.

===== Имя плагина =====

Корректное имя плагина:
  * Должно содержать только символы английского алфавита a-z и цифры 0-9. 
  * ПОДЧЕРКИВАНИЕ не разрешено так как:
    * используется для отделения ''<имени плагина>'' от ''<имени компонента>''. 
    * Использование ПОДЧЕРКИВАНИЯ может также понизить статистику [[:popularity|популярности]] до нуля. 
  * Если одинаковое имя используется двумя разными плагинами то:
    * они взаимно исключаются и становятся несовместимыми. 
    * кроме того, только один из них сможет иметь домашнюю страничку на dokuwiki.org.


===== Мастер создания плагинов =====

Мастер для создания базовой основы плагинов «Докувики» можно найти на [[http://pluginwiz.dokuwiki.org/]], его рекомендуется использовать для начала разработки.

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

===== Размещение плагина на dokuwiki.org =====

Если вы создали плагин, пожалуйста, поделитесь им с сообществом. 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((You can use the [[plugin:imageshack]] plugin to add images here)). [[devel:plugin_homepages|Plugin homepage template]] contains more tips on how to make an user friendly page.

At the top of the plugin page a few metadata fields have to be filled. A description of each field can be found [[plugin:repository|here]].

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 [[http://github.com/|Github]] which offers also a bug tracker for your repository.

===== Обзор плагинов =====

[[devel:plugin_survey:|Plugin Survey 2010]] --- обзор для разработчиков, в котором рассмотрены все [[ru:plugins|плагины]], представленные в пространстве имён «plugin» сайта [[doku>dokuwiki|www.dokuwiki.org]]. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы.