User Guide

Advanced Module Manager

Download Free Buy Pro   € 50

1) Introduction

This guide provides in-depth information about Advanced Module Manager and will tell you:

  • what it does
  • how to install it
  • how to set-up and use it

2) What is Advanced Modules Manager?

Advanced Module Manager is a Joomla! administrator component (and system plugin).

Advanced Module Manager is an extension that changes the way your module manager works.

With Joomla you can normally only assign modules to certain menu items.

With Advanced Module Manager you have the possibility to assign modules to just about anything you want.

Further on in this guide we will discuss each assignment option individually.

Advanced Module Manager also gives a few other features to improve the module manager, like the ability to edit modules in modal windows and add colour tags.

3) General options

Once Advanced Module Manager is installed, the core Joomla module manager will be replaced with the Advanced Module Manager. The 'Module Manger' menu link will no longer point to 'option=com_modules' but to 'option=com_advancedmodules'.

When you go to this new module manager you will see the normal list of modules with extra stuff here and there.

First, we'll look at the general options. In the toolbar, on the right, you will see the 'Options' button.

toolbar-options

When you click on that, a modal window will open with all the available global options for Advanced Module Manager.

Advanced Module Manager: Options

Here is an overview of all the available global options. All descriptions are available in the tooltips of the options.

3.1) Default settings

Show Open in Modals icons J2.5 ONLY When enabled there will be an icon before every module name in the Module Manager list. When you click on the icon, the module edit screen will open in a modal window.
Show Colour Enable to show the colour column in the module list.
Main Colours A comma separated list of RGB colours to show in the first tab of the colour picker.
Show Options Message Enable to show the message about the Options at the top of the module list.

3.2) Extra settings

This tab gives you the ability to disable any extra assignment options.

I advise you to disable any options you don't plan to use. This is to keep the available assignment options in the module edit screens to a minimum, improving clarity and page load.

3.3) Permissions

The Joomla core permission settings control access to the different actions. For more information on how these permissions work, see the Joomla docs:
Access Control List Tutorial : Component Options & Permissions

4) Assignment options

assignmentsAdvanced Module Manager comes packed with a multitude of module assignment options. You can assign modules to, or exclude them from, virtually anything.

Show available assignment options

Mirror other module You can mirror the assignment settings of another module. So this module will use the Assignment settings of another module.

If Reverse is selected, the module will show up on all pages where the selected module will not show up.
Matching Method Should all or any assignments be matched?

ALL
Will be published if ALL of below assignments are matched.

ANY
Will be published if ANY (one or more) of below assignments are matched.
Assignment groups where 'Ignore' is selected will be ignored.
Show Assignments Select whether to only show the selected assignments. You can use this to get a clean overview of the active assignments.

Menu Items

Menu Items Select the menu items to assign to.
Also on child items Also assign to child items of the selected items?
Include no Itemid Also assign when no menu Itemid is set in URL?

Home Page

Unlike selecting the home page (default) item via the Menu Items, this will only match the real home page, not any URL that has the same Itemid as the home menu item.

This might not work for all 3rd party SEF extensions.

Date & Time

The date and time assignments use the date/time of your servers, not that of the visitors system.

Date

Start Publishing Enter the date to start publishing
Finish Publishing Enter the date to end publishing

Seasons PRO ONLY

Seasons Select seasons to assign to.
Hemisphere Select the hemisphere your website is located in

Months PRO ONLY

Months Select months to assign to.

Days of the week PRO ONLY

Days of the week Select days of the week to assign to.

Time PRO ONLY

Start Publishing Enter the time to start publishing.

Format: 23:59
Finish Publishing Enter the time to end publishing.

Format: 23:59

Users

User Group Levels

User Groups Select the user groups to assign to.

Users PRO ONLY

User IDs Enter the user ids to assign to. Use commas to separate ids.

Languages

Languages Select the languages to assign to.

Geolocating PRO ONLY

Geolocating is not always 100% accurate. The geolocation is based on the IP address of the visitor. Not all IP addresses are fixed or known.

geoPlugin is used for geolocating. geoPlugin has a maximum of 120 lookups per minute.

Continents Select the continents to assign to.
Countries Select the countries to assign to.
Regions / States Select the regions / states to assign to.

Templates

Templates Select the templates to assign to.

URL

URL matches Enter (part of) the URLs to match.
Use a new line for each different match.
Use Regular Expressions Select to treat the value as regular expressions.

Url parts will be matched using regular expressions. So make sure the string uses valid regex syntax.

Operating Systems

