Inheritance diagram for ilAsyncPropertyFormGUI:

Collaboration diagram for ilAsyncPropertyFormGUI:

Public Member Functions
	__construct (array $config=array(), $is_async=true)

	checkInput ()
	Saves the change input result into a property. More...

	getErrors ()
	Return errors of the form as array. More...

	hasErrors ()
	Return if there were errors on the last checkInput call. More...

	cloneForm (ilPropertyFormGUI $form_to_clone)
	Copies form items, buttons and properties from another form. More...

	getHTML ()
	Returns the rendered form content. More...

	isSubmitted ()
	Checks if the form was submitted. More...

	setFormAction ($a_formaction)
	Sets the form action If the form is set to async, the cmdMode=asynch is added to the url. More...

	getJsPath ()

	setJsPath ($js_path)

	getDefaultFormName ()

	isAsync ()

	setAsync ($is_async)

	setName ($a_name)

Public Member Functions inherited from ilPropertyFormGUI
	__construct ()
	Constructor. More...

	executeCommand ()
	Execute command. More...

	setTableWidth ($a_width)
	Set table width. More...

	getTableWidth ()
	get table width More...

	setMode ($a_mode)
	Set Mode ('std', 'subform'). More...

	getMode ()
	Get Mode ('std', 'subform'). More...

	setTitle ($a_title)
	Set Title. More...

	getTitle ()
	Get Title. More...

	setTitleIcon ($a_titleicon)
	Set TitleIcon. More...

	getTitleIcon ()
	Get TitleIcon. More...

	setDescription ($a_val)
	Set description. More...

	getDescription ()
	Get description. More...

	setTopAnchor ($a_val)
	Set top anchor. More...

	getTopAnchor ()
	Get top anchor. More...

	setShowTopButtons ($a_val)
	Get show top buttons. More...

	getShowTopButtons ()
	Set show top buttons. More...

	addItem ($a_item)
	Add Item (Property, SectionHeader). More...

	removeItemByPostVar ($a_post_var, $a_remove_unused_headers=false)
	Remove Item. More...

	getItemByPostVar ($a_post_var)
	Get Item by POST variable. More...

	setItems ($a_items)
	Set Items. More...

	getItems ()
	Get Items. More...

	getInputItemsRecursive ()
	returns a flat array of all input items including the possibly existing subitems recursively More...

	setDisableStandardMessage ($a_val)
	Set disable standard message. More...

	getDisableStandardMessage ()
	Get disable standard message. More...

	getHideLabels ()
	Get a value indicating whether the labels should be hidden or not. More...

	setHideLabels ($a_value=true)
	Set a value indicating whether the labels should be hidden or not. More...

	setValuesByArray ($a_values, $a_restrict_to_value_keys=false)
	Set form values from an array. More...

	setValuesByPost ()
	Set form values from POST values. More...

	checkInput ()
	Check Post Input. More...

	getInput ($a_post_var, $ensureValidation=true)
	Returns the value of a HTTP-POST variable, identified by the passed id. More...

	addCustomProperty ( $a_title, $a_html, $a_info="", $a_alert="", $a_required=false)
	Add a custom property. More...

	addCommandButton ($a_cmd, $a_text, $a_id="")
	Add Command button. More...

	getCommandButtons ()
	Return all Command buttons. More...

	clearCommandButtons ()
	Remove all command buttons. More...

	getContent ()
	Get Content. More...

	insertItem ($item, $a_sub_item=false)

	getHTML ()

	getFileUpload ($a_field, $a_index=null, $a_sub_index=null)
	Get file upload data. More...

	hasFileUpload ($a_field, $a_index=null, $a_sub_index=null)
	Was any file uploaded? More...

	moveFileUpload ($a_target_directory, $a_field, $a_target_name=null, $a_index=null, $a_sub_index=null)
	Move upload to target directory. More...

