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

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

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

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

  * [[syntax_plugins|Синтаксические плагины]] расширяют базовый [[wiki:wiki:syntax|синтаксис]] «ДокуВики».
  * [[action_plugins|Плагины действий]] могут быть использованы для расширения или изменения многих аспектов основных операци «ДокуВики»: от сохранения статей до введения новых  [[action modes|режимов действия]].
  * [[admin_plugins|Плагины администрирования]] могут предоставить функциональность администрирования  «ДокуВики» --- эти плагины доступны для суперпользователей и менеджеров через кнопку «Управление» (Admin).
  * [[helper_plugins|Вспомогательные плагины]] могут использоваться для обеспечения функциональности для многих других плагинов, чтобы не реализовывать в этих плагинах снова и снова одни и те же функции. 
  * [[renderer_plugins|Плагины рендеринга]] позволяют создавать новые режимы [[wiki: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]] --- обзор для разработчиков, в котором рассмотрены все [[wiki:plugins|плагины]], представленные в пространстве имён «plugin» сайта [[doku>dokuwiki|www.dokuwiki.org]]. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы.

~~NOCACHE~~

---- pluginrepo ----
showscreenshot:       yes
screenshot:       yes
cloudmin: 2
----

Popularity values are based on data gathered through the [[plugin:popularity]] plugin -- please help to increase accuracy by reporting your data with this plugin.

===== Creating Plugins =====

If your needs aren't covered by the existing plugins above, please have a look at our pages on how to [[devel:plugins|create and publish a plugin]].

===== Reporting Bugs and Features Wishes =====

Two short notes:
  * Please use the issue tracker of the plugin
  * Provide enough information to reproduce your case

Please refer to [[https://forum.dokuwiki.org/d/4868|How to report bugs and request new features in plugins]] for more info about this topic.

===== Ideas for New Plugins ====

==== Requesting Plugin ====

If you are in need of a special feature in DokuWiki but haven't the skills or resources to create your own plugin you might want to suggest the feature for consideration by the community.

To ask for the creation of a new plugin or to discuss plugin ideas, please refer to the [[https://forum.dokuwiki.org/t/plugin-wishlist|Plugin Wishlist Forum]]. 

Recent Wishes in the forum:

[[https://forum.dokuwiki.org/atom/t/plugin-wishlist/discussions|{{https://raw.githubusercontent.com/legacy-icons/famfamfam-silk/master/dist/png/feed.png?16x16&recache |Recent Wishes in the forum (RSS feed)}}]]
{{rss>https://forum.dokuwiki.org/atom/t/plugin-wishlist/discussions date}}
==== More ideas... ====

Further some closed features requests, which we won't implement in DokuWiki core, are interesting ideas for plugins: [[https://github.com/dokuwiki/dokuwiki/issues?utf8=%E2%9C%93&q=label%3A%22Doku+Plugin+idea%22|Doku Plugin idea]]'s at our GitHub issue tracker.

[[https://feeds.feedburner.com/doku-plugin-idea|{{https://raw.githubusercontent.com/legacy-icons/famfamfam-silk/master/dist/png/feed.png?16x16&recache |Issues labeled “Doku Plugin idea” (RSS feed)}}]]
{{rss>https://feeds.feedburner.com/doku-plugin-idea author date}}