This class represents a form user interface. More...

Inheritance diagram for ilFormGUI:

Collaboration diagram for ilFormGUI:

Public Member Functions
	ilFormGUI ()
	Constructor. More...

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

Protected Attributes
	$formaction

	$multipart = false

	$keepopen = false

	$opentag = true

	$id

	$name

	$prevent_double_submission = false

Detailed Description

This class represents a form user interface.

Author: Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

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

Member Function Documentation

◆ getCloseTag()

ilFormGUI::getCloseTag ( )

Get close tag.

Returns: boolean close tag true/false

Definition at line 189 of file class.ilFormGUI.php.

        {
                return !$this->getKeepOpen();
        }

References getKeepOpen().

Here is the call graph for this function:

◆ getContent()

ilFormGUI::getContent ( )

Get Content.

Reimplemented in ilHierarchyFormGUI, and ilPropertyFormGUI.

Definition at line 287 of file class.ilFormGUI.php.

        {
                return "";
        }

Referenced by getHTML().

Here is the caller graph for this function:

◆ getFormAction()

ilFormGUI::getFormAction ( )

Get FormAction.

Returns: string FormAction

Definition at line 49 of file class.ilFormGUI.php.

        {
                return $this->formaction;
        }

References $formaction.

Referenced by getHTML().

Here is the caller graph for this function:

◆ getHTML()

ilFormGUI::getHTML ( )

Get HTML.

Reimplemented in ilHierarchyFormGUI, and ilPropertyFormGUI.

Definition at line 217 of file class.ilFormGUI.php.

        {
                $tpl = new ilTemplate("tpl.form.html", true, true, "Services/Form");
                
                // this line also sets multipart, so it must be before the multipart check
                $content = $this->getContent();
                if ($this->getOpenTag())
                {
                        $opentpl = new ilTemplate('tpl.form_open.html', true, true, "Services/Form");
                        if ($this->getTarget() != "")
                        {
                                $opentpl->setCurrentBlock("form_target");
                                $opentpl->setVariable("FORM_TARGET", $this->getTarget());
                                $opentpl->parseCurrentBlock();
                        }
                        if ($this->getName() != "")
                        {
                                $opentpl->setCurrentBlock("form_name");
                                $opentpl->setVariable("FORM_NAME", $this->getName());
                                $opentpl->parseCurrentBlock();
                        }
                        if ($this->getPreventDoubleSubmission())
                        {
                                $opentpl->setVariable("FORM_CLASS", "preventDoubleSubmission");
                        }
 
                        if ($this->getMultipart())
                        {
                                $opentpl->touchBlock("multipart");
                                /*if (function_exists("apc_fetch"))
                                //
                                // Progress bar would need additional browser window (popup)
                                // to not be stopped, when form is submitted  (we can't work
                                // with an iframe or httprequest solution here)
                                //
                                {
                                        $tpl->touchBlock("onsubmit");
                                        
                                        //onsubmit="postForm('{ON_ACT}','form_{F_ID}',1); return false;"
                                        $tpl->setCurrentBlock("onsubmit");
                                        $tpl->setVariable("ON_ACT", $this->getFormAction());
                                        $tpl->setVariable("F_ID", $this->getId());
                                        $tpl->setVariable("F_ID", $this->getId());
                                        $tpl->parseCurrentBlock();
        
                                        $tpl->setCurrentBlock("hidden_progress");
                                        $tpl->setVariable("APC_PROGRESS_ID", uniqid());
                                        $tpl->setVariable("APC_FORM_ID", $this->getId());
                                        $tpl->parseCurrentBlock();
                                }*/
                        }
                        $opentpl->setVariable("FORM_ACTION", $this->getFormAction());
                        if ($this->getId() != "")
                        {
                                $opentpl->setVariable("FORM_ID", $this->getId());
                        }
                        $opentpl->parseCurrentBlock();
                        $tpl->setVariable('FORM_OPEN_TAG', $opentpl->get());
                }
                $tpl->setVariable("FORM_CONTENT", $content);
                if (!$this->getKeepOpen())
                {
                        $tpl->setVariable("FORM_CLOSE_TAG", "</form>");
                }
                return $tpl->get();
        }

