ilImageFileInputGUI Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilImageFileInputGUI:

Collaboration diagram for ilImageFileInputGUI:

Public Member Functions
	__construct (string $a_title="", string $a_postvar="")
	setAllowDeletion (bool $a_val)
	getALlowDeletion ()
	setAllowCapture (bool $a_val)
	getAllowCapture ()
	setUseCache (bool $a_cache)
	Set cache. More...
	getUseCache ()
	setImage (string $a_image)
	getImage ()
	setAlt (string $a_alt)
	getAlt ()
	insert (ilTemplate $a_tpl)
	getDeletionFlag ()
Public Member Functions inherited from ilFileInputGUI
	__construct (string $a_title="", string $a_postvar="")
	setValueByArray (array $a_values)
	setValue (string $a_value)
	Set Value. More...
	getValue ()
	setSize (int $a_size)
	getSize ()
	setFilename (string $a_val)
	getFilename ()
	setSuffixes (array $a_suffixes)
	getSuffixes ()
	setForbiddenSuffixes (array $a_suffixes)
	getForbiddenSuffixes ()
	setPending (string $a_val)
	getPending ()
	enableFileNameSelection (string $a_post_var)
	isFileNameSelectionEnabled ()
	getFileNamePostVar ()
	setAllowDeletion (bool $a_val)
	getALlowDeletion ()
	checkInput ()
	getInput ()
	render (string $a_mode="")
	insert (ilTemplate $a_tpl)
	getDeletionFlag ()
	getToolbarHTML ()
	Get input item HTML to be inserted into ilToolbarGUI. More...
Public Member Functions inherited from ilSubEnabledFormPropertyGUI
	addSubItem (ilFormPropertyGUI $a_item)
	getSubItems ()
	getSubInputItemsRecursive ()
	returns a flat array of possibly existing subitems recursively More...
	checkSubItemsInput ()
	Check SubItems. More...
	getSubForm ()
	getItemByPostVar (string $a_post_var)
Public Member Functions inherited from ilFormPropertyGUI
	__construct (string $a_title="", string $a_postvar="")
	executeCommand ()
	getType ()
	setTitle (string $a_title)
	getTitle ()
	setPostVar (string $a_postvar)
	getPostVar ()
	getFieldId ()
	setInfo (string $a_info)
	getInfo ()
	setAlert (string $a_alert)
	getAlert ()
	setRequired (bool $a_required)
	getRequired ()
	setDisabled (bool $a_disabled)
	getDisabled ()
	checkInput ()
	Check input, strip slashes etc. More...
	setParentForm (ilPropertyFormGUI $a_parentform)
	getParentForm ()
	setParent (ilFormPropertyGUI $a_val)
	getParent ()
	getSubForm ()
	hideSubForm ()
	setHiddenTitle (string $a_val)
	getHiddenTitle ()
	getItemByPostVar (string $a_post_var)
	Get item by post var. More...
	serializeData ()
	unserializeData (string $a_data)
	setParentTable ($a_val)
	Set parent table. More...
	getParentTable ()
	Get parent table. More...
	writeToSession ()
	clearFromSession ()
	readFromSession ()
	getHiddenTag (string $a_post_var, string $a_value)
	setMulti (bool $a_multi, bool $a_sortable=false, bool $a_addremove=true)
	getMulti ()
	setMultiValues (array $a_values)
	getMultiValues ()
	getContentOutsideFormTag ()
	Get content that has to reside outside of the parent form tag, e.g. More...
	stripSlashesAddSpaceFallback (string $a_str)
	Strip slashes with add space fallback, see https://www.ilias.de/mantis/view.php?id=19727. More...
	getTableFilterLabelFor ()
	Get label "for" attribute value for filter. More...
	getFormLabelFor ()
	Get label "for" attribute value for form. More...
	setRequestParam (string $key, $val)
	This writes the request (aka post) values. More...

