Actions

J3.x

How to use the Template Manager

From Joomla! Documentation

Revision as of 23:38, 17 November 2013 by Tom Hutchison (Talk | contribs)

In the updated Joomla 3.2 Template Manager you can edit files, create files and folders and even create overrides directly inside your admin area.

Contents

Access the Template Manager

  • Go to Extensions  Template Manager and click Templates on the left-hand side.
  • You'll see a list of all the templates on your site:

3x-template-manager-templates.png

  • Click the Template Details and Files link:

3x-template-manager-templates-file-link.png

  • You'll now see an overview of your template files on the left-hand side:

3x-template-manager-customise-template-en.png

  • Click any file and you'll be able to edit it directly in the browser:

3x-template-manager-customise-template-file-edit-en.png

Using the Template Manager Toolbar

When you're inside the Template Manager, you'll see a toolbar like the one below:

3x-template-manager-customise-template-toolbar-en.png

  • Click the "Copy Template" button and you'll be able to make a complete copy of your existing template.

Creating a copy like this could be very useful for testing purposes. It used to be much more difficult.

3x-template-manager-customise-template-popup-copy-en.png

  • Click the "Template Preview" button and you'll immediately see a frontend preview of your template with the module positions marked:

3x-preview-template-template-manager-en.png

  • Click the "Manager Folders" button and you'll be able to create new folders inside your template.

3x-template-manager-customise-template-manage-folders-en.png

  • Click the "New File" button and you'll be able to create a new file or upload one from your desktop.

3x-template-manager-customise-template-create-upload-file-en.png

  • When you create a file, Joomla will offer you a variety of the most popular formats:

3x-template-manager-customise-template-create-upload-file-types-en.png

Creating Overrides

One of my favorite features of the new Template Manager is how easy it makes overrides.

Previously it was almost impossible to get a clean overview of what override possibilities were available on a Joomla site.

  • Click the "Create Overrides" tab and the new Template Manager presents all of the possibilities in one neat list:

3x-template-manager-customise-template-create-overrides-en.png

  • Click on a component and you'll get all the possibilities inside that one component. In this example, I clicked on com_content:

3x-template-manager-customise-template-create-overrides-component-en.png

  • Click on one of the possibilities, for example "article", and you'll see this message:

3x-template-manager-customise-template-create-overrides-message-en.png

  • Go back to the Editor screen and your override files will be available for editing:

3x-template-manager-customise-template-create-overrides-file-list-en.png

A Google Summer of Code Success

This new Template Manager was a Google Summer of Code 2013 project.

The coder was Ram Tripathi, a student from Delhi. He formed a very successful partnership with his mentor Ken Crowder, a long-time Joomla developer. Congrats to both of them and to all of this year's Google Summer of Code team.