class.ilTextAreaInputGUI.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2007 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/

include_once("./Services/Form/classes/class.ilSubEnabledFormPropertyGUI.php");
include_once "./Services/RTE/classes/class.ilRTE.php";

class ilTextAreaInputGUI extends ilSubEnabledFormPropertyGUI
{
        protected $value;
        protected $cols;
        protected $rows;
        protected $usert;
        protected $rtetags;
        protected $plugins;
        protected $removeplugins;
        protected $buttons;     
        protected $rtesupport;
        protected $use_tags_for_rte_only = true;

        protected $initial_rte_width = 795;
        
        protected $disabled_buttons = array();
        
        protected $usePurifier = false; 
        
        protected $Purifier = null;
        
        protected $root_block_element = null;
        
        protected $rte_tag_set = array(
                "mini" => array("strong", "em", "u", "ol", "li", "ul", "blockquote", "a", "p", "span", "br"), // #13286/#17981
                "standard" => array ("strong", "em", "u", "ol", "li", "ul", "p", "div",
                        "i", "b", "code", "sup", "sub", "pre", "strike", "gap"),
                "extended" => array (
                        "a","blockquote","br","cite","code","div","em","h1","h2","h3",
                        "h4","h5","h6","hr","li","ol","p",
                        "pre","span","strike","strong","sub","sup","u","ul",
                        "i", "b", "gap"),
                "extended_img" => array (
                        "a","blockquote","br","cite","code","div","em","h1","h2","h3",
                        "h4","h5","h6","hr","img","li","ol","p",
                        "pre","span","strike","strong","sub","sup","u","ul",
                        "i", "b", "gap"),
                "extended_table" => array (
                        "a","blockquote","br","cite","code","div","em","h1","h2","h3",
                        "h4","h5","h6","hr","li","ol","p",
                        "pre","span","strike","strong","sub","sup","table","td",
                        "tr","u","ul", "i", "b", "gap"),
                "extended_table_img" => array (
                        "a","blockquote","br","cite","code","div","em","h1","h2","h3",
                        "h4","h5","h6","hr","img","li","ol","p",
                        "pre","span","strike","strong","sub","sup","table","td",
                        "tr","u","ul", "i", "b", "gap"),
                "full" => array (
                        "a","blockquote","br","cite","code","div","em","h1","h2","h3",
                        "h4","h5","h6","hr","img","li","ol","p",
                        "pre","span","strike","strong","sub","sup","table","td",
                        "tr","u","ul","ruby","rbc","rtc","rb","rt","rp", "i", "b", "gap"));
                
        
        function __construct($a_title = "", $a_postvar = "")
        {
                parent::__construct($a_title, $a_postvar);
                $this->setType("textarea");
                $this->setRteTagSet("standard");
                $this->plugins = array();
                $this->removeplugins = array();
                $this->buttons = array();
                $this->rteSupport = array();
        }

        function setValue($a_value)
        {
                $this->value = $a_value;
        }

        function getValue()
        {
                return $this->value;
        }

        function setCols($a_cols)
        {
                // obsolete because of bootstrap
                $this->cols = $a_cols;
        }

        function getCols()
        {
                return $this->cols;
        }

        function setRows($a_rows)
        {
                $this->rows = $a_rows;
        }

        function getRows()
        {
                return $this->rows;
        }

        public function setUseRte($a_usert, $version = '')
        {
                $this->usert = $a_usert;

                if(strlen($version))
                {
                        $this->rteSupport['version'] = $version;
                }
        }

        function getUseRte()
        {
                return $this->usert;
        }
        
        function addPlugin($a_plugin)
        {
                $this->plugins[$a_plugin] = $a_plugin;
        }
        
        function removePlugin($a_plugin)
        {
                $this->removeplugins[$a_plugin] = $a_plugin;
        }

        function addButton($a_button)
        {
                $this->buttons[$a_button] = $a_button;
        }
        
        function removeButton($a_button)
        {
                unset($this->buttons[$a_button]);
        }

        function setRTESupport($obj_id, $obj_type, $module, $cfg_template = null, $hide_switch = false, $version = null)
        {
                $this->rteSupport = array("obj_id" => $obj_id, "obj_type" => $obj_type, "module" => $module, 'cfg_template' => $cfg_template, 'hide_switch' => $hide_switch, 'version' => $version);
        }
        
