worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======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-файл
  - распаковать его в<dokuwiki>/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'' настройку, чтобы переместить его в начало списка или отключить эту форму.


=====Применение=====
<note warning>Если вы не добавите следующий код в файл main.php вашего шаблона, ссылки для цитирования не появятся!</note>

В main.php добавьте следующее в начало файла:
<code php><?php if (file_exists(DOKU_PLUGIN.'cite/code.php')) include_once(DOKU_PLUGIN.'cite/code.php'); ?></code>

Чтобы отобразить постоянную ссылку или ссылку для цитирования в любой точке документа, используйте в качестве примера следующий код:
<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 } ?></code>

Мой совет — сохранить ''%%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]]