Fixed bug #12618: Validation issue in sysext lowlevel: Fix some warnings
[Packages/TYPO3.CMS.git] / t3lib / class.t3lib_arraybrowser.php
1 <?php
2 /***************************************************************
3 * Copyright notice
4 *
5 * (c) 1999-2009 Kasper Skaarhoj (kasperYYYY@typo3.com)
6 * All rights reserved
7 *
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
18 *
19 *
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
24 *
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
27 /**
28 * Class for displaying an array as a tree
29 *
30 * $Id$
31 * Revised for TYPO3 3.6 July/2003 by Kasper Skaarhoj
32 * XHTML compliant
33 *
34 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
35 */
36 /**
37 * [CLASS/FUNCTION INDEX of SCRIPT]
38 *
39 *
40 *
41 * 77: class t3lib_arrayBrowser
42 * 96: function tree($arr, $depth_in, $depthData)
43 * 160: function wrapValue($theValue,$depth)
44 * 172: function wrapArrayKey($label,$depth,$theValue)
45 * 196: function getSearchKeys($keyArr, $depth_in, $searchString, $keyArray)
46 * 228: function fixed_lgd($string,$chars)
47 * 245: function depthKeys($arr,$settings)
48 *
49 * TOTAL FUNCTIONS: 6
50 * (This index is automatically created/updated by the extension "extdeveval")
51 *
52 */
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68 /**
69 * Class for displaying an array as a tree
70 * See the extension 'lowlevel' /config (Backend module 'Tools > Configuration')
71 *
72 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
73 * @package TYPO3
74 * @subpackage t3lib
75 * @see SC_mod_tools_config_index::main()
76 */
77 class t3lib_arrayBrowser {
78 var $expAll = FALSE; // If set, will expand all (depthKeys is obsolete then) (and no links are applied)
79 var $dontLinkVar = FALSE; // If set, the variable keys are not linked.
80 var $depthKeys = array(); // Array defining which keys to expand. Typically set from outside from some session variable - otherwise the array will collapse.
81 var $searchKeys = array(); // After calling the getSearchKeys function this array is populated with the key-positions in the array which contains values matching the search.
82 var $fixedLgd=1; // If set, the values are truncated with "..." appended if longer than a certain length.
83 var $regexMode=0; // If set, search for string with regex, otherwise stristr()
84 var $searchKeysToo=FALSE; // If set, array keys are subject to the search too.
85 var $varName=''; // Set var name here if you want links to the variable name.
86
87 /**
88 * Make browsable tree
89 * Before calling this function you may want to set some of the internal vars like depthKeys, regexMode and fixedLgd. For examples see SC_mod_tools_config_index::main()
90 *
91 * @param array The array to display
92 * @param string Key-position id. Build up during recursive calls - [key1].[key2].[key3] - an so on.
93 * @param string Depth-data - basically a prefix for the icons. For calling this function from outside, let it stay blank.
94 * @return string HTML for the tree
95 * @see SC_mod_tools_config_index::main()
96 */
97 function tree($arr, $depth_in, $depthData) {
98 $HTML='';
99 $a=0;
100
101 if ($depth_in) {$depth_in = $depth_in.'.';}
102
103 $c=count($arr);
104 reset($arr);
105 while (list($key,)=each($arr)) {
106 $a++;
107 $depth = $depth_in.$key;
108 $goto = 'a' . substr(md5($depth), 0, 6);
109
110 $deeper = (is_array($arr[$key]) && ($this->depthKeys[$depth] || $this->expAll)) ? 1 : 0;
111 $PM = 'join';
112 $LN = ($a==$c)?'blank':'line';
113 $BTM = ($a==$c)?'bottom':'';
114 $PM = is_array($arr[$key]) ? ($deeper ? 'minus':'plus') : 'join';
115
116
117 $HTML.=$depthData;
118 $theIcon='<img'.t3lib_iconWorks::skinImg($GLOBALS['BACK_PATH'],'gfx/ol/'.$PM.$BTM.'.gif','width="18" height="16"').' align="top" border="0" alt="" />';
119 if ($PM=='join') {
120 $HTML.=$theIcon;
121 } else {
122 $HTML.=
123 ($this->expAll ? '' : '<a id="' . $goto . '" href="' . htmlspecialchars('index.php?node[' . $depth . ']=' . ($deeper ? 0 : 1) . '#' . $goto) . '">') .
124 $theIcon.
125 ($this->expAll ? '' : '</a>');
126 }
127
128 $label = $key;
129 $HTML.= $this->wrapArrayKey($label,$depth,!is_array($arr[$key]) ? $arr[$key] : '');
130
131 if (!is_array($arr[$key])) {
132 $theValue = $arr[$key];
133 if ($this->fixedLgd) {
134 $imgBlocks = ceil(1+strlen($depthData)/77);
135 // debug($imgBlocks);
136 $lgdChars = 68-ceil(strlen('['.$key.']')*0.8)-$imgBlocks*3;
137 $theValue = $this->fixed_lgd($theValue,$lgdChars);
138 }
139 if ($this->searchKeys[$depth]) {
140 $HTML.='=<span style="color:red;">'.$this->wrapValue($theValue,$depth).'</span>';
141 } else {
142 $HTML.='='.$this->wrapValue($theValue,$depth);
143 }
144 }
145 $HTML.='<br />';
146
147 if ($deeper) {
148 $HTML.=$this->tree($arr[$key], $depth, $depthData.'<img'.t3lib_iconWorks::skinImg($GLOBALS['BACK_PATH'],'gfx/ol/'.$LN.'.gif','width="18" height="16"').' align="top" alt="" />');
149 }
150 }
151 return $HTML;
152 }
153
154 /**
155 * Wrapping the value in bold tags etc.
156 *
157 * @param string The title string
158 * @param string Depth path
159 * @return string Title string, htmlspecialchars()'ed
160 */
161 function wrapValue($theValue,$depth) {
162 $wrappedValue = '';
163 if (strlen($theValue) > 0) {
164 $wrappedValue = '<b>' . htmlspecialchars($theValue) . '</b>';
165 }
166 return $wrappedValue;
167 }
168
169 /**
170 * Wrapping the value in bold tags etc.
171 *
172 * @param string The title string
173 * @param string Depth path
174 * @param string The value for the array entry.
175 * @return string Title string, htmlspecialchars()'ed
176 */
177 function wrapArrayKey($label,$depth,$theValue) {
178
179 // Protect label:
180 $label = htmlspecialchars($label);
181
182 // If varname is set:
183 if ($this->varName && !$this->dontLinkVar) {
184 $variableName = $this->varName.'[\''.str_replace('.','\'][\'',$depth).'\'] = '.(!t3lib_div::testInt($theValue) ? '\''.addslashes($theValue).'\'' : $theValue).'; ';
185 $label = '<a href="index.php?varname=' . urlencode($variableName) . '#varname">' . $label . '</a>';
186 }
187
188 // Return:
189 return '['.$label.']';
190 }
191
192 /**
193 * Creates an array with "depthKeys" which will expand the array to show the search results
194 *
195 * @param array The array to search for the value
196 * @param string Depth string - blank for first call (will build up during recursive calling creating an id of the position: [key1].[key2].[key3]
197 * @param string The string to search for
198 * @param array Key array, for first call pass empty array
199 * @return array
200 */
201 function getSearchKeys($keyArr, $depth_in, $searchString, $keyArray) {
202 reset($keyArr);
203 $c=count($keyArr);
204 if ($depth_in) {$depth_in = $depth_in.'.';}
205 while (list($key,)=each($keyArr)) {
206 $depth=$depth_in.$key;
207 $deeper = is_array($keyArr[$key]);
208
209 if ($this->regexMode) {
210 if (preg_match('/'.$searchString.'/',$keyArr[$key]) || ($this->searchKeysToo && preg_match('/'.$searchString.'/',$key))) { $this->searchKeys[$depth]=1; }
211 } else {
212 if (stristr($keyArr[$key],$searchString) || ($this->searchKeysToo && stristr($key,$searchString))) { $this->searchKeys[$depth]=1; }
213 }
214
215 if ($deeper) {
216 $cS = count($this->searchKeys);
217 $keyArray = $this->getSearchKeys($keyArr[$key], $depth, $searchString, $keyArray);
218 if ($cS != count($this->searchKeys)) {
219 $keyArray[$depth]=1;
220 }
221 }
222 }
223 return $keyArray;
224 }
225
226 /**
227 * Fixed length function
228 *
229 * @param string String to process
230 * @param integer Max number of chars
231 * @return string Processed string
232 */
233 function fixed_lgd($string,$chars) {
234 if ($chars >= 4) {
235 if(strlen($string)>$chars) {
236 return substr($string, 0, $chars-3).'...';
237 }
238 }
239 return $string;
240 }
241
242 /**
243 * Function modifying the depthKey array
244 *
245 * @param array Array with instructions to open/close nodes.
246 * @param array Input depth_key array
247 * @return array Output depth_key array with entries added/removed based on $arr
248 * @see SC_mod_tools_config_index::main()
249 */
250 function depthKeys($arr,$settings) {
251 $tsbrArray=array();
252 reset($arr);
253 while(list($theK,$theV)=each($arr)) {
254 $theKeyParts = explode('.',$theK);
255 $depth='';
256 $c=count($theKeyParts);
257 $a=0;
258 while(list(,$p)=each($theKeyParts)) {
259 $a++;
260 $depth.=($depth?'.':'').$p;
261 $tsbrArray[$depth]= ($c==$a) ? $theV : 1;
262 }
263 }
264 // Modify settings
265 reset($tsbrArray);
266 while(list($theK,$theV)=each($tsbrArray)) {
267 if ($theV) {
268 $settings[$theK] = 1;
269 } else {
270 unset($settings[$theK]);
271 }
272 }
273 return $settings;
274 }
275 }
276
277 if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_arraybrowser.php']) {
278 include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_arraybrowser.php']);
279 }
280 ?>