Произвольное меню в WP 3.0+ (wp_nav_menu)

Коротко о главном

Уже широко известно, что в WordPress 3.0 добавлена поддержка произвольных меню (настраиваемых меню). Вещь, на мой взгляд, крайне удобная и полезная. Собственно, отсюда и эта статья.

Удобство заключается в том, что теперь можно создавать и конфигурировать менюшки прямо из админки, добавляя ссылки кликами по чекбоксам и меняя порядок ссылок простым их перетаскиванием. В меню можно добавить ссылки на страницы, категории и отдельные посты. Можно создавать многоуровневые меню, так же в меню можно добавлять свои ссылки (обычно внешние) - ссылки о которых WordPress не знает. В общем, полная свобода действий.

Однако, чтобы такая "свобода" была доступна, нужно настроить вывод произвольного меню в шаблон, чтобы потом управлять им из админки, так скажем, легким движением мышки

Использовать такие меню будет крайне удобно, если пользоваться мультисайтовой возможностью WordPress, потому что для разных сайтов можно будет настраивать разные меню, а шаблон для них использовать один.

Итак, приступим.

Включаем поддержку произвольных меню (wp_nav_menu)

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

register_nav_menus(array(
    'top' => 'Верхнее меню',            //Название месторасположения меню в шаблоне
    'bottom' => 'Нижнее меню'   //Название другого месторасположения меню в шаблоне
));

Сейчас мы зарегистрировали 2 меню с идентификаторами  'top' и 'bottom', с соответствующими им названиями (можно кириллицой). Идентификаторы нужны будут, чтобы обращаться к определенному меню через функцию вывода wp_nav_menu. Названия месторасположений мы увидим в админке, когда зайдем в раздел редактирования произвольных меню (Внешний вид -> Меню). Там же мы будем привязывать какое, созданное нами, меню где должно располагаться.

После того, как меню зарегистрированы, идем в админку и создаем  свои меню (в данном примере 2 менюшки): даем им названия (функция wp_nav_menu может выводить по этому названию), слева, выбираем где будет расположено меню, так как мы зарегистрировали 2 менюшки "top", "bottom", у нас будет 2 варианта: "Верхнее меню" и "Нижнее меню". Слева ниже добавляем ссылки.

Вывод произвольных меню через функцию wp_nav_menu

Меню зарегистрированы и созданы, осталось их интегрировать в шаблон. Делается это функцией wp_nav_menu(), которая может принимать следующие параметры (аргументы):

$args = array(
  'menu'            => '',              //(string) Название выводимого меню (указывается в админке при создании меню, приоритетнее чем указанное местоположение theme_location - если указано, то параметр theme_location игнорируется)
  'container'       => 'div',           //(string) Контейнет меню. Обворачиватель ul. Указывается тег контейнера (по умолчанию в тег div)
  'container_class' => '',              //(string) class контейнера (div тега)
  'container_id'    => '',              //(string) id контейнера (div тега)
  'menu_class'      => 'menu',          //(string) class самого меню (ul тега)
  'menu_id'         => '',              //(string) id самого меню (ul тега)
  'echo'            => true,            //(boolean) Выводить на экран или возвращать для обработки
  'fallback_cb'     => 'wp_page_menu',  //(string) Используемая (резервная) функция, если меню не существует (не удалось получить)
  'before'          => '',              //(string) Текст перед <a> каждой ссылки
  'after'           => '',              //(string) Текст после </a> каждой ссылки
  'link_before'     => '',              //(string) Текст перед анкором (текстом) ссылки
  'link_after'      => '',              //(string) Текст после анкора (текста) ссылки
  'depth'           => 0,               //(integer) Глубина вложенности (0 - неограничена, 2 - двухуровневое меню)
  'walker'          => ,                //(object) Класс собирающий меню. Default: new Walker_Nav_Menu
  'theme_location'  => '');             //(string) Расположение меню в шаблоне. (указывается ключь которым было зарегистрировано меню в функции register_nav_menus)

В данном примере в шаблон нужно вставить примерно (зависит от необходимых вам параметров) такие, 2 кода:
1. Вставляем в шапку шаблона (header.php), там где будет выводится верхнее (top) меню:

<?php Array(
         'menu_class'=>'menu',
         'theme_location'=>'top',
         'after'=>' /'
         );
wp_nav_menu($args);
?>

Выведет созданное в админке меню, прикрепленное к расположению "Верхнее меню" с такой структурой:

	<div class='<классы WP>'>
		<ul class='menu'>
			<li><a class='<классы WP>' href="#">Анкор ссылки</a> /</li>
			<li><a class='<классы WP>' href="#">Анкор ссылки</a> /</li>
			<li><a class='<классы WP>' href="#">Анкор ссылки</a> /</li>
		</ul>
	</div>

2. Вставляем в подвал шаблона (footer.php), там где будет выводится нижнее (bottom) меню:

	<?php wp_nav_menu('menu_class=bmenu&theme_location=bottom'); ?>

Выведет созданное в админке меню, прикрепленное к расположению "Нижнее меню". Структура будет идентичная первой.

Выводим меню по названию

Чтобы вывести меню по его названию можно воспользоваться аргументом 'menu'. Название нужно указывать, то под которым создавалось меню в админке. Пример:

<?php wp_nav_menu('menu=Название меню'); ?>

Тонкости

Вы наверное обратили внимание, что меню "оборачивается", часто, ненужным тегом div. Его можно удалить, указав в аргументах для функции wp_nav_menu пустой параметр 'container'=>''. Или, чтобы постоянно не обнулять этот аргумент, можно переопределить аргументы по умолчанию при регистрации меню в functions.php, делается это через фильтр wp_nav_menu_args, так:

register_nav_menus(array(
    'top' => 'Верхнее меню'
    ,'bottom' => 'Нижнее меню'
));
function my_wp_nav_menu_args($args=''){
	$args['container'] = '';
	return $args;
} // function
add_filter( 'wp_nav_menu_args', 'my_wp_nav_menu_args' );

добавляя в функцию my_wp_nav_menu_args строки $args['аргумент']='значение', можно создать свои аргументы по умолчанию.

В WordPress так же есть, функция условия: has_nav_menu('primary'); - проверяет было ли указано меню для расположения primary. Если меню не указано, то функция wp_nav_menu() сработает, как wp_list_pages(), но "обворачиватель" div останется, несмотря на то что в аргументах мы его убрали. Решить эту проблему можно так:

if (has_nav_menu('top')){
  wp_nav_menu( array(
	'container' => '',
        'theme_location' => 'top',
        'menu_class' => 'menu')
	);
  } else {
	echo '<ul class="menu">';
	wp_list_pages( array('depth' => 1, 'title_li' => '' ));
	echo '</ul>';
  }

Из всех передаваемых аргументов, непонятным является walker. Для тех, кто хочет разобраться для чего он нужен и с чем его едят, советую прогуляться до этой статьи (знания php обязательны). Там коротко и ясно описан принцип. От себя коротко скажу, что с его помощью можно внедрится в процесс генерации меню и изменить его как угодно, правда для этого понадобятся знания в PHP.