{"result":{"depiction_url":null,"edges":{"in_module":{"objects":[{"created":"2020-05-30T05:47:51Z","object_id":{"id":1296,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_base","title":"mod_base","uri":"https:\/\/zotonic.com\/id\/1296"},"seq":1000000}],"predicate":{"id":333,"is_a":["meta","predicate"],"name":"in_module","title":{"_type":"trans","tr":{"en":"In module"}},"uri":"https:\/\/zotonic.com\/id\/in_module"}},"references":{"objects":[{"created":"2020-05-30T05:47:51Z","object_id":{"id":1325,"is_a":["text","documentation","reference","template_tag"],"name":"doc_template_tag_tag_catinclude","title":"catinclude","uri":"https:\/\/zotonic.com\/id\/1325"},"seq":1000000},{"created":"2020-05-30T05:47:51Z","object_id":{"id":1536,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_access_control","title":"Access control","uri":"https:\/\/zotonic.com\/id\/1536"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"refers":{"objects":[{"created":"2026-09-09T13:47:53Z","object_id":{"id":1325,"is_a":["text","documentation","reference","template_tag"],"name":"doc_template_tag_tag_catinclude","title":"catinclude","uri":"https:\/\/zotonic.com\/id\/1325"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"relation":{"objects":[{"created":"2020-05-30T05:47:51Z","object_id":{"id":1534,"is_a":["text","documentation","reference","controller"],"name":"doc_controller_controller_page","title":"controller_page","uri":"https:\/\/zotonic.com\/id\/1534"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-09T13:47:53Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2608,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_routing_and_redirects","title":"Routing and redirects","uri":"https:\/\/zotonic.com\/id\/2608"},"seq":3},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2620,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_template","title":"Template","uri":"https:\/\/zotonic.com\/id\/2620"},"seq":4},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2626,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_controller","title":"Controller","uri":"https:\/\/zotonic.com\/id\/2626"},"seq":5},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2641,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_render","title":"Render","uri":"https:\/\/zotonic.com\/id\/2641"},"seq":6},{"created":"2026-09-09T13:47:53Z","object_id":{"id":2672,"is_a":["categorization","keyword","keyword_technology"],"name":"zotonic_topic_html","title":"HTML","uri":"https:\/\/zotonic.com\/id\/2672"},"seq":7}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1537,"is_a":["text","documentation","reference","controller"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1537"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_controller_controller_template","page_url":{"en":"https:\/\/zotonic.com\/docs\/1537\/controller_template","x-default":"https:\/\/zotonic.com\/docs\/1537\/controller_template"},"preview_url":null,"resource":{"version":3325,"pivot_location_lat":null,"title":"controller_template","is_authoritative":true,"body":"

Show a template.<\/p>\n

This controller renders the template configured in the dispatch rules.<\/p>\n

Example dispatch rule:<\/p>\n

{home, [], controller_template, [{template, "home.tpl"}]}\n<\/code><\/pre>\n
This will render the home.tpl<\/code> template at the url \/<\/code>.<\/p>\n
Dispatch arguments<\/h2>\n
controller_template<\/code> recognizes the following arguments inside the dispatch pattern:<\/p>\n
Argument<\/th>Description<\/th>Example URL<\/th><\/tr><\/thead>
id<\/code><\/td>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.<\/td>\/page\/12345<\/code><\/td><\/tr><\/tbody><\/table>\n
Dispatch options<\/h2>\n
The following options can be given to the dispatch rule:<\/p>\n
Option<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
template<\/code><\/td>Name of the template to be rendered. Can also be a tuple of the following form: {cat, Name}<\/code>. See also: tag#catinclude<\/code><\/a>.<\/td>{template, "home.tpl"}<\/code> {template, {cat, "home.tpl"}}<\/code><\/td><\/tr>
anonymous<\/code><\/td>Render the template always as the anonymous user, even when a user is logged on. Defaults to false.<\/td>{anonymous, true}<\/code><\/td><\/tr>
content_type<\/code><\/td>The content type provided by the dispatch rule. Defaults to "text\/html"<\/code>.<\/td>{content_type, "application\/json"}<\/code><\/td><\/tr>
max_age<\/code><\/td>The number of seconds of how long to cache this file in the browser. Sets the response header Cache-Control: public; max-age=X<\/code>.<\/td>{max_age, 3600}<\/code><\/td><\/tr>
acl_action<\/code><\/td>What ACL action will be checked. Defaults to view<\/code>; but can also be edit<\/code> if users need edit permission on the rsc to be able to access the resource.<\/td>{acl_action, edit}<\/code><\/td><\/tr>
acl<\/code><\/td>Extra authorization checks to be performed.<\/td>See ACL options<\/a>.<\/td><\/tr>
id<\/code><\/td>Id or unique name of a resource to be referenced in the rendered template. This overrules an id from the query arguments.<\/td>{id, page_about}<\/code><\/td><\/tr>
seo_noindex<\/code><\/td>Ask crawlers to not index this page.<\/td>seo_noindex<\/code><\/td><\/tr>
nocache<\/code><\/td>Prevent browser caching this page.<\/td>nocache<\/code><\/td><\/tr>
http_status<\/code><\/td>The HTTP status code to return. This defaults to 200<\/code>.<\/td>{http_status, 418}<\/code><\/td><\/tr><\/tbody><\/table>\n
ACL options<\/h2>\n
Authorization<\/a> checks to perform, in addition to the acl_action<\/code> dispatch option, can be given in the acl<\/code> dispatch option, and accepts the following options:<\/p>\n
ACL option<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
is_auth<\/code><\/td>Disable anonymous access to this resource.<\/td>{acl, is_auth}<\/code><\/td><\/tr>
logoff<\/code><\/td>Log out user before processing the request.<\/td>{acl, logoff}<\/code><\/td><\/tr>
{Action, Resource}<\/code><\/td>Check if user is allowed to perform Action<\/code> on Resource<\/code>. The example is equivalent to the options {acl_action, edit}, {id, my_named_page}<\/code>.<\/td>{acl, {edit, my_named_page}}<\/code><\/td><\/tr>
[{Action, Resource}]<\/code><\/td>A list of checks to be performed, as above.<\/td>{acl, [{view, secret_page}, {update, 345}]}<\/code><\/td><\/tr>
ignore<\/code><\/td>Don’t perform any access control checks. Be careful to add your own checks in the rendered template and all its included templates.<\/td>{acl, ignore}<\/code><\/td><\/tr><\/tbody><\/table>","slug":"controller_template","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"ab4b68a4a7f4341a4c75ad60f8b05c45cb3dd3837dc6feeb02afdc10f410b6e9","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":321,"is_a":["meta","category"],"name":"controller","title":"Controllers","uri":"https:\/\/test.zotonic.com\/id\/321"},"doc_source_path":"apps\/zotonic_mod_base\/src\/controllers\/controller_template.erl","publication_start":"2023-01-30T19:23:58Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_base\/src\/controllers\/controller_template.erl","pivot_location_lng":null,"doc_source_kind":"controller","name":"doc_controller_controller_template","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:25Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_base","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"b8c4b2ccdc223257f311968fbd17b2d66f0c4156\n","erlang_module":"controller_template","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-09-30T09:39:41Z","title_slug":"controller_template"},"uri":"https:\/\/zotonic.com\/id\/1537","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1537"}},"status":"ok"}