Actions

J3.x

Difference between revisions of "How to use the Template Manager"

From Joomla! Documentation

(Added definition of Overrides to prevent confusion between Template overrides and Layout overrides)
Line 1: Line 1:
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.
+
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. Overrides created in this edit screen are Template overrides and not to be confused with Layout Overrides !!!
 +
 
 +
Template overrides override the core 'layout views' of Components, Modules and the files of /layout/joomla/.
 +
 
 +
Layout overrides create new layout views for Components and Modules. And can be selected (in Admin menus and options) as alternative layout views instead of the core Component and Module layout views.  For Layout Overrides please see [[Layout_Overrides_in_Joomla]]
  
 
==Access the Template Manager==
 
==Access the Template Manager==

Revision as of 06:42, 26 November 2013

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. Overrides created in this edit screen are Template overrides and not to be confused with Layout Overrides !!!

Template overrides override the core 'layout views' of Components, Modules and the files of /layout/joomla/.

Layout overrides create new layout views for Components and Modules. And can be selected (in Admin menus and options) as alternative layout views instead of the core Component and Module layout views. For Layout Overrides please see Layout_Overrides_in_Joomla

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

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

3x-template-manager-customise-template-file-edit.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.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.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.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.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.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.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.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.png

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

3x-template-manager-customise-template-create-overrides-message.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.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.