Public Member Functions inherited from ilFormGUI
	setFormAction ($a_formaction)
	Set FormAction. More...

	getFormAction ()
	Get FormAction. More...

	setTarget ($a_target)
	Set Target. More...

	getTarget ()
	Get Target. More...

	setMultipart ($a_multipart)
	Set Enctype Multipart/Formdata true/false. More...

	getMultipart ()
	Get Enctype Multipart/Formdata true/false. More...

	setId ($a_id)
	Set Id. More...

	getId ()
	Get Id. More...

	setName ($a_name)
	Set Name. More...

	getName ()
	Get Name. More...

	setKeepOpen ($a_keepopen)
	Set Keep Form Tag Open. More...

	getKeepOpen ()
	Get Keep Form Tag Open. More...

	setOpenTag ($a_open)
	Enable/Disable Open Form Tag. More...

	getOpenTag ()
	Get Open Form Tag Enabled. More...

	setCloseTag ($a_val)
	Set close tag. More...

	getCloseTag ()
	Get close tag. More...

	setPreventDoubleSubmission ($a_val)
	Set prevent double submission. More...

	getPreventDoubleSubmission ()
	Get prevent double submission. More...

	getHTML ()
	Get HTML. More...

	getContent ()
	Get Content. More...

Static Public Member Functions
static	addJavaScript ($add_form_loader=false, $js_base_path=null)
	Adds all needed js By default is called by ilAsyncPropertyFormGUI::getHTML() More...

static	getErrorMessageTemplate ()
	Returns the error-message template for the client-side validation. More...

Static Protected Member Functions
static	addOnLoadCode ($id, $content)
	Adds onload code to the template. More...

Protected Attributes
	$has_errors = false

	$is_async = true

Protected Attributes inherited from ilPropertyFormGUI
	$lng

	$ctrl

	$tpl

	$user

	$settings

	$mode = "std"

	$check_input_called = false

	$disable_standard_message = false

	$top_anchor = "il_form_top"

	$titleicon = false

	$description = ""

	$tbl_width = false

	$show_top_buttons = true

	$hide_labels = false

Protected Attributes inherited from ilFormGUI
	$formaction

	$multipart = false

	$keepopen = false

	$opentag = true

	$id

	$name

	$prevent_double_submission = false

Static Protected Attributes
static	$js_path = "./Modules/StudyProgramme/templates/js/"

static	$default_from_name = "async_form"

static	$js_on_load_added = array()

Additional Inherited Members
Protected Member Functions inherited from ilPropertyFormGUI
	hideRequired ($a_type)

	rebuildUploadedFiles ()
	try to rebuild files More...

Detailed Description

Class ilAsyncPropertyFormGUI.

Author: Michael Herren mh@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Version: 1.0.0

Definition at line 10 of file class.ilAsyncPropertyFormGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilAsyncPropertyFormGUI::__construct	(	array	$config = `array()`,
			$is_async = `true`
	)

Definition at line 37 of file class.ilAsyncPropertyFormGUI.php.

References $config, $is_async, $key, setAsync(), and setName().

     {
         parent::__construct();
 
         foreach ($config as $key=>$value) {
             $setterMethod = "set" . ucfirst($key);
             if (method_exists($this, $setterMethod)) {
                 $setterMethod($value);
             }
         }
 
         $this->setAsync($is_async);
         $this->setName(self::$default_from_name);
     }

Here is the call graph for this function:

Member Function Documentation

◆ addJavaScript()

static ilAsyncPropertyFormGUI::addJavaScript	(	$add_form_loader = `false`,
		$js_base_path = `null`
	)

static

Adds all needed js By default is called by ilAsyncPropertyFormGUI::getHTML()

Parameters

bool	$add_form_loader
null	$js_base_path

Definition at line 60 of file class.ilAsyncPropertyFormGUI.php.

References $DIC, $js_path, and ilPropertyFormGUI\$tpl.

Referenced by ilObjStudyProgrammeTreeGUI\initAsyncUIElements().

     {
         global $DIC;
         $tpl = $DIC['tpl'];
 
         $js_path = (isset($js_base_path))? $js_base_path : self::$js_path;
 
         $tpl->addJavaScript($js_path . 'ilAsyncPropertyFormGUI.js');
 
         $global_config = "$.ilAsyncPropertyForm.global_config.error_message_template = '" . self::getErrorMessageTemplate() . "'; $.ilAsyncPropertyForm.global_config.async_form_name = '" . self::$default_from_name . "';";
         self::addOnLoadCode('global_config', $global_config);
 
         if ($add_form_loader) {
             self::addOnLoadCode('form_loader', '$("body").ilAsyncPropertyForm();');
         }
     }

Here is the caller graph for this function:

◆ addOnLoadCode()

static ilAsyncPropertyFormGUI::addOnLoadCode	(	$id,
		$content
	)

staticprotected