        function removeRTESupport()
        {
                $this->rteSupport = array();
        }

        function setRteTags($a_rtetags)
        {
                $this->rtetags = $a_rtetags;
        }

        function getRteTags()
        {
                return $this->rtetags;
        }
        
        function setRteTagSet($a_set_name)
        {
                $this->setRteTags($this->rte_tag_set[$a_set_name]);
        }

        function getRteTagSet($a_set_name)
        {
                return $this->rte_tag_set[$a_set_name];
        }

        
        function getRteTagString()
        {
                $result = "";
                foreach ($this->getRteTags() as $tag)
                {
                        $result .= "<$tag>";
                }
                return $result;
        }

        function setUseTagsForRteOnly($a_val)
        {
                $this->use_tags_for_rte_only = $a_val;
        }
        
        function getUseTagsForRteOnly()
        {
                return $this->use_tags_for_rte_only;
        }
        
        function setValueByArray($a_values)
        {
                $this->setValue($a_values[$this->getPostVar()]);
                
                foreach($this->getSubItems() as $item)
                {
                        $item->setValueByArray($a_values);
                }
        }

        function checkInput()
        {
                global $lng;
                include_once("./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php");
                
                if($this->usePurifier() && $this->getPurifier())
                {
                        $_POST[$this->getPostVar()] = ilUtil::stripOnlySlashes($_POST[$this->getPostVar()]);
                        $_POST[$this->getPostVar()] = $this->getPurifier()->purify($_POST[$this->getPostVar()]);
                }
                else
                {
                        $allowed = $this->getRteTagString();
                        if ($this->plugins["latex"] == "latex" && !is_int(strpos($allowed, "<span>")))
                        {
                                $allowed.= "<span>";
                        }
                        $_POST[$this->getPostVar()] = ($this->getUseRte() || !$this->getUseTagsForRteOnly())
                                ? ilUtil::stripSlashes($_POST[$this->getPostVar()], true, $allowed)
                                : $this->stripSlashesAddSpaceFallback($_POST[$this->getPostVar()]);
                }

                $_POST[$this->getPostVar()] = self::removeProhibitedCharacters($_POST[$this->getPostVar()]);

                if ($this->getRequired() && trim($_POST[$this->getPostVar()]) == "")
                {
                        $this->setAlert($lng->txt("msg_input_is_required"));

                        return false;
                }
                return $this->checkSubItemsInput();
        }

