Advanced Module Manager

Take control over modules in Joomla!

  • Last updated: 10-Oct-2017
  • Version: 7.2.2
  • Types: Component System plugin
  • Joomla rating: 100%
Joomla rating: 100%

Do you like Advanced Module Manager?

Rate it!

Tutorial for Advanced Module Manager

There is a Free and a Pro version of Advanced Module Manager.
The parts in this tutorial that only concern the Pro version will be marked with: Pro only

Introduction

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 add colour tags.

General options

Once Advanced Module Manager is installed, the core Joomla module manager will be replaced with the Advanced Module Manager. The 'Modules' menu link under 'Manage' 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.

Advanced Module Manager - Options button

When you click on that you will be directed to the global options for Advanced Module Manager.

Advanced Module Manager - Options

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

Default settings

Module List Title Select whether to show the core or Advanced Module Manager title in the module list.
Default Ordering Set the default ordering of the list items
Default publish state Select whether to set new modules to published or unpublished by default.
Default menu assignment Select whether to set the menu assignment of new modules to all or no menu items.
Show Colour Enable to show the colour column in the module list.
Colours A comma separated list of RGB colours to show in the colour picker.
Show Note Select where to show the modules optional note in the module list view.
Show Switch Select to show the link to switch to the Joomla core module manager (and back).
Show Extra Fields Enable to show the custom extra fields.

You can define the labels of these fields. If no label is given, the field will not be shown.

The saved values can be used in the module chromes via values extra1-5:
$params->get('extra1')
Show Update Notification If selected, an update notification will be shown in the main component view when there is a new version for this extension.
Show Copyright If selected, extra copyright info will be displayed in the admin views. Regular Labs extensions never show copyright info or backlinks on the frontend.

Show Assignments

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

I advise you to disable all 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 speed.

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

Assignment options

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

The first option you see is the Same as other module option.
Select this to use the assignment settings of another module.
If Opposite is selected, the module will show up on all pages where the selected module will not show up.

If you not use the Same as other module option, you will be presented with all the assignment options listed below.
If all of the assignments in a module are set to Ignore, that module will show up on all pages.
As soon as you set one or more of the assignments to Include or Exclude, the module will be limited to the pages/situations matching those assignments.

The different assignments have 3 states:

  • Ignore (default)
  • Include
  • Exclude

By default the assignments are ignored, meaning the item is not limited by assignments.
To use an assignment, you set the option to Include or Exclude depending on the desired effect.
If you set an assignment to Exclude, the item is assigned to all pages/circumstances that do not match that assignment.

Below you find all the available assignments with the available settings for it.

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.

All not-selected assignment types are now hidden from view.

Options: All, Selected

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
Recurring Select to apply date range every year. (So the year in the selection will be ignored)

The date and time assignments use the date/time of your servers, not that of the visitors system.
Current date/time: %s
Seasons Select seasons to assign to.

Options: Winter, Spring, Summer, Fall / Autumn
Hemisphere Select the hemisphere your website is located in

Options: Northern, Southern, Australia
Months Select months to assign to.

Options: January, February, March, April, May, June, July, August, September, October, November, December
Days of the week Select days of the week to assign to.

Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday

Time

Start Publishing Enter the time to start publishing.
Finish Publishing Enter the time to end publishing.

Users

User Group Levels Select the user groups to assign to.
User IDs Enter the user ids to assign to. Use commas to separate ids.

Languages

Languages Select the languages to assign to.

IP Addresses

IP Addresses / Ranges A comma and/or enter seperated list of IP addresses and IP ranges. For instance:
127.0.0.1
128.0-128.1
129

Geolocating

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.
To be able to use this assignment, you need to install the Regular Labs GeoIP library.

Continents Select the continents to assign to.
Countries Select the countries to assign to.
Regions / States Select the regions / states to assign to.
Postal Codes A comma separated list of postal codes (12345) or postal code ranges (12300-12500).
This can only be used for a limited number of countries and IP addresses.

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.

Devices

Devices Select the devices to assign to. Keep in mind that device detection is not always 100% accurate. Users can setup their device to mimic other devices.

Options: Desktop, Tablet, Mobile

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

Components

Components Select the components to assign to.

Tags

Tags Enter the tags to assign to. Use commas to separate the tags.
Also on child items Also assign to child items of the selected items?

Joomla! Content

Page types Select on what page types the assignment should be active.

Options: Archived Articles, Single Article, List All Categories, Category Blog, Category List, Featured Articles, Create Article
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Articles, Others
Articles Select the articles to assign to.
Content Keywords Enter the keywords found in the content to assign to. Use commas to separate the keywords.
Meta Keywords Enter the keywords found in the meta keywords to assign to. Use commas to separate the keywords.
Authors Select the auhors to assign to.

EasyBlog

Page types Select on what page types the assignment should be active.

