Это старая версия документа!
Содержание
Discussion для «ДокуВики»
Добавляет раздел комментариев на вики-страницы. Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей. Это полезно для разделения содержимого страницы и его обсуждения, а также, если вы не хотите давать обычным пользователям право редактировать страницу, но по-прежнему хотите, чтобы заметки добавлялись пользователями.
Второй компонент этого подключаемого модуля показывает список всех страниц в пространстве имен с разделом обсуждения (называемым ветками обсуждения), упорядоченным по самым последним комментариям. Это позволяет вам создать очень простой дискуссионный форум в вашей вики.
- Релиз: 2020-09-22.
- Репозиторий:https://github.com/dokufreaks/plugin-discussion
- Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»
Совместимость
Пожалуйста, сообщайте об ошибках или пожеланиях в Bug tracker.
Монтаж
Используйте менеджер плагинов для установки или…
- скачать zip-файл
- распаковать его в<dokuwiki>/lib/plugins/
- войдите как администратор и измените плагин в менеджере конфигурации
Компоненты
Раздел комментариев
Это основная часть плагина. При включении ~~DISCUSSION~~
инструкции на вашу вики-страницу раздел обсуждения будет добавлен после обычного содержимого вики-страницы. Чтобы снова отключить его, используйте ~~DISCUSSION:off~~
. Если вы хотите показать существующее обсуждение, но не хотите разрешать новые комментарии/ответы, используйте ~~DISCUSSION:closed~~
.
~~DISCUSSION~~ ~~DISCUSSION:off~~ ~~DISCUSSION:closed~~
Пользовательский заголовок может быть добавлен после разделителя |.
~~DISCUSSION|Custom Title String~~ ~~DISCUSSION:closed|Custom Title String~~
После каждого комментария в разделе обсуждения может быть до трех кнопок (в зависимости от ваших прав):
- Ответ: Чтобы ответить на комментарий (вместо комментирования содержимого вики-страницы), нажмите кнопку
Reply
Затем форма ввода комментариев будет размещена соответствующим образом. - Редактировать: зарегистрированные пользователи могут редактировать свои комментарии; администраторы могут редактировать все комментарии. Чтобы удалить комментарий, просто отредактируйте его, очистите текст и сохраните пустой комментарий, как если бы вы делали это со страницей вики.
Удалить: Зарегистрированные пользователи и администратор всех комментариев.
- Внимание: если на комментарий есть ответы, его удаление также приведет к удалению всех ответов!
- Скрыть/показать: с помощью этой кнопки администраторы могут легко деактивировать и повторно активировать комментарии. Скрытые комментарии не отображаются для обычных пользователей и отображаются затемненными для администраторов. Зарегистрированные пользователи могут скрывать только свои комментарии. Скрытие комментария скрывает и его ответы.
Конечно, весь синтаксис «ДокуВики» можно использовать и в комментариях. Но есть проблемы с заголовками и сносками, поскольку они могут создавать конфликтующие идентификаторы и, следовательно, неверный XHTML. Я ищу способ либо разрешить только часть синтаксиса вики, либо автоматически создавать уникальные идентификаторы.
Применение
<note warning>Если вы не добавите следующий код в файл main.php вашего шаблона, ссылки для цитирования не появятся!</note>
В main.php добавьте следующее в начало файла:
<?php if (file_exists(DOKU_PLUGIN.'cite/code.php')) include_once(DOKU_PLUGIN.'cite/code.php'); ?>
Чтобы отобразить постоянную ссылку или ссылку для цитирования в любой точке документа, используйте в качестве примера следующий код:
<?php if (function_exists('cite_getPermURL')) { ?><a href="<?php echo cite_getPermURL(); ?>" rel="nofollow">Permanent Link</a><?php } ?> <?php if (function_exists('cite_getCiteURL')) { ?><a href="<?php echo cite_getCiteURL(); ?>" rel="nofollow">Cite this Page</a><?php } ?>
Мой совет — сохранить rel="nofollow"
нетронутым, так как это гарантирует, что поисковые системы не будут индексировать цитаты.
Установите параметры для этого плагина через меню «Настройки конфигурации» в меню администратора «ДокуВики». (Он будет внизу страницы.)
Конфигурация
Плагин можно настроить с помощью менеджера конфигурации «ДокуВики», доступного в меню администратора.
automatic | автоматически включает обсуждения на всех страницах |
---|---|
excluded_ns | список пространств имен, для которых нужно отменить automatic настройку конфигурации (регулярное выражение, например /(playground|wiki)/ , разделитель должен быть включен, например, '/' в начале и в конце) |
visibilityButton | Включить кнопку для переключения видимости всего раздела обсуждения |
allowguests | allow/disallow (разрешить/запретить) незарегистрированным пользователям оставлять комментарии |
showguests | show/hide (показать/скрыть) комментарии для незарегистрированных пользователей |
linkmail | связать имя пользователя с указанным почтовым адресом |
useavatar | отображать аватары (требуется плагин Avatar) |
urlfield | разрешить отправку URL-адреса домашней страницы (будет связан с именем, если не linkmail установлено) |
addressfield | разрешите указать адрес |
adminimport | администратор может заполнить все поля (только для импорта) |
wikisyntaxok | allow wiki syntax in comments1) |
threads_formposition | позиция новой формы потока, показанная с синтаксисомe {{threads> }} (до или под списком потоков) |
subscribe | разрешить подписку на комментарии (использует двойную подписку), если используются подписки на страницы , они используются только для незарегистрированных пользователей. |
newestfirst | Инвертировать порядок отображения комментариев |
usethreading | включить/отключить цепочку комментариев |
userealname | отображать настоящее имя вместо имени пользователя зарегистрированных пользователей вики |
moderate | модерировать новые комментарии |
moderatorgroups | добавить группы для делегирования административного контроля (например @coadmins,@mods ) |
moderatorsnotify | отправлять уведомление всем указанным модераторам всякий раз, когда был отправлен новый комментарий |
Обновление
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
Файл для загрузки
Лицензия
- License: GNU GPL v2