Advanced Template Manager

Take control over templates in Joomla!

  • Last updated: 19-Oct-2018
  • Version: 3.5.0
  • Types: Component System plugin
  • Joomla rating: 98%

Tutorial for Advanced Template Manager

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

Introduction

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

Advanced Template Manager is an extension that changes the way your template manager works.

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

With Advanced Template Manager you have the possibility to assign template styles to just about anything you want.

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

Advanced Template Manager also gives a few other features to improve the template manager, like the ability to add colour tags.

Note: Advanced Template Manager is NOT compatible with templates using the Gantry (RocketTheme), Warp (YooTheme) or T3 (JoomlArt) frameworks.

General options

Once Advanced Template Manager is installed, the core Joomla template manager will be replaced with the Advanced Template Manager. The 'Templates' menu link under 'Manage' will no longer point to option=com_templates but to option=com_advancedtemplates.

When you go to this new template manager you will see the normal list of template styles 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 you will be directed to the global options for Advanced Template Manager.

Options

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

Default settings

Heading Title Select whether to show the core or Advanced Template Manager title in the heading.
Show Thumbnails Select to show Thumbnails in the list views.
Show Colour Enable to show the colour column in the template style list.
Colours A comma separated list of RGB colours to show in the colour picker.
Show Note Select where to show the template styles optional note in the template style list view.
Show Switch Select to show the link to switch to the Joomla core template manager (and back).
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 template style 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 Template Manager comes packed with a multitude of assignment options. You can assign template styles to, or exclude them from, virtually anything.
Assignments

If all of the assignments in a template style are set to Ignore, that template style will not be assigned to anything.
As soon as you set one or more of the assignments to Include or Exclude, the template style will be assigned to the pages/situations matching those assignments.
Pages that have no template styles specifically assigned to them will use the template style that is set as default.

Matching Method

This option determines whether all or any assignments need be matched.

  • ALL: Will be published if ALL of below assignments are matched at the same time.
  • ANY: Will be published if ANY (one or more) of below assignments are matched at any time.

Assignment groups where "Ignore" is selected will be ignored.

Note: When setting any or more assignments to Exclude, the Matching Method should be set to ALL. Otherwise, using ANY would result in one Exclude conditon to always match and the item to show everywhere else.

Show Assignments

You can select whether to show the full list of available assignments, or only the selected assignments that are currently used. You can use this to get a clean overview of the active assignments.

When set to "Selected", all not-selected assignment types will be hidden from view.

Assignment Types

Each assignment type has three possible states/options.

  • Ignore (default)
  • Include
  • Exclude

By default all 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 your selection.

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

Menu Items

Selection 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 the ones 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)
Seasons
Selection 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
Selection Select months to assign to.

Options: January, February, March, April, May, June, July, August, September, October, November, December
Days of the week
Selection 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.
Format: 23:59
Finish Publishing Enter the time to end publishing.
Format: 23:59

Users

User Group Levels Select the user groups to assign to.
Users Select the users to assign to.

Languages

Selection 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

Selection 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

Selection 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

Selection 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

Selection Select the components to assign to.

Tags

Selection Enter the tags to assign to. Use commas to separate the tags.
Match all Select to only let the assignment pass if all of the selected items are matched.
Also on child items Also assign to child items of the selected items?

Joomla! Content

Page types
Selection 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
Selection 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
Selection 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.

3rd party Content

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

Extra features

Besides the above discussed assignment options, Advanced Template Manager gives you a couple of extra features to make template (style) management just that bit easier and faster.

Colour tags

You can give every template style 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 template style list you can see these colours and even order by colours. This makes grouping and finding certain template styles easier and faster.

Notes

Advanced Template Manager ability to add notes to template styles and display in the template style list view. You can make this note show under the template style name, as tooltip or in a separate column. You can set this via the general settings.

Not compatible with...

Advanced Template Manager is NOT compatible with these (and maybe other) templates and frameworks:

  • Astroid Framework
  • Gantry (RocketTheme)
  • JoomlaXTC
  • T3 (JoomlArt)
  • Warp (YooTheme)

Installation

You can either install Advanced Template 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 Template 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 Template Manager and hit enter;
  5. Click on the Advanced Template Manager listing;
  6. Click on Install;
  7. Click on Install to confirm.
Installer 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.
Installer Upload

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