Files
smarty/docs/programmers/resources/resources-extends.md
Simon Wisselink 428a701b18 Feature/add docs (#689)
* Add converted docs repo

* Set theme jekyll-theme-minimal

* Removed BC docs, added TOC

* Added TOCs, rewrote most important links in documentation. Linked README to new Github Pages site

* some link fixes
2021-12-03 11:59:22 +01:00

1.5 KiB

Extends Template Resources

The extends: resource is used to define child/parent relationships for template inheritance from the PHP script. For details see section of Template Interitance.

As of Smarty 3.1 the extends: resource may use any available template resource, including string: and eval:. When templates from strings are used, make sure they are properly (url or base64) encoded. Is an eval: resource found within an inheritance chain, its "don't save a compile file" property is superseeded by the extends: resource. The templates within an inheritance chain are not compiled separately, though. Only a single compiled template will be generated.

Note

Use this when inheritance is required programatically. When inheriting within PHP, it is not obvious from the child template what inheritance took place. If you have a choice, it is normally more flexible and intuitive to handle inheritance chains from within the templates.

<?php
$smarty->display('extends:parent.tpl|child.tpl|grandchild.tpl'); 

// inheritance from multiple template sources
$smarty->display('extends:db:parent.tpl|file:child.tpl|grandchild.tpl|eval:{block name="fooBazVar_"}hello world{/block}'); 
?>

See also Template Inheritance {block} and {extends}.