Class StandardFormContent

Description

This is a child of the FormContent class to provide a 'standard' look and feel for forms.

It also enables a confirmation 'page' by default.

Located in Program_Root/form/StandardFormContent.inc (line 26)

FormContent
   |
   --StandardFormContent
Direct descendents
Class Description
Step1 A simple Page Layout object child.
Step2 This is a child of the FormContent class to provide a 'standard' look and feel for forms.
Step3 This is a child of the FormContent class to provide a 'standard' look and feel for forms.
StandardAccountForm A simple Page Layout object child.
Variable Summary
Method Summary
void StandardFormContent (mixed $title, [mixed $cancel_action = NULL], [mixed $width = "100%"])
void add_form_block ([string $title = NULL], TABLEtag &$table)
FIELDSETtag &build_form_block ([string $title = NULL], TABLEtag &$content)
void confirm_action ()
InfoTable form (array 0, array 1)
boolean form_action ()
mixed form_confirm ([string $title = "Form Confirmation"], [boolean $show_buttons = TRUE])
object form_content ()
ButtonPanel form_content_buttons ()
void set_form_title (string $title)
void &_div_wrapper ()
void _form_content_table ([mixed $width = "100%"], mixed $border, mixed $cellspacing, [mixed $cellpadding = 3])
Variables
Methods
Constructor StandardFormContent (line 42)
void StandardFormContent (mixed $title, [mixed $cancel_action = NULL], [mixed $width = "100%"])
add_form_block (line 193)

This function is used to add a block of form fields inside a table to this form.

This table will automatically get wrapped inside a fieldset with a legend tag to label the block

void add_form_block ([string $title = NULL], TABLEtag &$table)
  • string $title:

    - the title for the fieldset

  • TABLEtag &$table:

    - the form fields inside a table

build_form_block (line 206)

this builds a fieldset and legend and adds the form table to it.

FIELDSETtag &build_form_block ([string $title = NULL], TABLEtag &$content)
  • string $title:

    - the legend string

  • TABLEtag &$content:

    - the form fields in a table

confirm_action (line 160)

This method is responsible for handling the confirmation page's Confirm action.

void confirm_action ()

Redefined in descendants as:
form (line 68)

this builds the main wrapper for the form fields and ads the Save and Cancel buttons

  • return:

    widget object

InfoTable form (array 0, array 1)
  • array 0:

    - the form data

  • array 1:

    - the form error fields (if any)


Redefinition of:
FormContent::form()
This method builds the html form.
form_action (line 144)

This method handles the form action.

  • return:

    TRUE = success FALSE = failed.

boolean form_action ()

Redefinition of:
FormContent::form_action()
This method handles the
form_confirm (line 111)

This function is used to show an intermediary confirmation page. Use this function to show a confirmation of the data that was submitted by the user.

This will get called after all of the form data was successfully validated. All of the form data will automatically be created as hidden form fields. All you have to do is show the data, and a confirm submit button.

  • return:

    - either raw html, or some container HTMLTag object.

mixed form_confirm ([string $title = "Form Confirmation"], [boolean $show_buttons = TRUE])
  • string $title:

    - the title for the table

  • boolean $show_buttons:

    - show the action buttons?


Redefinition of:
FormContent::form_confirm()
This function is used to show an intermediary confirmation page. Use this function to show a confirmation of the data that was submitted by the user.
form_content (line 89)

Child class MUST override this to provide the form fields

object form_content ()

Redefined in descendants as:
  • Step1::form_content() : This method is called by the StandardFormContent object to allow you to build the 'blocks' of fields you want to display. Each form block will live inside a fieldset tag with the a title.
  • Step2::form_content() : This method is called by the StandardFormContent object to allow you to build the 'blocks' of fields you want to display. Each form block will live inside a fieldset tag with the a title.
  • Step3::form_content() : This method is called by the StandardFormContent object to allow you to build the 'blocks' of fields you want to display. Each form block will live inside a fieldset tag with the a title.
  • StandardAccountForm::form_content() : This method is called by the StandardFormContent object to allow you to build the 'blocks' of fields you want to display. Each form block will live inside a fieldset tag with the a title.
form_content_buttons (line 172)

This function is used to build the standard buttons for a form.

ButtonPanel form_content_buttons ()
set_form_title (line 56)

this method sets the form title which is used to wrap the entire form

void set_form_title (string $title)
  • string $title:

    - the form title

_div_wrapper (line 219)
void &_div_wrapper ()
_form_content_table (line 225)
void _form_content_table ([mixed $width = "100%"], mixed $border, mixed $cellspacing, [mixed $cellpadding = 3])

Inherited Methods

Inherited From FormContent

FormContent::FormContent()
FormContent::add_action()
FormContent::add_cancel()
FormContent::add_element()
FormContent::add_error()
FormContent::add_hidden_action()
FormContent::add_hidden_element()
FormContent::add_image_action()
FormContent::build_confirm_table()
FormContent::element_form()
FormContent::element_label()
FormContent::form()
FormContent::form_action()
FormContent::form_backend_validation()
FormContent::form_confirm()
FormContent::form_errors()
FormContent::form_init_data()
FormContent::form_init_elements()
FormContent::form_success()
FormContent::get_action()
FormContent::get_default_css()
FormContent::get_element()
FormContent::get_element_value()
FormContent::get_error_array()
FormContent::get_form_errors_width()
FormContent::get_hidden_element_value()
FormContent::get_required_fields_text()
FormContent::has_confirm()
FormContent::hidden_element_label()
FormContent::javascript()
FormContent::pre_confirm()
FormContent::set_action()
FormContent::set_action_message()
FormContent::set_cancel_action()
FormContent::set_confirm()
FormContent::set_default_css()
FormContent::set_element_value()
FormContent::set_error_css()
FormContent::set_form_errors_title()
FormContent::set_form_errors_width()
FormContent::set_form_name()
FormContent::set_form_width()
FormContent::set_hidden_element_value()
FormContent::set_required_marker()
FormContent::set_required_text()
FormContent::set_stripslashes()
FormContent::_test_element()

Documention generated on Thu, 31 Jul 2003 18:33:00 -0700 by phpDocumentor 1.2.0