Class: I2CE Template (4.1.4)

For other versions, see Class: I2CE_Template (versions) .

This article describes the class I2CE_Template .

Extends the class: I2CE_TemplateMeister.
Location: Part of the module pages in the package I2CE 4.1.4-release
Source: Defined in the file modules/Pages/lib/I2CE_Template.php on line 28

Variables

$files_loaded

An array of files that have been loaded so they're aren't added in twice. The keys are the file names, the value is true if it has been loaded, unset otherwise

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 215
Type: protected array $files_loaded

Methods

__construct()

I2CE_Template constructor method. This constructor sets up the basic variables for all I2CE_Template objects. $loadOptions is set to zero.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 228
Signature: public function __construct()

_loadFile()

Helper method. Load a file into the spectified document as HTML

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 78
Signature: public function _loadFile($doc,$contentfile)
Parameters:
- DOMDocument $doc
- string $contentfile
  the file to load
Returns: boolean
False on failure,

_loadText()

Helper method. Load text into the spectified document as XML @param string $contentfile the file to load

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 163
Signature: protected function _loadText($doc,$text,$setEncoding)
Parameters:
- DOMDocument $doc
- $text
- string $setEncoding
  Defaults to true. If true, set the encoding to be that of the docuemnt. Only useful as false for loading root template files
  - Default Value: true
Returns: boolean
False on failure,

addClass()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 31
Signature: public function addClass($node,$class)
Parameters:
- $node
- $class

addHeaderLink()

Add a script or css to the header as a link

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 658
Signature: public function addHeaderLink($file,$attr,$use_filedump)
Parameters:
- string $file
- mixed $attr
  an array of attribute/value pairs. Defaults to the empty array. can also be a string in which case it is the id that you want to give the import node.
  - Default Value: array()
- boolean $use_filedump
  default to true meaning that we should use the filedump utility when looking for the script/css @returm DOMNode -- the node just created or appended to You might use this by calling addHeaderLink("printer.css",,array('media'=>'print')); Note: Uses the file's extension to determine the proper behavior. Valid ones are 'js', 'css', and 'vb'
  - Default Value: true

addHeaderText()

Add text to the header of the document.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 605
Signature: public function addHeaderText($text,$type,$as_separate_node,$init_text)
Parameters:
- string $text
- string $type
  one of 'css',javascipt','vbscript'
- mixed $as_separate_node
  whether or not we want add the node as a separate node or append it (default to false-- append). It will append it to the last node if so. If it is a string, then we create a new node and set the id of a node to the given string, or append to an existing node with that id. If it is a DOMNode then we just append to that node
  - Default Value: false
- string $init_text
  the text we ar adding as a separate node and the node does not exist. Defaults to the empty string
  - Default Value:
Returns: DOMNode
the node just created or appended to. False on failure Note the text does not have to be wrapped in <$tag> node. If not, it will put it in a <$tag> node with reasonalbe attributes.

checkRolesTasksAndPermissions()

Remove any restricted access elements of the page. This method processes all elements in the document that have a role attribute. If there is no known user or the user doesn't have access to that role then the entire node will be removed from the document. @param I2CE_User $user

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 426
Signature: public function checkRolesTasksAndPermissions($node)
Parameters:
- DOMNode $node
  Defaults to null, meaning we check the whole document. Otherwise, we check relaive to that role
  - Default Value: null

ensureCSSURLs()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 294
Signature: static public function ensureCSSURLs($css)
Parameters:
- $css

ensureURL()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 303
Signature: static public function ensureURL($url)
Parameters:
- $url

findTemplate()

This method finds the location of a template file. If the file is not an absolute path searches the class path 'TEMPLATES' This method searches the template directory path from the global configuration array for the given template. If it exists it returns the full path to the file and if not it returns false. It seaches the path backwards so that later directories can override package versions of files.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 192
Signature: public function findTemplate($template,$raise_error)
Parameters:
- string $template
  The name of the template file.
- boolean $raise_error
  Defaults to true. Raise error if template is not found
  - Default Value: true
Returns: mixed

fixupAnchors()

Fixes any href's starting with # so that they work properly Also makes sure that any relative URL include an index.php if .htaccess is not used.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 240
Signature: protected function fixupAnchors()

getDisplay()

Returns the displayed page as a string

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 328
Signature: public function getDisplay()
Returns: string

hasClass()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 47
Signature: public function hasClass($node,$class)
Parameters:
- $node
- $class

prepareDisplay()

Called to prepare the display.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 315
Signature: public function prepareDisplay()

processArgs()

Process any arguments sent to the page

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 472
Signature: public function processArgs($args)
Parameters:
- $args
Returns: boolean
true on sucess. false on failure

processLoopCount()

Recursively process all child nodes that are being added in a loop to replace the designator text.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 560
Signature: protected function processLoopCount($node,$designator,$count)
Parameters:
- DOMNode $node
- string $designator
- integer $count @see replaceCount

removeClass()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 59
Signature: public function removeClass($node,$class)
Parameters:
- $node
- $class

removeProprietaryAttr()

Remove the proprietary HTML attributes from tags before outputting the content through tidy. Commented out for now until the best course of action can be determined.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 373
Signature: protected function removeProprietaryAttr()

removeTranslatorComments()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 360
Signature: protected function removeTranslatorComments()

replaceCount()

Replace the given designator text with the loop count of the template file being added. If the node is a DOM element then the designator text with the number of the count.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 576
Signature: protected function replaceCount($node,$designator,$count)
Parameters:
- DOMNode $node
- string $designator
- integer $count

setBase()

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 403
Signature: protected function setBase()

setBodyAttr()

Adds an attribute to the body tag of this document. This will find the body tag of the document and add or replace the given attribute with the given value.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 528
Signature: public function setBodyAttr($attr,$value)
Parameters:
- string $attr
- string $value

setBodyId()

Sets the id attribute for the body tag. This will find the body tag of the document and add or replace the id attribute with the given id.

Defined in i2ce/modules/Pages/lib/I2CE_Template.php on line 545
Signature: public function setBodyId($id)
Parameters:
- string $id

setTitle()

Set the HTML title of the page. This will find the first title element of the page and replace the text in it with the given title. There should only be one title element in a valid HTML page.