ExpressionEngine Docs

Template Overview

What is a Template?

Templates can be considered as a single page of your site, but they’re much more than that. In ExpressionEngine, a template can be any of the following:

Because a Template is just a container that outputs information, you can create Templates for any type of data you need to present (RSS, CSS, HTML, XML, etc.).

Templates can also be a smaller component of your page. Through the use of the Embed Tag you can insert a Template into another Template.

How They Work

Templates are organized into Template Groups. A Template Group is analogous to a folder on your server.

In ExpressionEngine, a URL always contains the following structure, which allows a Template Group and a specific Template to be shown:

http://example.com/template_group/template

In addition to HTML and other markup, templates usually contain ExpressionEngine Tags, which allows information to be served dynamically.

Creating a Template

Templates can be created and edited in the Developer -> Templates area of your Control Panel.

ExpressionEngine, by default, saves Template Groups, Templates, Global Variable, and Template Partials as regular folders and files on your server at system/user/templates. This allows you to use your preferred text editor to edit Templates and then FTP the changes to the server.

These are the naming rules that ExpressionEngine applies to these resources:

You can also choose to save templates in the database using this system configuration override.

Hidden Templates

Sometimes it is undesirable to allow access to a template via a URL. For instance, a template that you only use as an embedded template would likely be an incomplete HTML document, and you wouldn’t want visitors to be able to view that template by itself.

“Hidden” templates are just that: templates that cannot be accessed from a URL, but can be used as embedded templates. To make a template “hidden”, give it a name preceded by an underscore, e.g. _my_hidden_template.

When someone attempts to access a hidden template via a URL, one of two things will occur. If you have specified a 404 template in your Template Settings, then the 404 template will be displayed, with 404 headers. If you have not specified a 404 template, then the index template of the requested template group will be displayed.

Changing the Hidden Template Indicator

By default, a template is hidden when an underscore prefixes the template name, but this can be changed with a configuration variable set in system/user/config/config.php:

$config['hidden_template_indicator'] = '.';

Hit Counters

Every time a template is accessed, a counter is incremented. To display the number of hits, put the following variable in any template:

{hits}

The hit count for each template can be manually altered in the template’s preferences under Developer --> Templates.

PHP in Templates

Important: Enabling PHP in a template enables anyone with editing rights for that template to become a de-facto Super Admin since they can execute any PHP they want in that template, including PHP that can reveal information about your system, PHP that can delete data from your database, etc. Exercise extreme caution before enabling this option if you permit others to edit your templates. Additionally, PHP code in templates will operate slower than same code wrapped in plugin or module function.

ExpressionEngine allows you to place PHP code within your Templates so that it can be executed, allowing more dynamic capability with your content.

In order for this feature to be available, it needs to be enabled by adding

    $config['allow_php'] = 'y';

to your config.php file.

Important: When upgrading from an earlier version of ExpressionEngine to v6, the allow_php config override will automatically be set to ‘y’ if templates already exists that have PHP enabled.

To enable PHP in particular template, set the Allow PHP? setting to Yes. Because PHP is a per-template setting, you can embed a Template that has PHP enabled into another Template which does not have PHP enabled.

PHP Parsing Stage

There are two choices for when PHP gets parsed:

You can read more about template parsing order here: Template Engine.