Home › API reference › menu.inc

menu_link_maintain

  1. drupal
    1. 6
    2. 7
Versions
6 – 7 menu_link_maintain($module, $op, $link_path, $link_title)

Insert, update or delete an uncustomized menu link related to a module.

Parameters

$module The name of the module.

$op Operation to perform: insert, update or delete.

$link_path The path this link points to.

$link_title Title of the link to insert or new title to update the link to. Unused for delete.

Return value

The insert op returns the mlid of the new item. Others op return NULL.

Related topics

Menu system
Define the navigation menus, and route page requests to code based on URLs.

▸ 1 function calls menu_link_maintain()

▾ 1 function calls menu_link_maintain()

aggregator_save_category in drupal/modules/aggregator/aggregator.module
Add/edit/delete aggregator categories.

Code

drupal/includes/menu.inc, line 3232

<?php
function menu_link_maintain($module, $op, $link_path, $link_title) {
  switch ($op) {
    case 'insert':
      $menu_link = array(
        'link_title' => $link_title, 
        'link_path' => $link_path, 
        'module' => $module,
      );
      return menu_link_save($menu_link);
      break;
    case 'update':
      $result = db_query("SELECT * FROM {menu_links} WHERE link_path = :link_path AND module = :module AND customized = 0", array(':link_path' => $link_path, ':module' => $module))->fetchAll(PDO::FETCH_ASSOC);
      foreach ($result as $link) {
        $link['link_title'] = $link_title;
        $link['options'] = unserialize($link['options']);
        menu_link_save($link);
      }
      break;
    case 'delete':
      menu_link_delete(NULL, $link_path);
      break;
  }
}
?>