Часто встречающиеся задачи

В настоящем разделе рассмотрены некоторые типичные подходы к часто встречающимся задачам, которые приходится решать разработчикам при работе с меню.

Назначение обратных вызовов без добавления ссылки в меню

Часто бывает необходимо создать отображение URL-адреса на функцию без создания видимого элемента меню. Например, веб-форма может иметь функцию JavaScript, которой нужно получить из Drupal список состояний — поэтому требуется связать URL и PHP-функцию, но все это не должно отображаться ни в одном навигационном меню. Это делается назначением элементу меню типа MENU_CALLBACK, как в первом примере в данной главе.

Вывод элементов меню в виде вкладок

Обратный вызов, который отображается в виде вкладки, называется локальной задачей (local task) и имеет тип MENU_LOCAL_TASK или MENU_DEFAULT_LOCAL_TASK. Заголовок локальной задачи должен быть коротким глаголом, таким как “add” (добавить) или “list” (перечислить). Локальные задачи ведут себя как некоторая разновидность объектов, вроде ноды или пользователя. Их можно считать семантическими объявлениями элемента меню, который обычно отображается в виде вкладки — примерно так же, как дескриптор является семантическим объявлением и обычно отображается как полужирный шрифт. Для отображения вкладок у локальных задач должен быть родительский элемент. Обычно назначается обратный вызов корневому пути вроде milkshake, а затем локальные задачи назначаются путям, расширяющим этот путь — вроде milkshake/prepare, milkshake/drink и т.п. В Drupal имеется встроенная поддержка тем для двух уровней локальных задач в виде вкладок. (Базовая система поддерживает и дополнительные уровни, но тогда тема должна обеспечить поддержку их отображения.) Порядок отображения вкладок определяется алфавитным упорядочением заголовков элементов меню. Если он вас не устраивает, элементам меню можно назначить весовые ключи, и тогда элементы будут упорядочены по весам. Приведенный ниже пример содержит код для вывода двух главных вкладок и двух вложенных вкладок для стандартной локальной задачи. Создайте файл sites/all/modules/custom/milkshake/milkshake.info со следующим содержимым:

name = Milkshake
description = Demonstrates menu local tasks.
package = Pro Drupal Development
core = 7.x
files[] = milkshake.module

Затем создайте файл sites/all/modules/custom/milkshake/milkshake.module:

<?php
/**
* @file
* Модуль для изучения системы меню Drupal, в частности, локальных задач.
*/

/**
* Реализация hook_menu().
*/

function milkshake_menu() {

 $items['milkshake'] = array(
 'title' => 'Milkshake flavors',
 'access arguments' => TRUE,
 'page callback' => 'milkshake_overview',
 'type' => MENU_NORMAL_ITEM,
 );

 $items['milkshake/list'] = array(
 'title' => 'List flavors',
 'access arguments' => TRUE,
 'type' => MENU_DEFAULT_LOCAL_TASK,
 'weight' => 0,
 );

 $items['milkshake/add'] = array(
 'title' => 'Add flavor',
 'access arguments' => TRUE,
 'page callback' => 'milkshake_add',
 'type' => MENU_LOCAL_TASK,
 'weight' => 1,
 );

 $items['milkshake/list/fruity'] = array(
 'title' => 'Fruity flavors',
 'access arguments' => TRUE,
 'page callback' => 'milkshake_list',
 'page arguments' => array(2), // Передается 'fruity'.
 'type' => MENU_LOCAL_TASK,
 );

 $items['milkshake/list/candy'] = array(
 'title' => 'Candy flavors',
 'access arguments' => TRUE,
 'page callback' => 'milkshake_list',
 'page arguments' => array(2), // Передается 'candy'.
 'type' => MENU_LOCAL_TASK,
 );

 return $items;
}

function milkshake_overview() {

 $output = t('The following flavors are available...');
 // ... какой-то код
 return $output;
}

function milkshake_add() {
 return t('A handy form to add flavors might go here...');
}

function milkshake_list($type) {
 return t('List @type flavors', array('@type' => $type));
}

Сокрытие существующих элементов меню

/**
* Реализация hook_menu_link_alter().
*/
function menufun_menu_link_alter(&$item) {
 // Сокрытие ссылки Create content.
 if ($item['link_path'] == 'node/add') {
 $item['hidden'] = 1;
 }
}

Использование menu.module

Распространенные ошибки