Class: I2CE Page (Development)

From IHRIS Wiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


This article describes the class I2CE_Page .

Variables

$template

The template object for handling the HTML templates and data to be displayed.

$defaultHTMLFile

The default HTML/XML files to be displayed by the template. of string

$role

The role that can view this page.

$user

The user viewing this page.

$access

The access level required for this page.

$redirect

A url to redirect to instead of displaying the page.

$post

Holds a reference to the $_POST array which is a list of all data sent from a form.

$get

Holds a reference to the $_GET array which is a list of all variables sent in the URL or from a form with an action of "GET."

$page_root

the page root -- this is the URL relative to the site base that is used to get to this page.

$page_remainder

the page remainder -- this is the remainder of the URL relative to the site base that is used to get to this page.

$args

The arguments passed in the constructor. @param protected array $args

$request_remainder

The remainder of the page request -- everything after (option_module_name/)page_name(/reminder/of/the/request) @param protected array $request_remainder

$permissionParser

The permission parser for the user of this page. @param I2CE_PermissionParser $permissionParser

$root_url

$page

. The requested page

$module

. The module that contains this page.

$is_post

-- true if this page is a post.

$session_req

Holds a reference to a session request array if one has been requested and exists in the session.

$request_vars

Methods

__construct()

Create a new instance of a page. The default constructor should be called by any pages extending this object. It creates the and objects and sets up the basic member variables.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 274
  • Signature: public function __construct($args,$request_remainder,$get,$post)
  • Parameters:
    • array $args
    • array $request_remainder
      The remainder of the request path
    • $get
      • Default Value: null
    • $post
      • Default Value: null

_display()

Display the template as HTML/XML. Sets the header and displays any buffered warnings/echoed text.

_flattenRequestVars()

action()

Perform any actions

actionCommandLine()

The business method if this page is called from the commmand line

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 662
  • Signature: protected function actionCommandLine($args,$request_remainder)
  • Parameters:
    • array $args
      the array of unix style command line arguments Arguements are link that in: http://us3.php.net/manual/en/features.commandline.php#78651 If we were called as: index.php --page=/module/page/some/thing/else --long -AB 2 -C -D 'ostrich' --eggs==good Then $request_remainder = array('some','thing','else') and $args = array('long'=>true, 'A'=>true, 'B'=>2, 'C'=>true, 'D'=>'ostrich', 'eggs'=>'good')
    • array $request_remainder
      the remainder of the request after the page specfication.

display()

Calls the appropriate action for the page. Then it Displays or redirects the page as appropriate. This will check to make sure the page can be seen by this user and if not redirect them to an error page. If the redirect variable has been set then the page will be redirected to the new page. Otherwise the  ::display() template display method will be called to output the combined template files to the browser.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 509
  • Signature: public function display($supress_output)
  • Parameters:
    • boolean $supress_output
      defaults to false. set to true to supress the output of a webpage
      • Default Value: false

displayCommandLine()

Main display method for command line interface

displayWeb()

Main display method for web interface

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 532
  • Signature: protected function displayWeb($supress_output)
  • Parameters:
    • boolean $supress_output
      defaults to false. set to true to supress the output of a webpage
      • Default Value: false

fixupRequestVariables()

Applies any transformations (make sure magic quotes is off, nesting, and json decoding) to an array variables @param boolean $transform. Defaults to true

flattenRequestVars()

get()

Gets/sets the $get value for the given key.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 822
  • Signature: public function get($key,$val)
  • Parameters:
    • string $key
      Defaults to null meaning we return all of the post variables (it is not slash escaped).
      • Default Value: null
    • mixed $val
      Defaults to null. If non-null we set the post value for $key to $val
      • Default Value: null
  • Returns: mixed
    if no val is set: string if a key is given and found. null if key is given nut not found. array otherwise

getAccess()

Get the access level required to view this page. If the access level requirements change after the page object has been instantiated this method is used to set a new access level for the $access variable.

getAccessedBaseURL()

