DokuWiki

It's better when it's simple

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

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


ru:plugin:acmenu

AcMenu Plugin

Совместим с «Докувики»

2017-02-19 "Frusterick Manners"

plugin Меню "аккордеон" для пространства имён и связанных страниц.

Последнее обновление:
2017-11-12
Предоставляет
Syntax
Репозиторий
исходный код

Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.

This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.

Теги: menu, navigation

Внимание

:!: URL-адрес репозитория изменен на https://bitbucket.org/tormec/acmenu/src. Если плагин уже установлен, в Менеджере расширений просто нажмите Переустановить для обновления.
Torpedo 2017-10-07 12:25

Описание

AcMenu предоставляет меню в виде «аккордеона», которое отображает содержимое пространств имен в древовидном формате. Дерево будет построено, начиная с пространства имен, где будет прописан синтаксис AcMenu.

Этот плагин учитывает правила ACL и, кроме того, параметры sneaky_index и hidepages, которые поставляются с вашей конфигурацией DokuWiki.

Установка

  • По ссылке:
    • Скопируйте адрес из ссылки «Скачать» из формы вверху этой страницы. Вставьте его в Менеджере Плагинов вашего сайта во вкладке «Ручная установка» в первое поле. Нажмите кнопку «Установить».
  • Скачанный архив:
    • Предложите архив второму полю той же вкладки. Нажмите кнопку «Установить».
    • Распакуйте из архива папку плагина. Правильное наименование папки плагина - в файле plugin.info.txt после указателя base. Переименуйте папку и загрузите на сервер вашего сайта, если понимаете, как это сделать.

Подробности

Синтаксис

На странице боковой панели используйте синтаксис:

<acmenu>

Примеры

Несколько скриншотов, чтобы дать общее представление о конечном результате.

Предположим, вы хотите разделить свою основную вики на две независимые между собой суб-вики:

+--sidebar.txt
+--start.txt
+--branch-a
|  +--sidebar.txt
|  +--start.txt
|  +--products
|  |  +--start.txt
|  +--services
|  |  +--start.txt
|  +--private
|     +--start.txt
|     +--confidential.txt
+--branch-b
   +--sidebar.txt
   +--start.txt
   +--products
   |  +--start.txt
   +--services
   |  +--start.txt
   +--private
      +--start.txt
      +--confidential.txt

Вы можете заполнить каждый sidebar.txt следующим образом:

  • в :sidebar.txt
    <acmenu>
  • в :branch-a:sidebar.txt
    [[..:start| Back to Main]]
    <acmenu>
  • в :branch-b:sidebar.txt
    [[..:start| Back to Main]]
    <acmenu>

Когда посетитель находится в :start.txt, плагин показывает, что полное дерево пространства имён свернуто, за исключением пространства имен, в котором sidebar.txt с синтаксисом AcMenu. В случае, если в браузере посетителя отключён JavaScript, все пространства имён отображают их содержимое, чтобы можно было продолжить навигацию.

Если посетитель решает открыть любое :branch-* или любое его под-пространство имён :branch-*:*, AcMenu показывает только боковую панель относительно выбранной ветви.

Если посетитель является гостем, и у него нет разрешения на вход в любую область :branch-*:private, вы должны установить соответствующее правило в ACL. Кроме того, вы можете скрыть для него пространство имен :branch-*:private, в котором будет установлен параметр sneaky_index в Менеджере конфигурации.

Если посетитель является зарегистрированным пользователем и имеет разрешение на вход в любую область :branch-*:private, но не имеет права просмотра страницы :branch-*:confidential.txt, вы должны установить соответствующее правило в ACL.

Кроме того, можно скрыть все страницы sidebar.txt с помощью опции hidepages в Менеджере конфигурации:

^:(?:.*sidebar)

Поскольку этот плагин использует файлы cookie для запоминания посещенных страниц (они автоматически удаляются, как только окно браузера закрывается), если посетитель возвращается к :start.txt, ветви и их подпространства имён без ограничений будут оставаться таковыми.

Порядок, в котором представлено дерево каталогов, выглядит следующим образом:

  • сначала папки 0-9A-Za-z
  • затем файлы 0-9A-Za-z

Это означает, что, если включена опция useheading, можно принудительно упорядочить порядок файлов, используя прогрессивную нумерацию в первом заголовке каждого файла.

Конфигурация и настройки

Поведение меню

Навигация через пространства имён и ссылки на связанные страницы работает следующим образом:

  • в пространстве имён:
    • один клик: показать/спрятать связанное содержание;
    • двойной клик: открывает связанную стартовую страницу;
  • на странице:
    • один клик: открывает связанную страницу.

Скрыть пространства имён и страницы

Сначала установите соответствующие разрешения в ACL. Затем используйте параметры:

  • sneaky_index: спрятать пространства имён.
  • hidepages: спрятать страницы;

Исправление проблем

Симптом: AcMenu не отображает/не скрывает содержимое пространства имен.

Возможное решение: убедитесь, что JavaScript включен в вашем браузере, иначе все пространства имён остаются открытыми, показывая их содержимое.


Симптом: После открытия любой ссылки AcMenu не оставляет без изменений какое-либо пространство имён.

Возможное решение: убедитесь, что файлы cookie включены в браузере, в противном случае AcMenu забывает пространства имен, которые были раскрыты при загрузке страницы.


Развитие

Все вопросы задавайте на этой странице.

ru/plugin/acmenu.txt · Последнее изменение: 2019-11-19 18:57 — Dr-Yukon

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki