Discussion для «ДокуВики»

Добавляет раздел комментариев на вики-страницы. Плагин обсуждения добавляет раздел обсуждения после вашей вики-страницы для комментариев пользователей. Это полезно для разделения содержимого страницы и его обсуждения, а также, если вы не хотите давать обычным пользователям право редактировать страницу, но по-прежнему хотите, чтобы заметки добавлялись пользователями.

Второй компонент этого подключаемого модуля показывает список всех страниц в пространстве имен с разделом обсуждения (называемым ветками обсуждения), упорядоченным по самым последним комментариям. Это позволяет вам создать очень простой дискуссионный форум в вашей вики.

• Релиз: 2020-09-22.
• Репозиторий:https://github.com/dokufreaks/plugin-discussion
• Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Пожалуйста, сообщайте об ошибках или пожеланиях в Bug tracker.

Используйте менеджер плагинов для установки или…

1. скачать zip-файл
2. распаковать его в<dokuwiki>/lib/plugins/
3. войдите как администратор и измените плагин в менеджере конфигурации

Это основная часть плагина. При включении ~~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}}

По умолчанию новая форма потока отображается под списком. См. threads_formposition настройку, чтобы переместить его в начало списка или отключить эту форму.

<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"нетронутым, так как это гарантирует, что поисковые системы не будут индексировать цитаты.

Установите параметры для этого плагина через меню «Настройки конфигурации» в меню администратора «ДокуВики». (Он будет внизу страницы.)

Плагин можно настроить с помощью менеджера конфигурации «ДокуВики», доступного в меню администратора.

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

discussion.zip

• Author: Michael Hamann, Gina Häußge, Michael Klier
• License: GNU GPL v2