Class: I2CE Page: Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
Line 69: Line 69:
** [[Class: I2CE_Page_TasksAndRoles | I2CE_Page_TasksAndRoles]]
** [[Class: I2CE_Page_TasksAndRoles | I2CE_Page_TasksAndRoles]]
*Location: Part of the module [[I2CE Module List#pages|pages]] in the package [https://launchpad.net/i2ce I2CE]
*Location: Part of the module [[I2CE Module List#pages|pages]] in the package [https://launchpad.net/i2ce I2CE]
*Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.1-release/annotate/head:/modules/Pages/lib/I2CE_Page.php modules/Pages/lib/I2CE_Page.php]
*Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L37 modules/Pages/lib/I2CE_Page.php] on line 37
==Variables==
==Variables==
===$template===
===$template===
The template object for handling the HTML templates and data to be displayed.
The template object for handling the HTML templates and data to be displayed.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L42 i2ce/modules/Pages/lib/I2CE_Page.php] on line 42
*Type: protected [[Class: I2CE_Template | I2CE_Template]] $template
*Type: protected [[Class: I2CE_Template | I2CE_Template]] $template


===$defaultHTMLFile===
===$defaultHTMLFile===
The default HTML/XML files to be displayed by the template. of string
The default HTML/XML files to be displayed by the template. of string
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L47 i2ce/modules/Pages/lib/I2CE_Page.php] on line 47
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $defaultHTMLFile
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $defaultHTMLFile


===$role===
===$role===
The role that can view this page.
The role that can view this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L52 i2ce/modules/Pages/lib/I2CE_Page.php] on line 52
*Type: protected [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $role
*Type: protected [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $role


===$user===
===$user===
The user viewing this page.
The user viewing this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L57 i2ce/modules/Pages/lib/I2CE_Page.php] on line 57
*Type: protected [[Class: I2CE_User | I2CE_User]] $user
*Type: protected [[Class: I2CE_User | I2CE_User]] $user


===$access===
===$access===
The access level required for this page.
The access level required for this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L62 i2ce/modules/Pages/lib/I2CE_Page.php] on line 62
*Type: private integer $access
*Type: private integer $access


===$redirect===
===$redirect===
A url to redirect to instead of displaying the page.
A url to redirect to instead of displaying the page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L67 i2ce/modules/Pages/lib/I2CE_Page.php] on line 67
*Type: private [http://www.php.net/manual/en/language.types.string.php string ] $redirect
*Type: private [http://www.php.net/manual/en/language.types.string.php string ] $redirect


===$post===
===$post===
Holds a reference to the $_POST array which is a list of all data sent from a form.
Holds a reference to the $_POST array which is a list of all data sent from a form.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L72 i2ce/modules/Pages/lib/I2CE_Page.php] on line 72
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $post
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $post


===$get===
===$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."
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."
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L78 i2ce/modules/Pages/lib/I2CE_Page.php] on line 78
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $get
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $get


===$page_root===
===$page_root===
the page root -- this is the URL relative to the site base that is used to get to this page.
the page root -- this is the URL relative to the site base that is used to get to this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L169 i2ce/modules/Pages/lib/I2CE_Page.php] on line 169
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page_root
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page_root


===$page_remainder===
===$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.
the page remainder -- this is the remainder of the URL relative to the site base that is used to get to this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L189 i2ce/modules/Pages/lib/I2CE_Page.php] on line 189
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page_remainder
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page_remainder


===$args===
===$args===
The arguments passed in the constructor. @param protected array $args
The arguments passed in the constructor. @param protected array $args
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L208 i2ce/modules/Pages/lib/I2CE_Page.php] on line 208
*Type: protected $args
*Type: protected $args


===$request_remainder===
===$request_remainder===
The remainder of the page request -- everything  after (option_module_name/)page_name(/reminder/of/the/request) @param protected array $request_remainder
The remainder of the page request -- everything  after (option_module_name/)page_name(/reminder/of/the/request) @param protected array $request_remainder
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L213 i2ce/modules/Pages/lib/I2CE_Page.php] on line 213
*Type: protected $request_remainder
*Type: protected $request_remainder


===$permissionParser===
===$permissionParser===
The permission parser for the user of this page. @param I2CE_PermissionParser $permissionParser
The permission parser for the user of this page. @param I2CE_PermissionParser $permissionParser
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L218 i2ce/modules/Pages/lib/I2CE_Page.php] on line 218
*Type: protected $permissionParser
*Type: protected $permissionParser


===$page===
===$page===
. The requested page
. The requested page
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L430 i2ce/modules/Pages/lib/I2CE_Page.php] on line 430
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $page


===$module===
===$module===
.  The module that contains this page.
.  The module that contains this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L434 i2ce/modules/Pages/lib/I2CE_Page.php] on line 434
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $module
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $module


