—- plugin —- description: управляет расширениями (плагинами и шаблонами) на dokuwiki.org, и предоставляет API для менеджера расширений author : Andreas Gohr/Håkan Sandell email : andi@splitbrain.org type : syntax, action, helper lastupdate : 2010-01-30 compatible : !Frusterick Manners, !Greebo, Hogfather, Igor, Jack Jackrum, Kaos, Librarian depends : sqlite similar : extension tags : database, sqlite, data, tags, tables, listing, extension, repository, repo
downloadurl: https://github.com/dokuwiki/dokuwiki-plugin-pluginrepo/archive/refs/heads/master.zip sourcerepo : https://github.com/dokuwiki/dokuwiki-plugin-pluginrepo bugtracker : https://github.com/splitbrain/dokuwiki-plugin-pluginrepo/issues
screenshot_img: :plugin:reposytory_2145.png?
Этот плагин является аналогом менеджера расширений. Он управляет расширениями (плагинами и шаблонами) здесь, на dokuwiki.org, и предоставляет API для менеджера расширений.
(Также доступен плагин, похожий на этот, но с большей гибкостью, предназначенный для использования за пределами dokuwiki.org. Это плагин данных.)
Каждый плагин должен иметь домашнюю страницу в plugin пространстве имен, содержащую как минимум краткое описание и блок данных, подобный следующему в начале:
---- plugin ---- description: Just an example to prove the point author : Joe Blow email : joe@example.com type : syntax, action, admin, helper, render lastupdate : 2007-12-17 compatible : Anteater, 2010-02-14 depends : plugin1 conflicts : plugin2 similar : plugin3 tags : example, sample downloadurl: https://github.com/example/dokuwiki-plugin-sample/zipball/master bugtracker : https://github.com/example/dokuwiki-plugin-sample/issues sourcerepo : https://github.com/example/dokuwiki-plugin-sample/ donationurl: https://www.paypal.com/... screenshot_img : http://<someserver>/image.png ----
Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список плагинов или менеджер расширений в вашей вики)
О полях:
+ если вы считаете, что плагин будет совместим с будущими версиями DokuWiki.! если плагин несовместим с версией DokuWiki (например, «!Greebo»).template:xxx если конфликтуют с шаблоном xxx!obsolete это единственный тег, то этот плагин будет скрыт из таблицы репозиторияinformationleak, allowsscript, requirespatch and partlyhidden (объяснение ))
Аналогично для шаблонов, но в template пространстве имен.
---- template ---- description : Just an example to prove the point author : Joe Blow email : joe@example.com lastupdate : 2007-12-17 compatible : Anteater, 2010-02-14 depends : conflicts : example, template:sample similar : tags : example, sample downloadurl : https://github.com/example/dokuwiki-plugin-sample/zipball/master bugtracker : https://github.com/example/dokuwiki-plugin-sample/issues sourcerepo : https://github.com/example/dokuwiki-plugin-sample/ donationurl : https://www.paypal.com/... screenshot_img: http://<someserver>/image.png ----
Информация хранится в базе данных и используется для создания динамического браузера репозитория (см. список шаблонов или менеджер расширений в вашей вики).
About the fields:
template:xxx если конфликтуют с шаблоном xxx!obsolete это единственный тег, то этот шаблон будет скрыт из таблицы репоПоле предупреждения безопасности позволяет использовать некоторые предопределенные сочетания клавиш. В следующей таблице показаны фактически определенные сочетания клавиш и их значение:
| Ярлык | Значение |
|---|---|
| informationleak | Это расширение раскрывает информацию, которая может быть ценной для хакера. Не рекомендуется для публичной установки. |
| allowsscript | Это расширение позволит выполнять скрипты. Его следует использовать только тогда, когда вы доверяете ВСЕМ редакторам, лучше всего подходит для личных вики. |
| requirespatch | Это расширение требует исправления ядра DokuWiki. Ручные исправления могут нарушить совместимость с другими расширениями и усложнить защиту вашей установки путем обновления до последней версии. |
| partlyhidden | Скрытие частей страницы DokuWiki не поддерживается ядром. Большинство попыток ввести контроль ACL для частей страницы приведут к утечке информации через RSS-канал, поиск или другие основные функции. |
Пример частично скрытого предупреждения безопасности можно посмотреть на странице plugin:ifauth.
В руководстве по доработке описывается, как настроить и использовать плагин в папке второго уровня.
В руководстве описывается, как использовать различные компоненты плагина на dokuwiki.org.
В документации API описывается , как удаленно запросить информацию о плагине.
Когда будет доступен новый релиз-кандидат, пожалуйста, обновите домашнюю страницу плагина с соответствующей совместимостью, используйте название релиза (например, «rincewind») вместо даты RC. Таким образом, вам не придется обновлять информацию о совместимости, когда будет готов финальный релиз.