Returns the base url from which the site was accessed. If no .htaccess is used, ths will include the index.php. If rewrites are used (via .htacces) this will no include the index.php. Point is... this is the base url from which the site was accessed, no questions asked. This of course assumes that you are now accessing the site via the command line

getTemplate()

Get the template associated to this page

getTitle()

Return the title for this page.

getURLRoot()

getUser()

Get the user of this page

get_exists()

Check to see if a key exists in the $get array.

hasPermission()

Parse a permission string to see if we have permission.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 260
  • Signature: public function hasPermission($permission,$node)
  • Parameters:
    • string $permission
    • DOMNode $node
      Defaults to null. If set, it is the node in the page's template that we get the data for.
      • Default Value: null
  • Returns: boolean.
    Null on failure.

initPage()

Initializes any data for the page

initializeTemplate()

Handles creating hte I2CE_TemplateMeister templates and loading any default templates

isGet()

Check to see if the current page is a GET request or not

isPost()

Check to see if the current page is a POST form submission or not.

loadHTMLTemplates()

Load the template (HTML or XML) files to the template object.

module()

Sets/Gets the module.

page()

Sets/Gets the page.

pageRemainder()

Get/set the page remainder -- this is the remainder of the URL relative to the site base that is used to get to this page. @param $page_remainder Defaults to null. If non-null we set the page remainder. If null we get the page remainder.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 197
  • Signature: public function pageRemainder($page_remainder)
  • Parameters:
    • $page_remainder
      • Default Value: null
  • Returns: string
    if $page_remainder was null(default)

pageRoot()

Get/set the page root -- this is the URL relative to the site base that is used to get to this page. @param $page_root Defaults to null. If non-null we set the page root. If null we get the page root.

post()

Get/set the $post value for the given key.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 760
  • Signature: public function post($key,$val)
  • Parameters:
    • string $key
      Defaults to null meaning we return all of the post variables (it is not slash escaped).
      • Default Value: null
    • mixed $val
      Defaults to null. If non-null we set the post value for $key to $val
      • Default Value: null
  • Returns: mixed
    if no val is set: string if a key is given and found. null if key is given nut not found. array otherwise

post_exists()

Check to see if a key exists in the $post array.

redirect()

Send the redirect header with the given URL.

request()

Return the given value for the key in one of the request arrays.

request_exists()

Checks all the request arrays for the given key and returns true if it exists.

rewrittenURLs()

returns true if the url's have been written. false if not

session_req()

Gets/sets the $session_req value for the given key.

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 891
  • Signature: public function session_req($key,$val)
  • Parameters:
    • string $key
      Defaults to null meaning we return all of the post variables (it is not slash escaped).
      • Default Value: null
    • mixed $val
      Defaults to null. If non-null we set the post value for $key to $val
      • Default Value: null
  • Returns: mixed
    if no val is set: string if a key is given and found. null if key is given nut not found. array otherwise

session_req_exists()

Check to see if a key exists in the $session_req array.

setAccess()

Change the access level required to view this page. If the access level requirements change after the page object has been instantiated this method is used to set a new access level for the $access variable. @param array of string

setActiveMenu()

Set the active menu

setIsPost()

Sets if this pages is a post or not

setRedirect()

Set the URL to be redirected to instead of displaying this page.

setupGetPost()

setup of the get and post variables. @param array $psot. If null (default) it will be $_POST if it is a HTTP array request. otherwise it is the empty array

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 354
  • Signature: protected function setupGetPost($get,$post,$strip)
  • Parameters:
    • array $get
      If null (default) it will be $_GET if it is a HTTP request. otherwise it is the empty array
      • Default Value: null
    • $post
      • Default Value: null
    • boolean $strip
      Defauls to true. If true it will try to strip off magic quotes if they exist for a HTTP request.
      • Default Value: true

Inherited Methods

_hasMethod()

This public method is inherited from I2CE_Fuzzy->_hasMethod()

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()

Fuzzy Methods

launchBackgroundProcess()

This method is implemented by I2CE_BackgroundProcess->launchBackgroundProcess()

launchBackgroundPHPScript()

This method is implemented by I2CE_BackgroundProcess->launchBackgroundPHPScript()

launchBackgroundPage()

This method is implemented by I2CE_BackgroundProcess->launchBackgroundPage()

addColorPickerTriple()

This method is implemented by I2CE_Module_ColorPicker->addColorPickerTriple()

addReportSelector()

This method is implemented by I2CE_Module_ReportSelector->addReportSelector()

addDatePicker()

This method is implemented by I2CE_Module_DatePicker->addDatePicker()

selectOptionsImmediate()

This method is implemented by I2CE_DisplayData->selectOptionsImmediate()

setDisplayData()

This method is implemented by I2CE_DisplayData->setDisplayData()

setDisplayDataImmediate()

This method is implemented by I2CE_DisplayData->setDisplayDataImmediate()

addFormWorm()

This method is implemented by I2CE_Module_FormWorm->addFormWorm()

getClassValue()

This method is implemented by I2CE_MootoolsCore->getClassValue()

loadClassValues()

This method is implemented by I2CE_MootoolsCore->loadClassValues()

setClassValue()

This method is implemented by I2CE_MootoolsCore->setClassValue()

setClassValues()

This method is implemented by I2CE_MootoolsCore->setClassValues()

useDropDown()

This method is implemented by I2CE_MootoolsCore->useDropDown()

addOption()

This method is implemented by I2CE_Template_Options->addOption()

addOptions()

This method is implemented by I2CE_Template_Options->addOptions()

addAutoCompleteInputTreeById()

This method is implemented by I2CE_Module_TreeSelect->addAutoCompleteInputTreeById()

addAutoCompleteInputTree()

This method is implemented by I2CE_Module_TreeSelect->addAutoCompleteInputTree()

setForm()

This method is implemented by I2CE_Module_Forms->setForm()

getForm()

This method is implemented by I2CE_Module_Forms->getForm()

getField()

This method is implemented by I2CE_Module_Forms->getField()

setReview()

This method is implemented by I2CE_Module_Forms->setReview()

isReview()

This method is implemented by I2CE_Module_Forms->isReview()

makeJumper()

This method is implemented by I2CE_Module_Jumper->makeJumper()

makeScalingJumper()

This method is implemented by I2CE_Module_Jumper->makeScalingJumper()

menuSelect()

This method is implemented by I2CE_Module_MenuSelect->menuSelect()

addUpdateSelect()

This method is implemented by I2CE_Module_MenuSelect->addUpdateSelect()

addAjaxUpdate()

This method is implemented by I2CE_Stub->addAjaxUpdate()

addAjaxLoad()

This method is implemented by I2CE_Stub->addAjaxLoad()

addAjaxToggle()

This method is implemented by I2CE_Stub->addAjaxToggle()

addAjaxRequestFunction()

This method is implemented by I2CE_Stub->addAjaxRequestFunction()

addAjaxCompleteFunction()

This method is implemented by I2CE_Stub->addAjaxCompleteFunction()

addAjaxToggleOnFunction()

This method is implemented by I2CE_Stub->addAjaxToggleOnFunction()

addAjaxToggleOffFunction()

This method is implemented by I2CE_Stub->addAjaxToggleOffFunction()

hasAjax()

This method is implemented by I2CE_Stub->hasAjaxFuzzy()

setDataTypePriority()

This method is implemented by I2CE_Module_TemplateData->setDataTypePriority()

setData()

This method is implemented by I2CE_Module_TemplateData->setData()

getData()

This method is implemented by I2CE_Module_TemplateData->getData()

getDefaultData()

This method is implemented by I2CE_Module_TemplateData->getDefaultData()

removeData()

This method is implemented by I2CE_Module_TemplateData->removeData()

getDataNames()

This method is implemented by I2CE_Module_TemplateData->getDataNames()

ensureNode()

This method is implemented by I2CE_Module_TemplateData->ensureNode()