Protected Attributes
ilGlobalTemplateInterface	$tpl
bool	$cache = false
string	$alt = ""
string	$image = ""
bool	$allow_capture = false
Protected Attributes inherited from ilFileInputGUI
int	$size = 40
string	$pending = ""
bool	$allow_deletion = false
bool	$filename_selection = false
array	$forbidden_suffixes = []
array	$suffixes = []
string	$value = ""
ILIAS FileUpload FileUpload	$upload_service
Protected Attributes inherited from ilSubEnabledFormPropertyGUI
array	$sub_items = array()
Protected Attributes inherited from ilFormPropertyGUI
array	$set_params = []
ilTable2GUI	$parent_table = null
ilFormPropertyGUI	$parent_gui = null
ilCtrl	$ctrl
ilLanguage	$lng
string	$type = ""
string	$title = ""
string	$postvar = ""
string	$info = ""
string	$alert = ""
bool	$required = false
ilPropertyFormGUI	$parentform = null
string	$hidden_title = ""
bool	$multi = false
bool	$multi_sortable = false
bool	$multi_addremove = true
array	$multi_values = []
RequestInterface	$request
HTTP Services	$http
Refinery Factory	$refinery = null
bool	$disabled = false
ilGlobalTemplateInterface	$global_tpl = null

Additional Inherited Members
Static Public Member Functions inherited from ilFormPropertyGUI
static	removeProhibitedCharacters (string $a_text)
	Remove prohibited characters see #19159. More...
Protected Member Functions inherited from ilFileInputGUI
	outputSuffixes (ilTemplate $a_tpl, string $a_block="allowed_suffixes")
	getMaxFileSizeString ()
	getMaxFileUploads ()
	Get number of maximum file uploads as declared in php.ini. More...
Protected Member Functions inherited from ilFormPropertyGUI
	setType (string $a_type)
	checkParentFormTable ()
	getSessionKey ()
	getMultiIconsHTML ()
	int ($key)
	intArray ($key)
	str ($key)
	raw ($key)
	strArray ($key)
	arrayArray ($key)
	isRequestParamArray (string $key)
	getRequestParam (string $key, Refinery\Transformation $t)

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning This class represents an image file property in a property form.

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 26 of file class.ilImageFileInputGUI.php.

Constructor & Destructor Documentation

__construct()

ilImageFileInputGUI::__construct	(	string	$a_title = "",
		string	$a_postvar = ""
	)

Definition at line 34 of file class.ilImageFileInputGUI.php.

References $DIC, ilFormPropertyGUI\$lng, ILIAS\GlobalScreen\Provider\__construct(), ILIAS\Repository\lng(), setAllowDeletion(), ilFormPropertyGUI\setHiddenTitle(), ilFileInputGUI\setSuffixes(), ilFormPropertyGUI\setType(), and ilLanguage\txt().

      {
        global $DIC;

        $this->lng = $DIC->language();
        $lng = $DIC->language();

        parent::__construct($a_title, $a_postvar);
        $this->setType("image_file");
        $this->setAllowDeletion(true);
        $this->setSuffixes(array("jpg", "jpeg", "png", "gif"));
        $this->setHiddenTitle("(" . $lng->txt("form_image_file_input") . ")");
        $this->cache = true;
        $this->tpl = $DIC->ui()->mainTemplate();
    }

Here is the call graph for this function:

Member Function Documentation

getAllowCapture()

ilImageFileInputGUI::getAllowCapture

(

)

Definition at line 67 of file class.ilImageFileInputGUI.php.

References $allow_capture.

Referenced by insert().

                                     : bool
    {
        return $this->allow_capture;
    }

Here is the caller graph for this function:

getALlowDeletion()

ilImageFileInputGUI::getALlowDeletion

(

)

Definition at line 57 of file class.ilImageFileInputGUI.php.

References ilFileInputGUI\$allow_deletion.

Referenced by insert().

                                      : bool
    {
        return $this->allow_deletion;
    }

Here is the caller graph for this function:

getAlt()

ilImageFileInputGUI::getAlt

(

)

Definition at line 103 of file class.ilImageFileInputGUI.php.

References $alt.

Referenced by ilImagemapCorrectionsInputGUI\insert(), insert(), and ilImagemapFileInputGUI\insert().

                            : string
    {
        return $this->alt;
    }

