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)
m (Customise a Template: updates)
 
(3 intermediate revisions by one user not shown)
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. Overrides created in this edit screen are Template overrides and not to be confused with Layout Overrides !!!  
+
In the updated Joomla 3.2 Template Manager: Customise Template 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/.
 
Template overrides override the core 'layout views' of Components, Modules and the files of /layout/joomla/.
Line 5: Line 5:
 
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]]
 
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==
+
{{J3.2:Editing_a_template_with_Template_Manager}}
 +
==Customise a Template==
  
* Go to {{rarr|Extensions,Template Manager}} and click Templates on the left-hand side.
+
Click any file and you'll be able to edit it directly in the browser.
* You'll see a list of all the templates on your site:
+
 
+
[[image:3x-template-manager-templates.png]]
+
 
+
* Click the Template Details and Files link:
+
 
+
[[image:3x-template-manager-templates-file-link.png]]
+
 
+
* You'll now see an overview of your template files on the left-hand side:
+
 
+
[[image:3x-template-manager-customise-template.png]]
+
 
+
* Click any file and you'll be able to edit it directly in the browser:
+
  
 
[[image:3x-template-manager-customise-template-file-edit.png]]
 
[[image:3x-template-manager-customise-template-file-edit.png]]

Latest revision as of 15:23, 29 November 2013

In the updated Joomla 3.2 Template Manager: Customise Template 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

To edit or copy a template's files with the Template Manager: Customise Template you must first access the Template manager.

Contents

Access the Template Manager

  • Click on: Extensions  Template Manager

Extension-manager-template-manager-3x.png

You will now see the Template Manager screen.

Note: If you do not see Template Manager listed as an option on the Extensions menu, then it is most likely because you are not logged in as a Super Administrator. Only Super Administrators will see this menu item.


Access the Template Manager Customisation Feature

There are two methods available for accessing the Template Manager: Customise Template. The Customise Template interface allows for editing the actual code found in the template files, creating template overrides and template file manipulation.

One-Click or Switch to Template View

30-Template-manager-template-styles-view-1.png

Tip-icon.png
A Tip!

Styles column refers to changing the available parameters of a template, such as color, font-color, logo, etc. These are dependent on the parameters a template maker made available and are a convenience for quick changes. Template - column refers to editing the actual template files.

To access the Template Customise feature:

  • Directly - Click the template name in the column Template
600
  • Indirectly - Styles will be highlighted, click on Templates below it which will turn the view to Template Manager:Templates, see image below.
30-Template-manager-template-style-view.png
  • Select the template you wish to modify which will change the view to Template Manager: Customise Template view

Customisation View

You should now be looking at the image below, Template Manager: Customise Template.

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


Customise a Template

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.