controller_template
Show a template.
This controller renders the template configured in the dispatch rules.
Example dispatch rule:
{home, [], controller_template, [{template, "home.tpl"}]}This will render the home.tpl template at the url /.
Dispatch arguments
controller_template recognizes the following arguments inside the dispatch pattern:
| Argument | Description | Example URL |
|---|---|---|
id | A resource id to be used in the template. This can be the numerical id or the unique name of a page. More commonly the id is given as a dispatch option. | /page/12345 |
Dispatch options
The following options can be given to the dispatch rule:
| Option | Description | Example |
|---|---|---|
template | Name of the template to be rendered. Can also be a tuple of the following form: {cat, Name}. See also: catinclude. | {template, "home.tpl"} {template, {cat, "home.tpl"}} |
anonymous | Render the template always as the anonymous user, even when a user is logged on. Defaults to false. | {anonymous, true} |
content_type | The content type provided by the dispatch rule. Defaults to "text/html". | {content_type, "application/json"} |
max_age | The number of seconds of how long to cache this file in the browser. Sets the response header Cache-Control: public; max-age=X. | {max_age, 3600} |
acl_action | What ACL action will be checked. Defaults to view; but can also be edit if users need edit permission on the rsc to be able to access the resource. | {acl_action, edit} |
acl | Extra authorization checks to be performed. | See ACL options. |
id | Id or unique name of a resource to be referenced in the rendered template. This overrules an id from the query arguments. | {id, page_about} |
seo_noindex | Ask crawlers to not index this page. | seo_noindex |
nocache | Prevent browser caching this page. | nocache |
http_status | The HTTP status code to return. This defaults to 200. | {http_status, 418} |
ACL options
Authorization checks to perform, in addition to the acl_action dispatch option, can be given in the acl dispatch option, and accepts the following options:
| ACL option | Description | Example |
|---|---|---|
is_auth | Disable anonymous access to this resource. | {acl, is_auth} |
logoff | Log out user before processing the request. | {acl, logoff} |
{Action, Resource} | Check if user is allowed to perform Action on Resource. The example is equivalent to the options {acl_action, edit}, {id, my_named_page}. | {acl, {edit, my_named_page}} |
[{Action, Resource}] | A list of checks to be performed, as above. | {acl, [{view, secret_page}, {update, 345}]} |
ignore | Don’t perform any access control checks. Be careful to add your own checks in the rendered template and all its included templates. | {acl, ignore} |
See also