Class: I2CE PageFormLists

This article describes the class I2CE_PageFormLists.

• Extends the class: I2CE_PageForm.
• Parent Classses: I2CE_PageForm I2CE_Page I2CE_Fuzzy
• Child Classes:
  • iHRIS_PageFormLists
• Location: Part of the module Lists in the package I2CE
• Source: Defined in the file modules/Forms/modules/Lists/lib/I2CE_PageFormLists.php
• Author: Luke Duncan <lduncan@intrahealth.org> / Carl leitner <litlfred@ibiblio.org>
• Since: v2.0.0

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

• Type: protected string $type

$select_field

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

• Type: protected string $select_field

$id

The record id number of the object being edited.

• Type: protected integer $id

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.

• Signature: public function __construct($args,$request_remainder,$get,$post)
• Parameters:
  • $args
  • $request_remainder
  • $get
    • Default Value: null
  • $post
    • Default Value: null

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.

• Signature: protected function action()

actionAllLists()

Perform the action of the page to show all lists.

• Signature: protected function actionAllLists()

actionDisplayList_row()

• Signature: protected function actionDisplayList_row($list)
• Parameters:
  • $list

actionExtra()

Perform the action of the page with a select object

• Signature: protected function actionExtra($select_obj)
• Parameters:
  • $select_obj

actionSelectList()

• Signature: protected function actionSelectList()

actionSelectMapped()

• Signature: protected function actionSelectMapped()

displayControls()

Display the save or confirm button templates as needed.

• Signature: protected function displayControls($save,$show_edit)
• Parameters:
  • boolean $save
    Flag to show the save button.
    • Default Value: false
  • boolean $show_edit
    (defaults to true)
    • Default Value: true

getChildHTMLTemplate()

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

• Signature: protected function getChildHTMLTemplate($child_form)
• Parameters:
  • $child_form
• Returns: string

getPrimaryHTMLTemplate()

Get the HTML template for the primary form

• Signature: protected function getPrimaryHTMLTemplate()
• Returns: string

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.

• Signature: protected function getViewPage($type)
• Parameters:
  • $type
• Returns: string

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

• Signature: protected function loadHTMLTemplates()

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.

• Signature: protected function loadObjects()

save()

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

• Signature: protected function save()

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. *

• Signature: protected function setDisplayData()

setMenus()

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

• Signature: protected function setMenus()