Home » Documentation » Tags » filter spaceless raw inherit overrules all catinclude catinclude cache with _ extended translation media image_url image print url call comment autoescape ifnotequal ifequal if for block cycle lib now all include include extends trans

overrules

Inherit markup from like named template in another module.

Signal that this template extends a template with the same name in a module with lower priority.

The overrules tag must be the first tag in the template.  A template that overrules another template contains only the extends tag and block tags.

Example, say a template "page.tpl" contains the following:

{% overrules %}
{% block title %} My new title {% endblock %}

All named blocks in this template will replace the similar named blocks in the template “page.tpl” that is "next in line" to be used.

This is useful if you want to use a template from a module, and the template is mentioned in (for example) a dispatch rule.  Now you can overrule and extend that template in your own modules without changing the dispatch rules or the original module.

Make sure your module has a higher priority (lower number) than the module containing the overruled template.

See also the {% block %}, {% inherit %} and {% extends %} tags and template inheritance.