| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| wiki:plugins [2026/01/18 15:13] – [Типы плагинов] VladPolskiy | wiki:plugins [2026/01/18 15:35] (текущий) – VladPolskiy |
|---|
| ====== Плагины ====== | ====== Плагины ====== |
| |
| В «ДокуВики» имеется гибкий API плагинов, который позволяет расширять их функциональность --- вводить дополнительные [[wiki:syntax|синтаксические моды]], специальные [[wiki:devel:action_modes|режимы действий]], новые форматы [[wiki:export|экспорта]] и многое другое. В зависимости от предназначения плагина, плагин может состоять из одного или более [[#типы плагинов|типов плагинов]], представленных ниже. | Плагины предоставляют систему расширения функциональности DokuWiki без необходимости вносить изменения в исходный код (и, следовательно, при каждом обновлении). Ниже приведен список готовых к использованию плагинов, созданных пользователями DokuWiki. |
| |
| ===== Типы плагинов ===== | Установка может быть выполнена автоматически путем поиска и установки плагина через [[wiki:plugin:extension|менеджер расширений]]((wiki:plugins#fn__1)). Плагин можно установить вручную, поместив его в отдельную папку в ''lib/plugins/''. См. подробные [[wiki:plugin_installation_instructions|инструкции по установке плагинов.]] |
| |
| В настоящее время «ДокуВики» содержит пять разных типов плагинов. | Обязательно ознакомьтесь с информацией о [[wiki:security#plugin_security|безопасности плагинов.]] |
| | |
| * [[wiki:devel:syntax_plugins|Синтаксические плагины]] расширяют базовый [[wiki:syntax|синтаксис]] «ДокуВики». | |
| * [[wiki:devel:action_plugins|Плагины действий]] могут быть использованы для расширения или изменения многих аспектов основных операци «ДокуВики»: от сохранения статей до введения новых [[wiki:devel:action modes|режимов действия]]. | |
| * [[wiki:devel:admin_plugins|Плагины администрирования]] могут предоставить функциональность администрирования «ДокуВики» --- эти плагины доступны для суперпользователей и менеджеров через кнопку «Управление» (Admin). | |
| * [[wiki:devel:helper_plugins|Вспомогательные плагины]] могут использоваться для обеспечения функциональности для многих других плагинов, чтобы не реализовывать в этих плагинах снова и снова одни и те же функции. | |
| * [[wiki:devel: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. | |
| |
| | Если вы хотите помочь в переводе плагинов на другой язык, пожалуйста, ознакомьтесь с этой страницей [[wiki:localization#localizing_the_plugins|«Локализация плагинов»]]. |
| ===== Обзор плагинов ===== | ===== Обзор плагинов ===== |
| |
| [[devel:plugin_survey:|Plugin Survey 2010]] --- обзор для разработчиков, в котором рассмотрены все [[wiki:plugins|плагины]], представленные в пространстве имён «plugin» сайта [[doku>dokuwiki|www.dokuwiki.org]]. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы. | [[https://www.dokuwiki.org/start|Plugin Survey 2011]] --- обзор для разработчиков, в котором рассмотрены все [[wiki:plugins|плагины]], представленные в пространстве имён «plugin» сайта [[doku>dokuwiki|www.dokuwiki.org]]. Данные были собраны 05.09.2010 г. автоматическим скриптом с небольшой ручной правкой и обработкой. Было проверено 697 страниц, содержащих 672-а плагина. Исходные коды 647-и плагинов (96%) были загружены и проанализированы. |
| |
| ~~NOCACHE~~ | ~~NOCACHE~~ |