The cfinclude tag adds the contents of a ColdFusion page to another ColdFusion page, as if the code on the included page was part of the page that uses the cfinclude tag. It lets you pursue a "write once use multiple times" strategy for ColdFusion elements that you incorporate in multiple pages. Instead of copying and maintaining the same code on multiple pages, you can store the code in one page and then reference it in many pages. For example, the cfinclude tag is commonly used to place a header and footer on multiple pages. This way, if you change the header or footer design, you only change the contents of a single file.
The model of an included page is that it is part of your page; it just resides in a separate file. The cfinclude tag cannot pass parameters to the included page, but the included page has access to all the variables on the page that includes it. The following image shows this model:
When you use the cfinclude tag to include one ColdFusion page in another ColdFusion page, the page that includes another page is referred to as the calling page. When ColdFusion encounters a cfinclude tag it replaces the tag on the calling page with the output from processing the included page. The included page can also set variables in the calling page.
The following line shows a sample cfinclude tag:
<cfinclude template = "header.cfm">
You cannot break CFML code blocks across pages. For example, if you open a cfoutput block in a ColdFusion page, close the block on the same page; you cannot include the closing portion of the block in an included page.
ColdFusion searches for included files as follows:
A page must not include itself. Doing so causes an infinite processing loop. To resolve the problem, stop the ColdFusion_ server._
(For this example to work, you must also place your logo as a GIF file in the same directory as the header.cfm file.)
Create a ColdFusion page with the following content:
<head> <title>Test for Include</title> </head> <body> <cfinclude template="header.cfm"> </body> </html>
Consider using the cfinclude tag in the following cases: