menu_firstchild.module in Menu Firstchild 6
Same filename and directory in other branches
menu_firstchild.module Main file for the menu_firstchild module.
By default, Drupal 6 requires that you enter a path for each menu link you add/edit from the Menu administration page. There are cases you may want to create a parent item, without any path, that simply links to its first viewable child item. Menu Firstchild provides this functionality. Developped by Henri MEDOT <henri.medot[AT]absyx[DOT]fr> http://www.absyx.fr
File
menu_firstchild.moduleView source
<?php
/**
* @file menu_firstchild.module
* Main file for the menu_firstchild module.
*
* By default, Drupal 6 requires that you enter a path for each menu link you add/edit from the Menu administration page.
* There are cases you may want to create a parent item, without any path, that simply links to its first viewable child item.
* Menu Firstchild provides this functionality.
* Developped by Henri MEDOT <henri.medot[AT]absyx[DOT]fr>
* http://www.absyx.fr
*/
/**
* Implementation of hook_menu().
*/
function menu_firstchild_menu() {
$items['<firstchild>'] = array(
'page callback' => '_menu_firstchild_menu',
'access callback' => TRUE,
'type' => MENU_CALLBACK,
);
return $items;
}
function _menu_firstchild_menu() {
return drupal_not_found();
}
/**
* Implementation of hook_menu_link_alter().
*/
function menu_firstchild_menu_link_alter(&$item, $menu) {
if ($item['module'] == 'menu') {
if ($item['link_path'] == '<firstchild>') {
$item['options']['alter'] = TRUE;
$item['options']['unaltered_hidden'] = $item['hidden'];
}
else {
unset($item['options']['unaltered_hidden']);
}
}
}
/**
* Implementation of hook_translated_menu_link_alter().
*/
function menu_firstchild_translated_menu_link_alter(&$item, $map) {
if ($item['module'] == 'menu' && $item['link_path'] == '<firstchild>') {
$href = _menu_firstchild_get_firstchild_href($item['mlid']);
if ($href != NULL) {
$item['href'] = $href;
if (isset($item['localized_options']['attributes']['class'])) {
$item['localized_options']['attributes']['class'] .= ' menu-firstchild';
}
else {
$item['localized_options']['attributes']['class'] = 'menu-firstchild';
}
}
else {
$item['hidden'] = TRUE;
}
}
}
function _menu_firstchild_get_firstchild_href($mlid) {
global $language;
$result = db_query("SELECT mlid, link_path FROM {menu_links} WHERE plid = %d ORDER BY weight, link_title", $mlid);
while ($m = db_fetch_array($result)) {
if ($m['link_path'] != '<firstchild>') {
$child = menu_link_load($m['mlid']);
if (!empty($child['access']) && empty($child['hidden']) && (!isset($child['localized_options']['langcode']) || $child['localized_options']['langcode'] == $language->language)) {
return $m['link_path'];
}
}
else {
$href = _menu_firstchild_get_firstchild_href($m['mlid']);
if ($href != NULL) {
return $href;
}
}
}
return NULL;
}
/**
* Implementation of hook_form_alter().
*/
function menu_firstchild_form_alter(&$form, $form_state, $form_id) {
if ($form_id == 'menu_overview_form') {
foreach ($form as $key => $value) {
if (isset($value['#item']['href']) && $value['#item']['href'] == '<firstchild>') {
$item = $value['#item'];
$unaltered_hidden = $item['options']['unaltered_hidden'];
$form[$key]['#item']['hidden'] = $unaltered_hidden;
$form[$key]['hidden']['#default_value'] = !$unaltered_hidden;
$form[$key]['#attributes']['class'] = $unaltered_hidden ? 'menu-disabled' : 'menu-enabled';
$form[$key]['title']['#value'] = check_plain($item['title']) . ($unaltered_hidden ? ' (' . t('disabled') . ')' : '');
}
}
}
elseif ($form_id == 'menu_edit_item' && isset($form['menu']['link_path'])) {
$form['menu']['link_path']['#description'] .= t(' Enter %firstchild to link to the item\'s first accessible child.', array(
'%firstchild' => '<firstchild>',
));
if (isset($form['menu']['#item']['options']['unaltered_hidden'])) {
$form['menu']['enabled']['#default_value'] = !$form['menu']['#item']['options']['unaltered_hidden'];
}
}
}
Functions
Name | Description |
---|---|
menu_firstchild_form_alter | Implementation of hook_form_alter(). |
menu_firstchild_menu | Implementation of hook_menu(). |
menu_firstchild_menu_link_alter | Implementation of hook_menu_link_alter(). |
menu_firstchild_translated_menu_link_alter | Implementation of hook_translated_menu_link_alter(). |
_menu_firstchild_get_firstchild_href | |
_menu_firstchild_menu |