You are here

Home » API reference » Administration menu 5

README.txt in Administration menu 5

Same filename and directory in other branches
  1. 8.3 README.txt
  2. 5.3 README.txt
  3. 5.2 README.txt
  4. 6.3 README.txt
  5. 6 README.txt
-- SUMMARY --

Drupal Administration Menu is re-building and automagically slicing the whole
menu tree below /admin including all invisible local tasks into the Drupal
Administration Menu. So administrators need less time to access pages which
are only visible after one or two clicks normally.

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.

* Drupal 4.7: If "Admin Menu Block" is not automatically activated after module
  installation, make sure you visit the block configuration page (admin/block)
  for each theme you want to have admin_menu activated for.


-- 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.


-- TROUBLESHOOTING --

* If your theme uses absolute or fixed positioned elements, and the default
  margin-top for <BODY> is not sufficient, you need to override admin_menu's
  stylesheet in your theme.

* If menu entries in admin_menu are rendered behind a flash movie object, you
  need to add the following property to your flash object:
<code>
<param name="wmode" value="transparent" />
</code>
  See http://drupal.org/node/195386 for further information.


-- FAQ --

Q: After upgrading to 5.x-1.2, 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 (</html>) tag:
<code>
   <?php echo $closure; ?>
</code>

Q: After upgrading to 5.x-1.2, the menu item 'administer' is no longer removed.
   Why?

A: Prior to release 5.x-1.2, Drupal Administration Menu was output via
   hook_block(), which allowed to alter the global menu array. Since 5.x-1.2, it
   is output via hook_footer() and thus no longer able to alter the menu. As
   long as there will be no built-in solution in an upcoming release, you may
   perform the following steps as a workaround:
   - Create a new menu.
   - Edit the menu item 'administer' and select the new menu as parent.

Q: I enabled "Aggregate and compress CSS files", but I found admin_menu.css is
   still there, is it normal?

A: Yes, this is the intended behavior. Since admin_menu is only visible for
   logged-on administrative users, it would not make sense to load its
   stylesheet for all, including anonymous users.


-- THEME-SPECIFIC TROUBLESHOOTING --

No more troubleshooting since release 5.x-1.2. :)


-- CONTACT --

Current maintainers:
* Daniel F. Kudwien (sun) - dev@unleashedmind.com
* Stefan M. Kudwien (smk-ka) - dev@unleashedmind.com

This project has been sponsored by:
* UNLEASHED MIND
  Specialized in consulting and planning of Drupal powered sites, UNLEASHED
  MIND offers installation, development, theming, customization, and hosting
  to get you started. Visit http://www.unleashedmind.com for more information.

File

README.txt
View source 
  1. 

  2. -- SUMMARY --

  3. 

  4. Drupal Administration Menu is re-building and automagically slicing the whole

  5. menu tree below /admin including all invisible local tasks into the Drupal

  6. Administration Menu. So administrators need less time to access pages which

  7. are only visible after one or two clicks normally.

  8. 

  9. For a full description visit the project page:

  10.   http://drupal.org/project/admin_menu

  11. Bug reports, feature suggestions and latest developments:

  12.   http://drupal.org/project/issues/admin_menu

  13. 

  14. 

  15. -- REQUIREMENTS --

  16. 

  17. None.

  18. 

  19. 

  20. -- INSTALLATION --

  21. 

  22. * Copy admin_menu module to your modules directory and enable it on the admin

  23.   modules page.

  24. 

  25. * Drupal 4.7: If "Admin Menu Block" is not automatically activated after module

  26.   installation, make sure you visit the block configuration page (admin/block)

  27.   for each theme you want to have admin_menu activated for.

  28. 

  29. 

  30. -- CUSTOMIZATION --

  31. 

  32. * You have two options to override the admin menu icon:

  33.   

  34.   1) Disable it via CSS in your theme:

  35. 

  36.      body #admin_menu_icon { display: none; }

  37. 

  38.   2) Alter the image by overriding the theme function:

  39. 

  40.      Copy the whole function theme_admin_menu_icon() into your template.php,

  41.      rename it to f.e. phptemplate_admin_menu_icon() and customize the output.

  42. 

  43. 

  44. -- TROUBLESHOOTING --

  45. 

  46. * If your theme uses absolute or fixed positioned elements, and the default

  47.   margin-top for  is not sufficient, you need to override admin_menu's

  48.   stylesheet in your theme.

  49. 

  50. * If menu entries in admin_menu are rendered behind a flash movie object, you

  51.   need to add the following property to your flash object:

  52. 

  53. 

  54. 

  55.   See http://drupal.org/node/195386 for further information.

  56. 

  57. 

  58. -- FAQ --

  59. 

  60. Q: After upgrading to 5.x-1.2, admin_menu disappeared. Why?

  61. 

  62. A: Prior to release 5.x-1.2, Drupal Administration Menu was output in a block.

  63.    Since 5.x-1.2, it is output via hook_footer(). Some custom themes may not

  64.    (yet) output $closure, so admin_menu could no longer be displayed. If you

  65.    decided to move the 'administer' tree into a new menu and disabled that menu

  66.    block, a site could become (temporarily) unmaintainable. Either way, you

  67.    should fix your theme by adding the following code in front of the closing

  68.    HTML () tag:

  69. 

  70.    

  71. 

  72. 

  73. Q: After upgrading to 5.x-1.2, the menu item 'administer' is no longer removed.

  74.    Why?

  75. 

  76. A: Prior to release 5.x-1.2, Drupal Administration Menu was output via

  77.    hook_block(), which allowed to alter the global menu array. Since 5.x-1.2, it

  78.    is output via hook_footer() and thus no longer able to alter the menu. As

  79.    long as there will be no built-in solution in an upcoming release, you may

  80.    perform the following steps as a workaround:

  81.    - Create a new menu.

  82.    - Edit the menu item 'administer' and select the new menu as parent.

  83. 

  84. Q: I enabled "Aggregate and compress CSS files", but I found admin_menu.css is

  85.    still there, is it normal?

  86. 

  87. A: Yes, this is the intended behavior. Since admin_menu is only visible for

  88.    logged-on administrative users, it would not make sense to load its

  89.    stylesheet for all, including anonymous users.

  90. 

  91. 

  92. -- THEME-SPECIFIC TROUBLESHOOTING --

  93. 

  94. No more troubleshooting since release 5.x-1.2. :)

  95. 

  96. 

  97. -- CONTACT --

  98. 

  99. Current maintainers:

  100. * Daniel F. Kudwien (sun) - dev@unleashedmind.com

  101. * Stefan M. Kudwien (smk-ka) - dev@unleashedmind.com

  102. 

  103. This project has been sponsored by:

  104. * UNLEASHED MIND

  105.   Specialized in consulting and planning of Drupal powered sites, UNLEASHED

  106.   MIND offers installation, development, theming, customization, and hosting

  107.   to get you started. Visit http://www.unleashedmind.com for more information.

  108.