Adds onload code to the template.

Parameters

$id
$content

Definition at line 185 of file class.ilAsyncPropertyFormGUI.php.

References $DIC, ilFormGUI\$id, and ilPropertyFormGUI\$tpl.

     {
         global $DIC;
         $tpl = $DIC['tpl'];
 
         if (!isset(self::$js_on_load_added[$id])) {
             $tpl->addOnLoadCode($content);
             self::$js_on_load_added[$id] = $content;
         }
     }

◆ checkInput()

ilAsyncPropertyFormGUI::checkInput ( )

Saves the change input result into a property.

Returns: bool

Definition at line 83 of file class.ilAsyncPropertyFormGUI.php.

References $result.

Referenced by getErrors().

     {
         $result = parent::checkInput();
         $this->has_errors = $result;
 
         return $result;
     }

Here is the caller graph for this function:

◆ cloneForm()

ilAsyncPropertyFormGUI::cloneForm ( ilPropertyFormGUI $form_to_clone )

Copies form items, buttons and properties from another form.

Parameters

ilPropertyFormGUI $form_to_clone

Returns: $this

Exceptions

ilException

Definition at line 154 of file class.ilAsyncPropertyFormGUI.php.

References ilPropertyFormGUI\addCommandButton(), ilPropertyFormGUI\addItem(), ilPropertyFormGUI\getCommandButtons(), and ilPropertyFormGUI\getItems().

     {
         if (count($this->getItems()) > 0) {
             throw new ilException("You cannot clone into a already filled form!");
         }
 
         $reflect = new ReflectionClass($this);
         $properties = $reflect->getProperties(ReflectionProperty::IS_PUBLIC);
 
         foreach ($properties as $property) {
             $this->{$property->getName()} = $property->getValue($form_to_clone);
         }
 
         foreach ($form_to_clone->getItems() as $item) {
             $this->addItem($item);
         }
 
         foreach ($form_to_clone->getCommandButtons() as $button) {
             $this->addCommandButton($button['cmd'], $button['text']);
         }
 
         return $this;
     }

Here is the call graph for this function:

◆ getDefaultFormName()

ilAsyncPropertyFormGUI::getDefaultFormName ( )

Returns: mixed

Definition at line 256 of file class.ilAsyncPropertyFormGUI.php.

     {
         return self::$default_from_name;
     }

◆ getErrorMessageTemplate()

static ilAsyncPropertyFormGUI::getErrorMessageTemplate ( )

static

Returns the error-message template for the client-side validation.

Returns: string

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

References $DIC, ilPropertyFormGUI\$lng, ilPropertyFormGUI\$tpl, and ilUtil\getImagePath().

     {
         global $DIC;
         $lng = $DIC['lng'];
 
         $tpl = new ilTemplate("tpl.property_form.html", true, true, "Services/Form");
 
         $tpl->setCurrentBlock("alert");
         $tpl->setVariable("IMG_ALERT", ilUtil::getImagePath("icon_alert.svg"));
         $tpl->setVariable("ALT_ALERT", $lng->txt("alert"));
         $tpl->setVariable("TXT_ALERT", "[TXT_ALERT]");
         $tpl->parseCurrentBlock();
         $content = trim($tpl->get("alert"));
 
         return $content;
     }

Here is the call graph for this function:

◆ getErrors()

ilAsyncPropertyFormGUI::getErrors ( )

Return errors of the form as array.

Returns: array Array with field id and error message: array([]=>array('key'=>fieldId, 'message'=>error-message))

Definition at line 96 of file class.ilAsyncPropertyFormGUI.php.

References $errors, array, checkInput(), and ilPropertyFormGUI\getItems().

     {
         if (!$this->check_input_called) {
             $this->checkInput();
         }
 
         $errors = array();
         foreach ($this->getItems() as $item) {
             // We call method exists as there are items in the form (ilFormSectionHeaderGUI)
             // that do not have alerts. (#16956)
             if (method_exists($item, "getAlert") && $item->getAlert() != "") {
                 $errors[] = array('key'=>$item->getFieldId(), 'message'=>$item->getAlert());
             }
         }
         return $errors;
     }

Here is the call graph for this function:

◆ getHTML()

ilAsyncPropertyFormGUI::getHTML ( )

Returns the rendered form content.

Returns: string

Definition at line 201 of file class.ilAsyncPropertyFormGUI.php.

