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

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

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

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

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

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

1. Загрузка плагина
   
   Поместите папку плагина в директорию:
   
   

   /engine/plugins/

2. Активация плагина
   
   В административной панели перейдите:
   
   

   Настройки → Плагины → XMenu → Активировать

3. Настройка меню
   
   После активации перейдите:
   
   

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

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

Привязка элементов к меню

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

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

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

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

0

1

1

0

3600

1

0

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

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

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

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

menu_id

template

xmenu

show_news

1

show_static

1

debug

0

Шаблоны меню

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

1. В шаблоне сайта:

   /templates/ВАШ_ШАБЛОН/plugins/xmenu/

2. В папке плагина:

   /engine/plugins/xmenu/tpl/

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

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

<style>
    .xmenu .static { color: #4a6ea9; }
    .xmenu .category { color: #333; }
    .xmenu .active { font-weight: bold; }
    .news-count { font-size: 0.8em; color: #666; }
</style>

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

items

items[].type

category

static

items[].id

items[].name

items[].url

items[].active

items[].news_count

items[].alt_name

menu_id

show_news

show_static

tpl_url

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

1. Простое меню с категориями и статикой

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

2. Меню только со статическими страницами

{{ callPlugin('xmenu.show', {
    menu_id: 2,
    show_news: 0,
    show_static: 1
}) }}

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

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

4. Меню только с категориями

{{ callPlugin('xmenu.show', {
    menu_id: 4,
    show_static: 0
}) }}

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

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