References $tpl, getContent(), getFormAction(), getId(), getKeepOpen(), getMultipart(), getName(), getOpenTag(), getPreventDoubleSubmission(), and getTarget().

Here is the call graph for this function:

◆ getId()

ilFormGUI::getId ( )

Get Id.

Returns: string Id

Reimplemented in ilHierarchyFormGUI.

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

        {
                return $this->id;
        }

References $id.

Referenced by getHTML().

Here is the caller graph for this function:

◆ getKeepOpen()

ilFormGUI::getKeepOpen ( )

Get Keep Form Tag Open.

Returns: boolean Keep Form Tag Open

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

        {
                return $this->keepopen;
        }

References $keepopen.

Referenced by getCloseTag(), and getHTML().

Here is the caller graph for this function:

◆ getMultipart()

ilFormGUI::getMultipart ( )

Get Enctype Multipart/Formdata true/false.

Returns: boolean Enctype Multipart/Formdata true/false

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

        {
                return $this->multipart;
        }

References $multipart.

Referenced by ilPropertyFormGUI\getContent(), and getHTML().

Here is the caller graph for this function:

◆ getName()

ilFormGUI::getName ( )

Get Name.

Returns: string Name

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

        {
                return $this->name;
        }

References $name.

Referenced by getHTML().

Here is the caller graph for this function:

◆ getOpenTag()

ilFormGUI::getOpenTag ( )

Get Open Form Tag Enabled.

Returns: boolean open form tag enabled

Definition at line 169 of file class.ilFormGUI.php.

        {
                return $this->opentag;
        }

References $opentag.

Referenced by getHTML().

Here is the caller graph for this function:

◆ getPreventDoubleSubmission()

ilFormGUI::getPreventDoubleSubmission ( )

Get prevent double submission.

Returns: bool prevent double submission

Definition at line 209 of file class.ilFormGUI.php.

        {
                return $this->prevent_double_submission;
        }

References $prevent_double_submission.

Referenced by getHTML().

Here is the caller graph for this function:

◆ getTarget()

ilFormGUI::getTarget ( )

Get Target.

Returns: string Target

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

        {
                return $this->target;
        }

Referenced by getHTML().

Here is the caller graph for this function:

◆ ilFormGUI()

ilFormGUI::ilFormGUI ( )

Constructor.

Parameters

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

31 {

32 }

◆ setCloseTag()

ilFormGUI::setCloseTag ( $a_val )

Set close tag.

Parameters

boolean close tag true/false

Definition at line 179 of file class.ilFormGUI.php.

        {
                $this->setKeepOpen(!$a_val);
        }

References setKeepOpen().

Here is the call graph for this function:

◆ setFormAction()

ilFormGUI::setFormAction ( $a_formaction )

Set FormAction.

Parameters

string $a_formaction FormAction

Definition at line 39 of file class.ilFormGUI.php.

        {
                $this->formaction = $a_formaction;
        }

Referenced by FormMailCodesGUI\__construct(), arConfigFormGUI\__construct(), ilTestRandomQuestionSetGeneralConfigFormGUI\build(), ilTestRandomQuestionSetPoolDefinitionFormGUI\build(), ilObjForumAdministrationGUI\getSettingsForm(), ilObjBibliographicAdminLibrariesFormGUI\initForm(), ilOrgUnitTypeCustomIconsFormGUI\initForm(), ilOrgUnitTypeFormGUI\initForm(), arEditGUI\initFormAction(), and ilObjUserFolderGUI\initLoginSettingsForm().

Here is the caller graph for this function:

◆ setId()

ilFormGUI::setId ( $a_id )

Set Id.

