Все о Wayfinder

WayFinder(с англ. - искатель пути) — это сниппет для MODx который предназначен для генерации меню(списков ссылок) и т.п. Функционально он очень обширен. Что можно сделать с его помощью:

1. Одно и многоуровневые меню, статичные меню, всплывающие под-меню.
2. Динамическое добавление классов в каждый пункт меню.
3. Добавить шаблоны для разных видов ссылки (текущая, родительская и т.д.)
    

Примеры использования Wayfinder:

Простое меню:

Здесь 10 - это папка из которой нужно вывести документы в меню. Результатом будет неупорядоченный список.

Карта сайта:

Здесь 0 - это корень сайта. Результатом будет многоуровневый неупорядоченный список. Пример такой карты

Дочерные документы: Если нужно вывести дочерние документы от текущего конструкция должна выглядеть так:

Результатом будет неупорядоченный список.

Параметры:

• startId — папка контейнер откуда будут браться ссылки (возможные значения: ID папки)
• sortBy — параметр по которому будет идти сортировка (возможные значения: id | menutitle | pagetitle | introtext | menuindex | pub_date | published | hidemenu | parent | isfolder | description | alias | longtitle | type | template)
• sortOrder — порядок сортировки, т.е. в каком напрявлении будет происходить сортировка (возможные значения: ASC | DESC)
• hereClass — css-класс для активного пункта меню
• firstClass — css-класс для первого пункта меню
• lastClass — css-класс для последнего пункта меню
• rowClass — css-класс для всех пунктов меню
• outerClass — css-класс для контейнера меню
• innerClass — css-класс для под-пунктов меню
• hideSubMenus — Скрывать подменю и выводить для активного пункта(возможные значения: true | false )
• includeDocs — включить в меню произвольные документы(возможные значения: ID документа)
• excludeDocs — исключить из меню произвольные документы(возможные значения: ID документа)

Шаблоны:

Бывают разные шаблоны для WayFinder. Шаблон - это чанк с определенным Html-кодом который разбавлен динамическими постановщиками(плейсхолдерами - placeholder). Плейсхолдер это специальный тег под который после подставляется динамическое содержимое. Выглядит конструкция постановщика так: [+placeholder+]. Название шаблона это его параметр при вызове Wayfinder (например если нужно задать шаблон outerTpl, то вызвать надо так [!Wayfinder? &outerTpl=`чанк`!])

1) outerTpl — шаблон всего контейнера меню. Классически выглядит так:

2) rowTpl — шаблон пункта меню. По умолчанию такой:

3) innerTpl — шаблон контейнера под-меню. Вот так выглядит без изменений:

4) innerRowTpl — шаблон под-пунктов. Пример:

5) hereTpl — шаблон активного пункта меню. Пример:

Плейсхолдеры для шаблонов:

• [+wf.classes+] — будет заменен классом (включая class=" ")
• [+wf.classnames+] — будет заменен именем класса (без class=" ")
• [+wf.link+] — место для гиперссылки (значения href)
• [+wf.title+] — место для текста атрибута title для ссылки
• [+wf.linktext+] — место вставки текста гиперссылки
• [+wf.wrapper+] — место вставки подменю
• [+wf.id+] — место вставки уникального id
• [+wf.attributes+] — место вставки атрибутов ссылки
• [+wf.docid+] — место вставки идентификатора текущего документа
• [+wf.description+] — описание документа