Templates: Customise Source

From Joomla! Documentation

Revision as of 03:49, 1 July 2022 by Brian (talk | contribs) (+Category:Help screen 4.1; +Category:Help screen 4.2 using HotCat)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


This screen is where the source code of template files is edited. It provides a plain text interface to edit the template files. HTML and PHP programming syntax is highlighted to make the source code files easier to read.

How to Access[edit]

  • Select System  Templates Panel  Site Templates from the Administrator menu. Or...
  • Select System  Templates Panel  Administrator Templates from the Administrator menu. Then...
    • Select a template name from the Templates column. Then...
      • Select a file to edit from the Editor tab.



Form Fields[edit]

Editor Tab[edit]

  • Select a file to edit. The edit area shows syntax highlighted text for some types of file.

Create Overrides Tab[edit]

  • Select an item to override. This is done immediately with no prompt for confirmation. The override is placed in the appropriate location. For example, if you make an override for mod_whosonline you will see this message:
Look in html/mod_whosonline to see the created files.

Template Description Tab[edit]

  • Thumbnail and Description. Information on this template.

Update Files Tab[edit]

If there have been no updates to the template since overrides were created this tab will contain a simple message:

  • Notice. Overridden files are up to date. Nothing has been changed in the last extension or Joomla update.

If there have been updates, a table will show a list of overrides that need to be reviewed.


At the top of the page you will see the toolbar shown in the Screenshot above. The functions are:

The Toolbar icons change with the action being taken. You may see:

  • Save. Saves the item and stays in the current screen.
  • Save & Close. Saves the item and closes the current screen.
  • Copy Template. Copies the current template. A dialog box prompts for a new name.
  • Template Preview. Select to open the Site in a new browser tab.
  • Manage Folders. Allows creation and deletion of template folders using a dialog box.
  • New File. Allows upload of a file from your computer to the template file hierarchy using a dialog box.
  • Rename File. Select a file to edit. Select the Rename button to prompt for a new name.
  • Delete File. You will be prompted to Confirm or Cancel.
  • Close File. Closes the open file and returns to the Editor Tab.
  • Help. Opens this help screen.

The Toolbar icons change with the action being taken. Some of the above are absent on some screens.

Quick Tips[edit]

  • Important: Do not delete the default template files using FTP because it generates an error in both the front-end and back-end.
  • Before editing the HTML and the CSS file of the template, it is a good idea to make a backup of the file you are editing. Also, you can edit these files outside of Joomla! using the HTML or CSS editor of your choice.

Related Information[edit]