======Discussion для «ДокуВики»====== {{:wiki:plugin:dwplugin.png?70 |}} Добавляет раздел комментариев на вики-страницы. Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей. Это полезно для разделения содержимого страницы и его обсуждения, а также, если вы не хотите давать обычным пользователям право редактировать страницу, но по-прежнему хотите, чтобы заметки добавлялись пользователями. Второй компонент этого подключаемого модуля показывает список всех страниц в пространстве имен с разделом обсуждения (называемым ветками обсуждения), упорядоченным по самым последним комментариям. Это позволяет вам создать очень простой дискуссионный форум в вашей вики. * **Релиз:** 2020-09-22. * **Репозиторий:**https://github.com/dokufreaks/plugin-discussion * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" =====Совместимость===== Пожалуйста, сообщайте об ошибках или пожеланиях в [[https://github.com/dokufreaks/plugin-discussion/issues|Bug tracker]]. =====Монтаж===== Используйте менеджер плагинов для установки или… - скачать zip-файл - распаковать его в/lib/plugins/ - войдите как администратор и измените плагин в менеджере конфигурации =====Компоненты===== ====Раздел комментариев==== Это основная часть плагина. При включении ''%%~~DISCUSSION~~%%'' инструкции на вашу вики-страницу раздел обсуждения будет добавлен после обычного содержимого вики-страницы. Чтобы снова отключить его, используйте ''%%~~DISCUSSION:off~~%%''. Если вы хотите показать существующее обсуждение, но не хотите разрешать новые комментарии/ответы, используйте ''%%~~DISCUSSION:closed~~%%''. ~~DISCUSSION~~ ~~DISCUSSION:off~~ ~~DISCUSSION:closed~~ Пользовательский заголовок может быть добавлен после разделителя %%|%%. ~~DISCUSSION|Custom Title String~~ ~~DISCUSSION:closed|Custom Title String~~ После каждого комментария в разделе обсуждения может быть до трех кнопок (в зависимости от ваших прав): * Ответ: Чтобы ответить на комментарий (вместо комментирования содержимого вики-страницы), нажмите кнопку ''Reply'' Затем форма ввода комментариев будет размещена соответствующим образом. * Редактировать: зарегистрированные пользователи могут редактировать свои комментарии; администраторы могут редактировать все комментарии. Чтобы удалить комментарий, просто отредактируйте его, очистите текст и сохраните пустой комментарий, как если бы вы делали это со страницей вики. Удалить: Зарегистрированные пользователи и администратор всех комментариев. * Внимание: если на комментарий есть ответы, его удаление также приведет к удалению всех ответов! * Скрыть/показать: с помощью этой кнопки администраторы могут легко деактивировать и повторно активировать комментарии. Скрытые комментарии не отображаются для обычных пользователей и отображаются затемненными для администраторов. Зарегистрированные пользователи могут скрывать только свои комментарии. Скрытие комментария скрывает и его ответы.\\ Конечно, весь синтаксис «ДокуВики» можно использовать и в комментариях. Но есть проблемы с заголовками и сносками, поскольку они могут создавать конфликтующие идентификаторы и, следовательно, неверный XHTML. Я ищу способ либо разрешить только часть синтаксиса вики, либо автоматически создавать уникальные идентификаторы. ==== Синтаксис потоков ==== Это отображает список всех страниц данного пространства имен с разделом обсуждения. Список отсортирован по последнему комментарию. {{threads>[namespace]&[count=n]&[flags]&skipempty}} ^ [namespace] | пространство имен, для которого вы хотите список потоков обсуждения; '':'' это верхнее пространство имен, ''.'' это то же пространство имен, в котором находится страница ''*'' вся вики | необходимый | ^ [count=n] | количество обсуждений, которые должны отображаться (допустимые значения: n > 0) | необязательный | ^ [flags] | флаги списка страниц, разделенные ''&''см. [[https://www.dokuwiki.org/plugin:pagelist#flags|флаги]] | необязательный | ^ skipempty | Не печатать обсуждения без комментариев | необязательный | ^ nonewthreadform | Не показывать новую форму формы темы под таблицей | необязательный | По умолчанию новая форма потока отображается под списком. См. ''threads_formposition'' настройку, чтобы переместить его в начало списка или отключить эту форму. =====Применение===== Если вы не добавите следующий код в файл main.php вашего шаблона, ссылки для цитирования не появятся! В main.php добавьте следующее в начало файла: Чтобы отобразить постоянную ссылку или ссылку для цитирования в любой точке документа, используйте в качестве примера следующий код: Permanent Link Cite this Page Мой совет — сохранить ''%%rel="nofollow"%%''нетронутым, так как это гарантирует, что поисковые системы не будут индексировать цитаты. Установите параметры для этого плагина через меню **«Настройки конфигурации»** в меню администратора «ДокуВики». (Он будет внизу страницы.) ===== Конфигурация ===== Плагин можно настроить с помощью менеджера конфигурации «ДокуВики», доступного в меню администратора. ^ ''automatic'' | автоматически включает обсуждения на всех страницах | ^ ''excluded_ns'' | список пространств имен, для которых нужно отменить ''automatic'' настройку конфигурации (регулярное выражение, например ''%%/(playground|wiki)/%%'', разделитель должен быть включен, например, '/' в начале и в конце)| ^ ''visibilityButton'' | Включить кнопку для переключения видимости всего раздела обсуждения | ^ ''allowguests'' | allow/disallow (разрешить/запретить) незарегистрированным пользователям оставлять комментарии| ^ ''showguests'' | show/hide (показать/скрыть) комментарии для незарегистрированных пользователей | ^ ''linkmail'' | связать имя пользователя с указанным почтовым адресом | ^ ''useavatar'' | отображать аватары (требуется плагин [[https://www.dokuwiki.org/plugin:avatar|Avatar]]) | ^ ''urlfield'' | разрешить отправку URL-адреса домашней страницы (будет связан с именем, если не ''linkmail'' установлено)| ^ ''addressfield'' | разрешите указать адрес | ^ ''adminimport'' | администратор может заполнить все поля (только для импорта) | ^ ''wikisyntaxok'' | allow [[wiki:syntax|wiki syntax]] in comments((Снимите флажок с этого параметра, чтобы избежать проблем с [[https://www.dokuwiki.org/wiki:syntax|плагином Struct.]] )) | ^ ''threads_formposition'' | позиция новой формы потока, показанная с синтаксисомe %%{{threads> }}%% (до или под списком потоков) | ^ ''subscribe'' | разрешить подписку на комментарии (использует двойную подписку), если используются [[https://www.dokuwiki.org/config:subscribers|подписки на страницы]] , они используются только для незарегистрированных пользователей. | ^ ''newestfirst'' | Инвертировать порядок отображения комментариев | ^ ''usethreading'' | включить/отключить цепочку комментариев | ^ ''userealname'' | отображать настоящее имя вместо имени пользователя зарегистрированных пользователей вики | ^ ''moderate'' | модерировать новые комментарии | ^ ''moderatorgroups'' | добавить группы для делегирования административного контроля (например ''@coadmins,@mods'') | ^ ''moderatorsnotify'' | отправлять уведомление всем указанным модераторам всякий раз, когда был отправлен новый комментарий| =====Обновление===== Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше. =====Файл для загрузки===== {{ :wiki:plugin:discussion.zip |}} =====Лицензия===== * **Author:** [[michael@content-space.de|Michael Hamann, Gina Häußge, Michael Klier]] * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]