References isAsync().

     {
         self::addJavaScript($this->isAsync());
 
         return parent::getHTML();
     }

Here is the call graph for this function:

◆ getJsPath()

ilAsyncPropertyFormGUI::getJsPath ( )

Returns: mixed

Definition at line 240 of file class.ilAsyncPropertyFormGUI.php.

References $js_path.

     {
         return $this->js_path;
     }

◆ hasErrors()

ilAsyncPropertyFormGUI::hasErrors ( )

Return if there were errors on the last checkInput call.

Returns: boolean

Definition at line 118 of file class.ilAsyncPropertyFormGUI.php.

References $has_errors.

     {
         return $this->has_errors;
     }

◆ isAsync()

ilAsyncPropertyFormGUI::isAsync ( )

Returns: boolean

Definition at line 264 of file class.ilAsyncPropertyFormGUI.php.

References $is_async.

Referenced by getHTML(), and setFormAction().

     {
         return $this->is_async;
     }

Here is the caller graph for this function:

◆ isSubmitted()

ilAsyncPropertyFormGUI::isSubmitted ( )

Checks if the form was submitted.

Returns: bool

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

References $_POST.

     {
         if (isset($_POST['cmd'])) {
             return true;
         }
         return false;
     }

◆ setAsync()

ilAsyncPropertyFormGUI::setAsync ( $is_async )

Parameters

boolean $is_async

Definition at line 273 of file class.ilAsyncPropertyFormGUI.php.

References $is_async.

Referenced by __construct().

     {
         $this->is_async = $is_async;
     }

Here is the caller graph for this function:

◆ setFormAction()

ilAsyncPropertyFormGUI::setFormAction ( $a_formaction )

Sets the form action If the form is set to async, the cmdMode=asynch is added to the url.

Parameters

string $a_formaction

Definition at line 228 of file class.ilAsyncPropertyFormGUI.php.

References isAsync().

     {
         if ($this->isAsync()) {
             $a_formaction .= "&cmdMode=asynch";
         }
 
         $this->formaction = $a_formaction;
     }

Here is the call graph for this function:

◆ setJsPath()

ilAsyncPropertyFormGUI::setJsPath ( $js_path )

Parameters

mixed $js_path

Definition at line 248 of file class.ilAsyncPropertyFormGUI.php.

References $js_path.

     {
         $this->js_path = $js_path;
     }

◆ setName()

ilAsyncPropertyFormGUI::setName ( $a_name )

Parameters

string $a_name

Definition at line 282 of file class.ilAsyncPropertyFormGUI.php.

Referenced by __construct().

     {
         self::$default_from_name = $a_name;
 
         parent::setName($a_name);
     }

Here is the caller graph for this function:

Field Documentation

◆ $default_from_name

ilAsyncPropertyFormGUI::$default_from_name = "async_form"

staticprotected

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

◆ $has_errors

ilAsyncPropertyFormGUI::$has_errors = false

protected

Definition at line 30 of file class.ilAsyncPropertyFormGUI.php.

Referenced by hasErrors().

◆ $is_async

ilAsyncPropertyFormGUI::$is_async = true

protected

Definition at line 35 of file class.ilAsyncPropertyFormGUI.php.

Referenced by __construct(), isAsync(), and setAsync().

◆ $js_on_load_added

ilAsyncPropertyFormGUI::$js_on_load_added = array()

staticprotected

Definition at line 25 of file class.ilAsyncPropertyFormGUI.php.

◆ $js_path

ilAsyncPropertyFormGUI::$js_path = "./Modules/StudyProgramme/templates/js/"

staticprotected

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

Referenced by addJavaScript(), getJsPath(), and setJsPath().

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

Modules/StudyProgramme/classes/helpers/class.ilAsyncPropertyFormGUI.php

Public Member Functions

Static Public Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addJavaScript()

◆ addOnLoadCode()

◆ checkInput()

◆ cloneForm()

◆ getDefaultFormName()

◆ getErrorMessageTemplate()

◆ getErrors()

◆ getHTML()

◆ getJsPath()

◆ hasErrors()

◆ isAsync()

◆ isSubmitted()

◆ setAsync()

◆ setFormAction()

◆ setJsPath()

◆ setName()

Field Documentation

◆ $default_from_name

◆ $has_errors

◆ $is_async

◆ $js_on_load_added

◆ $js_path