WP eLDeR MegaMenu документация v1.0.1 Вся документация Купить плагин
Документация › Шорткоды и код

PHP-функции и ручная интеграция

Функции для вставки мегаменю в шаблоны темы и для чтения настроек плагина из своего кода.

eldermenu() — вывести меню

PHP
eldermenu( string $config_id = 'main', array $args = array() )

Выводит мегаменю. $args — те же аргументы, что у wp_nav_menu() WordPress: theme_location, menu, echo, container_id и другие.

PHP
<?php
// Меню основной конфигурации в области темы primary
eldermenu( 'main', array( 'theme_location' => 'primary' ) );

// Конкретное меню в конфигурации catalog
eldermenu( 'catalog', array( 'menu' => 'Каталог' ) );

// Получить HTML строкой
$html = eldermenu( 'main', array( 'menu' => 165, 'echo' => false ) );

Как заменить меню темы вручную

  1. Найдите в шаблоне темы (чаще всего header.php) вызов wp_nav_menu( … 'theme_location' => 'primary' … ). Подсказку, из какого файла выводится меню, даёт «Найти backtrace шаблона темы».
  2. Замените его на <?php eldermenu( 'main', array( 'theme_location' => 'primary' ) ); ?>.
  3. Правьте не саму тему, а дочернюю тему — иначе обновление темы сотрёт изменения.
PHP
<?php if ( function_exists( 'eldermenu' ) ) {
	eldermenu( 'main', array( 'theme_location' => 'primary' ) );
} else {
	wp_nav_menu( array( 'theme_location' => 'primary' ) );
} ?>
Проверка function_exists() защищает сайт от ошибки, если плагин отключат.

eldermenu_toggle() — кнопка мобильного меню

PHP
eldermenu_toggle( string $target = '_any_', string $config_id = 'main', bool $echo = true, array $args = array() )
Ключ $argsПо умолчаниюНазначение
toggle_contentMenuтекст кнопки; {{menu_title}} заменяется названием меню
icon_classbarsиконка Font Awesome
icon_styleiconburger — анимированный «бургер»
tagaтег кнопки
close_iconbarstimes — крестик при открытом меню
align, content_alignfull, leftвыравнивание кнопки и текста
skin, classes, toggle_idскин, свои классы, ID
PHP
<?php eldermenu_toggle( '_any_', 'main', true, array(
	'toggle_content' => 'Каталог',
	'icon_style'     => 'burger',
	'tag'            => 'button',
) ); ?>
PHP
eldermenu_searchbar( $placeholder = null, $post_type = '', $search_field_id = 'eldermenu-search-field', $search_label_sr = null, $button_text_sr = null, $autofocus = true, $autocomplete = 'on' )

Печатает ту же форму, что шорткод [eldermenu-search].

eldermenu_op() — прочитать настройку

PHP
eldermenu_op( string $option, string $section, mixed $default = null )

$section — идентификатор конфигурации (main, footer…) или general для Общих настроек. $option — ключ настройки; он показан серым в каждой карточке настроек этой документации.

PHP
<?php
$skin       = eldermenu_op( 'skin', 'main' );              // light, dark, accent, minimal, none
$breakpoint = eldermenu_op( 'responsive_breakpoint', 'general' ); // '' = 959
$sticky_on  = eldermenu_op( 'sticky', 'main' ) === 'on';

eldermenu_is_mobile()

Обёртка над wp_is_mobile(), через которую плагин решает, мобильное ли устройство, для настроек «Отключить на мобильных». Результат меняется фильтром eldermenu_is_mobile.

Виджет «WP eLDeR MegaMenu Navigation»

В Внешний вид→Виджеты есть виджет, который выводит мегаменю в любой области виджетов темы — удобно для вертикального меню в боковой колонке. В нём выбирается конфигурация и меню, либо область меню темы.

Константы wp-config.php

КонстантаНазначение
WP_ELDER_MEGAMENU_DEBUGtrue — вести журнал плагина в wp-content/wp-elder-megamenu.txt (по просьбе техподдержки)