/* $Id: README.txt,v 1.12.2.5 2008-02-24 03:37:04 sun Exp $ */
-- SUMMARY --
Drupal Administration Menu displays the whole menu tree below /admin including
all invisible local tasks in a drop-down menu. So administrators need less time
to access pages which are only visible after one or two clicks normally.
Admin menu also provides hook_admin_menu() that allows other modules to add or
alter menu items.
For a full description visit the project page:
http://drupal.org/project/admin_menu
Bug reports, feature suggestions and latest developments:
http://drupal.org/project/issues/admin_menu
-- REQUIREMENTS --
None.
-- INSTALLATION --
* Copy admin_menu module to your modules directory and enable it on the admin
modules page.
-- CONFIGURATION --
* Configure module settings in administer -> Site configuration ->
Administration Menu.
* Go to Administer -> User management -> Access control and assign permissions
for Drupal Administration Menu:
- access administration menu: Displays Drupal Administration Menu.
- display drupal links: Displays additional links to Drupal.org and issue
queues of all enabled contrib modules in the Drupal Administration Menu icon.
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 'administer access control' and 'administer users', the whole 'User management' menu item will not be displayed.
-- CUSTOMIZATION --
* You have two options to override the admin menu icon:
1) Disable it via CSS in your theme:
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 (probably best using Devel module, or by manually truncating the
cache_menu database table) to see any changes of your theme override function.
-- TROUBLESHOOTING --
* If admin menu is not displayed, check the following steps:
- Is the 'access administration menu' permission enabled?
- Does your theme output $closure? (See FAQ below for more info)
* 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: After upgrading to 5.x-2.x, admin_menu disappeared. Why?
A: This should not happen. If it did, visit
http:///admin/build/menu to re-generate your menu cache.
Q: After upgrading, admin_menu disappeared. Why?
A: Prior to release 5.x-1.2, Drupal Administration Menu was output in a block.
Since 5.x-1.2, it is output via hook_footer(). Some custom themes may not
(yet) output $closure, so admin_menu could no longer be displayed. If you
decided to move the 'administer' tree into a new menu and disabled that menu
block, a site could become (temporarily) unmaintainable. Either way, you
should fix your theme by adding the following code in front of the closing
HTML (