====== Core Include Tag ======
===== Summary =====

Include the contents of a file into the current template

===== Syntax =====

<code html>
<core:include file="_filename_" literal>
</code>

===== Description =====

Components can be embedded inside the included file. These components become part of the enclosing document.

If you use the optional literal attribute in your include tag, then the contents of the included file is NOT parsed. (See [[tag:core:literal]])

Ironically this is a J2EE design pattern - the [[pattern:Composite View]]

==== Filename Resolution ====

Currently, the ''<core:include>'' tag does not support filenames which cannot be determined at the time of compiling the template. That is, you cannot load variable content with this tag. Therefore, the following will not work:

<code html>
<core:include file="{$contentpage}.tpl.htm">
</code>

The [[tag:core:wrap|wrap tag]] will do exactly what you need though (just the other way round). Please see the the example provided there.

===== See Also =====
The [[tag:core:include]] is implemented by the [[api:template:compiler:CoreIncludeTag]] class.