| Important: Don’t edit the HTML within the include tags in the templates—they too will be lost then next time generate PHP pages is run. |
This is a utility that is very helpful when working with the templates. In all the store templates, you will notice the presence of either:
A.
<!--begin_include=page_header-->
....Some HTML code here....
<!--end_include=page_header-->
Or,
B.
[[include(page_header)]]
If you see (A), the template includes have not been stripped away. That means, that when you view the template, all the header, left-nav, style-sheets, etc. will be rendered along with the template body. This makes working with the templates much like working with regular HTML pages. But, it is still a file include, meaning, that when the PHP pages are generated, the HTML between the tags are ignored, and the contents of the current include file is substituted for all code between the tags.
If you see (B), the template includes have been stripped away, and the contents of the current include file will be displayed only when the PHP page is called. If you like to work strictly on HTML source, then you might want to use the “strip includes” for easier editing.
The update template includes can either change (A) to (B) or the other way around. When not stripping the include file, it will take the current include file and substitute the code into the template, so you will see an updated header, footer, etc. when working with the template.
After you customize the page_header, left_nav, and page_footer, it is recommended that you can run the Update Template Includes to update all the templates with these parts.
More on working with templates and include files. . .
|