Определяет навигационные меню и преобразует запросы страниц в вызовы функций, привязанные к путям на сайте.

Система меню Друпала управляет как навигационной системой c точки зрения пользователя, так и callbackсистемой, которую Друпал использует, чтобы реагировать на URL полученный из браузера. Поэтому, правильное понимание системы меню является основой для создания сложных модулей.

Система меню Друпала поддерживает простую иерархию определяемую путями. Реализации hook_menu()определяют пункты меню и назначают им пути (которые должны быть уникальными). Система меню собирает эти пункты и определяет иерархию меню из путей. Например, если пути определены как a, a/b, e, a/b/c/d, f/g, и a/b/h, то система меню сформирует следующую структуру:

• a
  • a/b
    • a/b/c/d
    • a/b/h
• e
• f/g

Обратите внимание: число составных частей в пути не обязательно определяет глубину пункта меню в дереве.

В ответ на запрос страницы, система меню проверяет был ли путь, который запросил браузер, зарегистрирован как пункт меню с коллбеком (функцией, отвечающей данному пути). Если нет, то система продолжает искать в дереве меню наиболее полное совпадение (с коллбеком), которое можно найти. Если путь a/b/i был запрошен в дереве, показанном выше, будет использован коллбек для a/b.

Коллбек найденного пункта меню, вызывается с аргументами, в порядке, указанном в 'page arguments'спецификации этого пункта меню. Атрибуты должны быть помещены в массив. После этих аргументов, к компонентам указанного пути добавляются дополнительные аргументы. Таким образом, колбек a/b в приведенном примере может отдавать страницу a/b/i по другому, чем a/b/j.

Для иллюстрации этого процесса, смотрите page_example.module.

Доступ к функциям обратного вызова также определяется системой меню. Коллбек доступа ('access callback') с необязательными аргументами доступа ('access arguments') каждого пункта меню, вызывается перед тем как будет выполнен коллбек страницы. Если возвращается TRUE, то доступ разрешён; если FALSE, то доступ запрещён. Пункты меню могут пропускать этот атрибут, чтобы использовать значение, которое предоставляет родительский пункт.

В интерфейсе Друпал по умолчанию, вы найдёте много ссылок, которые показаны как вкладки. В системе меню они называются локальные задачи (local tasks) и по-умолчанию отображаются как вкладки (хотя и есть возможность представить их по-другому). Локальные задачи работают также, как и другие пункты меню во многих аспектах. Есть соглашение о том, что эти задачи должны быть описаны как можно более короткими глаголами. В дополнение, локальная задача по-умолчанию должна быть в каждом наборе. При посещении родительского пункта меню локальной задачи, локальная задача по умолчанию будет показана, как-будто она была выбрана. Этого требует обычный опыт работы со вкладками пользователя. Эта задача по умолчанию особенная, потому что она указывает не путь, который она представляет, а путь, который указывает на родительский пункт. Путь задачи по умолчанию используется только, чтобы соответственно расположить её в в иерархии меню.

Все, описанное выше, хранится в таблице 'menu_router'. Видимые ссылки меню хранятся в таблице'menu_links'. По умолчанию они получены из тох же самых определений через hook_menu(), но вы можете свободно добавлять ещё через menu_link_save().

Константы

Функции

Источник: drupal.ru