Operating Systems Select the operating systems to assign to. Keep in mind that operating system detection is not always 100% accurate. Users can setup their browser to mimic other operating systems.

Browsers

Browsers Select the browsers to assign to. Keep in mind that browser detection is not always 100% accurate. Users can setup their browser to mimic other browsers
Mobile Browsers

Components

Components Select the components to assign to.

Joomla! Content

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Articles Select the articles to assign to.
Article Keywords Enter the (meta) keywords to assign to. Use commas to separate the keywords.

FLEXIcontent PRO ONLY

Page types Select on what page types the assignment should be active.
Tags Enter the tags to assign to. Use commas to separate the tags.
Types Select the types to assign to.

K2 PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Types Select the types to assign to.
Items Select the items to assign to.

ZOO PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Items Select the items to assign to.

Akeeba Subscriptions PRO ONLY

Page types Select on what page types the assignment should be active.
Levels Select the levels to assign to.

HikaShop PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Products Select the items to assign to.

MijoShop PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Products Select the items to assign to.

RedShop PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Products Select the items to assign to.

VirtueMart PRO ONLY

Page types Select on what page types the assignment should be active.
Categories Select the categories to assign to.
Products Select the items to assign to.

Cookie Confirm PRO ONLY

Cookies allowed Assign to whether cookies are allowed or disallowed, based on the configuration of Cookie Confirm (by Twentronix) and the visitor's choice to accept or decline cookies.

Custom PHP PRO ONLY

Custom PHP Enter a piece of PHP code to evaluate. The code must return the value true or false.

For instance:

$user = JFactory:‍:getUser();
return ( $user->name == 'Peter van Westen' );

5) Extra features

Besides the above discussed assignment options, Advanced Module Manager gives you a couple of extra features to make module management just that bit easier and faster.

5.1) Colour tags

You can give every module a colour tag. This does not change anything in the frontend of your website, it is just a tag to use on the administrator side. In the module list you can see these colours and even order by colours. This makes grouping and finding certain modules easier and faster.

5.2) Open in modals

modalA modal window is a type of popup window that does not open in a new window, but hovers over your current page. These modal windows (also known as lightbox windows) throw a semi-transparent black overlay over your page and hover on top of that. Joomla uses modal windows for things like the general settings in components like the ones you have in Advanced Module Manager.

Advanced Module Manager also gives you the possibility to open module edit pages inside these modal windows. The advantage being that you do not have to reload the entire page and you can easily step back to the module list. This saves a lot of time when you have to look into or edit many modules.

When the ‘Show Open in Modals icons’ option is enabled in the general settings (which it is by default), you will see an icon before the module title in the module list. Clicking on this icon will open the module in a modal window.

modalicons

5.3) Hide if empty

This option can be used to prevent module blocks with title being shown when the module has nothing to show. This option might not work on all templates.

5.4) Notes

The core module manager (in Joomla! 2.5) already has the ability to add notes to modules that display in the module list. Advanced Module Manager however adds the ability to show this note as tooltip or in a separate column. You can set this via the general settings.

6) Requirements

Advanced Module Manager will only work correctly if your setup meets these requirements:

  • Up-to-date version of Joomla:
    • Joomla 2.5.10 or higher
    • Joomla 3.2.2 or higher
  • PHP 5.3+ ( No PHP 5.2 support! )
  • PHP mbstring (Multibyte String) functions enabled
  • MySQL 5+

Important: I can only provide support for setups that:

  • meet the above requirements;
  • do not have extension files or Joomla! core files which have been altered in any way.

7) Installation

You can either install Advanced Module Manager by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

Note: When updating Advanced Module Manager, you do not need to uninstall it first. The package will update all the files automatically.

Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.

7.1) NoNumber Extension Manager

It is very easy to install/update any NoNumber Extension using the NoNumber Extension Manager.

Please see the User Guide for the NoNumber Extension Manager for more detailed information...

NoNumber Extension Manager

7.2) Joomla! Extension Manager

To install via the Joomla! Extension Manager, just follow these steps (based on Joomla 2.5 setup):

  1. Download the extension zip.
  2. Log into your Joomla administrator
  3. In the menu, choose: Extensions >> Extension Manager
  4. Under 'Upload Package File' select the extension zip.
  5. Click on 'Upload & Install'
Joomla! Installer

If you have problems installing Advanced Module Manager, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension

8) Uninstallation

You can either uninstall Advanced Module Manager by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

If you no longer use any NoNumber extensions, you can also uninstall the NoNumber Framework plugin by using the Joomla! core extension manager.