-body #admin-menu-icon { display: none; }
-
+
+ body #admin-menu-icon { display: none; }
2) Alter the image by overriding the theme function:
- Copy the whole function theme_admin_menu_icon() into your template.php,
- rename it to f.e. phptemplate_admin_menu_icon() and customize the output
- according to your needs.
-
- Please bear in mind that admin_menu's output is cached. You need to clear your
- site's cache (via administration menu's link to flush caches,
- admin/settings/performance, or by using Devel module) to see any changes of
- your theme override function.
-
-* You can override the font size by adding a line to your stylesheet in your
- theme like the following:
-
-body #admin-menu { font-size: 10px; }
-
+ Copy the entire theme_admin_menu_icon() function into your template.php,
+ rename it to phptemplate_admin_menu_icon() or THEMENAME_admin_menu_icon(),
+ and customize the output according to your needs.
+
+ Remember that the output of the administration menu is cached. To see changes
+ from your theme override function, you must clear your site cache (via
+ the "Flush all caches" link on the menu).
+
+* To override the font size, add the following line to your theme's stylesheet:
+
+ body #admin-menu { font-size: 10px; }
-- TROUBLESHOOTING --
-* If the administration menu is not displayed, check the following steps:
+* If the menu does not display, check the following:
- - Is admin_menu's "access administration menu" permission enabled?
+ - Are the "access administration menu" and "access administration pages"
+ permissions enabled for the appropriate roles?
- - Is system's "access administration pages" permission enabled?
+ - Does your theme output the $closure variable?
- - Does your theme output $closure? (See FAQ below for more info)
+* If the menu is rendered behind a Flash movie object, add this property to your
+ Flash object(s):
+
+
-* If admin menu is rendered behind a flash movie object, you need to add the
- following property to your flash object(s):
-
-
-
See http://drupal.org/node/195386 for further information.
-- FAQ --
-Q: When admin_menu is enabled, plenty of blank space is added to the bottom of
- my theme. Why?
+Q: When the administration menu module is enabled, blank space is added to the
+ bottom of my theme. Why?
A: This is caused by a long list of links to module issue queues at Drupal.org.
- Just go to Administer >> User management >> Permissions >> admin_menu and
- disable the permission "display drupal links" for your or all roles.
- Since uid 1 always has all permissions, this link list cannot be disabled
- for uid 1.
-
-Q: After upgrading to 6.x-1.x, admin_menu disappeared. Why?
-
-A: This should not happen. If it did, visit
- http://tabs primary and tabs secondary for tabs (like Garland).'),
+ '#description' => t('If enabled, the tabs on the current page are moved into the administration menu. This feature is only available in themes that use the CSS classes tabs primary and tabs secondary for tabs.'),
);
$form = system_settings_form($form);
$form['wipe description'] = array(
'#type' => 'item',
- '#value' => t('If you are seeing a duplicated menu or other problems, you may use this button to delete everything in the menu and rebuild it.'),
+ '#value' => t('If the administration menu displays duplicate menu items, you may need to rebuild your menu items using the Wipe and rebuild button.'),
);
$form['wipe'] = array(
'#type' => 'submit',
@@ -409,24 +409,24 @@ function _admin_menu_devel_settings_form
$form['admin_menu'] = array(
'#type' => 'fieldset',
- '#title' => t('Administration Menu settings'),
+ '#title' => t('Administration menu settings'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$display_options = array('mid', 'weight', 'pid');
- $display_options = array(0 => t('None'), 'mlid' => t('Menu link id'), 'weight' => t('Weight'), 'plid' => t('Parent link id'));
+ $display_options = array(0 => t('None'), 'mlid' => t('Menu link ID'), 'weight' => t('Weight'), 'plid' => t('Parent link ID'));
$form['admin_menu']['admin_menu_display'] = array(
'#type' => 'radios',
- '#title' => t('Display extra information for menu items in Drupal Administration Menu'),
+ '#title' => t('Display additional data for each menu item'),
'#default_value' => variable_get('admin_menu_display', 0),
'#options' => $display_options,
- '#description' => t('If enabled, the chosen information will appear next to each menu item link.'),
+ '#description' => t('Display the selected items next to each menu item link.'),
);
$form['admin_menu']['admin_menu_show_all'] = array(
'#type' => 'checkbox',
'#title' => t('Display all menu items'),
'#default_value' => variable_get('admin_menu_show_all', 0),
- '#description' => t('Enable this option to disable user access checks for menu items, i.e. every menu item in the visible menu tree will be displayed to every user regardless of access permissions.'),
+ '#description' => t('If enabled, all menu items are displayed regardless of your site permissions. Note: Do not enable on a production site.'),
);
}
@@ -443,7 +443,7 @@ function admin_menu_toggle_modules() {
// Re-enable modules that were enabled before.
module_enable($saved_state);
variable_del('admin_menu_devel_modules_enabled');
- drupal_set_message(t('Re-enabled these modules: !module-list.', array('!module-list' => implode(', ', $saved_state))));
+ drupal_set_message(t('Enabled these modules: !module-list.', array('!module-list' => implode(', ', $saved_state))));
$rebuild = TRUE;
}
else {
Index: admin_menu.info
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/admin_menu/admin_menu.info,v
retrieving revision 1.8
diff -u -p -r1.8 admin_menu.info
--- admin_menu.info 18 Oct 2008 17:34:23 -0000 1.8
+++ admin_menu.info 7 Nov 2008 20:09:20 -0000
@@ -1,6 +1,6 @@
; $Id: admin_menu.info,v 1.8 2008/10/18 17:34:23 sun Exp $
-name = "Administration Menu"
-description = "Renders a menu tree for administrative purposes as dropdown menu at the top of the window."
+name = "Administration menu"
+description = "Provides a dropdown menu to most administrative tasks and other common destinations (to users with the proper permissions)."
package = "Administration"
core = 7.x
files[] = admin_menu.module
Index: admin_menu.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/admin_menu/admin_menu.module,v
retrieving revision 1.58
diff -u -p -r1.58 admin_menu.module
--- admin_menu.module 2 Nov 2008 22:22:32 -0000 1.58
+++ admin_menu.module 7 Nov 2008 20:09:20 -0000
@@ -3,7 +3,7 @@
/**
* @file
- * Renders a menu tree for administrative purposes as dropdown menu at the top
+ * Renders a menu tree for administrative purposes as a dropdown menu at the top
* of the window.
*/
@@ -13,25 +13,13 @@
function admin_menu_help($path, $arg) {
switch ($path) {
case 'admin/settings/admin_menu':
- return t('The Administration Menu will appear at the top of the page for users who have been given the "access administration menu" permission. Customize appearance of the dropdown menu here.');
-
+ return t('The administration menu module provides a dropdown menu arranged for one- or two-click access to most administrative tasks and other common destinations (to users with the proper permissions). Use the settings below to customize the appearance of the menu.');
case 'admin/help#admin_menu':
- return t(<<The menu also can display the number of anonymous and authenticated users, -Devel module links, and items generated by -other modules.
-The settings page is where administrators can choose -whether or not to allow the module to shift the page contents down to accommodate -the menu. Depending on the design/layout of your theme, this may cause problems with -the appearance of the page. Changing the '%margin-setting' setting may fix this -issue.
-Please bear in mind that the displayed menu items in Drupal Administration Menu depend on the actual permissions of a user. For example, if a user does not have the permission "@permission-access" and "@permission-users", the whole "@user-management" menu item will not be displayed.
-EOT -, array('!settings' => url('admin/settings/admin_menu'), '%margin-setting' => t('Apply margin-top to page body'), '@permission-access' => 'administer access control', '@permission-users' => 'administer users', '@user-management' => t('User management'))); + $output = ''; + $output .= '' . t('The administration menu module provides a dropdown menu arranged for one- or two-click access to most administrative tasks and other common destinations (to users with the proper permissions). Administration menu also displays the number of anonymous and authenticated users, and allows modules to add their own custom menu items. Integration with the menu varies from module to module; the contributed module Devel, for instance, make strong use of the administration menu module to provide quick access to development tools.', array('@drupal' => 'http://drupal.org/project/devel')) . '
'; + $output .= '' . t('The administration menu settings page allows you to modify some elements of the menu\'s behavior and appearance. Since the appearance of the menu is dependent on your site theme, substantial customizations require modifications to your site\'s theme and CSS files. See the advanced menu module README.txt file for more information on theme and CSS customizations.', array('@settings' => url('admin/settings/admin_menu'))) . '
'; + $output .= '' . t('The menu items displayed in the administration menu depend upon the actual permissions of the viewer. First, the administration menu is only displayed to users in roles with the Access administration menu (admin_menu module) permission. Second, a user must be a member of a role with the Access administration pages (system module) permission to view administrative links. And, third, only currently permitted links are displayed; for example, if a user is not a member of a role with the permissions Administer permissions (user module) and Administer users (user module), the User management menu item is not displayed.') . '
'; + return $output; } } @@ -42,11 +30,11 @@ function admin_menu_perm() { return array( 'access administration menu' => array( 'title' => t('Access administration menu'), - 'description' => t('Access the administration menu, which appears at the top of the page.'), + 'description' => t('Display the administration menu at the top of each page.'), ), 'display drupal links' => array( 'title' => t('Display drupal links'), - 'description' => t('View links to drupal.org in the administration menu.'), + 'description' => t('Provide Drupal.org links in the administration menu.'), ) ); } @@ -71,8 +59,8 @@ function admin_menu_theme() { function admin_menu_menu() { $items = array(); $items['admin/settings/admin_menu'] = array( - 'title' => 'Administration Menu', - 'description' => 'Adjust settings for the dropdown Administration Menu.', + 'title' => 'Administration menu', + 'description' => 'Adjust administration menu settings.', 'page callback' => 'drupal_get_form', 'page arguments' => array('admin_menu_theme_settings'), 'access arguments' => array('administer site configuration'),