Here is the caller graph for this function:

getDeletionFlag()

ilImageFileInputGUI::getDeletionFlag

(

)

Definition at line 194 of file class.ilImageFileInputGUI.php.

References ilFormPropertyGUI\getPostVar(), and ilFormPropertyGUI\str().

Referenced by ilLTIConsumeProviderIcon\handleUploadInputSubission().

                                     : bool
    {
        if ($this->str($this->getPostVar() . "_delete") != "") {
            return true;
        }
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getImage()

ilImageFileInputGUI::getImage

(

)

Definition at line 93 of file class.ilImageFileInputGUI.php.

References $image.

Referenced by ilImagemapCorrectionsInputGUI\insert(), insert(), and ilImagemapFileInputGUI\insert().

                              : string
    {
        return $this->image;
    }

Here is the caller graph for this function:

getUseCache()

ilImageFileInputGUI::getUseCache

(

)

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

References $cache.

Referenced by insert().

                                 : bool
    {
        return $this->cache;
    }

Here is the caller graph for this function:

insert()

ilImageFileInputGUI::insert

(

ilTemplate

$a_tpl

)

Definition at line 108 of file class.ilImageFileInputGUI.php.

References ilFormPropertyGUI\$lng, ilFileInputGUI\$pending, $tpl, getAllowCapture(), getALlowDeletion(), getAlt(), ilFormPropertyGUI\getDisabled(), ilFormPropertyGUI\getFieldId(), getImage(), ilFileInputGUI\getMaxFileSizeString(), ilFileInputGUI\getPending(), ilFormPropertyGUI\getPostVar(), getUseCache(), ilFileInputGUI\getValue(), ilFileInputGUI\outputSuffixes(), ilTemplate\parseCurrentBlock(), ilTemplate\setCurrentBlock(), ilGlobalTemplateInterface\setCurrentBlock(), HTML_Template_IT\setVariable(), and ilLanguage\txt().

                                             : void
    {
        $lng = $this->lng;

        $quota_exceeded = $quota_legend = false;
        $i_tpl = new ilTemplate("tpl.prop_image_file.html", true, true, "Services/Form");

        if ($this->getAllowCapture()) {
            $i_tpl->setCurrentBlock("capture");
            $i_tpl->setVariable("POST_VAR_V", $this->getPostVar());
            $i_tpl->setVariable("TXT_USE_CAMERA", $lng->txt("form_use_camera"));
            $i_tpl->setVariable("TXT_TAKE_SNAPSHOT", $lng->txt("form_take_snapshot"));
            $i_tpl->parseCurrentBlock();
            $main_tpl = $this->tpl;
            $main_tpl->addJavascript("./Services/Form/js/ServiceFormImageFileCapture.js");
        }

        if ($this->getImage() != "") {
            if (!$this->getDisabled() && $this->getALlowDeletion()) {
                $i_tpl->setCurrentBlock("delete_bl");
                $i_tpl->setVariable("POST_VAR_D", $this->getPostVar());
                $i_tpl->setVariable(
                    "TXT_DELETE_EXISTING",
                    $lng->txt("delete_existing_file")
                );
                $i_tpl->parseCurrentBlock();
            }

            if (strlen($this->getValue())) {
                $i_tpl->setCurrentBlock("has_value");
                $i_tpl->setVariable("TEXT_IMAGE_NAME", $this->getValue());
                $i_tpl->parseCurrentBlock();
            }
            $i_tpl->setCurrentBlock("image");
            if (!$this->getUseCache()) {
                $pos = strpos($this->getImage(), '?');
                if ($pos !== false) {
                    $i_tpl->setVariable("SRC_IMAGE", $this->getImage() . "&time=" . time());
                } else {
                    $i_tpl->setVariable("SRC_IMAGE", $this->getImage() . "?time=" . time());
                }
            } else {
                $i_tpl->setVariable("SRC_IMAGE", $this->getImage());
            }
            $i_tpl->setVariable("POST_VAR_I", $this->getPostVar());
            $i_tpl->setVariable("ALT_IMAGE", $this->getAlt());
            $i_tpl->parseCurrentBlock();
        }

        $pending = $this->getPending();
        if ($pending) {
            $i_tpl->setCurrentBlock("pending");
            $i_tpl->setVariable("TXT_PENDING", $lng->txt("file_upload_pending") .
                ": " . htmlentities($pending));
            $i_tpl->parseCurrentBlock();
        }

        $i_tpl->setVariable("POST_VAR", $this->getPostVar());
        $i_tpl->setVariable("ID", $this->getFieldId());


        /* experimental: bootstrap'ed file upload */
        $i_tpl->setVariable("TXT_BROWSE", $lng->txt("select_file"));


        if (!$quota_exceeded) {
            $i_tpl->setVariable("TXT_MAX_SIZE", $lng->txt("file_notice") . " " .
                $this->getMaxFileSizeString() . $quota_legend);

            $this->outputSuffixes($i_tpl, "allowed_image_suffixes");
        } else {
            $i_tpl->setVariable("TXT_MAX_SIZE", $quota_exceeded);
        }

        if ($this->getDisabled() || $quota_exceeded) {
            $i_tpl->setVariable(
                "DISABLED",
                " disabled=\"disabled\""
            );
        }

        $a_tpl->setCurrentBlock("prop_generic");
        $a_tpl->setVariable("PROP_GENERIC", $i_tpl->get());
        $a_tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

setAllowCapture()

ilImageFileInputGUI::setAllowCapture

(

bool

$a_val

)

Definition at line 62 of file class.ilImageFileInputGUI.php.

Referenced by ilUserProfile\addStandardFieldsToForm().

                                                : void
    {
        $this->allow_capture = $a_val;
    }

Here is the caller graph for this function:

setAllowDeletion()

ilImageFileInputGUI::setAllowDeletion

(

bool

$a_val

)

Definition at line 52 of file class.ilImageFileInputGUI.php.

Referenced by __construct(), ilDidacticTemplateSettingsGUI\createImportForm(), and ilPCInteractiveImageGUI\initForm().

                                                 : void
    {
        $this->allow_deletion = $a_val;
    }

Here is the caller graph for this function:

setAlt()

ilImageFileInputGUI::setAlt

(

string

$a_alt

)

Definition at line 98 of file class.ilImageFileInputGUI.php.

                                         : void
    {
        $this->alt = $a_alt;
    }

setImage()

ilImageFileInputGUI::setImage

(

string

$a_image

)

Definition at line 88 of file class.ilImageFileInputGUI.php.

Referenced by ilDidacticTemplateSettingsGUI\initEditTemplate(), and ilObjUserGUI\initForm().

                                             : void
    {
        $this->image = $a_image;
    }

Here is the caller graph for this function:

setUseCache()

ilImageFileInputGUI::setUseCache

(

bool

$a_cache

)

Set cache.

Parameters

bool

$a_cache

If false, the image will be forced to reload in the browser by adding an URL parameter with the actual timestamp

Definition at line 78 of file class.ilImageFileInputGUI.php.

                                              : void
    {
        $this->cache = $a_cache;
    }

Field Documentation

$allow_capture

bool ilImageFileInputGUI::$allow_capture = false

protected

Definition at line 32 of file class.ilImageFileInputGUI.php.

Referenced by getAllowCapture().

$alt

string ilImageFileInputGUI::$alt = ""

protected

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

Referenced by getAlt().

$cache

bool ilImageFileInputGUI::$cache = false

protected

Definition at line 29 of file class.ilImageFileInputGUI.php.

Referenced by getUseCache().

$image

string ilImageFileInputGUI::$image = ""

protected

Definition at line 31 of file class.ilImageFileInputGUI.php.

Referenced by getImage().

$tpl

ilGlobalTemplateInterface ilImageFileInputGUI::$tpl

protected

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

Referenced by ilImagemapCorrectionsInputGUI\insert(), and insert().

---

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

• Services/Form/classes/class.ilImageFileInputGUI.php