include Tag

	Documentation
	Getting Started
	New Features
	Component Guide

	Programming
	Language Guide
	Language Ref.
	General Design
	Lexical Structure
	Expressions
	Objects
	Methods
	Classes
	heitml Tags
	? Tag
	assign Tag
	defautoclose Tag
	break Tag
	callenv Tag
	dbdatabase Tag
	dbquery Tag
	dbupdate Tag
	def Tag
	defclass Tag
	defbody Tag
	defenv Tag
	defhtml Tag
	defwysiwyg Tag
	for Tag
	forin Tag
	forsep Tag
	if Tag
	elsif Tag
	else Tag
	include Tag
	includeonce Tag
	inherit Tag
	let Tag
	mail Tag
	return Tag
	shell Tag
	while Tag
	writefile Tag
	\ Tag
	heitml Functions
	Database Access
	Global Variables
	Form Fields
	Server Variables
	Sessions
	heitml Syntax
	Component Ref.
	Class Library
	User Components
	Tryout Form
	Tutorial
	heitml 1

	User Guide
	Registration


	Frame

include Tag

Format: <include Filename>

Format: <include> heitml </include>

Purpose: The first format includes the content of the given filename. The include is performed statically, when reading the .hei file. The file may contain defines needed for the current page. The include tag may not be combined with other tags in a pair of <> brackets, e.g. combining

<include std.hei><include basic.hei>

<include std.hei;include basic.hei>

is not allowed.

The alternate form includes a file of which the filename can be calculated dynamically. The file is read in only at execution time.

Anything you type between the opening and closing include tags is processed in HTML mode where the resulting string output is not sent to the browser, as usual, but used as the name of the file to be included.

Configuration: If the configuration option secure is switched on, there are some restrictions on the file name:

If configuration option includeall is switched off, the file name
1. must not contain "..", and
2. must not denote a symbolic link.
The file name must not be an absolute path.
The file name must have one of the following extensions: .hei, .heitml, .htm, .html, .asp or .htx.

The include tag uses the configuration parameter include which specifies an include path that is searched from left to right for a directory containing the filename given.

Note: The include Tag is Case Sensitive, which means heitml will not recognize it if you use capital letters (e.g. <INCLUDE Filename>).