===$is_post===
===$is_post===
-- true if this page is a post.
-- true if this page is a post.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L621 i2ce/modules/Pages/lib/I2CE_Page.php] on line 621
*Type: protected [http://www.php.net/manual/en/language.types.boolean.php boolean ] $is_post
*Type: protected [http://www.php.net/manual/en/language.types.boolean.php boolean ] $is_post


===$session_req===
===$session_req===
Holds a reference to a session request array if one has been requested and exists in the session.
Holds a reference to a session request array if one has been requested and exists in the session.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L757 i2ce/modules/Pages/lib/I2CE_Page.php] on line 757
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $session_req
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $session_req


===$request_vars===
===$request_vars===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L827 i2ce/modules/Pages/lib/I2CE_Page.php] on line 827
*Type: private $request_vars
*Type: private $request_vars


Line 145: Line 163:
===__construct()===
===__construct()===
Create a new instance of a page. The default constructor should be called by any pages extending this object.  It creates the [[Class: I2CE_Template | ]] and [[Class: I2CE_User | ]] objects and sets up the basic member variables.
Create a new instance of a page. The default constructor should be called by any pages extending this object.  It creates the [[Class: I2CE_Template | ]] and [[Class: I2CE_User | ]] objects and sets up the basic member variables.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L239 i2ce/modules/Pages/lib/I2CE_Page.php] on line 239
*Signature: public function __construct($args,$request_remainder,$get,$post)
*Signature: public function __construct($args,$request_remainder,$get,$post)
*Parameters:
*Parameters:
Line 155: Line 174:
===_display()===
===_display()===
Display the template as HTML/XML.  Sets the header and displays any buffered warnings/echoed text.
Display the template as HTML/XML.  Sets the header and displays any buffered warnings/echoed text.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L499 i2ce/modules/Pages/lib/I2CE_Page.php] on line 499
*Signature: protected function _display($supress_output)
*Signature: protected function _display($supress_output)
*Parameters:
*Parameters:
**$supress_output  
**$supress_output  
===_flattenRequestVars()===
===_flattenRequestVars()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L388 i2ce/modules/Pages/lib/I2CE_Page.php] on line 388
*Signature: static public function _flattenRequestVars($vars,$req,$prefix)
*Signature: static public function _flattenRequestVars($vars,$req,$prefix)
*Parameters:
*Parameters:
Line 166: Line 187:
===action()===
===action()===
Perform any actions to load the HTML templates. The default action simply loads all the HTML template files.
Perform any actions to load the HTML templates. The default action simply loads all the HTML template files.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L142 i2ce/modules/Pages/lib/I2CE_Page.php] on line 142
*Signature: protected function action()
*Signature: protected function action()
*Returns: boolean.<br/>true on sucess
*Returns: boolean.<br/>true on sucess
===actionCommandLine()===
===actionCommandLine()===
The business method if this page is called from the commmand line
The business method if this page is called from the commmand line
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L567 i2ce/modules/Pages/lib/I2CE_Page.php] on line 567
*Signature: protected function actionCommandLine($args,$request_remainder)
*Signature: protected function actionCommandLine($args,$request_remainder)
*Parameters:
*Parameters:
Line 176: Line 199:
===display()===
===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 [[Class: I2CE_Template | ::display() template display]] method will be called to output the combined template files to the browser.
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 [[Class: I2CE_Template | ::display() template display]] method will be called to output the combined template files to the browser.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L447 i2ce/modules/Pages/lib/I2CE_Page.php] on line 447
*Signature: public function display($supress_output)
*Signature: public function display($supress_output)
*Parameters:
*Parameters:
Line 182: Line 206:
===fixupRequestVariables()===
===fixupRequestVariables()===
Applies any transformations (make sure magic quotes is off, nesting, and json decoding) to an array variables @param boolean $transform.  Defaults to true
Applies any transformations (make sure magic quotes is off, nesting, and json decoding) to an array variables @param boolean $transform.  Defaults to true
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L359 i2ce/modules/Pages/lib/I2CE_Page.php] on line 359
*Signature: static public function fixupRequestVariables($vars)
*Signature: static public function fixupRequestVariables($vars)
*Parameters:
*Parameters:
Line 187: Line 212:
*Returns: $vars;
*Returns: $vars;
===flattenRequestVars()===
===flattenRequestVars()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L381 i2ce/modules/Pages/lib/I2CE_Page.php] on line 381
*Signature: static public function flattenRequestVars($vars)
*Signature: static public function flattenRequestVars($vars)
*Parameters:
*Parameters:
Line 192: Line 218:
===get()===
===get()===
Gets/sets the [[#$get | $get]] value for the given key.
Gets/sets the [[#$get | $get]] value for the given key.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L720 i2ce/modules/Pages/lib/I2CE_Page.php] on line 720
*Signature: public function get($key,$val)
*Signature: public function get($key,$val)
*Parameters:
*Parameters:
Line 201: Line 228:
===getAccess()===
===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 | $access]] variable.
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 | $access]] variable.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L591 i2ce/modules/Pages/lib/I2CE_Page.php] on line 591
*Signature: protected function getAccess()
*Signature: protected function getAccess()
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string
===getAccessedBaseURL()===
===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
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
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L93 i2ce/modules/Pages/lib/I2CE_Page.php] on line 93
*Signature: static public function getAccessedBaseURL()
*Signature: static public function getAccessedBaseURL()
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===getTemplate()===
===getTemplate()===
Get the template associated to this page
Get the template associated to this page
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L160 i2ce/modules/Pages/lib/I2CE_Page.php] on line 160
*Signature: public function getTemplate()
*Signature: public function getTemplate()
===getTitle()===
===getTitle()===
Return the title for this page.
Return the title for this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L153 i2ce/modules/Pages/lib/I2CE_Page.php] on line 153
*Signature: protected function getTitle()
*Signature: protected function getTitle()
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===getUser()===
===getUser()===
Get the user of this page
Get the user of this page
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L607 i2ce/modules/Pages/lib/I2CE_Page.php] on line 607
*Signature: public function getUser()
*Signature: public function getUser()
*Returns: [[Class: I2CE_User | I2CE_User]]
*Returns: [[Class: I2CE_User | I2CE_User]]
===get_exists()===
===get_exists()===
Check to see if a key exists in the [[#$get | $get]] array.
Check to see if a key exists in the [[#$get | $get]] array.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L699 i2ce/modules/Pages/lib/I2CE_Page.php] on line 699
*Signature: public function get_exists($key)
*Signature: public function get_exists($key)
*Parameters:
*Parameters:
Line 226: Line 259:
===hasPermission()===
===hasPermission()===
Parse a permission string to see if we have permission.
Parse a permission string to see if we have permission.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L227 i2ce/modules/Pages/lib/I2CE_Page.php] on line 227
*Signature: public function hasPermission($permission,$node)
*Signature: public function hasPermission($permission,$node)
*Parameters:
*Parameters:
Line 234: Line 268:
===initializeTemplate()===
===initializeTemplate()===
Handles creating hte I2CE_TemplateMeister templates and loading any default templates
Handles creating hte I2CE_TemplateMeister templates and loading any default templates
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L268 i2ce/modules/Pages/lib/I2CE_Page.php] on line 268
*Signature: protected function initializeTemplate()
*Signature: protected function initializeTemplate()
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]<br/>true on success
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]<br/>true on success
===isGet()===
===isGet()===
Check to see if the current page is a GET request or not
Check to see if the current page is a GET request or not
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L636 i2ce/modules/Pages/lib/I2CE_Page.php] on line 636
*Signature: public function isGet()
*Signature: public function isGet()
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===isPost()===
===isPost()===
Check to see if the current page is a POST form submission or not.
Check to see if the current page is a POST form submission or not.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L627 i2ce/modules/Pages/lib/I2CE_Page.php] on line 627
*Signature: public function isPost()
*Signature: public function isPost()
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===loadHTMLTemplates()===
===loadHTMLTemplates()===
Load the  template (HTML or XML) files to the template object.
Load the  template (HTML or XML) files to the template object.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L120 i2ce/modules/Pages/lib/I2CE_Page.php] on line 120
*Signature: protected function loadHTMLTemplates()
*Signature: protected function loadHTMLTemplates()
===module()===
===module()===
Sets/Gets the module.
Sets/Gets the module.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L406 i2ce/modules/Pages/lib/I2CE_Page.php] on line 406
*Signature: public function module($module)
*Signature: public function module($module)
*Parameters:
*Parameters:
Line 256: Line 295:
===page()===
===page()===
Sets/Gets the page.
Sets/Gets the page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L418 i2ce/modules/Pages/lib/I2CE_Page.php] on line 418
*Signature: public function page($page)
*Signature: public function page($page)
*Parameters:
*Parameters:
Line 263: Line 303:
===pageRemainder()===
===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.
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 [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L196 i2ce/modules/Pages/lib/I2CE_Page.php] on line 196
*Signature: public function pageRemainder($page_remainder)
*Signature: public function pageRemainder($page_remainder)
*Parameters:
*Parameters:
Line 270: Line 311:
===pageRoot()===
===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.
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.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L176 i2ce/modules/Pages/lib/I2CE_Page.php] on line 176
*Signature: public function pageRoot($page_root)
*Signature: public function pageRoot($page_root)
*Parameters:
*Parameters:
Line 277: Line 319:
===post()===
===post()===
Get/set  the [[#$post | $post]] value for the given key.
Get/set  the [[#$post | $post]] value for the given key.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L665 i2ce/modules/Pages/lib/I2CE_Page.php] on line 665
*Signature: public function post($key,$val)
*Signature: public function post($key,$val)
*Parameters:
*Parameters:
Line 286: Line 329:
===post_exists()===
===post_exists()===
Check to see if a key exists in the [[#$post | $post]] array.
Check to see if a key exists in the [[#$post | $post]] array.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L644 i2ce/modules/Pages/lib/I2CE_Page.php] on line 644
*Signature: public function post_exists($key)
*Signature: public function post_exists($key)
*Parameters:
*Parameters:
Line 292: Line 336:
===redirect()===
===redirect()===
Send the redirect header with the given URL.
Send the redirect header with the given URL.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L102 i2ce/modules/Pages/lib/I2CE_Page.php] on line 102
*Signature: public function redirect($url)
*Signature: public function redirect($url)
*Parameters:
*Parameters:
Line 297: Line 342:
===request()===
===request()===
Return the given value for the key in one of the request arrays.
Return the given value for the key in one of the request arrays.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L833 i2ce/modules/Pages/lib/I2CE_Page.php] on line 833
*Signature: public function request($key)
*Signature: public function request($key)
*Parameters:
*Parameters:
Line 304: Line 350:
===request_exists()===
===request_exists()===
Checks all the request arrays for the given key and returns true if it exists.
Checks all the request arrays for the given key and returns true if it exists.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L821 i2ce/modules/Pages/lib/I2CE_Page.php] on line 821
*Signature: public function request_exists($key)
*Signature: public function request_exists($key)
*Parameters:
*Parameters:
Line 310: Line 357:
===rewrittenURLs()===
===rewrittenURLs()===
returns true if the url's have been written. false if not
returns true if the url's have been written. false if not
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L83 i2ce/modules/Pages/lib/I2CE_Page.php] on line 83
*Signature: static public function rewrittenURLs()
*Signature: static public function rewrittenURLs()
===session_req()===
===session_req()===
Gets/sets the [[#$session_req | $session_req]] value for the given key.
Gets/sets the [[#$session_req | $session_req]] value for the given key.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L783 i2ce/modules/Pages/lib/I2CE_Page.php] on line 783
*Signature: public function session_req($key,$val)
*Signature: public function session_req($key,$val)
*Parameters:
*Parameters:
Line 322: Line 371:
===session_req_exists()===
===session_req_exists()===
Check to see if a key exists in the [[#$session_req | $session_req]] array.
Check to see if a key exists in the [[#$session_req | $session_req]] array.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L762 i2ce/modules/Pages/lib/I2CE_Page.php] on line 762
*Signature: public function session_req_exists($key)
*Signature: public function session_req_exists($key)
*Parameters:
*Parameters:
Line 328: Line 378:
===setAccess()===
===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 | $access]] variable. @param array of string
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 | $access]] variable. @param array of string
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L578 i2ce/modules/Pages/lib/I2CE_Page.php] on line 578
*Signature: public function setAccess($access)
*Signature: public function setAccess($access)
*Parameters:
*Parameters:
Line 333: Line 384:
===setIsPost()===
===setIsPost()===
Sets if this pages is a post or not
Sets if this pages is a post or not
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L614 i2ce/modules/Pages/lib/I2CE_Page.php] on line 614
*Signature: public function setIsPost($post)
*Signature: public function setIsPost($post)
*Parameters:
*Parameters:
Line 338: Line 390:
===setRedirect()===
===setRedirect()===
Set the URL to be redirected to instead of displaying this page.
Set the URL to be redirected to instead of displaying this page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L865 i2ce/modules/Pages/lib/I2CE_Page.php] on line 865
*Signature: public function setRedirect($url)
*Signature: public function setRedirect($url)
*Parameters:
*Parameters:
Line 343: Line 396:
===setupGetPost()===
===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
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 [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.2-release/annotate/head:/modules/Pages/lib/I2CE_Page.php#L308 i2ce/modules/Pages/lib/I2CE_Page.php] on line 308
*Signature: protected function setupGetPost($get,$post,$strip)
*Signature: protected function setupGetPost($get,$post,$strip)
*Parameters:
*Parameters:

Revision as of 08:51, 10 November 2009

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

$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 239
  • 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 to load the HTML templates. The default action simply loads all the HTML template files.

actionCommandLine()

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

  • Defined in i2ce/modules/Pages/lib/I2CE_Page.php on line 567
  • 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 447
  • 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

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 720
  • 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.

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 227
  • 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.

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 196
  • 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 665
  • 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 783
  • 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

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 308
  • 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()

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()

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()

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()

setShowForm()

This method is implemented by I2CE_Module_Forms->setShowForm()

showForm()

This method is implemented by I2CE_Module_Forms->showForm()

makeJumper()

This method is implemented by I2CE_Module_Jumper->makeJumper()

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()

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()