1: <?php
2: /**
3: * Formatted textarea form
4: *
5: * You may not change or alter any portion of this comment or credits
6: * of supporting developers from this source code or any supporting source code
7: * which is considered copyrighted (c) material of the original comment or credit authors.
8: * This program is distributed in the hope that it will be useful,
9: * but WITHOUT ANY WARRANTY; without even the implied warranty of
10: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
11: *
12: * @copyright (c) 2000-2017 XOOPS Project (www.xoops.org)
13: * @license GNU GPL 2 (http://www.gnu.org/licenses/gpl-2.0.html)
14: * @package kernel
15: * @subpackage form
16: * @since 2.0.0
17: * @author Kazumi Ono (AKA onokazu) http://www.myweb.ne.jp/, http://jp.xoops.org/
18: * @author Taiwen Jiang <phppp@users.sourceforge.net>
19: * @author Vinod <smartvinu@gmail.com>
20: */
21: defined('XOOPS_ROOT_PATH') || exit('Restricted access');
22:
23: /**
24: * base class
25: */
26: xoops_load('XoopsFormTextArea');
27:
28: /**
29: * A textarea with xoopsish formatting and smilie buttons
30: *
31: */
32: class XoopsFormDhtmlTextArea extends XoopsFormTextArea
33: {
34: /**
35: * Extended HTML editor
36: *
37: * <p>If an extended HTML editor is set, the renderer will be replaced by the specified editor, usually a visual or WYSIWYG editor.</p>
38: *
39: * <ul>Developer and user guide:
40: * <li><ul>For run-time settings per call
41: * <li>To use an editor pre-configured by {@link XoopsEditor}, e.g. 'fckeditor': <code>$options['editor'] = 'fckeditor';</code></li>
42: * <li>To use a custom editor, e.g. 'MyEditor' class located in "/modules/myeditor/myeditor.php": <code>$options['editor'] = array('MyEditor', XOOPS_ROOT_PATH . "/modules/myeditor/myeditor.php");</code></li>
43: * </ul></li>
44: * <li><ul>For pre-configured settings, which will force to use a editor if no specific editor is set for call
45: * <li><ul>Set up custom configs: in XOOPS_VAR_PATH . '/configs/xoopsconfig.php' set a editor as default, e.g.
46: * <li>a pre-configured editor 'fckeditor': <code>return array('editor' => 'fckeditor');</code></li>
47: * <li>a custom editor 'MyEditor' class located in "/modules/myeditor/myeditor.php": <code>return array('editor' => array('MyEditor', XOOPS_ROOT_PATH . "/modules/myeditor/myeditor.php");</code></li>
48: * </ul></li>
49: * <li>To disable the default editor, in XOOPS_VAR_PATH . '/configs/xoopsconfig.php': <code>return array();</code></li>
50: * <li>To disable the default editor for a specific call: <code>$options['editor'] = 'dhtmltextarea';</code></li>
51: * </ul></li>
52: * </ul>
53: */
54: public $htmlEditor = array();
55:
56: /**
57: * Hidden text
58: *
59: * @var string
60: * @access private
61: */
62: public $_hiddenText;
63:
64: public $skipPreview = false;
65: public $doHtml = false;
66: public $js = '';
67:
68: /**
69: * Constructor
70: *
71: * @param string $caption Caption
72: * @param string $name "name" attribute
73: * @param string $value Initial text
74: * @param int $rows Number of rows
75: * @param int $cols Number of columns
76: * @param string $hiddentext Identifier for hidden Text
77: * @param array $options Extra options
78: */
79: public function __construct($caption, $name, $value = '', $rows = 5, $cols = 50, $hiddentext = 'xoopsHiddenText', $options = array())
80: {
81: global $xoopsConfig;
82: static $inLoop = 0;
83:
84: ++$inLoop;
85: // Second loop, invalid, return directly
86: if ($inLoop > 2) {
87: return null;
88: }
89: // Else, initialize
90: parent::__construct($caption, $name, $value, $rows, $cols);
91: $this->_hiddenText = $hiddentext;
92:
93: if ($inLoop > 1) {
94: return null;
95: }
96: if (!isset($options['editor'])) {
97: if (isset($xoopsConfig['editor'])) {
98: $options['editor'] = $xoopsConfig['editor'];
99: }
100: }
101:
102: if (!empty($this->htmlEditor) || !empty($options['editor'])) {
103: $options['name'] = $this->getName();
104: $options['value'] = $this->getValue();
105: if (!empty($options['editor'])) {
106: $this->htmlEditor = is_array($options['editor']) ? $options['editor'] : array($options['editor']);
107: }
108:
109: if (count($this->htmlEditor) == 1) {
110: xoops_load('XoopsEditorHandler');
111: $editor_handler = XoopsEditorHandler::getInstance();
112: $this->htmlEditor = $editor_handler->get($this->htmlEditor[0], $options);
113: if ($inLoop > 1) {
114: $this->htmlEditor = null;
115: }
116: } else {
117: list($class, $path) = $this->htmlEditor;
118: include_once XOOPS_ROOT_PATH . $path;
119: if (class_exists($class)) {
120: $this->htmlEditor = new $class($options);
121: }
122: if ($inLoop > 1) {
123: $this->htmlEditor = null;
124: }
125: }
126: }
127:
128: $inLoop = 0;
129: }
130:
131: /**
132: * Prepare HTML for output
133: *
134: * @return string HTML
135: */
136: public function render()
137: {
138: if ($this->htmlEditor && is_object($this->htmlEditor)) {
139: if (!isset($this->htmlEditor->isEnabled) || $this->htmlEditor->isEnabled) {
140: return $this->htmlEditor->render();
141: }
142: }
143:
144: return XoopsFormRenderer::getInstance()->get()->renderFormDhtmlTextArea($this);
145: }
146:
147: /**
148: * XoopsFormDhtmlTextArea::renderValidationJS()
149: *
150: * @return bool|string
151: */
152: public function renderValidationJS()
153: {
154: if ($this->htmlEditor && is_object($this->htmlEditor) && method_exists($this->htmlEditor, 'renderValidationJS')) {
155: if (!isset($this->htmlEditor->isEnabled) || $this->htmlEditor->isEnabled) {
156: return $this->htmlEditor->renderValidationJS();
157: }
158: }
159:
160: return parent::renderValidationJS();
161: }
162: }
163: