Installation / update

What are the system requirements?

  • Joomla 2.5 or 3 fully and correct installed
  • PHP 5 or later

Error: 'Could not create directory, Warning! Failed to move file'

Check your directory premissions:
'help' > 'System info' > 'Directory Permissions'
All least these folders should be writeable:

  • administrator/components/
  • administrator/language/en-GB/
  • administrator/modules
  • tmp/

You can also enable the FTP layer and try to install again.

Error: 'Path does not point to a valid folder' 'Could not find a Joomla! XML setup file' 'File...does not exist'

You are probably dealing with a corrupt download. Both Symantec and McAfee are known to corrupt downloads with certain settings. They can also corrupt the extensions send and received by email. So try this: go to the download area, disable the firewall/virusscanner, download the file, enable the firewall/virusscanner.

How to install?

  1. Download the latest version of the component.
  2. Go to 'Extensions > Extensions Manager'.
  3. Click 'browse' and select the file which you just downloaded. 
    The file name starts with 'com_adminmenumanager'.
  4. Click 'Upload File & Install'.
    The extension is being uploaded and installed. 
    Installed will be:
    - component Admin-Menu-Manager
    - menu module (administrator module!)

How to update?

  1. Download the component.
    free- and trial-version
    pro-version
  2. Install the component over the old component (no need to uninstall first).
    This will also install the Admin-Menu-Manager menu module.

Do I lose my settings and configuration when updating or upgrading?

No. All configuration and settings will remain in the database.

If you are updating from free- to trial-version, or trial- to pro-version, just install the new version over the old version.

End faq

Configuration

Can I set access to menu-items for users instead of groups/accesslevels?

No. Rights can only be applied to Joomla groups/accesslevels and not to individual users.

Users see no menu-item when they should have access

First check if the user is really assigned to the correct groups/accesslevels on page 'users'.

Double check if the group/level has the correct rights.

I don't see the menu module in the module manager

Go to:
'extensions' > 'module manager'
then select the location filter to 'administrator' to see the backend modules.

How to show the Joomla menu only to 'Super Users' ?

Please read 'Show Joomla menu only to some group(s)'.

How to create a link to the frontend ?

If you like to create a link from the admin-menu to a frontend page, enter ../ at the start of the url.
example:

../index.php?option=com_content&view=article&id=8
The above will display a specific article at the frontend of the site.

How to create a link to a page without the navigation ?

If you like to create a link from the admin-menu to a page with hidden navigation, add to the url:

&tmpl=component
example:
index.php?option=com_modules
change to
index.php?option=com_modules&tmpl=component

How to use with template 'Mission Control' ?

The administrator template 'Mission Control' by Rockettheme does not use the Joomla module system to display any modules in the backend at all. So it can not display the admin-menu-manager module.

(To see for yourself that the template ignores the Joomla module framework, go to the 'module-manager' > 'admin modules' and disable the Joomla admin menu, it will show anyway, because in this template, it is simply not a module like in any other template.)

To load the module into the template:

  1. Go to the module manager > 'admin modules' find the Admin-Menu-Manager module. Make a note of the module id.
  2. open file:
    administrator/templates/rt_missioncontrol/index.php
  3. go to line 41
    <div id="mc-nav">
  4. replace with
     <!-- start load admin-menu-manager module -->
     <div> 
     <?php
     $document = &JFactory::getDocument();
     $renderer = $document->loadRenderer('module'); 
    
     //get module as an object
     $database = JFactory::getDBO();
     $database->setQuery("SELECT * FROM #__modules WHERE id='132' ");
     $modules = $database->loadObjectList();
     $module = $modules[0]; 
    
     //just to get rid of that stupid php warning
     $module->user = ''; 
     echo $renderer->render($module, array('style'=>'')); 
     ?>
     </div> 
     <div class="mc-clr"></div> 
     <div style="height: 2px;">&nbsp;</div> 
     <!-- end load admin-menu-manager module --> 
    
     <div id="mc-nav">
  5. Replace in the code 132 with the id of the module
  6. Save the file. Done.

To hide the Joomla admin menu:

In the same file line 64

<?php $mctrl->displayMenu(); ?>

replace width:
<?php //hide mission control menu
//$mctrl->displayMenu(); ?>


If you only want to display the menu for Joomla group 'super users':

In the same file line 64

<?php $mctrl->displayMenu(); ?>

replace width:
<?php 
 //show mission control menu only to super users
 $user =& JFactory::getUser();
 $user_id = $user->get('id');
 jimport( 'joomla.user.helper' );
 $groups = JUserHelper::getUserGroups($user_id);
 if(in_array(8, $groups)){
 $mctrl->displayMenu();
 }
 ?>

Show custom menu only to some group(s) ?

You can create a menu and assign this to an accesslevel in the module-manager. In a default Joomla install all backend groups ('Manager', 'Administrator' and 'Super Users') are all assigned to accesslevel 'Special'. So if you want only some backend groups to see the custom menu, you will have to create a new accesslevel.

Create a new accesslevel

  1. Go to 'Users' > 'Access Levels'
  2. Click 'New'
  3. Enter a title. example 'admin menu (custom)'.
  4. Select the groups that should see the menu
  5. Click 'Save & Close'


Now you can assign the custom menu-module to the new accesslevel

  1. Go to the module manager 'Extensions' > 'Module Manager'
  2. Select in the first filter ('Site') > 'Administrator', to see the admin-modules
  3. Open the Admin-Menu-Manager module
  4. Set 'access' to the accesslevel you just created
  5. Click 'Save & Close'.

After you save this setting, it might be that you can not see the menu anymore. This is a cache issue. Just logout and login again and it will be there.

If that does not work, please read the fix on http://forum.joomla.org/viewtopic.php?f=579&t=731232.

Show Joomla menu only to some group(s) ?

In a default Joomla install, the Joomla admin menu is assigned to accesslevel 'special'. All backend groups ('Manager', 'Administrator' and 'Super Users') are all assigned to that level. So if you want only some backend groups to see the Joomla menu, you will have to create a new accesslevel.

Create a new accesslevel

  1. Go to 'Users' > 'Access Levels'
  2. Click 'New'
  3. Enter a title. example 'admin menu (joomla)'.
  4. Select the groups that should see the menu
  5. Click 'Save & Close'


Now you can assign the joomla-menu-module to the new accesslevel

  1. Go to the module manager 'Extensions' > 'Module Manager'
  2. Select in the first filter ('Site') > 'Administrator', to see the admin-modules
  3. Open the 'Admin Menu'
  4. Set 'access' to the accesslevel you just created
  5. Click 'Save & Close'.

After you save this setting, it might be that you can not see the Joomla menu anymore. This is a cache issue. Just logout and login again and it will be there.

How to create a link to 'article new' in a specific category ?

Joomla 3

In the Joomla 3 backend there is no way to parse the prevered category via the url. But you can use a template override to do this.

  1. Create this folder if it is not there yet
    templates/template_name/html/com_content
  2. If there is a edit.php already in the folder, go to 4.
  3. Copy-paste administrator/components/com_content/views/tmpl/edit.php into the folder you just created
  4. Open templates/template_name/html/com_content/edit.php in a text-editor (like notepad)
  5. On line 13
    JHtml::addIncludePath(JPATH_COMPONENT.'/helpers/html');

    change to
    JHtml::addIncludePath(JPATH_COMPONENT.'/helpers/html');
    $category_id_override = JRequest::getVar('category_id_override', '');
    if($category_id_override){
     $this->form->setValue('catid', null, $category_id_override);
    }
    
  6. Make a link to the 'article new' page 
    index.php?option=com_content&view=article&layout=edit&category_id_override=75

    change 75 to whichever category you want.

Joomla 2.5

Make a link like this where 75 is the id of the category. Please note that this will only work in the Joomla backend.

index.php?option=com_content&view=article&layout=edit&filter.category_id=75

How to create a link to a page with a filter set ?

Make a link to the page and add the filter name and the value which should be selected. Note that this does not always work in all filters and in all components. Please note that this will only work in the Joomla backend.

&filter.category_id=75

The filter name can be found in the HTML of the page you link to.

 

Check in the HTML the name of the select-element.
example:

<select name="filter_category_id"

In Joomla 2.5:

replace 'filter_' with 'filter.' so filter.category_id

In Joomla 3:

use the filtername
example index.php?option=com_modules&filter_position=position-7

Please note that this does not work consistently for each component and each filter.

End faq

Pre/post sale

On how many websites can I use the pro-version?

There is no limit. Use it on as many sites as you like.

Is the pro-version encrypted?

no.

Does the pro-version need Ioncube?

No. The pro version is un-encrypted and does not need Ioncube. Only the trial version is encrypted. The free and the pro-version are not encrypted and do not need Ioncube on the server.

Is there a trial-version available?

Yes. You can download the trial-version on the project page. You can use this extension unlimited on localhost. If used online it can be used for a few weeks.

free-version pro-version, what is the difference?

 freepro
number of menus 1 no limits
number of menu-items 5 no limits
menu-item access per accesslevel/usergroup   x

I purchased this extension, how to download?

After payment is confirmed you login and click in the right column on 'my extensions'. Then click on your purchase and download the files. 

End faq

Known issues

Joomla does not show backend modules per language. Multi language menu's.

In the module manager, you can select a language per module. This will show/hide the modules according to the users' selected language at the frontend. This does not work in the backend. This issue has been reported in the Joomla bugtracker.

So if you want to show a menu in different languages, the best workaround is to copy the menu and translate each of the menu-titles. Then create usergroups/accesslevels for each language and set access rights so the group can see the menu in its own language.

End faq

 
Follow Us On Twitter
spicy-sacerdotal