Options: Archive Layout, Bloggers Layout (All authors), Categories Layout (All categories), Overview Layout (Dashboard), Single Blog Entry Layout, Featured Blogs Layout, Frontpage Blog Layout, Login layout, My Blog Layout, Subscriptions Layout, Tags Layout, Team Blog Layout
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Items
Tags Enter the tags to assign to. Use commas to separate the tags.
Page types Select on what page types the assignment should be active.

Options: Tags, Items
Items Select the items to assign to.
Authors Select the auhors to assign to.

FLEXIContent

For category & article (item) assignments, see the above Joomla! Content section.

Page types Select on what page types the assignment should be active.

Options: Author, Category, My Items, Favourites, Directory, Single item., Search, Tag
Tags Enter the tags to assign to. Use commas to separate the tags.
Page types Select on what page types the assignment should be active.

Options: Tags, Items
Types Select the types to assign to.

Form2Content Lite

For category & article (item) assignments, see the above Joomla! Content section.

Types Select the types to assign to.

K2

Page types Select on what page types the assignment should be active.

Options: Item, Item edit form, Categories, Tag, User page (blog), Latest items from (one or more) users or categories
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Items
Tags Enter the tags to assign to. Use commas to separate the tags.
Page types Select on what page types the assignment should be active.

Options: Tags, Items
Items Select the items to assign to.
Content Keywords Enter the keywords found in the content to assign to. Use commas to separate the keywords.
Meta Keywords Enter the keywords found in the meta keywords to assign to. Use commas to separate the keywords.
Authors Select the auhors to assign to.

ZOO

Page types Select on what page types the assignment should be active.

Options: Category, ITEM, Frontpage, My Submissions, Submission
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Items
Items Select the items to assign to.
Authors Select the auhors to assign to.

Akeeba Subscriptions

Page types Select on what page types the assignment should be active.

Options: Specific level, All Levels (Awesome layout), All Levels, All of my subscriptions, Edit user information
Levels Select the levels to assign to.

HikaShop

Page types Select on what page types the assignment should be active.

Options: User addresses, Categories listing, Featured Articles, Create Article, Contact page, Products listing, Product page, User control panel, Registration form
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Products
Products Select the items to assign to.

MijoShop

Page types Select on what page types the assignment should be active.

Options: Account, Admin Panel, Affiliates, Bestsellers, Shopping Cart, Checkout, Compare, Contact, Downloads, Home, Latest Products, Login, Manufacturers, Newsletter, Orders, Popular Products, Registration, Returns, Search, Sitemap, Specials, Voucher, Wishlist
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Products
Products Select the items to assign to.

RedShop

Page types Select on what page types the assignment should be active.

Options: Account, My Wishlist, Cart, Catalogue, Sample, All Products From a Category, Categories, Category Detailed, Checkout, Gift Cards List, Login, Logout, Portal Layout For Shopper Group, Portal Detail Layout For Shopper Group, Manufacturers, Manufacturer Details, Products From Selected Manufacturer, Newsletter Subscription, Orders, Orders Tracker, Reset Password, Set Password, Token, Product, Product Download, Product Rating, Quotation, Registration, Product Search, Newest Products, Products On Sale, redFILTER, My Wishlist, All Wish Lists
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Products
Products Select the items to assign to.

VirtueMart

Page types Select on what page types the assignment should be active.

Options: Shopping Cart, VirtueMart Categories Layout, Category Layout, Manufacturer Default Layout, Manufacturer Details Layout, List Orders, Product Details Layout, Account Maintenance, User Edit Address, Displays vendor contact, Displays vendors, Displays vendor details, View vendor TOS, Front page
Categories Select the categories to assign to.
Also on child items Also assign to child items of the selected items?
Page types Select on what page types the assignment should be active.

Options: Categories, Products
Products Select the items to assign to.

Cookie Confirm

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

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

For instance:
return ( $user->name == 'Peter van Westen' );

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.

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.

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.

Notes

The core module manager 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.

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

Regular Labs Extension Manager

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

Please see the Tutorial for the Regular Labs Extension Manager for more detailed information...

Joomla! Extension Manager

To install via the Joomla! Extension Manager, just follow these steps:

  1. Log into your Joomla administrator;
  2. In the menu, choose: Extensions >> Extensions;
  3. Choose the tab: Install from Web (or enable it if you haven't done so yet);
  4. Select the search field and enter Advanced Module Manager and hit enter;
  5. Click on the Advanced Module Manager listing;
  6. Click on Install;
  7. Click on Install to confirm.
Joomla! Installer - Install from Web

Or if you need to install the Pro version or cannot install via the 'Install via Web' method for some reason:

  1. Download the extension install file (.zip);
  2. Log into your Joomla administrator;
  3. In the menu, choose: Extensions >> Extensions;
  4. Choose the tab: Upload Package File;
  5. Click on the Choose File button and select the extension zip;
  6. Click on Upload & Install.
Joomla! Installer - Upload Package File

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