ilADTFormBridge Class Reference

ADT form bridge base class. More...

Inheritance diagram for ilADTFormBridge:

Collaboration diagram for ilADTFormBridge:

Public Member Functions
	__construct (ilADT $a_adt)
	Constructor. More...
	getADT ()
	Get ADT. More...
	setForm (ilPropertyFormGUI $a_form)
	Set form. More...
	getForm ()
	Get form. More...
	setElementId ($a_value)
	Set element id (aka form field) More...
	getElementId ()
	Get element id. More...
	setTitle ($a_value)
	Set title (aka form field caption) More...
	getTitle ()
	Get title. More...
	setInfo ($a_value)
	Set info (aka form field info text) More...
	getInfo ()
	Get info. More...
	setParentElement ($a_value)
	Set parent element. More...
	getParentElement ()
	Get parent element. More...
	setDisabled ($a_value)
	Set disabled. More...
	isDisabled ()
	Get disabled. More...
	setRequired ($a_value)
	Set required. More...
	isRequired ()
	Get required. More...
	addToForm ()
	Add ADT-specific fields to form. More...
	addJS (ilTemplate $a_tpl)
	Add ADT-specific JS-files to template. More...
	shouldBeImportedFromPost (ilADTFormBridge $a_parent_adt=null)
	Check if incoming values should be imported at all. More...
	importFromPost ()
	Import values from form request POST data. More...
	validate ()
	Validate ADT and parse error codes. More...
	setExternalErrors ($a_errors)

Protected Member Functions
	isValidADT (ilADT $a_adt)
	Check if given ADT is valid. More...
	setADT (ilADT $a_adt)
	Set ADT. More...
	addBasicFieldProperties (ilFormPropertyGUI $a_field, ilADTDefinition $a_def)
	Helper method to handle generic properties like setRequired(), setInfo() More...
	findParentElementInForm ()
	Try to find parent element in form (could be option) More...
	addToParentElement (ilFormPropertyGUI $a_field)
	Add form field to parent element. More...
	isActiveForSubItems ($a_parent_option=null)
	Check if element is currently active for subitem(s) More...

Protected Attributes
	$adt
	$form
	$id
	$title
	$info
	$parent_element
	$required
	$disabled

Detailed Description

ADT form bridge base class.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

$Id$

Definition at line 11 of file class.ilADTFormBridge.php.

Constructor & Destructor Documentation

__construct()

ilADTFormBridge::__construct

(

ilADT

$a_adt

)

Constructor.

Parameters

ilADT

$a_adt

Returns

self

Definition at line 28 of file class.ilADTFormBridge.php.

        {
                $this->setADT($a_adt);          
        }               

References setADT().

Here is the call graph for this function:

Member Function Documentation

addBasicFieldProperties()

ilADTFormBridge::addBasicFieldProperties ( ilFormPropertyGUI  $a_field, ilADTDefinition  $a_def  )

protected

Helper method to handle generic properties like setRequired(), setInfo()

Parameters

ilFormPropertyGUI	$a_field
ilADTDefinition	$a_def

Definition at line 229 of file class.ilADTFormBridge.php.

        {
                if((bool)$this->isDisabled())
                {
                        $a_field->setDisabled(true);
                }
                else if($this->isRequired())
                {
                        $a_field->setRequired(true);
                }                               
                
                $info = $this->getInfo();
                if($info)
                {
                        $a_field->setInfo($info);
                }
        }

References $info, getInfo(), isDisabled(), isRequired(), ilFormPropertyGUI\setDisabled(), ilFormPropertyGUI\setInfo(), and ilFormPropertyGUI\setRequired().

