Инструменты пользователя

Инструменты сайта

  • Показать исходный текст
  • История страницы
  • Ссылки сюда
  • Оставить на чай
  • Экспорт в PDF
  • Наверх

  • wiki:plugin:discussion

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

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

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

    Совместимость

    Пожалуйста, сообщайте об ошибках или пожеланиях в 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}}
    [namespace] пространство имен, для которого вы хотите список потоков обсуждения; : это верхнее пространство имен, . это то же пространство имен, в котором находится страница * вся вики необходимый
    [count=n] количество обсуждений, которые должны отображаться (допустимые значения: n > 0) необязательный
    [flags] флаги списка страниц, разделенные &см. флаги необязательный
    skipempty Не печатать обсуждения без комментариев необязательный
    nonewthreadform Не показывать новую форму формы темы под таблицей необязательный

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

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

    Конфигурация

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

    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 и установите новую версию, как указано выше.

    Файл для загрузки

    Лицензия

    1)
    Снимите флажок с этого параметра, чтобы избежать проблем с плагином Struct.

    Обсуждение

    Ваш комментарий:

    Внимание! Оставляя комментарий Вы соглашаетесь с пониманием и несете ответственность за свои действия гл.2 ст.18 Федерального закона №38-ФЗ «О рекламе» и ст.3 п.1 Федерального закона №152-ФЗ «О персональных данных»
    126 -1 =​
     
    wiki/plugin/discussion.txt · Последнее изменение: 2023/08/10 21:17 — vladpolskiy