If you use multiple forms on a screen you should set this value.

Parameters

string $a_id Id

Reimplemented in ilHierarchyFormGUI.

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

        {
                $this->id = $a_id;
        }

Referenced by ilTestRandomQuestionSetGeneralConfigFormGUI\build(), and ilTestRandomQuestionSetPoolDefinitionFormGUI\build().

Here is the caller graph for this function:

◆ setKeepOpen()

ilFormGUI::setKeepOpen ( $a_keepopen )

Set Keep Form Tag Open.

Parameters

boolean $a_keepopen Keep Form Tag Open

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

        {
                $this->keepopen = $a_keepopen;
        }

Referenced by setCloseTag().

Here is the caller graph for this function:

◆ setMultipart()

ilFormGUI::setMultipart ( $a_multipart )

Set Enctype Multipart/Formdata true/false.

Parameters

boolean $a_multipart Enctype Multipart/Formdata true/false

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

        {
                $this->multipart = $a_multipart;
        }

Referenced by ilPropertyFormGUI\insertItem().

Here is the caller graph for this function:

◆ setName()

ilFormGUI::setName ( $a_name )

Set Name.

Useful for Javascript

Parameters

string $a_name Name

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

        {
                $this->name = $a_name;
        }

◆ setOpenTag()

ilFormGUI::setOpenTag ( $a_open )

Enable/Disable Open Form Tag.

Parameters

boolean $a_keepopen enable/disable form open tag

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

        {
                $this->opentag = $a_open;
        }

◆ setPreventDoubleSubmission()

ilFormGUI::setPreventDoubleSubmission ( $a_val )

Set prevent double submission.

Parameters

bool $a_val prevent double submission

Definition at line 199 of file class.ilFormGUI.php.

        {
                $this->prevent_double_submission = $a_val;
        }

Referenced by ilPropertyFormGUI\ilPropertyFormGUI().

Here is the caller graph for this function:

◆ setTarget()

ilFormGUI::setTarget ( $a_target )

Set Target.

Parameters

string $a_target Target

Definition at line 59 of file class.ilFormGUI.php.

        {
                $this->target = $a_target;
        }

Field Documentation

◆ $formaction

ilFormGUI::$formaction

protected

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

Referenced by getFormAction().

◆ $id

ilFormGUI::$id

protected

Definition at line 21 of file class.ilFormGUI.php.

Referenced by getId().

◆ $keepopen

ilFormGUI::$keepopen = false

protected

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

Referenced by getKeepOpen().

◆ $multipart

ilFormGUI::$multipart = false

protected

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

Referenced by getMultipart().

◆ $name

ilFormGUI::$name

protected

Definition at line 22 of file class.ilFormGUI.php.

Referenced by getName(), ilObjBibliographicAdminLibrariesFormGUI\initForm(), and ilPropertyFormGUI\rebuildUploadedFiles().

◆ $opentag

ilFormGUI::$opentag = true

protected

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

Referenced by getOpenTag().

◆ $prevent_double_submission

ilFormGUI::$prevent_double_submission = false

protected

Definition at line 23 of file class.ilFormGUI.php.

Referenced by getPreventDoubleSubmission().

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

Services/Form/classes/class.ilFormGUI.php

Public Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ getCloseTag()

◆ getContent()

◆ getFormAction()

◆ getHTML()

◆ getId()

◆ getKeepOpen()

◆ getMultipart()

◆ getName()

◆ getOpenTag()

◆ getPreventDoubleSubmission()

◆ getTarget()

◆ ilFormGUI()

◆ setCloseTag()

◆ setFormAction()

◆ setId()

◆ setKeepOpen()

◆ setMultipart()

◆ setName()

◆ setOpenTag()

◆ setPreventDoubleSubmission()

◆ setTarget()

Field Documentation

◆ $formaction

◆ $id

◆ $keepopen

◆ $multipart

◆ $name

◆ $opentag

◆ $prevent_double_submission