Referenced by ilADTBooleanFormBridge\addToForm(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTFloatFormBridge\addToForm(), ilADTIntegerFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTMultiEnumFormBridge\addToForm(), ilADTMultiTextFormBridge\addToForm(), and ilADTTextFormBridge\addToForm().

Here is the call graph for this function:

Here is the caller graph for this function:

addJS()

ilADTFormBridge::addJS

(

ilTemplate

$a_tpl

)

Add ADT-specific JS-files to template.

Parameters

ilTemplate

$a_tpl

Reimplemented in ilADTGroupFormBridge.

Definition at line 317 of file class.ilADTFormBridge.php.

        {
                
        }

addToForm()

ilADTFormBridge::addToForm ( )

abstract

Add ADT-specific fields to form.

Reimplemented in ilADTBooleanFormBridge, ilADTDateFormBridge, ilADTDateTimeFormBridge, ilADTEnumFormBridge, ilADTFloatFormBridge, ilADTGroupFormBridge, ilADTIntegerFormBridge, ilADTLocationFormBridge, ilADTMultiEnumFormBridge, ilADTMultiTextFormBridge, and ilADTTextFormBridge.

addToParentElement()

ilADTFormBridge::addToParentElement ( ilFormPropertyGUI  $a_field )

protected

Add form field to parent element.

Parameters

ilFormPropertyGUI

$a_field

Definition at line 294 of file class.ilADTFormBridge.php.

        {                               
                $field = $this->findParentElementInForm();
                if($field)
                {
                        $field->addSubItem($a_field);
                }
                else if($this->getForm() instanceof ilPropertyFormGUI)
                {
                        $this->getForm()->addItem($a_field);            
                }
        }

References findParentElementInForm(), and getForm().

Referenced by ilADTBooleanFormBridge\addToForm(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTFloatFormBridge\addToForm(), ilADTIntegerFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTMultiEnumFormBridge\addToForm(), ilADTMultiTextFormBridge\addToForm(), and ilADTTextFormBridge\addToForm().

Here is the call graph for this function:

Here is the caller graph for this function:

findParentElementInForm()

ilADTFormBridge::findParentElementInForm ( )

protected

Try to find parent element in form (could be option)

Returns

ilFormPropertyGUI

Definition at line 252 of file class.ilADTFormBridge.php.

        {
                $parent_def = $this->getParentElement();
                if($parent_def)
                {
                        if(is_array($parent_def))
                        {
                                $parent_option = $parent_def[1];
                                $parent_def = $parent_def[0];                                                           
                        }                       
 
                        // :TODO: throw exception on invalid definition ?!
 
                        $parent_field = $this->getForm()->getItemByPostVar($parent_def);                                                
                        if($parent_field instanceof ilSubEnabledFormPropertyGUI)
                        {
                                // radio/checkbox group
                                if($parent_option && method_exists($parent_field, "getOptions"))
                                {                                       
                                        foreach($parent_field->getOptions() as $option)
                                        {
                                                if($option->getValue() == $parent_option)
                                                {
                                                        $parent_field = $option;
                                                        break;
                                                }
                                        }
                                }
                        }
                        
                        if($parent_field)
                        {
                                return $parent_field;
                        }                                       
                }
        }

References getForm(), and getParentElement().

Referenced by addToParentElement().

Here is the call graph for this function:

Here is the caller graph for this function:

getADT()

ilADTFormBridge::getADT

(

)

Get ADT.

Returns

ilADT

Definition at line 69 of file class.ilADTFormBridge.php.

        {
                return $this->adt;
        }

References $adt.

Referenced by ilADTBooleanFormBridge\addToForm(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTFloatFormBridge\addToForm(), ilADTIntegerFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTMultiEnumFormBridge\addToForm(), ilADTMultiTextFormBridge\addToForm(), ilADTTextFormBridge\addToForm(), ilADTBooleanFormBridge\importFromPost(), ilADTDateFormBridge\importFromPost(), ilADTDateTimeFormBridge\importFromPost(), ilADTEnumFormBridge\importFromPost(), ilADTFloatFormBridge\importFromPost(), ilADTIntegerFormBridge\importFromPost(), ilADTLocationFormBridge\importFromPost(), ilADTMultiEnumFormBridge\importFromPost(), ilADTMultiTextFormBridge\importFromPost(), ilADTTextFormBridge\importFromPost(), isActiveForSubItems(), ilADTBooleanFormBridge\isActiveForSubItems(), ilADTEnumFormBridge\isActiveForSubItems(), ilADTMultiEnumFormBridge\isActiveForSubItems(), ilADTGroupFormBridge\prepareElements(), validate(), and ilADTGroupFormBridge\validate().

Here is the caller graph for this function:

getElementId()

ilADTFormBridge::getElementId

(

)

Get element id.

Returns

string

Definition at line 109 of file class.ilADTFormBridge.php.

        {
                return $this->id;
        }

References $id.

Referenced by ilADTDateFormBridge\addToElementId(), ilADTBooleanFormBridge\addToForm(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTFloatFormBridge\addToForm(), ilADTIntegerFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTMultiEnumFormBridge\addToForm(), ilADTMultiTextFormBridge\addToForm(), ilADTTextFormBridge\addToForm(), ilADTBooleanFormBridge\importFromPost(), ilADTDateFormBridge\importFromPost(), ilADTDateTimeFormBridge\importFromPost(), ilADTEnumFormBridge\importFromPost(), ilADTFloatFormBridge\importFromPost(), ilADTIntegerFormBridge\importFromPost(), ilADTLocationFormBridge\importFromPost(), ilADTMultiEnumFormBridge\importFromPost(), ilADTMultiTextFormBridge\importFromPost(), ilADTTextFormBridge\importFromPost(), setExternalErrors(), and validate().

Here is the caller graph for this function:

getForm()

ilADTFormBridge::getForm

(

)

Get form.

Returns

ilPropertyFormGUI

Definition at line 89 of file class.ilADTFormBridge.php.

        {
                return $this->form;
        }

References $form.

Referenced by ilADTGroupFormBridge\addToForm(), addToParentElement(), findParentElementInForm(), ilADTBooleanFormBridge\importFromPost(), ilADTDateFormBridge\importFromPost(), ilADTDateTimeFormBridge\importFromPost(), ilADTEnumFormBridge\importFromPost(), ilADTFloatFormBridge\importFromPost(), ilADTIntegerFormBridge\importFromPost(), ilADTLocationFormBridge\importFromPost(), ilADTMultiEnumFormBridge\importFromPost(), ilADTMultiTextFormBridge\importFromPost(), ilADTTextFormBridge\importFromPost(), ilADTGroupFormBridge\prepareElements(), ilADTTestGUI\prepareFormElements(), setExternalErrors(), validate(), and ilADTGroupFormBridge\validate().

Here is the caller graph for this function:

getInfo()

ilADTFormBridge::getInfo

(

)

Get info.

Returns

string

Definition at line 149 of file class.ilADTFormBridge.php.

        {
                return $this->info;
        }

References $info.

Referenced by addBasicFieldProperties(), and ilADTGroupFormBridge\addToForm().

Here is the caller graph for this function:

getParentElement()

ilADTFormBridge::getParentElement

(

)

Get parent element.

Returns

string

Definition at line 173 of file class.ilADTFormBridge.php.

        {
                return $this->parent;
        }

Referenced by findParentElementInForm(), and shouldBeImportedFromPost().

Here is the caller graph for this function:

getTitle()

ilADTFormBridge::getTitle

(

)

Get title.

Returns

string

Definition at line 129 of file class.ilADTFormBridge.php.

        {
                return $this->title;
        }

References $title.

Referenced by ilADTBooleanFormBridge\addToForm(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTFloatFormBridge\addToForm(), ilADTGroupFormBridge\addToForm(), ilADTIntegerFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTMultiEnumFormBridge\addToForm(), ilADTMultiTextFormBridge\addToForm(), and ilADTTextFormBridge\addToForm().

Here is the caller graph for this function:

importFromPost()

ilADTFormBridge::importFromPost ( )

abstract

Import values from form request POST data.

Reimplemented in ilADTBooleanFormBridge, ilADTDateFormBridge, ilADTDateTimeFormBridge, ilADTEnumFormBridge, ilADTFloatFormBridge, ilADTGroupFormBridge, ilADTIntegerFormBridge, ilADTLocationFormBridge, ilADTMultiEnumFormBridge, ilADTMultiTextFormBridge, and ilADTTextFormBridge.

isActiveForSubItems()

ilADTFormBridge::isActiveForSubItems (   $a_parent_option = null )

protected

Check if element is currently active for subitem(s)

Parameters

mixed

$a_parent_option

Returns

bool

Reimplemented in ilADTBooleanFormBridge, ilADTEnumFormBridge, and ilADTMultiEnumFormBridge.

Definition at line 328 of file class.ilADTFormBridge.php.

        {
                return !$this->getADT()->isNull();
        }

References getADT().

Here is the call graph for this function:

isDisabled()

ilADTFormBridge::isDisabled

(

)

Get disabled.

Returns

bool

Definition at line 193 of file class.ilADTFormBridge.php.

        {
                return $this->disabled;
        }

References $disabled.

Referenced by addBasicFieldProperties(), and shouldBeImportedFromPost().

Here is the caller graph for this function:

isRequired()

ilADTFormBridge::isRequired

(

)

Get required.

Returns

required

Definition at line 213 of file class.ilADTFormBridge.php.

        {
                return $this->required;
        }

References $required.

Referenced by addBasicFieldProperties(), ilADTDateFormBridge\addToForm(), ilADTDateTimeFormBridge\addToForm(), ilADTEnumFormBridge\addToForm(), ilADTLocationFormBridge\addToForm(), ilADTDateFormBridge\importFromPost(), ilADTDateTimeFormBridge\importFromPost(), ilADTLocationFormBridge\importFromPost(), and validate().

Here is the caller graph for this function:

isValidADT()

ilADTFormBridge::isValidADT ( ilADT  $a_adt )

abstractprotected

Check if given ADT is valid.

:TODO: This could be avoided with type-specifc constructors :TODO: bridge base class?

Parameters

ilADT

$a_adt

Reimplemented in ilADTBooleanFormBridge, ilADTDateFormBridge, ilADTDateTimeFormBridge, ilADTEnumFormBridge, ilADTFloatFormBridge, ilADTGroupFormBridge, ilADTIntegerFormBridge, ilADTLocationFormBridge, ilADTMultiEnumFormBridge, ilADTMultiTextFormBridge, and ilADTTextFormBridge.

Referenced by setADT().

Here is the caller graph for this function:

setADT()

ilADTFormBridge::setADT ( ilADT  $a_adt )

protected

Set ADT.

Exceptions

Exception

Parameters

ilADT

$a_adt

Definition at line 54 of file class.ilADTFormBridge.php.

        {
                if(!$this->isValidADT($a_adt))
                {
                        throw new Exception('ADTFormBridge Type mismatch.');
                }
                
                $this->adt = $a_adt;                            
        }

References isValidADT().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

setDisabled()

ilADTFormBridge::setDisabled

(

$a_value

)

Set disabled.

Parameters

bool

$a_value

Definition at line 183 of file class.ilADTFormBridge.php.

        {
                $this->disabled = (bool)$a_value;
        }

setElementId()

ilADTFormBridge::setElementId

(

$a_value

)

Set element id (aka form field)

Parameters

string

$a_value

Definition at line 99 of file class.ilADTFormBridge.php.

        {
                $this->id = (string)$a_value;
        }

setExternalErrors()

ilADTFormBridge::setExternalErrors

(

$a_errors

)

Definition at line 402 of file class.ilADTFormBridge.php.

        {
                $field = $this->getForm()->getItemByPostvar($this->getElementId());                                     
                $field->setAlert(implode("<br />", $a_errors));
        }

References getElementId(), and getForm().

Here is the call graph for this function:

setForm()

ilADTFormBridge::setForm

(

ilPropertyFormGUI

$a_form

)

Set form.

Parameters

ilPropertyFormGUI

$a_form

Definition at line 79 of file class.ilADTFormBridge.php.

        {
                $this->form = $a_form;
        }

setInfo()

ilADTFormBridge::setInfo

(

$a_value

)

Set info (aka form field info text)

Parameters

string

$a_value

Definition at line 139 of file class.ilADTFormBridge.php.

        {
                $this->info = trim($a_value);
        }

Referenced by ilADTTestGUI\prepareFormElements().

Here is the caller graph for this function:

setParentElement()

ilADTFormBridge::setParentElement

(

$a_value

)

Set parent element.

Parameters

string | array

$a_value

Definition at line 159 of file class.ilADTFormBridge.php.

        {
                if(!is_array($a_value))
                {
                        $a_value = (string)$a_value;
                }
                $this->parent = $a_value;
        }

setRequired()

ilADTFormBridge::setRequired

(

$a_value

)

Set required.

Parameters

bool

$a_value

Definition at line 203 of file class.ilADTFormBridge.php.

        {
                $this->required = (bool)$a_value;
        }

setTitle()

ilADTFormBridge::setTitle

(

$a_value

)

Set title (aka form field caption)

Parameters

string

$a_value

Definition at line 119 of file class.ilADTFormBridge.php.

        {
                $this->title = trim($a_value);
        }

Referenced by ilADTTestGUI\prepareFormElements().

Here is the caller graph for this function:

shouldBeImportedFromPost()

ilADTFormBridge::shouldBeImportedFromPost

(

ilADTFormBridge

$a_parent_adt = null

)

Check if incoming values should be imported at all.

Parameters

ilADTFormBridge

$a_parent_adt

Returns

bool

Definition at line 339 of file class.ilADTFormBridge.php.

        {
                if($this->isDisabled())
                {
                        return false;
                }
                
                // inactive parent elements disable importing
                if($a_parent_adt)
                {
                        $parent_option = null;
                        $parent_element = $this->getParentElement();
                        if(is_array($parent_element))
                        {
                                $parent_option = $parent_element[1];
                        }
                        return $a_parent_adt->isActiveForSubItems($parent_option);
                }       
                
                return true;
        }

References $parent_element, getParentElement(), and isDisabled().

Here is the call graph for this function:

validate()

ilADTFormBridge::validate

(

)

Validate ADT and parse error codes.

Returns

boolean

Reimplemented in ilADTBooleanFormBridge, ilADTDateFormBridge, ilADTDateTimeFormBridge, and ilADTGroupFormBridge.

Definition at line 371 of file class.ilADTFormBridge.php.

        {               
                global $lng;
                
                // ilADTFormBridge->isRequired() != ilADT->allowNull()
                if($this->isRequired() && $this->getADT()->isNull())
                {
                        $field = $this->getForm()->getItemByPostvar($this->getElementId());                                     
                        $field->setAlert($lng->txt("msg_input_is_required"));
                        return false;
                }               
                // no need to further validate if no value given
                else if(!$this->getADT()->isValid())
                {
                        $tmp = array();
                        
                        $mess = $this->getADT()->getValidationErrors();
                        foreach($mess as $error_code)
                        {
                                $tmp[] = $this->getADT()->translateErrorCode($error_code);
                        }                       
                        
                        $field = $this->getForm()->getItemByPostvar($this->getElementId());                                     
                        $field->setAlert(implode("<br />", $tmp));
                        
                        return false;
                }
                
                return true;
        }

References $lng, getADT(), getElementId(), getForm(), and isRequired().

Here is the call graph for this function:

Field Documentation

$adt

ilADTFormBridge::$adt

protected

Definition at line 13 of file class.ilADTFormBridge.php.

Referenced by ilADTLocationFormBridge\addToForm(), and getADT().

$disabled

ilADTFormBridge::$disabled

protected

Definition at line 20 of file class.ilADTFormBridge.php.

Referenced by isDisabled().

$form

ilADTFormBridge::$form

protected

Definition at line 14 of file class.ilADTFormBridge.php.

Referenced by getForm().

$id

ilADTFormBridge::$id

protected

Definition at line 15 of file class.ilADTFormBridge.php.

Referenced by getElementId().

$info

ilADTFormBridge::$info

protected

Definition at line 17 of file class.ilADTFormBridge.php.

Referenced by addBasicFieldProperties(), and getInfo().

$parent_element

ilADTFormBridge::$parent_element

protected

Definition at line 18 of file class.ilADTFormBridge.php.

Referenced by shouldBeImportedFromPost().

$required

ilADTFormBridge::$required

protected

Definition at line 19 of file class.ilADTFormBridge.php.

Referenced by isRequired().

$title

ilADTFormBridge::$title

protected

Definition at line 16 of file class.ilADTFormBridge.php.

Referenced by ilADTLocationFormBridge\addToForm(), and getTitle().

---

The documentation for this class was generated from the following file:

• Services/ADT/classes/Bridges/class.ilADTFormBridge.php