Class: I2CE PageFormLists (Development): Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
Line 3: Line 3:
*Extends the class: [[Class: I2CE_PageForm (Development) | I2CE_PageForm]].
*Extends the class: [[Class: I2CE_PageForm (Development) | I2CE_PageForm]].
*Child Classes:
*Child Classes:
** [[Class: I2CE_Page_CustomReport_ArchiveMenu (Development) | I2CE_Page_CustomReport_ArchiveMenu]]
** [[Class: iHRIS_PageFormLists (Development) | iHRIS_PageFormLists]]
** [[Class: iHRIS_PageFormLists (Development) | iHRIS_PageFormLists]]
*Location: Part of the module [[I2CE Module List (Development)#Lists|Lists]] in the package [https://launchpad.net/i2ce I2CE] 4.0-dev
*Location: Part of the module [[I2CE Module List (Development)#Lists|Lists]] in the package [https://launchpad.net/i2ce I2CE] 4.0-dev
Line 44: Line 45:
===action()===
===action()===
Perform the actions of the page. This handles some special actions because there are three versions of this page: - The list page of all objects that can be edited. - The add/update page for each list object. - The edit form for each list object. Only in the third case is the parent object action method called since that is the default setup for editing objects used in most other PageForm  objects.
Perform the actions of the page. This handles some special actions because there are three versions of this page: - The list page of all objects that can be edited. - The add/update page for each list object. - The edit form for each list object. Only in the third case is the parent object action method called since that is the default setup for editing objects used in most other PageForm  objects.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L488 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 488
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L499 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 499
*Signature: protected function action()
*Signature: protected function action()
===actionAllLists()===
===actionAllLists()===
Perform the action of the page to show all lists.
Perform the action of the page to show all lists.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L318 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 318
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L324 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 324
*Signature: protected function actionAllLists()
*Signature: protected function actionAllLists()
===actionDisplayList_row()===
===actionDisplayList_row()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L435 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 435
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L461 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 461
*Signature: protected function actionDisplayList_row($list)
*Signature: protected function actionDisplayList_row($list)
*Parameters:
*Parameters:
Line 57: Line 58:
===actionExtra()===
===actionExtra()===
Perform the action of the page with a select object
Perform the action of the page with a select object
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L311 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 311
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L317 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 317
*Signature: protected function actionExtra($select_obj)
*Signature: protected function actionExtra($select_obj)
*Parameters:
*Parameters:
**$select_obj  
**$select_obj  
===actionSelectList()===
===actionSelectList()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L327 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 327
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L333 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 333
*Signature: protected function actionSelectList()
*Signature: protected function actionSelectList()
===actionSelectMapped()===
===actionSelectMapped()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L374 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 374
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L380 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 380
*Signature: protected function actionSelectMapped()
*Signature: protected function actionSelectMapped()
===displayControls()===
===displayControls()===
Display the save or confirm button templates as needed.
Display the save or confirm button templates as needed.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L279 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 279
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L285 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 285
*Signature: protected function displayControls($save,$show_edit)
*Signature: protected function displayControls($save,$show_edit)
*Parameters:
*Parameters:
Line 88: Line 89:
*Signature: protected function getPrimaryHTMLTemplate()
*Signature: protected function getPrimaryHTMLTemplate()
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===getRowBaseLink()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L440 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 440
*Signature: protected function getRowBaseLink()
===getViewPage()===
===getViewPage()===
Return the view list page for this type of form. If the page exists for view_$type it returns that, otherwise it uses view_list.
Return the view list page for this type of form. If the page exists for view_$type it returns that, otherwise it uses view_list.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L426 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 426
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L432 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 432
*Signature: protected function getViewPage($type)
*Signature: protected function getViewPage($type)
*Parameters:
*Parameters:
Line 97: Line 101:
===loadHTMLTemplates()===
===loadHTMLTemplates()===
Load the HTML template files for editing and confirming the list information. Since this page has special versions, this method is only called when a particular list object is being added or edited.  All other pages are loaded within the action  
Load the HTML template files for editing and confirming the list information. Since this page has special versions, this method is only called when a particular list object is being added or edited.  All other pages are loaded within the action  
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L254 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 254
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L260 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 260
*Signature: protected function loadHTMLTemplates()
*Signature: protected function loadHTMLTemplates()
===loadObjects()===
===loadObjects()===
Create and load data for the objects used for this form. Create the list object and if this is a form submission load the data from the form data.  It determines the type based on the [[#$type | $type]] member variable.
Create and load data for the objects used for this form. Create the list object and if this is a form submission load the data from the form data.  It determines the type based on the [[#$type | $type]] member variable.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L185 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 185
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L191 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 191
*Signature: protected function loadObjects()
*Signature: protected function loadObjects()
===paginateList()===
===paginateList()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L339 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 339
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L345 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 345
*Signature: protected function paginateList($list)
*Signature: protected function paginateList($list)
*Parameters:
*Parameters:
Line 110: Line 114:
===save()===
===save()===
Save the objects to the database. Save the list object being edited and return to the appropriate admin page.
Save the objects to the database. Save the list object being edited and return to the appropriate admin page.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L292 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 292
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L298 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 298
*Signature: protected function save()
*Signature: protected function save()
===setDisplayData()===
===setDisplayData()===
Line 118: Line 122:
===setMenus()===
===setMenus()===
Set the attributes for the left hand navigation menu to highlight the proper location.
Set the attributes for the left hand navigation menu to highlight the proper location.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L534 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 534
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php#L545 i2ce/modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php] on line 545
*Signature: protected function setMenus()
*Signature: protected function setMenus()
===showHidden()===
===showHidden()===

Revision as of 07:57, 3 August 2010


This article describes the class I2CE_PageFormLists .

Manage editing of all the list databases used for drop down menus. This page has the code for the ListsPage object and then it creates an instance of this page object and calls the ListsPage ::display() display method. Page object to handle the management of all the list databases used for drop down menus. This page handles all the editing of the list database tables using the relevant interface objects. The base page lists all the types of data that can be edited. From there you can add a new entry or edit an existing one. This object overrides the default save () and action () methods since there are many database objects to be edited.

Variables

$type

The type of list object being edited. e.g. the form name

$select_field

The field, if any, for which we wish to select the list for.

$id

The record id number of the object being edited.

$show_hidden

. Whether or not to show hidden elements

Methods

__construct()

Create a new instance of this page. This will call the parent constructor and then setup the base template pages for the template. It also sets up the values for the member variables. @param string $title The title for this page. @param string $defaultHTMLFile The default HTML file for this page. @param mixed $access The role required to access this page. @param array $files The list of template files to load for this page.

action()

Perform the actions of the page. This handles some special actions because there are three versions of this page: - The list page of all objects that can be edited. - The add/update page for each list object. - The edit form for each list object. Only in the third case is the parent object action method called since that is the default setup for editing objects used in most other PageForm objects.

actionAllLists()

Perform the action of the page to show all lists.

actionDisplayList_row()

actionExtra()

Perform the action of the page with a select object

actionSelectList()

actionSelectMapped()

displayControls()

Display the save or confirm button templates as needed.

getChildHTMLTemplate()

Get the HTML templat for any child forms @var string $child_form

getPrimaryHTMLTemplate()

Get the HTML template for the primary form

getRowBaseLink()

getViewPage()

Return the view list page for this type of form. If the page exists for view_$type it returns that, otherwise it uses view_list.

loadHTMLTemplates()

Load the HTML template files for editing and confirming the list information. Since this page has special versions, this method is only called when a particular list object is being added or edited. All other pages are loaded within the action

loadObjects()

Create and load data for the objects used for this form. Create the list object and if this is a form submission load the data from the form data. It determines the type based on the $type member variable.

paginateList()

save()

Save the objects to the database. Save the list object being edited and return to the appropriate admin page.

setDisplayData()

Set the data to be displayed for the outside of the form field elements. Set up the static data to be displayed in the template. The default method doesn't do anything, but sub-classes may need to override this method. *

setMenus()

Set the attributes for the left hand navigation menu to highlight the proper location.

showHidden()

Wether or not we show a hidden list member

Inherited Methods

hasInvalid()

This public method is inherited from I2CE_PageForm->hasInvalid()

invalidMessage()

This public method is inherited from I2CE_PageForm->invalidMessage()

setFormAttributes()

This public method is inherited from I2CE_PageForm->setFormAttributes()

usesConfirmPage()

This public method is inherited from I2CE_PageForm->usesConfirmPage()

getParent()

This protected method is inherited from I2CE_PageForm->getParent()

getPrimary()

This protected method is inherited from I2CE_PageForm->getPrimary()

isConfirm()

This protected method is inherited from I2CE_PageForm->isConfirm()

isEdit()

This protected method is inherited from I2CE_PageForm->isEdit()

isEditing()

This protected method is inherited from I2CE_PageForm->isEditing()

isSave()

This protected method is inherited from I2CE_PageForm->isSave()

setEditing()

This protected method is inherited from I2CE_PageForm->setEditing()

setForm()

This protected method is inherited from I2CE_PageForm->setForm()

setObject()

This protected method is inherited from I2CE_PageForm->setObject()

validate()

This protected method is inherited from I2CE_PageForm->validate()

_flattenRequestVars()

This public method is inherited from I2CE_Page->_flattenRequestVars()

display()

This public method is inherited from I2CE_Page->display()

fixupRequestVariables()

This public method is inherited from I2CE_Page->fixupRequestVariables()

flattenRequestVars()

This public method is inherited from I2CE_Page->flattenRequestVars()

get()

This public method is inherited from I2CE_Page->get()

getAccessedBaseURL()

This public method is inherited from I2CE_Page->getAccessedBaseURL()

getTemplate()

This public method is inherited from I2CE_Page->getTemplate()

getUser()

This public method is inherited from I2CE_Page->getUser()

get_exists()

This public method is inherited from I2CE_Page->get_exists()

hasPermission()

This public method is inherited from I2CE_Page->hasPermission()

isGet()

This public method is inherited from I2CE_Page->isGet()

isPost()

This public method is inherited from I2CE_Page->isPost()

module()

This public method is inherited from I2CE_Page->module()

page()

This public method is inherited from I2CE_Page->page()

pageRemainder()

This public method is inherited from I2CE_Page->pageRemainder()

pageRoot()

This public method is inherited from I2CE_Page->pageRoot()

post()

This public method is inherited from I2CE_Page->post()

post_exists()

This public method is inherited from I2CE_Page->post_exists()

redirect()

This public method is inherited from I2CE_Page->redirect()

request()

This public method is inherited from I2CE_Page->request()

request_exists()

This public method is inherited from I2CE_Page->request_exists()

rewrittenURLs()

This public method is inherited from I2CE_Page->rewrittenURLs()

session_req()

This public method is inherited from I2CE_Page->session_req()

session_req_exists()

This public method is inherited from I2CE_Page->session_req_exists()

setAccess()

This public method is inherited from I2CE_Page->setAccess()

setIsPost()

This public method is inherited from I2CE_Page->setIsPost()

setRedirect()

This public method is inherited from I2CE_Page->setRedirect()

_display()

This protected method is inherited from I2CE_Page->_display()

actionCommandLine()

This protected method is inherited from I2CE_Page->actionCommandLine()

getAccess()

This protected method is inherited from I2CE_Page->getAccess()

getTitle()

This protected method is inherited from I2CE_Page->getTitle()

initializeTemplate()

This protected method is inherited from I2CE_Page->initializeTemplate()

setupGetPost()

This protected method is inherited from I2CE_Page->setupGetPost()

_hasMethod()

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

Inherited Variables

$objects

Theis protected variable is inherited from I2CE_PageForm->$objects

$node_ids

Theis protected variable is inherited from I2CE_PageForm->$node_ids

$factory

Theis protected variable is inherited from I2CE_PageForm->$factory

$usesConfimPage

Theis protected variable is inherited from I2CE_PageForm->$usesConfimPage

$formAttributes

Theis protected variable is inherited from I2CE_PageForm->$formAttributes

$template

Theis protected variable is inherited from I2CE_Page->$template

$defaultHTMLFile

Theis protected variable is inherited from I2CE_Page->$defaultHTMLFile

$role

Theis protected variable is inherited from I2CE_Page->$role

$user

Theis protected variable is inherited from I2CE_Page->$user

$post

Theis protected variable is inherited from I2CE_Page->$post

$get

Theis protected variable is inherited from I2CE_Page->$get

$page_root

Theis protected variable is inherited from I2CE_Page->$page_root

$page_remainder

Theis protected variable is inherited from I2CE_Page->$page_remainder

$args

Theis protected variable is inherited from I2CE_Page->$args

$request_remainder

Theis protected variable is inherited from I2CE_Page->$request_remainder

$permissionParser

Theis protected variable is inherited from I2CE_Page->$permissionParser

$page

Theis protected variable is inherited from I2CE_Page->$page

$module

Theis protected variable is inherited from I2CE_Page->$module

$is_post

Theis protected variable is inherited from I2CE_Page->$is_post

$session_req

Theis protected variable is inherited from I2CE_Page->$session_req

Inherited Fuzzy Methods

launchBackgroundProcess()

This method is inherited from I2CE_Page->launchBackgroundProcess()

launchBackgroundPHPScript()

This method is inherited from I2CE_Page->launchBackgroundPHPScript()

launchBackgroundPage()

This method is inherited from I2CE_Page->launchBackgroundPage()

addColorPickerTriple()

This method is inherited from I2CE_Page->addColorPickerTriple()

addDatePicker()

This method is inherited from I2CE_Page->addDatePicker()

selectOptionsImmediate()

This method is inherited from I2CE_Page->selectOptionsImmediate()

setDisplayDataImmediate()

This method is inherited from I2CE_Page->setDisplayDataImmediate()

addFormWorm()

This method is inherited from I2CE_Page->addFormWorm()

getClassValue()

This method is inherited from I2CE_Page->getClassValue()

loadClassValues()

This method is inherited from I2CE_Page->loadClassValues()

setClassValue()

This method is inherited from I2CE_Page->setClassValue()

setClassValues()

This method is inherited from I2CE_Page->setClassValues()

addOption()

This method is inherited from I2CE_Page->addOption()

addOptions()

This method is inherited from I2CE_Page->addOptions()

addAutoCompleteInputTreeById()

This method is inherited from I2CE_Page->addAutoCompleteInputTreeById()

addAutoCompleteInputTree()

This method is inherited from I2CE_Page->addAutoCompleteInputTree()

setForm()

This method is inherited from I2CE_Page->setForm()

getField()

This method is inherited from I2CE_Page->getField()

setReview()

This method is inherited from I2CE_Page->setReview()

isReview()

This method is inherited from I2CE_Page->isReview()

setShowForm()

This method is inherited from I2CE_Page->setShowForm()

showForm()

This method is inherited from I2CE_Page->showForm()

makeJumper()

This method is inherited from I2CE_Page->makeJumper()

menuSelect()

This method is inherited from I2CE_Page->menuSelect()

addUpdateSelect()

This method is inherited from I2CE_Page->addUpdateSelect()

addAjaxUpdate()

This method is inherited from I2CE_Page->addAjaxUpdate()

addAjaxToggle()

This method is inherited from I2CE_Page->addAjaxToggle()

addAjaxRequestFunction()

This method is inherited from I2CE_Page->addAjaxRequestFunction()

addAjaxCompleteFunction()

This method is inherited from I2CE_Page->addAjaxCompleteFunction()

addAjaxToggleOnFunction()

This method is inherited from I2CE_Page->addAjaxToggleOnFunction()

addAjaxToggleOffFunction()

This method is inherited from I2CE_Page->addAjaxToggleOffFunction()

hasAjax()

This method is inherited from I2CE_Page->hasAjax()

setDataTypePriority()

This method is inherited from I2CE_Page->setDataTypePriority()

setData()

This method is inherited from I2CE_Page->setData()

getData()

This method is inherited from I2CE_Page->getData()

getDefaultData()

This method is inherited from I2CE_Page->getDefaultData()

removeData()

This method is inherited from I2CE_Page->removeData()

getDataNames()

This method is inherited from I2CE_Page->getDataNames()

ensureNode()

This method is inherited from I2CE_Page->ensureNode()

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()