Плагин XMenu для NG-CMS

Описание плагина

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

Основные возможности:

• Поддержка до 9 независимых меню
• Гибкая система привязки категорий
• Оптимизированное кеширование для быстрой работы
• Поддержка пользовательских шаблонов
• Возможность отображения количества новостей в категориях

Установка плагина

1. Загрузка плагина
   
   Поместите папку плагина в директорию:
   
   /engine/plugins/
2. Активация плагина
   
   В административной панели перейдите:
   
   Настройки → Плагины → XMenu → Активировать
3. Настройка меню
   
   После активации перейдите:
   
   Настройки → XMenu → Конфигурация

Настройка плагина

Привязка категорий к меню

В разделе конфигурации вы увидите таблицу всех категорий сайта. Для каждой категории можно указать, в каких меню она должна отображаться:

• # - категория отображается в меню
• _ - категория скрыта в меню

Каждый столбец соответствует номеру меню (от 1 до 9).

Дополнительные настройки

Использование в шаблонах

Для вывода меню используйте TWIG-функцию callPlugin():

  {{ callPlugin('xmenu.show', {
    menu_id: 1,             // Обязательный параметр (1-9)
    template: 'custom_menu', // Необязательно (по умолчанию 'xmenu')
    show_news: 1,           // Необязательно (1 - показывать кол-во новостей)
    debug: 0                // Необязательно (1 - включить режим отладки)
}) }}

Параметры вызова:

Шаблоны меню

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

1. В шаблоне сайта: /templates/ВАШ_ШАБЛОН/plugins/xmenu/
2. В папке плагина: /engine/plugins/xmenu/tpl/

Стандартный шаблон (xmenu.tpl)

   <ul class="xmenu menu-{{ menu_id }}">
    {% for item in items %}
        <li class="{{ item.active ? 'active' : '' }}">
            <a href="{{ item.url }}">{{ item.name }}</a>
            {% if show_news and item.news_count > 0 %}
                <span class="news-count">({{ item.news_count }})</span>
            {% endif %}
        </li>
    {% endfor %}
</ul>

Доступные переменные в шаблонах

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

1. Простое меню

{{ callPlugin('xmenu.show', {menu_id: 1}) }}

2. Меню с кастомным шаблоном

{{ callPlugin('xmenu.show', {
    menu_id: 2,
    template: 'custom_menu'
}) }}

3. Меню без подсчета новостей

{{ callPlugin('xmenu.show', {
    menu_id: 3,
    show_news: 0
}) }}

4. Меню с отладкой

{{ callPlugin('xmenu.show', {
    menu_id: 1,
    debug: 1
}) }}

Рекомендации

Плагин XMenu предоставляет полный контроль над отображением меню через мощную TWIG-систему, позволяя создавать меню любой сложности с минимальными затратами ресурсов.