API Docs for: WebTemplate API v2.0
Show:

WTType Class

Extends WTNode
Defined in: /data/www/webtemplate/wtv2/codedoc/wtType.php:3
Module: WebTemplate Core

The class representing wtType Nodes

Methods

approveChanges

(
  • [sendEmail=false]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:4546

Approve changes made

Parameters:

  • [sendEmail=false] Boolean optional

copyModerationFrom

(
  • copyFrom
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2253

Copy the moderation settings from a node

Parameters:

  • copyFrom String

    The guid, path or object to copy the moderation from

copyModerationToChildren

(
  • excludeTypes
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2207

Copy the node's moderation settings to its children

Parameters:

  • excludeTypes String

    A comma separated list of types to exclude from the copy

copyPage

(
  • parentPath
  • menuText
  • [copySubPages=false]
)
Object

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:157

Copy the page

Parameters:

  • parentPath String

    The page will be created as a child of this path

  • menuText String

    The Menu Text for the new page

  • [copySubPages=false] Boolean optional

    If set to true, subpages will also be copied

Returns:

Object: The object for the new page node

copyPermissionsFrom

(
  • copyFrom
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2338

Copy the permissions from a node

Parameters:

  • copyFrom String

    The guid, path or object of the node to copy permissions from

copyPermissionsToChildren

(
  • [excludeTypes=""]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2293

Copy the node's permissions to its children

Parameters:

  • [excludeTypes=""] String optional

    A comma seperated list of type to exclude from the copy

create

(
  • parentGuid
  • nodeType
  • attributes
)

Defined in /data/www/webtemplate/wtv2/codedoc/wtType.php:12

Create a wtType node, creates the associated database tables

Parameters:

  • parentGuid Integer

    the guid of the parent node

  • nodeType String

    the type of the node to create - should be "wtType"

  • attributes Array

    the attributes for the node

createChild

(
  • typeName
  • [attributes=NULL]
)
Object

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:4914

Create a child node

Parameters:

  • typeName String
  • [attributes=NULL] Array optional

    The attributes of the child node

Returns:

Object: The child node

createChildFromForm

(
  • typeName
  • attributes
)
Object private

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2786

Create a node from a form submission in the office

Parameters:

  • typeName String

    The name of the type to create

  • attributes Array

    The attributes from the form

Returns:

Object: The object for the node

createTranslationNode

(
  • languageID
)
Object

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:583

Create a node containing a translation of this node

Parameters:

  • languageID Int

    The guid for the language

Returns:

Object: The translation node object

deleteNode

()

Inherited from WTNode but overwritten in /data/www/webtemplate/wtv2/codedoc/wtType.php:82

Delete the node, drop the associated table

export

() Array

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:5050

Create an associative array of a nodes properties and its childrens properties
Useful for saving the state of a page

Returns:

Array: The node and its children as a structure of arrays

forceSecure

()

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:581

Force a page to switch to secure mode

getAncestors

(
  • args
)
Array

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:951

Get all the ancestors of a node as their guid's in an array

Parameters:

  • args Array

    Possible keys are "directAncestors", "type", "useCache"

Returns:

Array: An array of the guid's of the ancestors

getAttribute

(
  • attributeName
  • [latest=false]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1667

Get an attribute of the node

Parameters:

  • attributeName String

    The name of the attribute

  • [latest=false] Boolean optional

    Set to true to get the latest version (possibly draft or unapproved version)

getAttributes

(
  • [latest=false]
)
Array

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2739

Get the attributes of the node as an associative array

Parameters:

  • [latest=false] Boolean optional

    Set to true to get the latest version (could be a draft or unapproved version)

Returns:

Array: returns the attributes of the node

getCreator

() Object

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1453

Get the contact who created this node

Returns:

Object: The object for the creator contact

getDepth

(
  • [stopPath=""]
)
Int

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1479

Get the depth of a node above a path

Parameters:

  • [stopPath=""] Object optional

    The path to find the depth from

Returns:

Int: The depth of the node

getFormHTML

(
  • typeName
  • values
  • args
)
String private

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1714

Get the HTML of a form for the node, used by the office

Parameters:

  • typeName String

    The type to get the form for

  • values Array

    Values to use in the form

  • args Array

    Extra arguments to create the form with

Returns:

String: The HTML for the form

getKeywords

()

Inherited from WTNode but overwritten in /data/www/webtemplate/wtv2/codedoc/wtPage.php:553

Get the keywords for the page
Useful for indexing the page

getLanguageID

() Int

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:503

Get the ID of the language for this node

Returns:

Int: The ID for the language of this node

getModerationChainGuid

() Int

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1150

Get the guid of the Moderation Chain for the node

Returns:

Int: The guid of the moderation chain for the node (0 if none)

getName

() String

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1578

Get the name of the node

Returns:

String: The name of the node

getNextModerationGroupID

() Int

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:4308

If the node is being moderated, get the next group in the moderation chain

Returns:

Int: The guid of the next moderation group

getParent

() Object

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:940

Get the parent node

Returns:

Object: The parent node's object

getParents

(
  • [type=""]
)
Array

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1043

Get the parents of the node as an array of guids
A node may have more than one parent if it has been linked

Parameters:

  • [type=""] String optional

    Limit the parents to a certain type

Returns:

Array: An array of the nodes parents

getPath

(
  • [separator=/]
  • [template]
  • [stopPath]
  • [includeSelf=true]
)
String

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1515

Return the path to the object as a string
Optionally stop at a node instead of the root

Parameters:

  • [separator=/] String optional

    The separator to use to construct the path

  • [template] String optional

    If set, the template to use to construct each element in the path

  • [stopPath] String optional

    The node to stop at when constructing the path

  • [includeSelf=true] Bool optional

    Set to true to include the node in the path

Returns:

String: The path to the node as a string

getTranslationNode

(
  • languageID
  • [createIfNotExist=false]
)
Object

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:524

Get the translation node for this node

Parameters:

  • languageID Int

    The id of the language to get the translation for

  • [createIfNotExist=false] Boolean optional

    Set to true to create a translation node if it doesn't exist

Returns:

Object: Returns the node containing the translation, or NULL if there is no node

getType

() String

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1566

Get the type of the node as a string

Returns:

String: The type of the node as a string

getURI

(
  • [absolute=false]
  • [latest=false]
)
String

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:345

Get the URI for the page

Parameters:

  • [absolute=false] Boolean optional

    If true, return the absolute URI

  • [latest=false] Boolean optional

    If true, return the latest URI (possibly draft version or non approved)

Returns:

String: the URI for the page

getVisibleTextFromHtml

(
  • text
)
String static

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:30

Get the visible text from a HTML document
This is used for generating search text

Parameters:

  • text String

    the HTML to get the text from

Returns:

String: the text from the HTML

hasPermission

(
  • group
  • permissionType
)
Boolean

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2125

Test if a group has a certain permission for the node

Parameters:

  • group String

    The guid or name of the Group (or "__all" to test for public permission)

  • permissionType String

    The type of permission to test for "read", "write" or "list"

Returns:

Boolean: Returns true if the group has permission

insert

(
  • placeNode
  • relation
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1193

Insert the node above or below another node

Parameters:

  • placeNode String

    The node to place the node in relation to (may be guid, path or object)

  • relation Int

    0 for above, 1 for below

insertAfter

(
  • node
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1288

Insert this node after another node, keeping the same parent

Parameters:

  • node String

    The node to insert this node after (may be guid, path or object)

isAncestorOf

(
  • child
)
Boolean

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:349

Test if the node is an ancestor of another node

Parameters:

  • child String

    The guid or path of the child node to test

Returns:

Boolean: Returns true if the node is an ancestor of the child node

isDescendantOf

(
  • parent
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:365

Test is a node is a descendant of another node

Parameters:

  • parent String

    The guid or path of the parent node to test return {boolean} Returns true if the node is a descendant of the parent node

isLockedForModeration

() Boolean

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2058

Test if the node is locked for moderation

Returns:

Boolean: returns true if the node is locked for moderation

linkedToParent

(
  • parentNode
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:266

This function will be called whenever a node is linked to a parent
It can be overridden by subclasses to provide custom functionality

Parameters:

  • parentNode Object

    The parent node this node is being linked to

logEvent

(
  • eventType
  • [moderationChainGuid=0]
  • changes
)
private

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:3058

Log an event

Parameters:

  • eventType Int

    The type of event: 1 create, 2 edit, 3 delete

  • [moderationChainGuid=0] Int optional

    The id of the moderation chain for the node

  • changes String

    The changes made

move

(
  • [direction=1]
  • [moveWithinType=false]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1383

Move this node up or down within its siblings

Parameters:

  • [direction=1] Int optional

    1 for down, -1 for up

  • [moveWithinType=false] Boolean optional

    Set to true to move in relation to its siblings of the same node type

moveToTop

()

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1346

Move this node to the top of its siblings

preEvaluateTemplate

(
  • template
  • templateData
  • args
)

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:399

This function is called just before a template is rendered
It can be overridden and used to send custom data to the template

Parameters:

  • template String

    The template about to be evaluated

  • templateData Array

    The data to send to the template. Modify this array to change the data to be passed to the template

  • args Array

    Extra Data

preRender

()

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:387

This function is called just before the output for the page is to be produced
It can be overridden to provide custom functionality before a page is shown

rejectChanges

(
  • [reason]
  • [sendEmail=false]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:4398

Reject the changes

Parameters:

  • [reason] String optional

    The reason for the rejection

  • [sendEmail=false] Boolean optional

    Set to true to send the moderation email

removeModerationChain

()

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1173

Remove the moderation chain from a node

render

() String

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:418

Return the HTML for the page

Returns:

String: The HTML for the page

restore

(
  • eventID
)

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:197

Restore a page from a previous version

Parameters:

  • eventID Int

    The id of the event representing the version

restoreNode

(
  • node
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:5093

restore a node to a previous version from its exported node

Parameters:

  • node Array

    The data structure representing an exported node

sendModerationApprovedEmail

(
  • eventID
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2836

Send the email informing the editor the edit has been approved by the moderators

Parameters:

  • eventID Int

    The id of the moderation event

sendModerationRejectedEmail

(
  • eventID
  • [reason=""]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2926

Send the email informing the editor their edit was rejected by the moderator

Parameters:

  • eventID Int

    The id related to the moderation event

  • [reason=""] String optional

    The reason for the rejection

sendModerationRequiredEmail

(
  • eventID
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:3006

Send an email to a moderator informing them moderation is required

Parameters:

  • eventID Int

    The moderation event

setAttributes

(
  • attributes
)

Inherited from WTNode but overwritten in /data/www/webtemplate/wtv2/codedoc/wtType.php:98

Set the attributes for the node, alter the database table if necessary

Parameters:

  • attributes Array

    an associated array of the attributes for the node

setAttributesFromForm

(
  • attributes
)
private

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:3717

Set the attributes from form submission in the office

Parameters:

  • attributes Array

setCreatedBy creatorGuid The guid of the contact

()

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1463

Set the creator of the node

setHidden

(
  • [hidden=true]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:242

Hide a node, the node will only be accessible through WebTemplate::getNode

Parameters:

  • [hidden=true] Boolean optional

    Set to true to hide the node

setKeywords

()

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:4272

Set the keywords for the node. Used for search

setModerationChain

(
  • moderationChain
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1123

Set the moderation chain for the node

Parameters:

  • moderationChain Int

    The guid, path, or object for the moderation chain

setName

() String

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:1589

Set the name of the node

Returns:

String: Set the Name of the node

setNodeParents

() private

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:417

Internal function to allow quick searching of all descendants of a node

setParent

(
  • parent
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:393

Change the parent of a node

Parameters:

  • parent String

    The guid or path of the new parent node

setPermission

(
  • group
  • permissionType
  • [set=1]
  • [overwritecurrent=false]
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2382

Set the permissions on the node for a group

Parameters:

  • group String

    The guid or name of the group (or "__all" for public)

  • permissionType String

    Either "read", "write" or "list"

  • [set=1] Int optional

    Set to 1 to add the permission, set to 0 to remove it

  • [overwritecurrent=false] Boolean optional

    Set to true to remove all permissions on the node of the permissionType apart from the one being set

setURI

(
  • [base=""]
  • [uriAttribute="Menu
)

Defined in /data/www/webtemplate/wtv2/codedoc/wtPage.php:233

Set the uri for the page using the Menu Text

Parameters:

  • [base=""] String optional

    A value to attach to the base of the URI

  • [uriAttribute="Menu String

    Text"] The attribute of the page to use to generate the URI

unlinkedFromParent

(
  • parentNode
)

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:276

This function will be called whenever a node is unlinked from a parent
It can be overridden by subclasses to provide custom functionality

Parameters:

  • parentNode Object

    The parent node this node is being unlinked from

userHasPermission

(
  • permissionType
)
Boolean

Inherited from WTNode: /data/www/webtemplate/wtv2/codedoc/wtNode.php:2077

Test if the current user has a permission for the node

Parameters:

  • permissionType String

    Can be "read", "write", "list"

Returns:

Boolean: Returns true if the user has the permission specified