        function insert($a_tpl)
        {
                $ttpl = new ilTemplate("tpl.prop_textarea.html", true, true, "Services/Form");
                
                // disabled rte
                if ($this->getUseRte() && $this->getDisabled())
                {
                        $ttpl->setCurrentBlock("disabled_rte");
                        $ttpl->setVariable("DR_VAL", $this->getValue());
                        $ttpl->parseCurrentBlock();
                }
                else
                {
                        if ($this->getUseRte())
                        {
                                $rtestring = ilRTE::_getRTEClassname();
                                include_once "./Services/RTE/classes/class.$rtestring.php";
                                $rte = new $rtestring($this->rteSupport['version']);

                                $rte->setInitialWidth($this->getInitialRteWidth());
                                
                                // @todo: Check this.
                                $rte->addPlugin("emotions");
                                foreach ($this->plugins as $plugin)
                                {
                                        if (strlen($plugin))
                                        {
                                                $rte->addPlugin($plugin);
                                        }
                                }
                                foreach ($this->removeplugins as $plugin)
                                {
                                        if (strlen($plugin))
                                        {
                                                $rte->removePlugin($plugin);
                                        }
                                }
        
                                foreach ($this->buttons as $button)
                                {
                                        if (strlen($button))
                                        {
                                                $rte->addButton($button);
                                        }
                                }
                                
                                $rte->disableButtons($this->getDisabledButtons());
                                
                                if($this->getRTERootBlockElement() !== null)
                                {
                                        $rte->setRTERootBlockElement($this->getRTERootBlockElement());
                                }
                                
                                if (count($this->rteSupport) >= 3)
                                {
                                        $rte->addRTESupport($this->rteSupport["obj_id"], $this->rteSupport["obj_type"], $this->rteSupport["module"], false, $this->rteSupport['cfg_template'], $this->rteSupport['hide_switch']);
                                }
                                else
                                {                                       
                                        // disable all plugins for mini-tagset
                                        if(!array_diff($this->getRteTags(), $this->getRteTagSet("mini")))
                                        {
                                                $rte->removeAllPlugins();
                                                
                                                // #13603 - "paste from word" is essential
                                                $rte->addPlugin("paste"); 
                                                
                                                // #11980 - p-tag is mandatory but we do not want the icons it comes with
                                                $rte->disableButtons(array("anchor", "justifyleft", "justifycenter", 
                                                        "justifyright", "justifyfull", "formatselect", "removeformat",
                                                        "cut", "copy", "paste", "pastetext")); // JF, 2013-12-09
                                        }
                                        
                                        $rte->addCustomRTESupport(0, "", $this->getRteTags());                                  
                                }                       
                                
                                $ttpl->touchBlock("prop_ta_w");
                                $ttpl->setCurrentBlock("prop_textarea");
                                $ttpl->setVariable("ROWS", $this->getRows());
                        }
                        else
                        {
                                $ttpl->touchBlock("no_rteditor");
        
                                if ($this->getCols() > 5)
                                {
                                        $ttpl->setCurrentBlock("prop_ta_c");
                                        $ttpl->setVariable("COLS", $this->getCols());
                                        $ttpl->parseCurrentBlock();
                                }
                                else
                                {
                                        $ttpl->touchBlock("prop_ta_w");
                                }
                                
                                $ttpl->setCurrentBlock("prop_textarea");
                                $ttpl->setVariable("ROWS", $this->getRows());
                        }
                        if (!$this->getDisabled())
                        {
                                $ttpl->setVariable("POST_VAR",
                                        $this->getPostVar());
                        }
                        $ttpl->setVariable("ID", $this->getFieldId());
                        if ($this->getDisabled())
                        {
                                $ttpl->setVariable('DISABLED','disabled="disabled" ');
                        }
                        $ttpl->setVariable("PROPERTY_VALUE", ilUtil::prepareFormOutput($this->getValue()));                                             
                
                        if($this->getRequired())
                        {
                                $ttpl->setVariable("REQUIRED", "required=\"required\"");
                        }
                
                        $ttpl->parseCurrentBlock();
                }
                
                if ($this->getDisabled())
                {
                        $ttpl->setVariable("HIDDEN_INPUT",
                                $this->getHiddenTag($this->getPostVar(), $this->getValue()));
                }
                $a_tpl->setCurrentBlock("prop_generic");
                $a_tpl->setVariable("PROP_GENERIC", $ttpl->get());
                $a_tpl->parseCurrentBlock();

        }
        
        public function usePurifier($a_flag = null)
        {
                if(null === $a_flag)
                {
                        return $this->usePurifier;
                }
                
                $this->usePurifier = $a_flag;
                return $this;
        }
        
        public function setPurifier(ilHtmlPurifierInterface $Purifier)
        {
                $this->Purifier = $Purifier;
                return $this;
        }
        
        public function getPurifier()
        {
                return $this->Purifier;
        }
        
        public function setRTERootBlockElement($a_root_block_element)
        {
                $this->root_block_element = $a_root_block_element;
                return $this;
        }
        
        public function getRTERootBlockElement()
        {
                return $this->root_block_element;
        }
        
        public function disableButtons($a_button)
        {
                if(is_array($a_button))
                {
                        $this->disabled_buttons = array_unique(array_merge($this->disabled_buttons, $a_button));
                }
                else
                {
                        $this->disabled_buttons = array_unique(array_merge($this->disabled_buttons, array($a_button)));
                }
                
                return $this;
        }
        
        public function getDisabledButtons($as_array = true)
        {
                if(!$as_array)
                {
                        return implode(',', $this->disabled_buttons);
                }
                else
                {
                        return $this->disabled_buttons;
                }
        }

        public function getInitialRteWidth()
        {
                return $this->initial_rte_width;
        }

        public function setInitialRteWidth($initial_rte_width)
        {
                $this->initial_rte_width = $initial_rte_width;
        }
}