2 /***************************************************************
5 * (c) 1999-2009 Kasper Skaarhoj (kasperYYYY@typo3.com)
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.
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.
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.
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
28 * Contains TYPO3 Core Form generator - AKA "TCEforms"
31 * Revised for TYPO3 3.6 August/2003 by Kasper Skaarhoj
34 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
37 * [CLASS/FUNCTION INDEX of SCRIPT]
41 * 196: class t3lib_TCEforms
42 * 302: function t3lib_TCEforms()
43 * 338: function initDefaultBEmode()
45 * SECTION: Rendering the forms, fields etc
46 * 385: function getSoloField($table,$row,$theFieldToReturn)
47 * 424: function getMainFields($table,$row,$depth=0)
48 * 618: function getListedFields($table,$row,$list)
49 * 660: function getPaletteFields($table,$row,$palette,$header='',$itemList='',$collapsedHeader='')
50 * 737: function getSingleField($table,$field,$row,$altName='',$palette=0,$extra='',$pal=0)
51 * 900: function getSingleField_SW($table,$field,$row,&$PA)
53 * SECTION: Rendering of each TCEform field type
54 * 976: function getSingleField_typeInput($table,$field,$row,&$PA)
55 * 1057: function getSingleField_typeText($table,$field,$row,&$PA)
56 * 1178: function getSingleField_typeCheck($table,$field,$row,&$PA)
57 * 1244: function getSingleField_typeRadio($table,$field,$row,&$PA)
58 * 1279: function getSingleField_typeSelect($table,$field,$row,&$PA)
59 * 1359: function getSingleField_typeSelect_single($table,$field,$row,&$PA,$config,$selItems,$nMV_label)
60 * 1490: function getSingleField_typeSelect_checkbox($table,$field,$row,&$PA,$config,$selItems,$nMV_label)
61 * 1609: function getSingleField_typeSelect_singlebox($table,$field,$row,&$PA,$config,$selItems,$nMV_label)
62 * 1719: function getSingleField_typeSelect_multiple($table,$field,$row,&$PA,$config,$selItems,$nMV_label)
63 * 1823: function getSingleField_typeGroup($table,$field,$row,&$PA)
64 * 1992: function getSingleField_typeNone($table,$field,$row,&$PA)
65 * 2008: function getSingleField_typeNone_render($config,$itemValue)
66 * 2070: function getSingleField_typeFlex($table,$field,$row,&$PA)
67 * 2205: function getSingleField_typeFlex_langMenu($languages,$elName,$selectedLanguage,$multi=1)
68 * 2224: function getSingleField_typeFlex_sheetMenu($sArr,$elName,$sheetKey)
69 * 2259: function getSingleField_typeFlex_draw($dataStruct,$editData,$cmdData,$table,$field,$row,&$PA,$formPrefix='',$level=0,$tRows=array())
70 * 2452: function getSingleField_typeUnknown($table,$field,$row,&$PA)
71 * 2467: function getSingleField_typeUser($table,$field,$row,&$PA)
73 * SECTION: Field content processing
74 * 2496: function formatValue ($config, $itemValue)
76 * SECTION: "Configuration" fetching/processing functions
77 * 2588: function getRTypeNum($table,$row)
78 * 2614: function rearrange($fields)
79 * 2640: function getExcludeElements($table,$row,$typeNum)
80 * 2688: function getFieldsToAdd($table,$row,$typeNum)
81 * 2713: function mergeFieldsWithAddedFields($fields,$fieldsToAdd)
82 * 2745: function setTSconfig($table,$row,$field='')
83 * 2767: function getSpecConfForField($table,$row,$field)
84 * 2788: function getSpecConfFromString($extraString, $defaultExtras)
85 * 3007: function loadPaletteElements($table, $row, $palette, $itemList='')
87 * SECTION: Display of localized content etc.
88 * 2816: function registerDefaultLanguageData($table,$rec)
89 * 2848: function getLanguageOverlayRawValue($table, $row, $field, $fieldConf)
90 * 2876: function renderDefaultLanguageContent($table,$field,$row,$item)
91 * 2899: function renderDefaultLanguageDiff($table,$field,$row,$item)
93 * SECTION: Form element helper functions
94 * 2955: function dbFileIcons($fName,$mode,$allowed,$itemArray,$selector='',$params=array(),$onFocus='')
95 * 3108: function getClipboardElements($allowed,$mode)
96 * 3157: function getClickMenu($str,$table,$uid='')
97 * 3178: function renderWizards($itemKinds,$wizConf,$table,$row,$field,&$PA,$itemName,$specConf,$RTE=0)
98 * 3382: function getIcon($icon)
99 * 3409: function optionTagStyle($iconString)
100 * 3425: function extractValuesOnlyFromValueLabelList($itemFormElValue)
101 * 3447: function wrapOpenPalette($header,$table,$row,$palette,$retFunc=0)
102 * 3471: function checkBoxParams($itemName,$thisValue,$c,$iCount,$addFunc='')
103 * 3485: function elName($itemName)
104 * 3496: function noTitle($str,$wrapParts=array())
105 * 3505: function blur()
106 * 3514: function thisReturnUrl()
107 * 3527: function getSingleHiddenField($table,$field,$row)
108 * 3549: function formWidth($size=48,$textarea=0)
109 * 3576: function formWidthText($size=48,$wrap='')
110 * 3592: function formElStyle($type)
111 * 3603: function formElClass($type)
112 * 3614: function formElStyleClassValue($type, $class=FALSE)
113 * 3638: function insertDefStyle($type)
114 * 3657: function getDynTabMenu($parts, $idString)
116 * SECTION: Item-array manipulation functions (check/select/radio)
117 * 3696: function initItemArray($fieldValue)
118 * 3714: function addItems($items,$iArray)
119 * 3736: function procItems($items,$iArray,$config,$table,$row,$field)
120 * 3760: function addSelectOptionsToItemArray($items,$fieldValue,$TSconfig,$field)
121 * 3980: function addSelectOptionsToItemArray_makeModuleData($value)
122 * 4002: function foreignTable($items,$fieldValue,$TSconfig,$field,$pFFlag=0)
124 * SECTION: Template functions
125 * 4083: function setNewBEDesign()
126 * 4138: function intoTemplate($inArr,$altTemplate='')
127 * 4162: function addUserTemplateMarkers($marker,$table,$field,$row,&$PA)
128 * 4173: function wrapLabels($str)
129 * 4186: function wrapTotal($c,$rec,$table)
130 * 4199: function replaceTableWrap($arr,$rec,$table)
131 * 4236: function wrapBorder(&$out_array,&$out_pointer)
132 * 4258: function rplColorScheme($inTemplate)
133 * 4278: function getDivider()
134 * 4288: function printPalette($palArr)
135 * 4339: function helpTextIcon($table,$field,$force=0)
136 * 4359: function helpText($table,$field)
137 * 4380: function setColorScheme($scheme)
138 * 4404: function resetSchemes()
139 * 4415: function storeSchemes()
140 * 4427: function restoreSchemes()
142 * SECTION: JavaScript related functions
143 * 4457: function JStop()
144 * 4508: function JSbottom($formname='forms[0]')
145 * 4835: function dbFileCon($formObj='document.forms[0]')
146 * 5053: function printNeededJSFunctions()
147 * 5080: function printNeededJSFunctions_top()
149 * SECTION: Various helper functions
150 * 5128: function getDefaultRecord($table,$pid=0)
151 * 5167: function getRecordPath($table,$rec)
152 * 5181: function readPerms()
153 * 5195: function sL($str)
154 * 5208: function getLL($str)
155 * 5229: function isPalettesCollapsed($table,$palette)
156 * 5245: function isDisplayCondition($displayCond,$row,$ffValueKey='')
157 * 5349: function getTSCpid($table,$uid,$pid)
158 * 5363: function doLoadTableDescr($table)
159 * 5375: function getAvailableLanguages($onlyIsoCoded=1,$setDefault=1)
162 * 5417: class t3lib_TCEforms_FE extends t3lib_TCEforms
163 * 5425: function wrapLabels($str)
164 * 5435: function printPalette($palArr)
165 * 5460: function setFancyDesign()
167 * TOTAL FUNCTIONS: 100
168 * (This index is automatically created/updated by the extension "extdeveval")
184 require_once(PATH_t3lib
.'class.t3lib_diff.php');
185 require_once(PATH_t3lib
.'class.t3lib_tceforms_inline.php');
188 * Frontend version of TCEForms has been moved into its own file and should
189 * be included directly by calling scripts.
191 require_once(PATH_t3lib
. 'class.t3lib_tceforms_fe.php');
195 * 'TCEforms' - Class for creating the backend editing forms.
197 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
198 * @coauthor Rene Fritz <r.fritz@colorcube.de>
202 class t3lib_TCEforms
{
204 // variables not commented yet.... (do so...)
205 var $palFieldArr = array();
206 var $disableWizards = 0;
207 var $isPalettedoc = 0;
208 var $paletteMargin = 1;
209 var $defStyle = ''; // 'font-family:Verdana;font-size:10px;';
210 var $cachedTSconfig = array();
211 var $cachedTSconfig_fieldLevel = array();
212 var $cachedLanguageFlag = array();
213 var $cachedAdditionalPreviewLanguages = NULL;
214 var $transformedRow = array();
216 var $printNeededJS = array();
217 var $hiddenFieldAccum=array();
218 var $TBE_EDITOR_fieldChanged_func='';
220 var $prevBorderStyle='[nothing here...]'; // Something unique...
221 var $allowUpload=0; // If set direct upload fields will be shown
222 var $titleLen=15; // @deprecated since TYPO3 4.1: $BE_USER->uc['titleLen'] but what is default??
223 var $defaultLanguageData = array(); // Array where records in the default language is stored. (processed by transferdata)
224 var $defaultLanguageData_diff = array(); // Array where records in the default language is stored (raw without any processing. used for making diff)
225 var $additionalPreviewLanguageData = array();
229 var $backPath=''; // Set this to the 'backPath' pointing back to the typo3 admin directory from the script where this form is displayed.
230 var $returnUrl=''; // Alternative return URL path (default is t3lib_div::linkThisScript())
231 var $doSaveFieldName=''; // Can be set to point to a field name in the form which will be set to '1' when the form is submitted with a *save* button. This way the recipient script can determine that the form was submitted for save and not "close" for example.
232 var $palettesCollapsed=0; // Can be set true/false to whether palettes (secondary options) are in the topframe or in form. True means they are NOT IN-form. So a collapsed palette is one, which is shown in the top frame, not in the page.
233 var $disableRTE=0; // If set, the RTE is disabled (from form display, eg. by checkbox in the bottom of the page!)
234 var $globalShowHelp=1; // If false, then all CSH will be disabled, regardless of settings in $this->edit_showFieldHelp
235 var $localizationMode=''; // If true, the forms are rendering only localization relevant fields of the records.
236 var $fieldOrder=''; // Overrule the field order set in TCA[types][showitem], eg for tt_content this value, 'bodytext,image', would make first the 'bodytext' field, then the 'image' field (if set for display)... and then the rest in the old order.
237 var $doPrintPalette=1; // If set to false, palettes will NEVER be rendered.
240 * Set to initialized clipboard object; Then the element browser will offer a link to paste in records from clipboard.
242 * @var t3lib_clipboard
245 var $enableClickMenu=FALSE; // Enable click menu on reference icons.
246 var $enableTabMenu = FALSE; // Enable Tab Menus. If set to true, the JavaScript content from template::getDynTabMenuJScode() must be included in the document.
247 var $renderReadonly = FALSE; // When enabled all fields are rendered non-editable.
249 var $form_rowsToStylewidth = 9.58; // Form field width compensation: Factor from NN4 form field widths to style-aware browsers (like NN6+ and MSIE, with the $CLIENT[FORMSTYLE] value set)
250 var $form_largeComp = 1.33; // Form field width compensation: Compensation for large documents, doc-tab (editing)
251 var $charsPerRow=40; // The number of chars expected per row when the height of a text area field is automatically calculated based on the number of characters found in the field content.
252 var $maxTextareaWidth=48; // The maximum abstract value for textareas
253 var $maxInputWidth=48; // The maximum abstract value for input fields
254 var $defaultMultipleSelectorStyle='width:250px;'; // Default style for the selector boxes used for multiple items in "select" and "group" types.
258 var $prependFormFieldNames = 'data'; // The string to prepend formfield names with.
259 var $prependCmdFieldNames = 'cmd'; // The string to prepend commands for tcemain::process_cmdmap with.
260 var $prependFormFieldNames_file = 'data_files'; // The string to prepend FILE form field names with.
261 var $formName = 'editform'; // The name attribute of the form.
262 var $allowOverrideMatrix = array(); // Whitelist that allows TCA field configuration to be overridden by TSconfig, @see overrideFieldConf()
267 var $perms_clause=''; // Set by readPerms() (caching)
268 var $perms_clause_set=0; // Set by readPerms() (caching-flag)
269 var $edit_showFieldHelp=''; // Used to indicate the mode of CSH (Context Sensitive Help), whether it should be icons-only ('icon'), full description ('text') or not at all (blank).
270 var $docLarge=0; // If set, the forms will be rendered a little wider, more precisely with a factor of $this->form_largeComp.
271 var $clientInfo=array(); // Loaded with info about the browser when class is instantiated.
272 var $RTEenabled=0; // True, if RTE is possible for the current user (based on result from BE_USER->isRTE())
273 var $RTEenabled_notReasons=''; // If $this->RTEenabled was false, you can find the reasons listed in this array which is filled with reasons why the RTE could not be loaded)
274 var $RTEcounter = 0; // Counter that is incremented before an RTE is created. Can be used for unique ids etc.
276 var $colorScheme; // Contains current color scheme
277 var $classScheme; // Contains current class scheme
278 var $defColorScheme; // Contains the default color scheme
279 var $defClassScheme; // Contains the default class scheme
280 var $fieldStyle; // Contains field style values
281 var $borderStyle; // Contains border style values.
283 var $commentMessages=array(); // An accumulation of messages from the class.
285 // INTERNAL, templates
286 var $totalWrap='<hr />|<hr />'; // Total wrapping for the table rows.
287 var $fieldTemplate='<b>###FIELD_NAME###</b><br />###FIELD_ITEM###<hr />'; // Field template
288 var $sectionWrap=''; // Wrapping template code for a section
289 var $palFieldTemplateHeader=''; // Template for palette headers
290 var $palFieldTemplate=''; // Template for palettes
292 // INTERNAL, working memory
293 var $excludeElements=''; // Set to the fields NOT to display, if any.
294 var $palettesRendered=array(); // During rendering of forms this will keep track of which palettes has already been rendered (so they are not rendered twice by mistake)
295 var $hiddenFieldListArr = array(); // This array of fields will be set as hidden-fields instead of rendered normally! For instance palette fields edited in the top frame are set as hidden fields since the main form has to submit the values. The top frame actually just sets the value in the main form!
296 var $requiredFields=array(); // Used to register input-field names, which are required. (Done during rendering of the fields). This information is then used later when the JavaScript is made.
297 var $requiredAdditional=array(); // Used to register input-field names, which are required an have additional requirements (e.g. like a date/time must be positive integer). The information of this array is merged with $this->requiredFields later.
298 var $requiredElements=array(); // Used to register the min and max number of elements for selectorboxes where that apply (in the "group" type for instance)
299 var $requiredNested=array(); // Used to determine where $requiredFields or $requiredElements are nested (in Tabs or IRRE)
300 var $renderDepth=0; // Keeps track of the rendering depth of nested records.
301 var $savedSchemes=array(); // Color scheme buffer.
302 var $dynNestedStack = array(); // holds the path an element is nested in (e.g. required for RTEhtmlarea)
304 // Internal, registers for user defined functions etc.
305 var $additionalCode_pre = array(); // Additional HTML code, printed before the form.
306 var $additionalJS_pre = array(); // Additional JavaScript, printed before the form
307 var $additionalJS_post = array(); // Additional JavaScript printed after the form
308 var $additionalJS_submit = array(); // Additional JavaScript executed on submit; If you set "OK" variable it will raise an error about RTEs not being loaded and offer to block further submission.
309 var $additionalJS_delete = array(); // Additional JavaScript executed when section element is deleted. This is neceessary, for example, to correctly clean up HTMLArea RTE (bug #8232)
312 * Instance of t3lib_tceforms_inline
314 * @var t3lib_TCEforms_inline
317 var $hookObjectsMainFields = array(); // Array containing hook class instances called once for a form
318 var $hookObjectsSingleField = array(); // Array containing hook class instances called for each field
319 var $extraFormHeaders = array(); // Rows gettings inserted into the alt_doc headers (when called from alt_doc.php)
326 * Constructor function, setting internal variables, loading the styles used.
330 function t3lib_TCEforms() {
331 global $CLIENT, $TYPO3_CONF_VARS;
333 $this->clientInfo
= t3lib_div
::clientInfo();
335 $this->RTEenabled
= $GLOBALS['BE_USER']->isRTE();
336 if (!$this->RTEenabled
) {
337 $this->RTEenabled_notReasons
= implode(chr(10),$GLOBALS['BE_USER']->RTE_errors
);
338 $this->commentMessages
[] = 'RTE NOT ENABLED IN SYSTEM due to:'.chr(10).$this->RTEenabled_notReasons
;
341 // Default color+class scheme
342 $this->defColorScheme
= array(
343 $GLOBALS['SOBE']->doc
->bgColor
, // Background for the field AND palette
344 t3lib_div
::modifyHTMLColorAll($GLOBALS['SOBE']->doc
->bgColor
,-20), // Background for the field header
345 t3lib_div
::modifyHTMLColorAll($GLOBALS['SOBE']->doc
->bgColor
,-10), // Background for the palette field header
346 'black', // Field header font color
347 '#666666' // Palette field header font color
349 $this->defColorScheme
= array();
351 // Override / Setting defaults from TBE_STYLES array
352 $this->resetSchemes();
354 // Setting the current colorScheme to default.
355 $this->defColorScheme
= $this->colorScheme
;
356 $this->defClassScheme
= $this->classScheme
;
358 // Define whitelist that allows TCA field configuration to be overridden by TSconfig, @see overrideFieldConf():
359 $this->allowOverrideMatrix
= array(
360 'input' => array('size', 'max'),
361 'text' => array('cols', 'rows', 'wrap'),
362 'check' => array('cols', 'showIfRTE'),
363 'select' => array('size', 'autoSizeMax', 'maxitems', 'minitems'),
364 'group' => array('size', 'autoSizeMax', 'max_size', 'show_thumbs', 'maxitems', 'minitems', 'disable_controls'),
365 'inline' => array('appearance', 'behaviour', 'foreign_label', 'foreign_selector', 'foreign_unique', 'maxitems', 'minitems', 'size', 'autoSizeMax', 'symmetric_label'),
368 // Create instance of t3lib_TCEforms_inline only if this a non-IRRE-AJAX call:
369 if (!isset($GLOBALS['ajaxID']) ||
strpos($GLOBALS['ajaxID'], 't3lib_TCEforms_inline::')!==0) {
370 $this->inline
= t3lib_div
::makeInstance('t3lib_TCEforms_inline');
373 // Prepare user defined objects (if any) for hooks which extend this function:
374 $this->hookObjectsMainFields
= array();
375 if (is_array ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tceforms.php']['getMainFieldsClass'])) {
376 foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tceforms.php']['getMainFieldsClass'] as $classRef) {
377 $this->hookObjectsMainFields
[] = &t3lib_div
::getUserObj($classRef);
380 $this->hookObjectsSingleField
= array();
381 if (is_array ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tceforms.php']['getSingleFieldClass'])) {
382 foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tceforms.php']['getSingleFieldClass'] as $classRef) {
383 $this->hookObjectsSingleField
[] = &t3lib_div
::getUserObj($classRef);
390 * Initialize various internal variables.
394 function initDefaultBEmode() {
396 $this->prependFormFieldNames
= 'data';
397 $this->formName
= 'editform';
398 $this->setNewBEDesign();
399 $this->docLarge
= $BE_USER->uc
['edit_wideDocument'] ?
1 : 0;
400 $this->edit_showFieldHelp
= $BE_USER->uc
['edit_showFieldHelp'];
402 $this->edit_docModuleUpload
= $BE_USER->uc
['edit_docModuleUpload'];
403 $this->titleLen
= $BE_USER->uc
['titleLen']; // @deprecated since TYPO3 4.1
405 $this->inline
->init($this);
424 /*******************************************************
426 * Rendering the forms, fields etc
428 *******************************************************/
431 * Will return the TCEform element for just a single field from a record.
432 * The field must be listed in the currently displayed fields (as found in [types][showitem]) for the record.
433 * This also means that the $table/$row supplied must be complete so the list of fields to show can be found correctly
435 * @param string The table name
436 * @param array The record from the table for which to render a field.
437 * @param string The field name to return the TCEform element for.
438 * @return string HTML output
439 * @see getMainFields()
441 function getSoloField($table,$row,$theFieldToReturn) {
445 t3lib_div
::loadTCA($table);
446 $typeNum = $this->getRTypeNum($table,$row);
447 if ($TCA[$table]['types'][$typeNum]) {
448 $itemList = $TCA[$table]['types'][$typeNum]['showitem'];
450 $fields = t3lib_div
::trimExplode(',',$itemList,1);
451 $excludeElements = $this->excludeElements
= $this->getExcludeElements($table,$row,$typeNum);
454 while(list(,$fieldInfo)=each($fields)) {
455 $parts = explode(';',$fieldInfo);
457 $theField = trim($parts[0]);
458 if (!in_array($theField,$excludeElements) && !strcmp($theField,$theFieldToReturn)) {
459 if ($TCA[$table]['columns'][$theField]) {
460 $sField = $this->getSingleField($table,$theField,$row,$parts[1],1,$parts[3],$parts[2]);
461 return $sField['ITEM'];
471 * Based on the $table and $row of content, this displays the complete TCEform for the record.
472 * The input-$row is required to be preprocessed if necessary by eg. the t3lib_transferdata class. For instance the RTE content should be transformed through this class first.
474 * @param string The table name
475 * @param array The record from the table for which to render a field.
476 * @param integer Depth level
477 * @return string HTML output
478 * @see getSoloField()
480 function getMainFields($table,$row,$depth=0) {
481 global $TCA, $TYPO3_CONF_VARS;
483 $this->renderDepth
=$depth;
486 $out_array = array(array());
487 $out_array_meta = array(array(
488 'title' => $this->getLL('l_generalTab')
493 $this->palettesRendered
=array();
494 $this->palettesRendered
[$this->renderDepth
][$table]=array();
496 // Hook: getMainFields_preProcess (requested by Thomas Hempel for use with the "dynaflex" extension)
497 foreach ($this->hookObjectsMainFields
as $hookObj) {
498 if (method_exists($hookObj,'getMainFields_preProcess')) {
499 $hookObj->getMainFields_preProcess($table,$row,$this);
505 // Load the full TCA for the table.
506 t3lib_div
::loadTCA($table);
508 // Get dividers2tabs setting from TCA of the current table:
509 $dividers2tabs =& $TCA[$table]['ctrl']['dividers2tabs'];
511 // Load the description content for the table.
512 if ($this->edit_showFieldHelp ||
$this->doLoadTableDescr($table)) {
513 $GLOBALS['LANG']->loadSingleTableDescription($table);
515 // Get the current "type" value for the record.
516 $typeNum = $this->getRTypeNum($table,$row);
518 // Find the list of fields to display:
519 if ($TCA[$table]['types'][$typeNum]) {
520 $itemList = $TCA[$table]['types'][$typeNum]['showitem'];
521 if ($itemList) { // If such a list existed...
522 // Explode the field list and possibly rearrange the order of the fields, if configured for
523 $fields = t3lib_div
::trimExplode(',',$itemList,1);
524 if ($this->fieldOrder
) {
525 $fields = $this->rearrange($fields);
528 // Get excluded fields, added fiels and put it together:
529 $excludeElements = $this->excludeElements
= $this->getExcludeElements($table,$row,$typeNum);
530 $fields = $this->mergeFieldsWithAddedFields($fields,$this->getFieldsToAdd($table,$row,$typeNum));
532 // If TCEforms will render a tab menu in the next step, push the name to the tab stack:
533 $tabIdentString = '';
534 $tabIdentStringMD5 = '';
535 if (strstr($itemList, '--div--') !== false && $this->enableTabMenu
&& $dividers2tabs) {
536 $tabIdentString = 'TCEforms:'.$table.':'.$row['uid'];
537 $tabIdentStringMD5 = $GLOBALS['TBE_TEMPLATE']->getDynTabMenuId($tabIdentString);
538 // Remember that were currently working on the general tab:
539 if (isset($fields[0]) && strpos($fields[0], '--div--') !== 0) {
540 $this->pushToDynNestedStack('tab', $tabIdentStringMD5.'-1');
544 // Traverse the fields to render:
546 foreach($fields as $fieldInfo) {
547 // Exploding subparts of the field configuration:
548 $parts = explode(';',$fieldInfo);
550 // Getting the style information out:
551 $color_style_parts = t3lib_div
::trimExplode('-',$parts[4]);
552 if (strcmp($color_style_parts[0],'')) {
553 $this->setColorScheme($GLOBALS['TBE_STYLES']['colorschemes'][intval($color_style_parts[0])]);
555 if (strcmp($color_style_parts[1],'')) {
556 $this->fieldStyle
= $GLOBALS['TBE_STYLES']['styleschemes'][intval($color_style_parts[1])];
557 if (!isset($this->fieldStyle
)) $this->fieldStyle
= $GLOBALS['TBE_STYLES']['styleschemes'][0];
559 if (strcmp($color_style_parts[2],'')) {
560 $this->wrapBorder($out_array[$out_sheet],$out_pointer);
561 $this->borderStyle
= $GLOBALS['TBE_STYLES']['borderschemes'][intval($color_style_parts[2])];
562 if (!isset($this->borderStyle
)) $this->borderStyle
= $GLOBALS['TBE_STYLES']['borderschemes'][0];
566 $theField = $parts[0];
567 if (!in_array($theField,$excludeElements)) {
568 if ($TCA[$table]['columns'][$theField]) {
571 if ($parts[2] && !isset($this->palettesRendered
[$this->renderDepth
][$table][$parts[2]])) {
572 $sFieldPal=$this->getPaletteFields($table,$row,$parts[2]);
573 $this->palettesRendered
[$this->renderDepth
][$table][$parts[2]] = 1;
575 $sField = $this->getSingleField($table,$theField,$row,$parts[1],0,$parts[3],$parts[2]);
576 if ($sField) { $sField.= $sFieldPal; }
578 $out_array[$out_sheet][$out_pointer].= $sField;
579 } elseif ($theField=='--div--') {
581 $out_array[$out_sheet][$out_pointer].=$this->getDivider();
583 if ($this->enableTabMenu
&& $dividers2tabs) {
584 $this->wrapBorder($out_array[$out_sheet],$out_pointer);
585 // Remove last tab entry from the dynNestedStack:
587 // Remove the previous sheet from stack (if any):
588 $this->popFromDynNestedStack('tab', $tabIdentStringMD5.'-'.($out_sheet));
589 // Remember on which sheet we're currently working:
590 $this->pushToDynNestedStack('tab', $tabIdentStringMD5.'-'.($out_sheet+
1));
591 $out_array[$out_sheet] = array();
592 $out_array_meta[$out_sheet]['title'] = $this->sL($parts[1]);
593 // Register newline for Tab
594 $out_array_meta[$out_sheet]['newline'] = ($parts[2] == "newline");
596 } else { // Setting alternative title for "General" tab if "--div--" is the very first element.
597 $out_array_meta[$out_sheet]['title'] = $this->sL($parts[1]);
598 // Only add the first tab to the dynNestedStack if there are more tabs:
599 if ($tabIdentString && strpos($itemList, '--div--', strlen($fieldInfo))) {
600 $this->pushToDynNestedStack('tab', $tabIdentStringMD5.'-1');
603 } elseif($theField=='--palette--') {
604 if ($parts[2] && !isset($this->palettesRendered
[$this->renderDepth
][$table][$parts[2]])) {
605 // render a 'header' if not collapsed
606 if ($TCA[$table]['palettes'][$parts[2]]['canNotCollapse'] AND $parts[1]) {
607 $out_array[$out_sheet][$out_pointer].=$this->getPaletteFields($table,$row,$parts[2],$this->sL($parts[1]));
609 $out_array[$out_sheet][$out_pointer].=$this->getPaletteFields($table,$row,$parts[2],'','',$this->sL($parts[1]));
611 $this->palettesRendered
[$this->renderDepth
][$table][$parts[2]] = 1;
622 // Hook: getMainFields_postProcess (requested by Thomas Hempel for use with the "dynaflex" extension)
623 foreach ($this->hookObjectsMainFields
as $hookObj) {
624 if (method_exists($hookObj,'getMainFields_postProcess')) {
625 $hookObj->getMainFields_postProcess($table,$row,$this);
629 // Wrapping a border around it all:
630 $this->wrapBorder($out_array[$out_sheet],$out_pointer);
633 $this->resetSchemes();
635 // Rendering Main palettes, if any
636 $mParr = t3lib_div
::trimExplode(',',$TCA[$table]['ctrl']['mainpalette']);
639 foreach ($mParr as $mP) {
640 if (!isset($this->palettesRendered
[$this->renderDepth
][$table][$mP])) {
641 $temp_palettesCollapsed=$this->palettesCollapsed
;
642 $this->palettesCollapsed
=0;
643 $label = ($i==0?
$this->getLL('l_generalOptions'):$this->getLL('l_generalOptions_more'));
644 $out_array[$out_sheet][$out_pointer].=$this->getPaletteFields($table,$row,$mP,$label);
645 $this->palettesCollapsed
=$temp_palettesCollapsed;
646 $this->palettesRendered
[$this->renderDepth
][$table][$mP] = 1;
648 $this->wrapBorder($out_array[$out_sheet],$out_pointer);
650 if ($this->renderDepth
) {
651 $this->renderDepth
--;
656 // Return the imploded $out_array:
657 if ($out_sheet>0) { // There were --div-- dividers around...
659 // Create parts array for the tab menu:
661 foreach ($out_array as $idx => $sheetContent) {
662 $content = implode('', $sheetContent);
664 // Wrap content (row) with table-tag, otherwise tab/sheet will be disabled (see getdynTabMenu() )
665 $content = '<table border="0" cellspacing="0" cellpadding="0" width="100%">'.$content.'</table>';
667 $parts[$idx] = array(
668 'label' => $out_array_meta[$idx]['title'],
669 'content' => $content,
670 'newline' => $out_array_meta[$idx]['newline'], // Newline for this tab/sheet
674 if (count($parts) > 1) {
675 // Unset the current level of tab menus:
676 $this->popFromDynNestedStack('tab', $tabIdentStringMD5.'-'.($out_sheet+
1));
677 $dividersToTabsBehaviour = (isset($TCA[$table]['ctrl']['dividers2tabs']) ?
$TCA[$table]['ctrl']['dividers2tabs'] : 1);
678 $output = $this->getDynTabMenu($parts, $tabIdentString, $dividersToTabsBehaviour);
681 // If there is only one tab/part there is no need to wrap it into the dynTab code
682 $output = isset($parts[0]) ?
trim($parts[0]['content']) : '';
693 // Only one, so just implode:
694 $output = implode('',$out_array[$out_sheet]);
701 * Will return the TCEform elements for a pre-defined list of fields.
702 * Notice that this will STILL use the configuration found in the list [types][showitem] for those fields which are found there. So ideally the list of fields given as argument to this function should also be in the current [types][showitem] list of the record.
703 * Used for displaying forms for the frontend edit icons for instance.
705 * @param string The table name
706 * @param array The record array.
707 * @param string Commalist of fields from the table. These will be shown in the specified order in a form.
708 * @return string TCEform elements in a string.
710 function getListedFields($table,$row,$list) {
713 t3lib_div
::loadTCA($table);
714 if ($this->edit_showFieldHelp ||
$this->doLoadTableDescr($table)) {
715 $GLOBALS['LANG']->loadSingleTableDescription($table);
719 $types_fieldConfig = t3lib_BEfunc
::getTCAtypes($table,$row,1);
721 $editFieldList=array_unique(t3lib_div
::trimExplode(',',$list,1));
722 foreach($editFieldList as $theFieldC) {
723 list($theField,$palFields) = preg_split('/\[|\]/', $theFieldC);
724 $theField = trim($theField);
725 $palFields = trim($palFields);
726 if ($TCA[$table]['columns'][$theField]) {
727 $parts = t3lib_div
::trimExplode(';',$types_fieldConfig[$theField]['origString']);
728 $sField = $this->getSingleField($table,$theField,$row,$parts[1],0,$parts[3],0); // Don't sent palette pointer - there are no options anyways for a field-list.
730 } elseif($theField=='--div--') {
731 $out.= $this->getDivider();
734 $out.= $this->getPaletteFields($table,$row,'','',implode(',',t3lib_div
::trimExplode('|',$palFields,1)));
742 * Creates a palette (collection of secondary options).
744 * @param string The table name
745 * @param array The row array
746 * @param string The palette number/pointer
747 * @param string Header string for the palette (used when in-form). If not set, no header item is made.
748 * @param string Optional alternative list of fields for the palette
749 * @param string Optional Link text for activating a palette (when palettes does not have another form element to belong to).
750 * @return string HTML code.
752 function getPaletteFields($table,$row,$palette,$header='',$itemList='',$collapsedHeader=NULL) {
753 if (!$this->doPrintPalette
) {
758 $parts = $this->loadPaletteElements($table, $row, $palette, $itemList);
760 // Put palette together if there are fields in it:
763 $out .= $this->intoTemplate(
764 array('HEADER' => htmlspecialchars($header)),
765 $this->palFieldTemplateHeader
769 $collapsed = $this->isPalettesCollapsed($table,$palette);
772 if ($collapsed && $collapsedHeader !== NULL) {
773 list($thePalIcon,) = $this->wrapOpenPalette('<img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/options.gif','width="18" height="16"').' border="0" title="'.htmlspecialchars($this->getLL('l_moreOptions')).'" alt="" />',$table,$row,$palette,1);
774 $thePalIcon = '<span style="margin-left: 20px;">' . $thePalIcon . $collapsedHeader . '</span>';
777 $paletteHtml = $this->wrapPaletteField($this->printPalette($parts), $table, $row ,$palette, $collapsed);
779 $out .= $this->intoTemplate(
780 array('PALETTE' => $thePalIcon . $paletteHtml),
781 $this->palFieldTemplate
788 * Returns the form HTML code for a database table field.
790 * @param string The table name
791 * @param string The field name
792 * @param array The record to edit from the database table.
793 * @param string Alternative field name label to show.
794 * @param boolean Set this if the field is on a palette (in top frame), otherwise not. (if set, field will render as a hidden field).
795 * @param string The "extra" options from "Part 4" of the field configurations found in the "types" "showitem" list. Typically parsed by $this->getSpecConfFromString() in order to get the options as an associative array.
796 * @param integer The palette pointer.
797 * @return mixed String (normal) or array (palettes)
799 function getSingleField($table,$field,$row,$altName='',$palette=0,$extra='',$pal=0) {
800 global $TCA,$BE_USER;
802 // Hook: getSingleField_preProcess
803 foreach ($this->hookObjectsSingleField
as $hookObj) {
804 if (method_exists($hookObj,'getSingleField_preProcess')) {
805 $hookObj->getSingleField_preProcess($table, $field, $row, $altName, $palette, $extra, $pal, $this);
811 $PA['altName'] = $altName;
812 $PA['palette'] = $palette;
813 $PA['extra'] = $extra;
816 // Make sure to load full $TCA array for the table:
817 t3lib_div
::loadTCA($table);
819 // Get the TCA configuration for the current field:
820 $PA['fieldConf'] = $TCA[$table]['columns'][$field];
821 $PA['fieldConf']['config']['form_type'] = $PA['fieldConf']['config']['form_type'] ?
$PA['fieldConf']['config']['form_type'] : $PA['fieldConf']['config']['type']; // Using "form_type" locally in this script
823 $skipThisField = $this->inline
->skipField($table, $field, $row, $PA['fieldConf']['config']);
825 // Now, check if this field is configured and editable (according to excludefields + other configuration)
826 if ( is_array($PA['fieldConf']) &&
828 (!$PA['fieldConf']['exclude'] ||
$BE_USER->check('non_exclude_fields',$table.':'.$field)) &&
829 $PA['fieldConf']['config']['form_type']!='passthrough' &&
830 ($this->RTEenabled ||
!$PA['fieldConf']['config']['showIfRTE']) &&
831 (!$PA['fieldConf']['displayCond'] ||
$this->isDisplayCondition($PA['fieldConf']['displayCond'],$row)) &&
832 (!$TCA[$table]['ctrl']['languageField'] ||
$PA['fieldConf']['l10n_display'] ||
strcmp($PA['fieldConf']['l10n_mode'],'exclude') ||
$row[$TCA[$table]['ctrl']['languageField']]<=0) &&
833 (!$TCA[$table]['ctrl']['languageField'] ||
!$this->localizationMode ||
$this->localizationMode
===$PA['fieldConf']['l10n_cat'])
838 // Fetching the TSconfig for the current table/field. This includes the $row which means that
839 $PA['fieldTSConfig'] = $this->setTSconfig($table,$row,$field);
841 // If the field is NOT disabled from TSconfig (which it could have been) then render it
842 if (!$PA['fieldTSConfig']['disabled']) {
843 // Override fieldConf by fieldTSconfig:
844 $PA['fieldConf']['config'] = $this->overrideFieldConf($PA['fieldConf']['config'], $PA['fieldTSConfig']);
847 $PA['itemFormElName']=$this->prependFormFieldNames
.'['.$table.']['.$row['uid'].']['.$field.']'; // Form field name
848 $PA['itemFormElName_file']=$this->prependFormFieldNames_file
.'['.$table.']['.$row['uid'].']['.$field.']'; // Form field name, in case of file uploads
849 $PA['itemFormElValue']=$row[$field]; // The value to show in the form field.
850 $PA['itemFormElID']=$this->prependFormFieldNames
.'_'.$table.'_'.$row['uid'].'_'.$field;
852 // set field to read-only if configured for translated records to show default language content as readonly
853 if ($PA['fieldConf']['l10n_display'] && t3lib_div
::inList($PA['fieldConf']['l10n_display'], 'defaultAsReadonly') && $row[$TCA[$table]['ctrl']['languageField']] > 0) {
854 $PA['fieldConf']['config']['readOnly'] = true;
855 $PA['itemFormElValue'] = $this->defaultLanguageData
[$table.':'.$row['uid']][$field];
858 // Create a JavaScript code line which will ask the user to save/update the form due to changing the element. This is used for eg. "type" fields and others configured with "requestUpdate"
860 ($TCA[$table]['ctrl']['type'] && !strcmp($field,$TCA[$table]['ctrl']['type'])) ||
861 ($TCA[$table]['ctrl']['requestUpdate'] && t3lib_div
::inList($TCA[$table]['ctrl']['requestUpdate'],$field))) {
862 if($GLOBALS['BE_USER']->jsConfirmation(1)) {
863 $alertMsgOnChange = 'if (confirm(TBE_EDITOR.labels.onChangeAlert) && TBE_EDITOR.checkSubmit(-1)){ TBE_EDITOR.submitForm() };';
865 $alertMsgOnChange = 'if (TBE_EDITOR.checkSubmit(-1)){ TBE_EDITOR.submitForm() };';
868 $alertMsgOnChange = '';
871 // Render as a hidden field?
872 if (in_array($field,$this->hiddenFieldListArr
)) {
873 $this->hiddenFieldAccum
[]='<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />';
874 } else { // Render as a normal field:
876 // If the field is NOT a palette field, then we might create an icon which links to a palette for the field, if one exists.
877 if (!$PA['palette']) {
878 $paletteFields = $this->loadPaletteElements($table, $row, $PA['pal']);
879 if ($PA['pal'] && $this->isPalettesCollapsed($table,$PA['pal']) && count($paletteFields)) {
880 list($thePalIcon,$palJSfunc) = $this->wrapOpenPalette('<img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/options.gif','width="18" height="16"').' border="0" title="'.htmlspecialchars($this->getLL('l_moreOptions')).'" alt="" />',$table,$row,$PA['pal'],1);
886 // onFocus attribute to add to the field:
887 $PA['onFocus'] = ($palJSfunc && !$BE_USER->uc
['dontShowPalettesOnFocusInAB']) ?
' onfocus="'.htmlspecialchars($palJSfunc).'"' : '';
891 $PA['label'] = ($PA['altName'] ?
$PA['altName'] : $PA['fieldConf']['label']);
892 $PA['label'] = ($PA['fieldTSConfig']['label'] ?
$PA['fieldTSConfig']['label'] : $PA['label']);
893 $PA['label'] = ($PA['fieldTSConfig']['label.'][$GLOBALS['LANG']->lang
] ?
$PA['fieldTSConfig']['label.'][$GLOBALS['LANG']->lang
] : $PA['label']);
894 $PA['label'] = $this->sL($PA['label']);
895 // JavaScript code for event handlers:
896 $PA['fieldChangeFunc']=array();
897 $PA['fieldChangeFunc']['TBE_EDITOR_fieldChanged'] = "TBE_EDITOR.fieldChanged('".$table."','".$row['uid']."','".$field."','".$PA['itemFormElName']."');";
898 $PA['fieldChangeFunc']['alert']=$alertMsgOnChange;
899 // if this is the child of an inline type and it is the field creating the label
900 if ($this->inline
->isInlineChildAndLabelField($table, $field)) {
901 $PA['fieldChangeFunc']['inline'] = "inline.handleChangedField('".$PA['itemFormElName']."','".$this->inline
->inlineNames
['object']."[$table][".$row['uid']."]');";
904 // Based on the type of the item, call a render function:
905 $item = $this->getSingleField_SW($table,$field,$row,$PA);
907 // Add language + diff
908 if ($PA['fieldConf']['l10n_display'] && (t3lib_div
::inList($PA['fieldConf']['l10n_display'], 'hideDiff') || t3lib_div
::inList($PA['fieldConf']['l10n_display'], 'defaultAsReadonly'))) {
909 $renderLanguageDiff = false;
911 $renderLanguageDiff = true;
914 if ($renderLanguageDiff) {
915 $item = $this->renderDefaultLanguageContent($table,$field,$row,$item);
916 $item = $this->renderDefaultLanguageDiff($table,$field,$row,$item);
919 // If the record has been saved and the "linkTitleToSelf" is set, we make the field name into a link, which will load ONLY this field in alt_doc.php
920 $PA['label'] = t3lib_div
::deHSCentities(htmlspecialchars($PA['label']));
921 if (t3lib_div
::testInt($row['uid']) && $PA['fieldTSConfig']['linkTitleToSelf'] && !t3lib_div
::_GP('columnsOnly')) {
922 $lTTS_url = $this->backPath
.'alt_doc.php?edit['.$table.']['.$row['uid'].']=edit&columnsOnly='.$field.'&returnUrl='.rawurlencode($this->thisReturnUrl());
923 $PA['label'] = '<a href="'.htmlspecialchars($lTTS_url).'">'.$PA['label'].'</a>';
926 // Create output value:
927 if ($PA['fieldConf']['config']['form_type']=='user' && $PA['fieldConf']['config']['noTableWrapping']) {
929 } elseif ($PA['palette']) {
932 'NAME'=>$PA['label'],
937 'HELP_ICON' => $this->helpTextIcon($table,$field,1)
939 $out = $this->addUserTemplateMarkers($out,$table,$field,$row,$PA);
943 'NAME'=>$PA['label'],
947 'HELP_ICON'=>$this->helpTextIcon($table,$field),
948 'HELP_TEXT'=>$this->helpText($table,$field),
949 'PAL_LINK_ICON'=>$thePalIcon,
952 $out = $this->addUserTemplateMarkers($out,$table,$field,$row,$PA);
954 $out=$this->intoTemplate($out);
957 } else $this->commentMessages
[]=$this->prependFormFieldNames
.'['.$table.']['.$row['uid'].']['.$field.']: Disabled by TSconfig';
959 // Hook: getSingleField_postProcess
960 foreach ($this->hookObjectsSingleField
as $hookObj) {
961 if (method_exists($hookObj,'getSingleField_postProcess')) {
962 $hookObj->getSingleField_postProcess($table, $field, $row, $out, $PA, $this);
965 // Return value (string or array)
970 * Rendering a single item for the form
972 * @param string Table name of record
973 * @param string Fieldname to render
974 * @param array The record
975 * @param array parameters array containing a lot of stuff. Value by Reference!
976 * @return string Returns the item as HTML code to insert
978 * @see getSingleField(), getSingleField_typeFlex_draw()
980 function getSingleField_SW($table,$field,$row,&$PA) {
981 $PA['fieldConf']['config']['form_type'] = $PA['fieldConf']['config']['form_type'] ?
$PA['fieldConf']['config']['form_type'] : $PA['fieldConf']['config']['type']; // Using "form_type" locally in this script
983 // Hook: getSingleField_beforeRender
984 foreach ($this->hookObjectsSingleField
as $hookObject) {
985 if (method_exists($hookObject, 'getSingleField_beforeRender')) {
986 $hookObject->getSingleField_beforeRender($table, $field, $row, $PA);
990 switch($PA['fieldConf']['config']['form_type']) {
992 $item = $this->getSingleField_typeInput($table,$field,$row,$PA);
995 $item = $this->getSingleField_typeText($table,$field,$row,$PA);
998 $item = $this->getSingleField_typeCheck($table,$field,$row,$PA);
1001 $item = $this->getSingleField_typeRadio($table,$field,$row,$PA);
1004 $item = $this->getSingleField_typeSelect($table,$field,$row,$PA);
1007 $item = $this->getSingleField_typeGroup($table,$field,$row,$PA);
1010 $item = $this->inline
->getSingleField_typeInline($table,$field,$row,$PA);
1013 $item = $this->getSingleField_typeNone($table,$field,$row,$PA);
1016 $item = $this->getSingleField_typeUser($table,$field,$row,$PA);
1019 $item = $this->getSingleField_typeFlex($table,$field,$row,$PA);
1022 $item = $this->getSingleField_typeUnknown($table,$field,$row,$PA);
1047 /**********************************************************
1049 * Rendering of each TCEform field type
1051 ************************************************************/
1054 * Generation of TCEform elements of the type "input"
1055 * This will render a single-line input form field, possibly with various control/validation features
1057 * @param string The table name of the record
1058 * @param string The field name which this element is supposed to edit
1059 * @param array The record data array where the value(s) for the field can be found
1060 * @param array An array with additional configuration options.
1061 * @return string The HTML code for the TCEform field
1063 function getSingleField_typeInput($table,$field,$row,&$PA) {
1064 // typo3FormFieldSet(theField, evallist, is_in, checkbox, checkboxValue)
1065 // typo3FormFieldGet(theField, evallist, is_in, checkbox, checkboxValue, checkbox_off)
1067 $config = $PA['fieldConf']['config'];
1069 # $specConf = $this->getSpecConfForField($table,$row,$field);
1070 $specConf = $this->getSpecConfFromString($PA['extra'], $PA['fieldConf']['defaultExtras']);
1071 $size = t3lib_div
::intInRange($config['size']?
$config['size']:30,5,$this->maxInputWidth
);
1072 $evalList = t3lib_div
::trimExplode(',',$config['eval'],1);
1074 if($this->renderReadonly ||
$config['readOnly']) {
1075 $itemFormElValue = $PA['itemFormElValue'];
1076 if (in_array('date',$evalList)) {
1077 $config['format'] = 'date';
1078 } elseif (in_array('datetime',$evalList)) {
1079 $config['format'] = 'datetime';
1080 } elseif (in_array('time',$evalList)) {
1081 $config['format'] = 'time';
1083 if (in_array('password',$evalList)) {
1084 $itemFormElValue = $itemFormElValue ?
'*********' : '';
1086 return $this->getSingleField_typeNone_render($config, $itemFormElValue);
1089 foreach ($evalList as $func) {
1092 $this->registerRequiredProperty('field', $table.'_'.$row['uid'].'_'.$field, $PA['itemFormElName']);
1093 // Mark this field for date/time disposal:
1094 if (array_intersect($evalList, array('date', 'datetime', 'time'))) {
1095 $this->requiredAdditional
[$PA['itemFormElName']]['isPositiveNumber'] = true;
1099 if (substr($func, 0, 3) == 'tx_') {
1100 // Pair hook to the one in t3lib_TCEmain::checkValue_input_Eval()
1101 $evalObj = t3lib_div
::getUserObj($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tce']['formevals'][$func].':&'.$func);
1102 if (is_object($evalObj) && method_exists($evalObj, 'deevaluateFieldValue')) {
1104 'value' => $PA['itemFormElValue']
1106 $PA['itemFormElValue'] = $evalObj->deevaluateFieldValue($_params);
1113 $paramsList = "'".$PA['itemFormElName']."','".implode(',',$evalList)."','".trim($config['is_in'])."',".(isset($config['checkbox'])?
1:0).",'".$config['checkbox']."'";
1114 if (isset($config['checkbox'])) {
1115 // Setting default "click-checkbox" values for eval types "date" and "datetime":
1116 $thisMidnight = gmmktime(0,0,0);
1117 if (in_array('date',$evalList)) {
1118 $checkSetValue = $thisMidnight;
1119 } elseif (in_array('datetime',$evalList)) {
1120 $checkSetValue = time();
1121 } elseif (in_array('year',$evalList)) {
1122 $checkSetValue = gmdate('Y');
1124 $cOnClick = 'typo3form.fieldGet('.$paramsList.',1,\''.$checkSetValue.'\');'.implode('',$PA['fieldChangeFunc']);
1125 $item .= '<input type="checkbox" class="' . $this->formElStyleClassValue('check', TRUE) . ' alignToInputText" name="' . $PA['itemFormElName'] . '_cb" onclick="' . htmlspecialchars($cOnClick) . '" />';
1127 if ((in_array('date',$evalList) ||
in_array('datetime',$evalList)) && $PA['itemFormElValue']>0){
1128 // Add server timezone offset to UTC to our stored date
1129 $PA['itemFormElValue'] +
= date('Z', $PA['itemFormElValue']);
1132 $PA['fieldChangeFunc'] = array_merge(array('typo3form.fieldGet'=>'typo3form.fieldGet('.$paramsList.');'), $PA['fieldChangeFunc']);
1133 $mLgd = ($config['max']?
$config['max']:256);
1134 $iOnChange = implode('',$PA['fieldChangeFunc']);
1135 $item.='<input type="text" name="'.$PA['itemFormElName'].'_hr" value=""'.$this->formWidth($size).' maxlength="'.$mLgd.'" onchange="'.htmlspecialchars($iOnChange).'"'.$PA['onFocus'].' />'; // This is the EDITABLE form field.
1136 $item.='<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />'; // This is the ACTUAL form field - values from the EDITABLE field must be transferred to this field which is the one that is written to the database.
1137 $this->extJSCODE
.='typo3form.fieldSet('.$paramsList.');';
1139 // going through all custom evaluations configured for this field
1140 foreach ($evalList as $evalData) {
1141 if (substr($evalData, 0, 3) == 'tx_') {
1142 $evalObj = t3lib_div
::getUserObj($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tce']['formevals'][$evalData].':&'.$evalData);
1143 if(is_object($evalObj) && method_exists($evalObj, 'returnFieldJS')) {
1144 $this->extJSCODE
.= "\n\nfunction ".$evalData."(value) {\n".$evalObj->returnFieldJS()."\n}\n";
1149 // Creating an alternative item without the JavaScript handlers.
1150 $altItem = '<input type="hidden" name="'.$PA['itemFormElName'].'_hr" value="" />';
1151 $altItem.= '<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />';
1153 // Wrap a wizard around the item?
1154 $item= $this->renderWizards(array($item,$altItem),$config['wizards'],$table,$row,$field,$PA,$PA['itemFormElName'].'_hr',$specConf);
1160 * Generation of TCEform elements of the type "text"
1161 * This will render a <textarea> OR RTE area form field, possibly with various control/validation features
1163 * @param string The table name of the record
1164 * @param string The field name which this element is supposed to edit
1165 * @param array The record data array where the value(s) for the field can be found
1166 * @param array An array with additional configuration options.
1167 * @return string The HTML code for the TCEform field
1169 function getSingleField_typeText($table,$field,$row,&$PA) {
1172 $config = $PA['fieldConf']['config'];
1174 if($this->renderReadonly ||
$config['readOnly']) {
1175 return $this->getSingleField_typeNone_render($config, $PA['itemFormElValue']);
1178 // Setting columns number:
1179 $cols = t3lib_div
::intInRange($config['cols'] ?
$config['cols'] : 30, 5, $this->maxTextareaWidth
);
1181 // Setting number of rows:
1182 $origRows = $rows = t3lib_div
::intInRange($config['rows'] ?
$config['rows'] : 5, 1, 20);
1183 if (strlen($PA['itemFormElValue']) > $this->charsPerRow
*2) {
1184 $cols = $this->maxTextareaWidth
;
1185 $rows = t3lib_div
::intInRange(round(strlen($PA['itemFormElValue'])/$this->charsPerRow
), count(explode(chr(10),$PA['itemFormElValue'])), 20);
1186 if ($rows<$origRows) $rows = $origRows;
1190 $RTEwasLoaded = 0; // Set true, if the RTE is loaded; If not a normal textarea is shown.
1191 $RTEwouldHaveBeenLoaded = 0; // Set true, if the RTE would have been loaded if it wasn't for the disable-RTE flag in the bottom of the page...
1193 // "Extra" configuration; Returns configuration for the field based on settings found in the "types" fieldlist. Traditionally, this is where RTE configuration has been found.
1194 $specConf = $this->getSpecConfFromString($PA['extra'], $PA['fieldConf']['defaultExtras']);
1196 // Setting up the altItem form field, which is a hidden field containing the value
1197 $altItem = '<input type="hidden" name="'.htmlspecialchars($PA['itemFormElName']).'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />';
1199 // If RTE is generally enabled (TYPO3_CONF_VARS and user settings)
1200 if ($this->RTEenabled
) {
1201 $p = t3lib_BEfunc
::getSpecConfParametersFromArray($specConf['rte_transform']['parameters']);
1202 if (isset($specConf['richtext']) && (!$p['flag'] ||
!$row[$p['flag']])) { // If the field is configured for RTE and if any flag-field is not set to disable it.
1203 t3lib_BEfunc
::fixVersioningPid($table,$row);
1204 list($tscPID,$thePidValue) = $this->getTSCpid($table,$row['uid'],$row['pid']);
1206 // If the pid-value is not negative (that is, a pid could NOT be fetched)
1207 if ($thePidValue >= 0) {
1208 $RTEsetup = $GLOBALS['BE_USER']->getTSConfig('RTE',t3lib_BEfunc
::getPagesTSconfig($tscPID));
1209 $RTEtypeVal = t3lib_BEfunc
::getTCAtypeValue($table,$row);
1210 $thisConfig = t3lib_BEfunc
::RTEsetup($RTEsetup['properties'],$table,$field,$RTEtypeVal);
1212 if (!$thisConfig['disabled']) {
1213 if (!$this->disableRTE
) {
1214 $this->RTEcounter++
;
1216 // Find alternative relative path for RTE images/links:
1217 $eFile = t3lib_parsehtml_proc
::evalWriteFile($specConf['static_write'], $row);
1218 $RTErelPath = is_array($eFile) ?
dirname($eFile['relEditFile']) : '';
1220 // Get RTE object, draw form and set flag:
1221 $RTEobj = &t3lib_BEfunc
::RTEgetObj();
1222 $item = $RTEobj->drawRTE($this,$table,$field,$row,$PA,$specConf,$thisConfig,$RTEtypeVal,$RTErelPath,$thePidValue);
1225 $item = $this->renderWizards(array($item,$altItem),$config['wizards'],$table,$row,$field,$PA,$PA['itemFormElName'],$specConf,1);
1229 $RTEwouldHaveBeenLoaded = 1;
1230 $this->commentMessages
[] = $PA['itemFormElName'].': RTE is disabled by the on-page RTE-flag (probably you can enable it by the check-box in the bottom of this page!)';
1232 } else $this->commentMessages
[] = $PA['itemFormElName'].': RTE is disabled by the Page TSconfig, "RTE"-key (eg. by RTE.default.disabled=0 or such)';
1233 } else $this->commentMessages
[] = $PA['itemFormElName'].': PID value could NOT be fetched. Rare error, normally with new records.';
1235 if (!isset($specConf['richtext'])) $this->commentMessages
[] = $PA['itemFormElName'].': RTE was not configured for this field in TCA-types';
1236 if (!(!$p['flag'] ||
!$row[$p['flag']])) $this->commentMessages
[] = $PA['itemFormElName'].': Field-flag ('.$PA['flag'].') has been set to disable RTE!';
1240 // Display ordinary field if RTE was not loaded.
1241 if (!$RTEwasLoaded) {
1242 if ($specConf['rte_only']) { // Show message, if no RTE (field can only be edited with RTE!)
1243 $item = '<p><em>'.htmlspecialchars($this->getLL('l_noRTEfound')).'</em></p>';
1245 if ($specConf['nowrap']) {
1248 $wrap = ($config['wrap'] ?
$config['wrap'] : 'virtual');
1252 if ($specConf['fixed-font']) { $classes[] = 'fixed-font'; }
1253 if ($specConf['enable-tab']) { $classes[] = 'enable-tab'; }
1255 $formWidthText = $this->formWidthText($cols,$wrap);
1257 // Extract class attributes from $formWidthText (otherwise it would be added twice to the output)
1259 if (preg_match('/ class="(.+?)"/',$formWidthText,$res)) {
1260 $formWidthText = str_replace(' class="'.$res[1].'"','',$formWidthText);
1261 $classes = array_merge($classes, explode(' ',$res[1]));
1264 if (count($classes)) {
1265 $class = ' class="'.implode(' ',$classes).'"';
1268 $evalList = t3lib_div
::trimExplode(',',$config['eval'],1);
1269 foreach ($evalList as $func) {
1272 $this->registerRequiredProperty('field', $table.'_'.$row['uid'].'_'.$field, $PA['itemFormElName']);
1275 if (substr($func, 0, 3) == 'tx_') {
1276 // Pair hook to the one in t3lib_TCEmain::checkValue_input_Eval() and t3lib_TCEmain::checkValue_text_Eval()
1277 $evalObj = t3lib_div
::getUserObj($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tce']['formevals'][$func].':&'.$func);
1278 if (is_object($evalObj) && method_exists($evalObj, 'deevaluateFieldValue')) {
1280 'value' => $PA['itemFormElValue']
1282 $PA['itemFormElValue'] = $evalObj->deevaluateFieldValue($_params);
1289 $iOnChange = implode('',$PA['fieldChangeFunc']);
1291 <textarea name="'.$PA['itemFormElName'].'"'.$formWidthText.$class.' rows="'.$rows.'" wrap="'.$wrap.'" onchange="'.htmlspecialchars($iOnChange).'"'.$PA['onFocus'].'>'.
1292 t3lib_div
::formatForTextarea($PA['itemFormElValue']).
1294 $item = $this->renderWizards(array($item,$altItem),$config['wizards'],$table,$row,$field,$PA,$PA['itemFormElName'],$specConf,$RTEwouldHaveBeenLoaded);
1298 // Return field HTML:
1303 * Generation of TCEform elements of the type "check"
1304 * This will render a check-box OR an array of checkboxes
1306 * @param string The table name of the record
1307 * @param string The field name which this element is supposed to edit
1308 * @param array The record data array where the value(s) for the field can be found
1309 * @param array An array with additional configuration options.
1310 * @return string The HTML code for the TCEform field
1312 function getSingleField_typeCheck($table,$field,$row,&$PA) {
1313 $config = $PA['fieldConf']['config'];
1316 if($this->renderReadonly ||
$config['readOnly']) {
1317 $disabled = ' disabled="disabled"';
1320 // Traversing the array of items:
1321 $selItems = $this->initItemArray($PA['fieldConf']);
1322 if ($config['itemsProcFunc']) $selItems = $this->procItems($selItems,$PA['fieldTSConfig']['itemsProcFunc.'],$config,$table,$row,$field);
1324 if (!count($selItems)) {
1325 $selItems[]=array('','');
1327 $thisValue = intval($PA['itemFormElValue']);
1329 $cols = intval($config['cols']);
1331 $item.= '<table border="0" cellspacing="0" cellpadding="0" class="typo3-TCEforms-checkboxArray">';
1332 for ($c=0;$c<count($selItems);$c++
) {
1334 if(!($c%
$cols)) { $item.='<tr>'; }
1335 $cBP = $this->checkBoxParams($PA['itemFormElName'],$thisValue,$c,count($selItems),implode('',$PA['fieldChangeFunc']));
1336 $cBName = $PA['itemFormElName'].'_'.$c;
1337 $cBID = $PA['itemFormElID'].'_'.$c;
1338 $item.= '<td nowrap="nowrap">'.
1339 '<input type="checkbox"'.$this->insertDefStyle('check').' value="1" name="'.$cBName.'"'.$cBP.$disabled.' id="'.$cBID.'" />'.
1340 $this->wrapLabels('<label for="'.$cBID.'">'.htmlspecialchars($p[0]).'</label> ').
1342 if(($c%
$cols)+
1==$cols) {$item.='</tr>';}
1345 $rest=$cols-($c%
$cols);
1346 for ($c=0;$c<$rest;$c++
) {
1347 $item.= '<td></td>';
1349 if ($c>0) { $item.= '</tr>'; }
1353 for ($c=0;$c<count($selItems);$c++
) {
1355 $cBP = $this->checkBoxParams($PA['itemFormElName'],$thisValue,$c,count($selItems),implode('',$PA['fieldChangeFunc']));
1356 $cBName = $PA['itemFormElName'].'_'.$c;
1357 $cBID = $PA['itemFormElID'].'_'.$c;
1358 $item.= ($c>0?
'<br />':'').
1359 '<input type="checkbox"'.$this->insertDefStyle('check').' value="1" name="'.$cBName.'"'.$cBP.$PA['onFocus'].$disabled.' id="'.$cBID.'" />'.
1360 $this->wrapLabels('<label for="'.$cBID.'">'.htmlspecialchars($p[0]).'</label>');
1364 $item.= '<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($thisValue).'" />';
1371 * Generation of TCEform elements of the type "radio"
1372 * This will render a series of radio buttons.
1374 * @param string The table name of the record
1375 * @param string The field name which this element is supposed to edit
1376 * @param array The record data array where the value(s) for the field can be found
1377 * @param array An array with additional configuration options.
1378 * @return string The HTML code for the TCEform field
1380 function getSingleField_typeRadio($table,$field,$row,&$PA) {
1381 $config = $PA['fieldConf']['config'];
1384 if($this->renderReadonly ||
$config['readOnly']) {
1385 $disabled = ' disabled="disabled"';
1388 // Get items for the array:
1389 $selItems = $this->initItemArray($PA['fieldConf']);
1390 if ($config['itemsProcFunc']) $selItems = $this->procItems($selItems,$PA['fieldTSConfig']['itemsProcFunc.'],$config,$table,$row,$field);
1392 // Traverse the items, making the form elements:
1393 for ($c=0;$c<count($selItems);$c++
) {
1395 $rID = $PA['itemFormElID'].'_'.$c;
1396 $rOnClick = implode('',$PA['fieldChangeFunc']);
1397 $rChecked = (!strcmp($p[1],$PA['itemFormElValue'])?
' checked="checked"':'');
1398 $item.= '<input type="radio"'.$this->insertDefStyle('radio').' name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($p[1]).'" onclick="'.htmlspecialchars($rOnClick).'"'.$rChecked.$PA['onFocus'].$disabled.' id="'.$rID.'" />
1399 <label for="'.$rID.'">'.htmlspecialchars($p[0]).'</label>
1407 * Generation of TCEform elements of the type "select"
1408 * This will render a selector box element, or possibly a special construction with two selector boxes. That depends on configuration.
1410 * @param string The table name of the record
1411 * @param string The field name which this element is supposed to edit
1412 * @param array The record data array where the value(s) for the field can be found
1413 * @param array An array with additional configuration options.
1414 * @return string The HTML code for the TCEform field
1416 function getSingleField_typeSelect($table,$field,$row,&$PA) {
1419 // Field configuration from TCA:
1420 $config = $PA['fieldConf']['config'];
1423 if($this->renderReadonly ||
$config['readOnly']) {
1424 $disabled = ' disabled="disabled"';
1427 // "Extra" configuration; Returns configuration for the field based on settings found in the "types" fieldlist. See http://typo3.org/documentation/document-library/doc_core_api/Wizards_Configuratio/.
1428 $specConf = $this->getSpecConfFromString($PA['extra'], $PA['fieldConf']['defaultExtras']);
1430 // Getting the selector box items from the system
1431 $selItems = $this->addSelectOptionsToItemArray(
1432 $this->initItemArray($PA['fieldConf']),
1434 $this->setTSconfig($table, $row),
1437 // Possibly filter some items:
1438 $keepItemsFunc = create_function('$value', 'return $value[1];');
1439 $selItems = t3lib_div
::keepItemsInArray($selItems, $PA['fieldTSConfig']['keepItems'], $keepItemsFunc);
1440 // Possibly add some items:
1441 $selItems = $this->addItems($selItems, $PA['fieldTSConfig']['addItems.']);
1442 // Process items by a user function:
1443 if (isset($config['itemsProcFunc']) && $config['itemsProcFunc']) {
1444 $selItems = $this->procItems($selItems, $PA['fieldTSConfig']['itemsProcFunc.'], $config, $table, $row, $field);
1447 // Possibly remove some items:
1448 $removeItems = t3lib_div
::trimExplode(',',$PA['fieldTSConfig']['removeItems'],1);
1449 foreach($selItems as $tk => $p) {
1451 // Checking languages and authMode:
1452 $languageDeny = $TCA[$table]['ctrl']['languageField'] && !strcmp($TCA[$table]['ctrl']['languageField'], $field) && !$GLOBALS['BE_USER']->checkLanguageAccess($p[1]);
1453 $authModeDeny = $config['form_type']=='select' && $config['authMode'] && !$GLOBALS['BE_USER']->checkAuthMode($table,$field,$p[1],$config['authMode']);
1454 if (in_array($p[1],$removeItems) ||
$languageDeny ||
$authModeDeny) {
1455 unset($selItems[$tk]);
1456 } elseif (isset($PA['fieldTSConfig']['altLabels.'][$p[1]])) {
1457 $selItems[$tk][0]=$this->sL($PA['fieldTSConfig']['altLabels.'][$p[1]]);
1460 // Removing doktypes with no access:
1461 if ($table.'.'.$field == 'pages.doktype') {
1462 if (!($GLOBALS['BE_USER']->isAdmin() || t3lib_div
::inList($GLOBALS['BE_USER']->groupData
['pagetypes_select'],$p[1]))) {
1463 unset($selItems[$tk]);
1468 // Creating the label for the "No Matching Value" entry.
1469 $nMV_label = isset($PA['fieldTSConfig']['noMatchingValue_label']) ?
$this->sL($PA['fieldTSConfig']['noMatchingValue_label']) : '[ '.$this->getLL('l_noMatchingValue').' ]';
1471 // Prepare some values:
1472 $maxitems = intval($config['maxitems']);
1474 // If a SINGLE selector box...
1476 $item = $this->getSingleField_typeSelect_single($table,$field,$row,$PA,$config,$selItems,$nMV_label);
1477 } elseif (!strcmp($config['renderMode'],'checkbox')) { // Checkbox renderMode
1478 $item = $this->getSingleField_typeSelect_checkbox($table,$field,$row,$PA,$config,$selItems,$nMV_label);
1479 } elseif (!strcmp($config['renderMode'],'singlebox')) { // Single selector box renderMode
1480 $item = $this->getSingleField_typeSelect_singlebox($table,$field,$row,$PA,$config,$selItems,$nMV_label);
1481 } else { // Traditional multiple selector box:
1482 $item = $this->getSingleField_typeSelect_multiple($table,$field,$row,$PA,$config,$selItems,$nMV_label);
1487 $altItem = '<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />';
1488 $item = $this->renderWizards(array($item,$altItem),$config['wizards'],$table,$row,$field,$PA,$PA['itemFormElName'],$specConf);
1495 * Creates a single-selector box
1496 * (Render function for getSingleField_typeSelect())
1498 * @param string See getSingleField_typeSelect()
1499 * @param string See getSingleField_typeSelect()
1500 * @param array See getSingleField_typeSelect()
1501 * @param array See getSingleField_typeSelect()
1502 * @param array (Redundant) content of $PA['fieldConf']['config'] (for convenience)
1503 * @param array Items available for selection
1504 * @param string Label for no-matching-value
1505 * @return string The HTML code for the item
1506 * @see getSingleField_typeSelect()
1508 function getSingleField_typeSelect_single($table,$field,$row,&$PA,$config,$selItems,$nMV_label) {
1509 // check against inline uniqueness
1510 $inlineParent = $this->inline
->getStructureLevel(-1);
1511 if(is_array($inlineParent) && $inlineParent['uid']) {
1512 if ($inlineParent['config']['foreign_table'] == $table && $inlineParent['config']['foreign_unique'] == $field) {
1513 $uniqueIds = $this->inline
->inlineData
['unique'][$this->inline
->inlineNames
['object'].'['.$table.']']['used'];
1514 $PA['fieldChangeFunc']['inlineUnique'] = "inline.updateUnique(this,'".$this->inline
->inlineNames
['object'].'['.$table."]','".$this->inline
->inlineNames
['form']."','".$row['uid']."');";
1516 // hide uid of parent record for symmetric relations
1517 if ($inlineParent['config']['foreign_table'] == $table && ($inlineParent['config']['foreign_field'] == $field ||
$inlineParent['config']['symmetric_field'] == $field)) {
1518 $uniqueIds[] = $inlineParent['uid'];
1525 $noMatchingValue = 1;
1527 $selicons = array();
1528 $onlySelectedIconShown = 0;
1529 $size = intval($config['size']);
1530 $selectedStyle = ''; // Style set on <select/>
1533 if($this->renderReadonly ||
$config['readOnly']) {
1534 $disabled = ' disabled="disabled"';
1535 $onlySelectedIconShown = 1;
1538 // Icon configuration:
1539 if ($config['suppress_icons']=='IF_VALUE_FALSE') {
1540 $suppressIcons = !$PA['itemFormElValue'] ?
1 : 0;
1541 } elseif ($config['suppress_icons']=='ONLY_SELECTED') {
1543 $onlySelectedIconShown=1;
1544 } elseif ($config['suppress_icons']) {
1546 } else $suppressIcons = 0;
1548 // Traverse the Array of selector box items:
1549 $optGroupStart = array();
1550 foreach($selItems as $p) {
1551 $sM = (!strcmp($PA['itemFormElValue'],$p[1])?
' selected="selected"':'');
1554 $noMatchingValue = 0;
1557 // Getting style attribute value (for icons):
1558 if ($config['iconsInOptionTags']) {
1559 $styleAttrValue = $this->optionTagStyle($p[2]);
1561 list($selectIconFile,$selectIconInfo) = $this->getIcon($p[2]);
1562 if (!empty($selectIconInfo)) {
1563 $selectedStyle = ' style="background-image: url('.$selectIconFile.'); background-repeat: no-repeat; background-position: 0% 50%; padding: 1px; padding-left: 24px; -webkit-background-size: 0;"';
1568 // Compiling the <option> tag:
1569 if (!($p[1] != $PA['itemFormElValue'] && is_array($uniqueIds) && in_array($p[1], $uniqueIds))) {
1570 if(!strcmp($p[1],'--div--')) {
1571 $optGroupStart[0] = $p[0];
1572 $optGroupStart[1] = $styleAttrValue;
1575 if (count($optGroupStart)) {
1576 if($optGroupOpen) { // Closing last optgroup before next one starts
1577 $opt[]='</optgroup>' . "\n";
1579 $opt[]= '<optgroup label="'.t3lib_div
::deHSCentities(htmlspecialchars($optGroupStart[0])).'"'.
1580 ($optGroupStart[1] ?
' style="'.htmlspecialchars($optGroupStart[1]).'"' : '').
1581 ' class="c-divider">' . "\n";
1582 $optGroupOpen = true;
1584 $optGroupStart = array();
1586 $opt[]= '<option value="'.htmlspecialchars($p[1]).'"'.
1588 ($styleAttrValue ?
' style="'.htmlspecialchars($styleAttrValue).'"' : '').
1589 '>'.t3lib_div
::deHSCentities(htmlspecialchars($p[0])).'</option>' . "\n";
1593 // If there is an icon for the selector box (rendered in table under)...:
1594 if ($p[2] && !$suppressIcons && (!$onlySelectedIconShown ||
$sM)) {
1595 list($selIconFile,$selIconInfo)=$this->getIcon($p[2]);
1596 $iOnClick = $this->elName($PA['itemFormElName']) . '.selectedIndex=' . $c . '; ' .
1597 $this->elName($PA['itemFormElName']) . '.style.backgroundImage=' . $this->elName($PA['itemFormElName']) . '.options[' . $c .'].style.backgroundImage; ' .
1598 implode('',$PA['fieldChangeFunc']).$this->blur().'return false;';
1600 (!$onlySelectedIconShown ?
'<a href="#" onclick="'.htmlspecialchars($iOnClick).'">' : '').
1601 '<img src="'.$selIconFile.'" '.$selIconInfo[3].' vspace="2" border="0" title="'.htmlspecialchars($p[0]).'" alt="'.htmlspecialchars($p[0]).'" />'.
1602 (!$onlySelectedIconShown ?
'</a>' : ''),
1604 $onChangeIcon = 'this.style.backgroundImage=this.options[this.selectedIndex].style.backgroundImage;';
1609 if($optGroupOpen) { // Closing optgroup if open
1610 $opt[]='</optgroup>';
1611 $optGroupOpen = false;
1614 // No-matching-value:
1615 if ($PA['itemFormElValue'] && $noMatchingValue && !$PA['fieldTSConfig']['disableNoMatchingValueElement'] && !$config['disableNoMatchingValueElement']) {
1616 $nMV_label = @sprintf
($nMV_label, $PA['itemFormElValue']);
1617 $opt[]= '<option value="'.htmlspecialchars($PA['itemFormElValue']).'" selected="selected">'.htmlspecialchars($nMV_label).'</option>';
1620 // Create item form fields:
1621 $sOnChange = 'if (this.options[this.selectedIndex].value==\'--div--\') {this.selectedIndex='.$sI.';} '.implode('',$PA['fieldChangeFunc']);
1623 $item.= '<input type="hidden" name="'.$PA['itemFormElName'].'_selIconVal" value="'.htmlspecialchars($sI).'" />'; // MUST be inserted before the selector - else is the value of the hiddenfield here mysteriously submitted...
1625 $item .= '<select' . $selectedStyle . ' name="' . $PA['itemFormElName'] . '"' .
1626 ($config['iconsInOptionTags'] ?
' class="icon-select"' : '') .
1627 $this->insertDefStyle('select') .
1628 ($size ?
' size="' . $size . '"' : '') .
1629 ' onchange="' . htmlspecialchars($onChangeIcon . $sOnChange) . '"' .
1630 $PA['onFocus'] . $disabled . '>';
1631 $item.= implode('',$opt);
1632 $item.= '</select>';
1634 // Create icon table:
1635 if (count($selicons) && !$config['noIconsBelowSelect']) {
1636 $item.='<table border="0" cellpadding="0" cellspacing="0" class="typo3-TCEforms-selectIcons">';
1637 $selicon_cols = intval($config['selicon_cols']);
1638 if (!$selicon_cols) $selicon_cols=count($selicons);
1639 $sR = ceil(count($selicons)/$selicon_cols);
1640 $selicons = array_pad($selicons,$sR*$selicon_cols,'');
1641 for($sa=0;$sa<$sR;$sa++
) {
1643 for($sb=0;$sb<$selicon_cols;$sb++
) {
1644 $sk=($sa*$selicon_cols+
$sb);
1645 $imgN = 'selIcon_'.$table.'_'.$row['uid'].'_'.$field.'_'.$selicons[$sk][1];
1646 $imgS = ($selicons[$sk][2]?
$this->backPath
.'gfx/content_selected.gif':'clear.gif');
1647 $item.='<td><img name="'.htmlspecialchars($imgN).'" src="'.$imgS.'" width="7" height="10" alt="" /></td>';
1648 $item.='<td>'.$selicons[$sk][0].'</td>';
1659 * Creates a checkbox list (renderMode = "checkbox")
1660 * (Render function for getSingleField_typeSelect())
1662 * @param string See getSingleField_typeSelect()
1663 * @param string See getSingleField_typeSelect()
1664 * @param array See getSingleField_typeSelect()
1665 * @param array See getSingleField_typeSelect()
1666 * @param array (Redundant) content of $PA['fieldConf']['config'] (for convenience)
1667 * @param array Items available for selection
1668 * @param string Label for no-matching-value
1669 * @return string The HTML code for the item
1670 * @see getSingleField_typeSelect()
1672 function getSingleField_typeSelect_checkbox($table,$field,$row,&$PA,$config,$selItems,$nMV_label) {
1674 // Get values in an array (and make unique, which is fine because there can be no duplicates anyway):
1675 $itemArray = array_flip($this->extractValuesOnlyFromValueLabelList($PA['itemFormElValue']));
1678 if($this->renderReadonly ||
$config['readOnly']) {
1679 $disabled = ' disabled="disabled"';
1682 // Traverse the Array of selector box items:
1686 $sOnChange = implode('',$PA['fieldChangeFunc']);
1687 $setAll = array(); // Used to accumulate the JS needed to restore the original selection.
1688 foreach($selItems as $p) {
1689 // Non-selectable element:
1690 if (!strcmp($p[1],'--div--')) {
1691 if (count($setAll)) {
1693 <tr class="c-header-checkbox-controls">
1695 '<a href="#" onclick="' . htmlspecialchars(implode('', $setAll).' return false;') . '">' .
1696 htmlspecialchars($this->getLL('l_checkAll')) .
1698 <a href="#" onclick="' . htmlspecialchars(implode('', $unSetAll).' return false;').'">' .
1699 htmlspecialchars($this->getLL('l_uncheckAll')) .
1707 <tr class="c-header">
1708 <td colspan="3">'.htmlspecialchars($p[0]).'</td>
1711 // Selected or not by default:
1713 if (isset($itemArray[$p[1]])) {
1714 $sM = ' checked="checked"';
1715 unset($itemArray[$p[1]]);
1721 list($selIconFile,$selIconInfo) = $this->getIcon($p[2]);
1725 $rowId = uniqid('select_checkbox_row_');
1726 $onClickCell = $this->elName($PA['itemFormElName'] . '[' . $c . ']') . '.checked=!' . $this->elName($PA['itemFormElName'] . '[' . $c . ']') . '.checked;';
1727 $onClick = 'this.attributes.getNamedItem("class").nodeValue = ' . $this->elName($PA['itemFormElName'] . '[' . $c . ']') . '.checked ? "c-selectedItem" : "c-unselectedItem";';
1728 $setAll[] = $this->elName($PA['itemFormElName'] . '[' . $c . ']') . '.checked=1;';
1729 $setAll[] .= '$(\'' . $rowId . '\').removeClassName(\'c-unselectedItem\');$(\'' . $rowId . '\').addClassName(\'c-selectedItem\');';
1730 $unSetAll[] = $this->elName($PA['itemFormElName'].'['.$c.']').'.checked=0;';
1731 $unSetAll[] .= '$(\'' . $rowId . '\').removeClassName(\'c-selectedItem\');$(\'' . $rowId . '\').addClassName(\'c-unselectedItem\');';
1732 $restoreCmd[] = $this->elName($PA['itemFormElName'] . '[' . $c . ']') . '.checked=' . ($sM ?
1 : 0) . ';' .
1733 '$(\'' . $rowId . '\').removeClassName(\'c-selectedItem\');$(\'' . $rowId . '\').removeClassName(\'c-unselectedItem\');' .
1734 '$(\'' . $rowId . '\').addClassName(\'c-' . ($sM ?
'' : 'un') . 'selectedItem\');';
1736 $hasHelp = ($p[3] !='');
1738 $label = t3lib_div
::deHSCentities(htmlspecialchars($p[0]));
1739 $help = $hasHelp ?
'<span class="typo3-csh-inline show-right"><span class="header">' . $label . '</span>' .
1740 '<span class="paragraph">' . $GLOBALS['LANG']->hscAndCharConv(nl2br(trim(htmlspecialchars($p[3]))), false) . '</span></span>' : '';
1742 if ($hasHelp && $this->edit_showFieldHelp
== 'icon') {
1743 $helpIcon = '<a class="typo3-csh-link" href="#">';
1744 $helpIcon .= '<img' . t3lib_iconWorks
::skinImg($this->backPath
, 'gfx/helpbubble.gif', 'width="14" height="14"');
1745 $helpIcon .= ' hspace="2" border="0" class="absmiddle"' . ($GLOBALS['CLIENT']['FORMSTYLE'] ?
' style="cursor:help;"' : '') . ' alt="" />' . $help;
1746 $helpIcon .= '</a>';
1751 <tr id="' . $rowId . '" class="'.($sM ?
'c-selectedItem' : 'c-unselectedItem').'" onclick="'.htmlspecialchars($onClick).'" style="cursor: pointer;">
1752 <td width="12"><input type="checkbox"'.$this->insertDefStyle('check').' name="'.htmlspecialchars($PA['itemFormElName'].'['.$c.']').'" value="'.htmlspecialchars($p[1]).'"'.$sM.' onclick="'.htmlspecialchars($sOnChange).'"'.$PA['onFocus'].' /></td>
1753 <td class="c-labelCell" onclick="'.htmlspecialchars($onClickCell).'">'.
1754 ($selIconFile ?
'<img src="'.$selIconFile.'" '.$selIconInfo[3].' vspace="2" border="0" class="absmiddle" style="margin-right: 4px;" alt="" />' : '').
1757 <td class="c-descr" onclick="'.htmlspecialchars($onClickCell).'">' . (strcmp($p[3],'') ?
$help : '') . '</td>
1763 // Remaining checkboxes will get their set-all link:
1764 if (count($setAll)) {
1766 <tr class="c-header-checkbox-controls">
1768 '<a href="#" onclick="' . htmlspecialchars(implode('', $setAll).' return false;') . '">' .
1769 htmlspecialchars($this->getLL('l_checkAll')) .
1771 <a href="#" onclick="' . htmlspecialchars(implode('', $unSetAll).' return false;') . '">' .
1772 htmlspecialchars($this->getLL('l_uncheckAll')) .
1779 // Remaining values (invalid):
1780 if (count($itemArray) && !$PA['fieldTSConfig']['disableNoMatchingValueElement'] && !$config['disableNoMatchingValueElement']) {
1781 foreach($itemArray as $theNoMatchValue => $temp) {
1782 // Compile <checkboxes> tag:
1783 array_unshift($tRows,'
1784 <tr class="c-invalidItem">
1785 <td><input type="checkbox"'.$this->insertDefStyle('check').' name="'.htmlspecialchars($PA['itemFormElName'].'['.$c.']').'" value="'.htmlspecialchars($theNoMatchValue).'" checked="checked" onclick="'.htmlspecialchars($sOnChange).'"'.$PA['onFocus'].$disabled.' /></td>
1786 <td class="c-labelCell">'.
1787 t3lib_div
::deHSCentities(htmlspecialchars(@sprintf
($nMV_label, $theNoMatchValue))).
1788 '</td><td> </td>
1794 // Add an empty hidden field which will send a blank value if all items are unselected.
1795 $item .= '<input type="hidden" name="'.htmlspecialchars($PA['itemFormElName']) . '" value="" />';
1798 if (is_array($restoreCmd)) {
1799 $item .= '<a href="#" onclick="' . implode('', $restoreCmd).' return false;' . '">' .
1800 '<img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/undo.gif','width="13" height="12"') . ' title="' .
1801 htmlspecialchars($this->getLL('l_revertSelection')) . '" alt="" />' .'</a>';
1803 // Implode rows in table:
1805 <table border="0" cellpadding="0" cellspacing="0" class="typo3-TCEforms-select-checkbox">'.
1806 implode('',$tRows).'
1814 * Creates a selectorbox list (renderMode = "singlebox")
1815 * (Render function for getSingleField_typeSelect())
1817 * @param string See getSingleField_typeSelect()
1818 * @param string See getSingleField_typeSelect()
1819 * @param array See getSingleField_typeSelect()
1820 * @param array See getSingleField_typeSelect()
1821 * @param array (Redundant) content of $PA['fieldConf']['config'] (for convenience)
1822 * @param array Items available for selection
1823 * @param string Label for no-matching-value
1824 * @return string The HTML code for the item
1825 * @see getSingleField_typeSelect()
1827 function getSingleField_typeSelect_singlebox($table,$field,$row,&$PA,$config,$selItems,$nMV_label) {
1829 // Get values in an array (and make unique, which is fine because there can be no duplicates anyway):
1830 $itemArray = array_flip($this->extractValuesOnlyFromValueLabelList($PA['itemFormElValue']));
1833 if($this->renderReadonly ||
$config['readOnly']) {
1834 $disabled = ' disabled="disabled"';
1837 // Traverse the Array of selector box items:
1839 $restoreCmd = array(); // Used to accumulate the JS needed to restore the original selection.
1841 foreach($selItems as $p) {
1842 // Selected or not by default:
1844 if (isset($itemArray[$p[1]])) {
1845 $sM = ' selected="selected"';
1846 $restoreCmd[] = $this->elName($PA['itemFormElName'].'[]').'.options['.$c.'].selected=1;';
1847 unset($itemArray[$p[1]]);
1850 // Non-selectable element:
1852 if (!strcmp($p[1],'--div--')) {
1853 $nonSel = ' onclick="this.selected=0;" class="c-divider"';
1856 // Icon style for option tag:
1857 if ($config['iconsInOptionTags']) {
1858 $styleAttrValue = $this->optionTagStyle($p[2]);
1861 // Compile <option> tag:
1862 $opt[] = '<option value="'.htmlspecialchars($p[1]).'"'.
1865 ($styleAttrValue ?
' style="'.htmlspecialchars($styleAttrValue).'"' : '').
1866 '>'.t3lib_div
::deHSCentities(htmlspecialchars($p[0])).'</option>';
1870 // Remaining values:
1871 if (count($itemArray) && !$PA['fieldTSConfig']['disableNoMatchingValueElement'] && !$config['disableNoMatchingValueElement']) {
1872 foreach($itemArray as $theNoMatchValue => $temp) {
1873 // Compile <option> tag:
1874 array_unshift($opt,'<option value="'.htmlspecialchars($theNoMatchValue).'" selected="selected">'.t3lib_div
::deHSCentities(htmlspecialchars(@sprintf
($nMV_label, $theNoMatchValue))).'</option>');
1878 // Compile selector box:
1879 $sOnChange = implode('',$PA['fieldChangeFunc']);
1880 $selector_itemListStyle = isset($config['itemListStyle']) ?
' style="'.htmlspecialchars($config['itemListStyle']).'"' : ' style="'.$this->defaultMultipleSelectorStyle
.'"';
1881 $size = intval($config['size']);
1882 $size = $config['autoSizeMax'] ? t3lib_div
::intInRange(count($selItems)+
1,t3lib_div
::intInRange($size,1),$config['autoSizeMax']) : $size;
1883 $selectBox = '<select name="'.$PA['itemFormElName'].'[]"'.
1884 $this->insertDefStyle('select').
1885 ($size ?
' size="'.$size.'"' : '').
1886 ' multiple="multiple" onchange="'.htmlspecialchars($sOnChange).'"'.
1888 $selector_itemListStyle.
1895 // Add an empty hidden field which will send a blank value if all items are unselected.
1897 $item.='<input type="hidden" name="'.htmlspecialchars($PA['itemFormElName']).'" value="" />';
1900 // Put it all into a table:
1902 <table border="0" cellspacing="0" cellpadding="0" width="1" class="typo3-TCEforms-select-singlebox">
1908 htmlspecialchars($this->getLL('l_holdDownCTRL')).
1912 <a href="#" onclick="'.htmlspecialchars($this->elName($PA['itemFormElName'].'[]').'.selectedIndex=-1;'.implode('',$restoreCmd).' return false;').'">'.
1913 '<img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/undo.gif','width="13" height="12"').' title="'.htmlspecialchars($this->getLL('l_revertSelection')).'" alt="" />'.
1924 * Creates a multiple-selector box (two boxes, side-by-side)
1925 * (Render function for getSingleField_typeSelect())
1927 * @param string See getSingleField_typeSelect()
1928 * @param string See getSingleField_typeSelect()
1929 * @param array See getSingleField_typeSelect()
1930 * @param array See getSingleField_typeSelect()
1931 * @param array (Redundant) content of $PA['fieldConf']['config'] (for convenience)
1932 * @param array Items available for selection
1933 * @param string Label for no-matching-value
1934 * @return string The HTML code for the item
1935 * @see getSingleField_typeSelect()
1937 function getSingleField_typeSelect_multiple($table,$field,$row,&$PA,$config,$selItems,$nMV_label) {
1940 if($this->renderReadonly ||
$config['readOnly']) {
1941 $disabled = ' disabled="disabled"';
1944 // Setting this hidden field (as a flag that JavaScript can read out)
1946 $item.= '<input type="hidden" name="'.$PA['itemFormElName'].'_mul" value="'.($config['multiple']?
1:0).'" />';
1949 // Set max and min items:
1950 $maxitems = t3lib_div
::intInRange($config['maxitems'],0);
1951 if (!$maxitems) $maxitems=100000;
1952 $minitems = t3lib_div
::intInRange($config['minitems'],0);
1954 // Register the required number of elements:
1955 $this->registerRequiredProperty('range', $PA['itemFormElName'], array($minitems,$maxitems,'imgName'=>$table.'_'.$row['uid'].'_'.$field));
1957 // Get "removeItems":
1958 $removeItems = t3lib_div
::trimExplode(',',$PA['fieldTSConfig']['removeItems'],1);
1960 // Get the array with selected items:
1961 $itemArray = t3lib_div
::trimExplode(',', $PA['itemFormElValue'], 1);
1963 // Possibly filter some items:
1964 $keepItemsFunc = create_function('$value', '$parts=explode(\'|\',$value,2); return rawurldecode($parts[0]);');
1965 $itemArray = t3lib_div
::keepItemsInArray($itemArray, $PA['fieldTSConfig']['keepItems'], $keepItemsFunc);
1967 // Perform modification of the selected items array:
1968 foreach($itemArray as $tk => $tv) {
1969 $tvP = explode('|',$tv,2);
1970 $evalValue = rawurldecode($tvP[0]);
1971 $isRemoved = in_array($evalValue,$removeItems) ||
($config['form_type']=='select' && $config['authMode'] && !$GLOBALS['BE_USER']->checkAuthMode($table,$field,$evalValue,$config['authMode']));
1972 if ($isRemoved && !$PA['fieldTSConfig']['disableNoMatchingValueElement'] && !$config['disableNoMatchingValueElement']) {
1973 $tvP[1] = rawurlencode(@sprintf
($nMV_label, $evalValue));
1974 } elseif (isset($PA['fieldTSConfig']['altLabels.'][$evalValue])) {
1975 $tvP[1] = rawurlencode($this->sL($PA['fieldTSConfig']['altLabels.'][$evalValue]));
1977 $itemArray[$tk] = implode('|',$tvP);
1979 $itemsToSelect = '';
1982 // Create option tags:
1984 $styleAttrValue = '';
1985 foreach($selItems as $p) {
1986 if ($config['iconsInOptionTags']) {
1987 $styleAttrValue = $this->optionTagStyle($p[2]);
1989 $opt[]= '<option value="'.htmlspecialchars($p[1]).'"'.
1990 ($styleAttrValue ?
' style="'.htmlspecialchars($styleAttrValue).'"' : '').
1991 '>'.htmlspecialchars($p[0]).'</option>';
1994 // Put together the selector box:
1995 $selector_itemListStyle = isset($config['itemListStyle']) ?
' style="'.htmlspecialchars($config['itemListStyle']).'"' : ' style="'.$this->defaultMultipleSelectorStyle
.'"';
1996 $size = intval($config['size']);
1997 $size = $config['autoSizeMax'] ? t3lib_div
::intInRange(count($itemArray)+
1,t3lib_div
::intInRange($size,1),$config['autoSizeMax']) : $size;
1998 if ($config['exclusiveKeys']) {
1999 $sOnChange = 'setFormValueFromBrowseWin(\''.$PA['itemFormElName'].'\',this.options[this.selectedIndex].value,this.options[this.selectedIndex].text,\''.$config['exclusiveKeys'].'\'); ';
2001 $sOnChange = 'setFormValueFromBrowseWin(\''.$PA['itemFormElName'].'\',this.options[this.selectedIndex].value,this.options[this.selectedIndex].text); ';
2003 $sOnChange .= implode('',$PA['fieldChangeFunc']);
2005 <select name="'.$PA['itemFormElName'].'_sel"'.
2006 $this->insertDefStyle('select').
2007 ($size ?
' size="'.$size.'"' : '').
2008 ' onchange="'.htmlspecialchars($sOnChange).'"'.
2010 $selector_itemListStyle.'>
2016 // Pass to "dbFileIcons" function:
2019 'autoSizeMax' => t3lib_div
::intInRange($config['autoSizeMax'],0),
2020 'style' => isset($config['selectedListStyle']) ?
' style="'.htmlspecialchars($config['selectedListStyle']).'"' : ' style="'.$this->defaultMultipleSelectorStyle
.'"',
2021 'dontShowMoveIcons' => ($maxitems<=1),
2022 'maxitems' => $maxitems,
2025 'selector' => $this->getLL('l_selected').':<br />',
2026 'items' => $this->getLL('l_items').':<br />'
2029 'thumbnails' => $itemsToSelect,
2030 'readOnly' => $disabled
2032 $item.= $this->dbFileIcons($PA['itemFormElName'],'','',$itemArray,'',$params,$PA['onFocus']);
2038 * Generation of TCEform elements of the type "group"
2039 * This will render a selectorbox into which elements from either the file system or database can be inserted. Relations.
2041 * @param string The table name of the record
2042 * @param string The field name which this element is supposed to edit
2043 * @param array The record data array where the value(s) for the field can be found
2044 * @param array An array with additional configuration options.
2045 * @return string The HTML code for the TCEform field
2047 function getSingleField_typeGroup($table,$field,$row,&$PA) {
2049 $config = $PA['fieldConf']['config'];
2050 $internal_type = $config['internal_type'];
2051 $show_thumbs = $config['show_thumbs'];
2052 $size = intval($config['size']);
2053 $maxitems = t3lib_div
::intInRange($config['maxitems'],0);
2054 if (!$maxitems) $maxitems=100000;
2055 $minitems = t3lib_div
::intInRange($config['minitems'],0);
2056 $allowed = trim($config['allowed']);
2057 $disallowed = trim($config['disallowed']);
2060 if($this->renderReadonly ||
$config['readOnly']) {
2061 $disabled = ' disabled="disabled"';
2064 $item.= '<input type="hidden" name="'.$PA['itemFormElName'].'_mul" value="'.($config['multiple']?
1:0).'"'.$disabled.' />';
2065 $this->registerRequiredProperty('range', $PA['itemFormElName'], array($minitems,$maxitems,'imgName'=>$table.'_'.$row['uid'].'_'.$field));
2068 // "Extra" configuration; Returns configuration for the field based on settings found in the "types" fieldlist. See http://typo3.org/documentation/document-library/doc_core_api/Wizards_Configuratio/.
2069 $specConf = $this->getSpecConfFromString($PA['extra'], $PA['fieldConf']['defaultExtras']);
2071 // Acting according to either "file" or "db" type:
2072 switch((string)$config['internal_type']) {
2073 case 'file': // If the element is of the internal type "file":
2075 // Creating string showing allowed types:
2076 $tempFT = t3lib_div
::trimExplode(',',$allowed,1);
2077 if (!count($tempFT)) {$info.='*';}
2078 foreach($tempFT as $ext) {
2080 $info.=strtoupper($ext).' ';
2083 // Creating string, showing disallowed types:
2084 $tempFT_dis = t3lib_div
::trimExplode(',',$disallowed,1);
2085 if (count($tempFT_dis)) {$info.='<br />';}
2086 foreach($tempFT_dis as $ext) {
2088 $info.='-'.strtoupper($ext).' ';
2092 // Making the array of file items:
2093 $itemArray = t3lib_div
::trimExplode(',',$PA['itemFormElValue'],1);
2095 // Showing thumbnails:
2099 foreach($itemArray as $imgRead) {
2100 $imgP = explode('|',$imgRead);
2101 $imgPath = rawurldecode($imgP[0]);
2104 $rowCopy[$field] = $imgPath;
2106 // Icon + clickmenu:
2107 $absFilePath = t3lib_div
::getFileAbsFileName($config['uploadfolder'].'/'.$imgPath);
2109 $fI = pathinfo($imgPath);
2110 $fileIcon = t3lib_BEfunc
::getFileIcon(strtolower($fI['extension']));
2111 $fileIcon = '<img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/fileicons/'.$fileIcon,'width="18" height="16"').' class="absmiddle" title="'.htmlspecialchars($fI['basename'].($absFilePath && @is_file
($absFilePath) ?
' ('.t3lib_div
::formatSize(filesize($absFilePath)).'bytes)' : ' - FILE NOT FOUND!')).'" alt="" />';
2113 $imgs[] = '<span class="nobr">'.t3lib_BEfunc
::thumbCode($rowCopy,$table,$field,$this->backPath
,'thumbs.php',$config['uploadfolder'],0,' align="middle"').
2114 ($absFilePath ?
$this->getClickMenu($fileIcon, $absFilePath) : $fileIcon).
2118 $thumbsnail = implode('<br />',$imgs);
2121 // Creating the element:
2122 $noList = isset($config['disable_controls']) && t3lib_div
::inList($config['disable_controls'], 'list');
2125 'dontShowMoveIcons' => ($maxitems<=1),
2126 'autoSizeMax' => t3lib_div
::intInRange($config['autoSizeMax'],0),
2127 'maxitems' => $maxitems,
2128 'style' => isset($config['selectedListStyle']) ?
' style="'.htmlspecialchars($config['selectedListStyle']).'"' : ' style="'.$this->defaultMultipleSelectorStyle
.'"',
2130 'thumbnails' => $thumbsnail,
2131 'readOnly' => $disabled,
2132 'noBrowser' => $noList ||
isset($config['disable_controls']) && t3lib_div
::inList($config['disable_controls'], 'browser'),
2133 'noList' => $noList,
2135 $item.= $this->dbFileIcons($PA['itemFormElName'],'file',implode(',',$tempFT),$itemArray,'',$params,$PA['onFocus']);
2137 if(!$disabled && !(isset($config['disable_controls']) && t3lib_div
::inList($config['disable_controls'], 'upload'))) {
2138 // Adding the upload field:
2139 if ($this->edit_docModuleUpload
) $item.='<input type="file" name="'.$PA['itemFormElName_file'].'"'.$this->formWidth().' size="60" />';
2142 case 'folder': // If the element is of the internal type "folder":
2144 // array of folder items:
2145 $itemArray = t3lib_div
::trimExplode(',', $PA['itemFormElValue'], 1);
2147 // Creating the element:
2150 'dontShowMoveIcons' => ($maxitems <= 1),
2151 'autoSizeMax' => t3lib_div
::intInRange($config['autoSizeMax'], 0),
2152 'maxitems' => $maxitems,
2153 'style' => isset($config['selectedListStyle']) ?
2154 ' style="'.htmlspecialchars($config['selectedListStyle']).'"'
2155 : ' style="'.$this->defaultMultipleSelectorStyle
.'"',
2157 'readOnly' => $disabled
2160 $item.= $this->dbFileIcons(
2161 $PA['itemFormElName'],
2170 case 'db': // If the element is of the internal type "db":
2172 // Creating string showing allowed types:
2173 $tempFT = t3lib_div
::trimExplode(',', $allowed, true);
2174 if (!strcmp(trim($tempFT[0]), '*')) {
2175 $onlySingleTableAllowed = false;
2176 $info.='<span class="nobr"> '.
2177 htmlspecialchars($this->getLL('l_allTables')).
2179 } elseif ($tempFT) {
2180 $onlySingleTableAllowed = (count($tempFT) == 1);
2181 foreach ($tempFT as $theT) {
2182 $info.= '<span class="nobr"> ' .
2183 t3lib_iconWorks
::getIconImage($theT, array(), $this->backPath
, 'align="top"') .
2184 htmlspecialchars($this->sL($GLOBALS['TCA'][$theT]['ctrl']['title'])) .
2189 $perms_clause = $GLOBALS['BE_USER']->getPagePermsClause(1);
2190 $itemArray = array();
2194 $temp_itemArray = t3lib_div
::trimExplode(',',$PA['itemFormElValue'],1);
2195 foreach($temp_itemArray as $dbRead) {
2196 $recordParts = explode('|',$dbRead);
2197 list($this_table,$this_uid) = t3lib_BEfunc
::splitTable_Uid($recordParts[0]);
2198 // For the case that no table was found and only a single table is defined to be allowed, use that one:
2199 if (!$this_table && $onlySingleTableAllowed) {
2200 $this_table = $allowed;
2202 $itemArray[] = array('table'=>$this_table, 'id'=>$this_uid);
2203 if (!$disabled && $show_thumbs) {
2204 $rr = t3lib_BEfunc
::getRecordWSOL($this_table,$this_uid);
2205 $imgs[] = '<span class="nobr">'.
2206 $this->getClickMenu(t3lib_iconWorks
::getIconImage($this_table,$rr,$this->backPath
,'align="top" title="'.htmlspecialchars(t3lib_BEfunc
::getRecordPath($rr['pid'],$perms_clause,15)).' [UID: '.$rr['uid'].']"'),$this_table, $this_uid).
2208 t3lib_BEfunc
::getRecordTitle($this_table,$rr,TRUE).' <span class="typo3-dimmed"><em>['.$rr['uid'].']</em></span>'.
2213 if (!$disabled && $show_thumbs) {
2214 $thumbsnail = implode('<br />',$imgs);
2217 // Creating the element:
2220 'dontShowMoveIcons' => ($maxitems<=1),
2221 'autoSizeMax' => t3lib_div
::intInRange($config['autoSizeMax'],0),
2222 'maxitems' => $maxitems,
2223 'style' => isset($config['selectedListStyle']) ?
' style="'.htmlspecialchars($config['selectedListStyle']).'"' : ' style="'.$this->defaultMultipleSelectorStyle
.'"',
2225 'thumbnails' => $thumbsnail,
2226 'readOnly' => $disabled
2228 $item.= $this->dbFileIcons($PA['itemFormElName'],'db',implode(',',$tempFT),$itemArray,'',$params,$PA['onFocus'],$table,$field,$row['uid']);
2234 $altItem = '<input type="hidden" name="'.$PA['itemFormElName'].'" value="'.htmlspecialchars($PA['itemFormElValue']).'" />';
2236 $item = $this->renderWizards(array($item,$altItem),$config['wizards'],$table,$row,$field,$PA,$PA['itemFormElName'],$specConf);
2243 * Generation of TCEform elements of the type "none"
2244 * This will render a non-editable display of the content of the field.
2246 * @param string The table name of the record
2247 * @param string The field name which this element is supposed to edit
2248 * @param array The record data array where the value(s) for the field can be found
2249 * @param array An array with additional configuration options.
2250 * @return string The HTML code for the TCEform field
2252 function getSingleField_typeNone($table,$field,$row,&$PA) {
2254 $config = $PA['fieldConf']['config'];
2255 $itemValue = $PA['itemFormElValue'];
2257 return $this->getSingleField_typeNone_render($config,$itemValue);
2261 * HTML rendering of a value which is not editable.
2263 * @param array Configuration for the display
2264 * @param string The value to display
2265 * @return string The HTML code for the display
2266 * @see getSingleField_typeNone();
2268 function getSingleField_typeNone_render($config,$itemValue) {
2270 // is colorScheme[0] the right value?
2271 $divStyle = 'border:solid 1px '.t3lib_div
::modifyHTMLColorAll($this->colorScheme
[0],-30).';'.$this->defStyle
.$this->formElStyle('none').' background-color: '.$this->colorScheme
[0].'; padding-left:1px;color:#555;';
2273 if ($config['format']) {
2274 $itemValue = $this->formatValue($config, $itemValue);
2277 $rows = intval($config['rows']);
2279 if(!$config['pass_content']) {
2280 $itemValue = nl2br(htmlspecialchars($itemValue));
2283 $cols = t3lib_div
::intInRange($config['cols'] ?
$config['cols'] : 30, 5, $this->maxTextareaWidth
);
2284 if (!$config['fixedRows']) {
2285 $origRows = $rows = t3lib_div
::intInRange($rows, 1, 20);
2286 if (strlen($itemValue)>$this->charsPerRow
*2) {
2287 $cols = $this->maxTextareaWidth
;
2288 $rows = t3lib_div
::intInRange(round(strlen($itemValue)/$this->charsPerRow
),count(explode(chr(10),$itemValue)),20);
2289 if ($rows<$origRows) $rows=$origRows;
2293 if ($this->docLarge
) $cols = round($cols*$this->form_largeComp
);
2294 $width = ceil($cols*$this->form_rowsToStylewidth
);
2295 // hardcoded: 12 is the height of the font
2299 <div style="'.htmlspecialchars($divStyle.' overflow:auto; height:'.$height.'px; width:'.$width.'px;').'" class="'.htmlspecialchars($this->formElClass('none')).'">'.
2303 if(!$config['pass_content']) {
2304 $itemValue = htmlspecialchars($itemValue);
2307 $cols = $config['cols']?
$config['cols']:($config['size']?
$config['size']:$this->maxInputWidth
);
2308 if ($this->docLarge
) $cols = round($cols*$this->form_largeComp
);
2309 $width = ceil($cols*$this->form_rowsToStylewidth
);
2311 // overflow:auto crashes mozilla here. Title tag is usefull when text is longer than the div box (overflow:hidden).
2313 <div style="'.htmlspecialchars($divStyle.' overflow:hidden; width:'.$width.'px;').'" class="'.htmlspecialchars($this->formElClass('none')).'" title="'.$itemValue.'">'.
2314 '<span class="nobr">'.(strcmp($itemValue,'')?
$itemValue:' ').'</span>'.
2322 * Handler for Flex Forms
2324 * @param string The table name of the record
2325 * @param string The field name which this element is supposed to edit
2326 * @param array The record data array where the value(s) for the field can be found
2327 * @param array An array with additional configuration options.
2328 * @return string The HTML code for the TCEform field
2330 function getSingleField_typeFlex($table,$field,$row,&$PA) {
2333 $dataStructArray = t3lib_BEfunc
::getFlexFormDS($PA['fieldConf']['config'],$row,$table);
2335 // Get data structure:
2336 if (is_array($dataStructArray)) {
2339 $xmlData = $PA['itemFormElValue'];
2340 $xmlHeaderAttributes = t3lib_div
::xmlGetHeaderAttribs($xmlData);
2341 $storeInCharset = strtolower($xmlHeaderAttributes['encoding']);
2342 if ($storeInCharset) {
2343 $currentCharset=$GLOBALS['LANG']->charSet
;
2344 $xmlData = $GLOBALS['LANG']->csConvObj
->conv($xmlData,$storeInCharset,$currentCharset,1);
2346 $editData=t3lib_div
::xml2array($xmlData);
2347 if (!is_array($editData)) { // Must be XML parsing error...
2349 } elseif (!isset($editData['meta']) ||
!is_array($editData['meta'])) {
2350 $editData['meta'] = array();
2353 // Find the data structure if sheets are found:
2354 $sheet = $editData['meta']['currentSheetId'] ?
$editData['meta']['currentSheetId'] : 'sDEF'; // Sheet to display
2356 // Create sheet menu:
2357 // if (is_array($dataStructArray['sheets'])) {
2358 // #$item.=$this->getSingleField_typeFlex_sheetMenu($dataStructArray['sheets'], $PA['itemFormElName'].'[meta][currentSheetId]', $sheet).'<br />';
2361 // Create language menu:
2362 $langChildren = $dataStructArray['meta']['langChildren'] ?
1 : 0;
2363 $langDisabled = $dataStructArray['meta']['langDisable'] ?
1 : 0;
2365 $editData['meta']['currentLangId']=array();
2366 $languages = $this->getAvailableLanguages();
2368 foreach($languages as $lInfo) {
2369 if ($GLOBALS['BE_USER']->checkLanguageAccess($lInfo['uid'])) {
2370 $editData['meta']['currentLangId'][] = $lInfo['ISOcode'];
2373 if (!is_array($editData['meta']['currentLangId']) ||
!count($editData['meta']['currentLangId'])) {
2374 $editData['meta']['currentLangId']=array('DEF');
2377 $editData['meta']['currentLangId'] = array_unique($editData['meta']['currentLangId']);
2380 // if (!$langDisabled && count($languages) > 1) {
2381 // $item.=$this->getSingleField_typeFlex_langMenu($languages, $PA['itemFormElName'].'[meta][currentLangId]', $editData['meta']['currentLangId']).'<br />';
2384 $PA['_noEditDEF'] = FALSE;
2385 if ($langChildren ||
$langDisabled) {
2386 $rotateLang = array('DEF');
2388 if (!in_array('DEF',$editData['meta']['currentLangId'])) {
2389 array_unshift($editData['meta']['currentLangId'],'DEF');
2390 $PA['_noEditDEF'] = TRUE;
2392 $rotateLang = $editData['meta']['currentLangId'];
2396 if (is_array($dataStructArray['sheets'])) {
2397 $tabsToTraverse = array_keys($dataStructArray['sheets']);
2399 $tabsToTraverse = array($sheet);
2402 foreach ($rotateLang as $lKey) {
2403 if (!$langChildren && !$langDisabled) {
2404 $item.= '<b>'.$this->getLanguageIcon($table,$row,'v'.$lKey).$lKey.':</b>';
2407 $tabParts = array();
2408 foreach ($tabsToTraverse as $sheet) {
2409 list ($dataStruct, $sheet) = t3lib_div
::resolveSheetDefInDS($dataStructArray,$sheet);
2412 if (is_array($dataStruct['ROOT']) && is_array($dataStruct['ROOT']['el'])) {
2413 $lang = 'l'.$lKey; // Default language, other options are "lUK" or whatever country code (independant of system!!!)
2414 $PA['_valLang'] = $langChildren && !$langDisabled ?
$editData['meta']['currentLangId'] : 'DEF'; // Default language, other options are "lUK" or whatever country code (independant of system!!!)
2415 $PA['_lang'] = $lang;
2416 $PA['_cshFile'] = ((isset($dataStruct['ROOT']['TCEforms']) && isset($dataStruct['ROOT']['TCEforms']['cshFile'])) ?
$dataStruct['ROOT']['TCEforms']['cshFile'] : '');
2419 $tRows = $this->getSingleField_typeFlex_draw(
2420 $dataStruct['ROOT']['el'],
2421 $editData['data'][$sheet][$lang],
2426 '[data]['.$sheet.']['.$lang.']'
2428 #$sheetContent= '<table border="0" cellpadding="1" cellspacing="1" class="typo3-TCEforms-flexForm">'.implode('',$tRows).'</table>';
2429 $sheetContent = '<div class="typo3-TCEforms-flexForm">'.$tRows.'</div>';
2431 # $item = '<div style=" position:absolute;">'.$item.'</div>';
2432 //visibility:hidden;
2433 } else $sheetContent='Data Structure ERROR: No ROOT element found for sheet "'.$sheet.'".';
2436 $tabParts[] = array(
2437 'label' => ($dataStruct['ROOT']['TCEforms']['sheetTitle'] ?
$this->sL($dataStruct['ROOT']['TCEforms']['sheetTitle']) : $sheet),
2438 'description' => ($dataStruct['ROOT']['TCEforms']['sheetDescription'] ?
$this->sL($dataStruct['ROOT']['TCEforms']['sheetDescription']) : ''),
2439 'linkTitle' => ($dataStruct['ROOT']['TCEforms']['sheetShortDescr'] ?
$this->sL($dataStruct['ROOT']['TCEforms']['sheetShortDescr']) : ''),
2440 'content' => $sheetContent
2444 if (is_array($dataStructArray['sheets'])) {
2445 $dividersToTabsBehaviour = (isset($GLOBALS['TCA'][$table]['ctrl']['dividers2tabs']) ?
$GLOBALS['TCA'][$table]['ctrl']['dividers2tabs'] : 1);
2446 $item.= $this->getDynTabMenu($tabParts, 'TCEFORMS:flexform:'.$PA['itemFormElName'].$PA['_lang'], $dividersToTabsBehaviour);
2448 $item.= $sheetContent;
2451 } else $item='Data Structure ERROR: '.$dataStructArray;
2457 * Creates the language menu for FlexForms:
2459 * @param [type] $languages: ...
2460 * @param [type] $elName: ...
2461 * @param [type] $selectedLanguage: ...
2462 * @param [type] $multi: ...
2463 * @return string HTML for menu
2465 function getSingleField_typeFlex_langMenu($languages,$elName,$selectedLanguage,$multi=1) {
2467 foreach($languages as $lArr) {
2468 $opt[]='<option value="'.htmlspecialchars($lArr['ISOcode']).'"'.(in_array($lArr['ISOcode'],$selectedLanguage)?
' selected="selected"':'').'>'.htmlspecialchars($lArr['title']).'</option>';
2471 $output = '<select name="'.$elName.'[]"'.($multi ?
' multiple="multiple" size="'.count($languages).'"' : '').'>'.implode('',$opt).'</select>';
2477 * Creates the menu for selection of the sheets:
2479 * @param array Sheet array for which to render the menu
2480 * @param string Form element name of the field containing the sheet pointer
2481 * @param string Current sheet key
2482 * @return string HTML for menu
2484 function getSingleField_typeFlex_sheetMenu($sArr,$elName,$sheetKey) {
2487 $pct = round(100/count($sArr));
2488 foreach($sArr as $sKey => $sheetCfg) {
2489 if ($GLOBALS['BE_USER']->jsConfirmation(1)) {
2490 $onClick = 'if (confirm(TBE_EDITOR.labels.onChangeAlert) && TBE_EDITOR.checkSubmit(-1)){'.$this->elName($elName).".value='".$sKey."'; TBE_EDITOR.submitForm()};";
2492 $onClick = 'if(TBE_EDITOR.checkSubmit(-1)){ '.$this->elName($elName).".value='".$sKey."'; TBE_EDITOR.submitForm();}";
2496 $tCells[]='<td width="'.$pct.'%" style="'.($sKey==$sheetKey ?
'background-color: #9999cc; font-weight: bold;' : 'background-color: #aaaaaa;').' cursor: hand;" onclick="'.htmlspecialchars($onClick).'" align="center">'.
2497 ($sheetCfg['ROOT']['TCEforms']['sheetTitle'] ?
$this->sL($sheetCfg['ROOT']['TCEforms']['sheetTitle']) : $sKey).
2501 return '<table border="0" cellpadding="0" cellspacing="2" class="typo3-TCEforms-flexForm-sheetMenu"><tr>'.implode('',$tCells).'</tr></table>';
2505 * Recursive rendering of flexforms
2507 * @param array (part of) Data Structure for which to render. Keys on first level is flex-form fields
2508 * @param array (part of) Data array of flexform corresponding to the input DS. Keys on first level is flex-form field names
2509 * @param string Table name, eg. tt_content
2510 * @param string Field name, eg. tx_templavoila_flex
2511 * @param array The particular record from $table in which the field $field is found
2512 * @param array Array of standard information for rendering of a form field in TCEforms, see other rendering functions too
2513 * @param string Form field prefix, eg. "[data][sDEF][lDEF][...][...]"
2514 * @param integer Indicates nesting level for the function call
2515 * @param string Prefix for ID-values
2516 * @param boolean Defines whether the next flexform level is open or closed. Comes from _TOGGLE pseudo field in FlexForm xml.
2517 * @return string HTMl code for form.
2519 function getSingleField_typeFlex_draw($dataStruct,$editData,$table,$field,$row,&$PA,$formPrefix='',$level=0,$idPrefix='ID',$toggleClosed=FALSE) {
2522 $mayRestructureFlexforms = $GLOBALS['BE_USER']->checkLanguageAccess(0);
2524 // Data Structure array must be ... and array of course...
2525 if (is_array($dataStruct)) {
2526 foreach($dataStruct as $key => $value) { // Traversing fields in structure:
2527 if (is_array($value)) { // The value of each entry must be an array.
2529 // ********************
2531 // ********************
2533 $theTitle = htmlspecialchars(t3lib_div
::fixed_lgd_cs($this->sL($value['tx_templavoila']['title']),30));
2535 // If it's a "section" or "container":
2536 if ($value['type']=='array') {
2538 // Creating IDs for form fields:
2539 // It's important that the IDs "cascade" - otherwise we can't dynamically expand the flex form because this relies on simple string substitution of the first parts of the id values.
2540 $thisId = t3lib_div
::shortMd5(uniqid('id',true)); // This is a suffix used for forms on this level
2541 $idTagPrefix = $idPrefix.'-'.$thisId; // $idPrefix is the prefix for elements on lower levels in the hierarchy and we combine this with the thisId value to form a new ID on this level.
2543 // If it's a "section" containing other elements:
2544 if ($value['section']) {
2546 // Load script.aculo.us if flexform sections can be moved by drag'n'drop:
2547 $this->loadJavascriptLib('contrib/scriptaculous/scriptaculous.js');
2548 // Render header of section:
2549 $output.= '<div class="bgColor2"><strong>'.$theTitle.'</strong></div>';
2551 // Render elements in data array for section:
2554 if (is_array($editData[$key]['el'])) {
2555 foreach ($editData[$key]['el'] as $k3 => $v3) {
2557 if (is_array($v3)) {
2558 $theType = key($v3);
2559 $theDat = $v3[$theType];
2560 $newSectionEl = $value['el'][$theType];
2561 if (is_array($newSectionEl)) {
2562 $tRows[]= $this->getSingleField_typeFlex_draw(
2563 array($theType => $newSectionEl),
2564 array($theType => $theDat),
2569 $formPrefix.'['.$key.'][el]['.$cc.']',
2579 // Now, we generate "templates" for new elements that could be added to this section by traversing all possible types of content inside the section:
2580 // We have to handle the fact that requiredElements and such may be set during this rendering process and therefore we save and reset the state of some internal variables - little crude, but works...
2582 // Preserving internal variables we don't want to change:
2583 $TEMP_requiredElements = $this->requiredElements
;
2585 // Traversing possible types of new content in the section:
2586 $newElementsLinks = array();
2587 foreach($value['el'] as $nnKey => $nCfg) {
2588 $additionalJS_post_saved = $this->additionalJS_post
;
2589 $this->additionalJS_post
= array();
2590 $additionalJS_submit_saved = $this->additionalJS_submit
;
2591 $this->additionalJS_submit
= array();
2592 $newElementTemplate = $this->getSingleField_typeFlex_draw(
2593 array($nnKey => $nCfg),
2599 $formPrefix.'['.$key.'][el]['.$idTagPrefix.'-form]',
2604 // Makes a "Add new" link:
2605 $var = uniqid('idvar');
2606 $replace = 'replace(/' . $idTagPrefix . '-/g,"' . $idTagPrefix . '"+' . $var . '+"-")';
2607 $onClickInsert = 'var ' . $var . ' = "' . $idTagPrefix . '-idx"+(new Date()).getTime();';
2608 // Do not replace $isTagPrefix in setActionStatus() because it needs section id!
2609 $onClickInsert .= 'new Insertion.Bottom($("'.$idTagPrefix.'"), unescape("'.rawurlencode($newElementTemplate).'").' . $replace . '); setActionStatus("'.$idTagPrefix.'");';
2610 $onClickInsert .= 'eval(unescape("' . rawurlencode(implode(';', $this->additionalJS_post
)) . '").' . $replace . ');';
2611 $onClickInsert .= 'TBE_EDITOR.addActionChecks("submit", unescape("' . rawurlencode(implode(';', $this->additionalJS_submit
)) . '").' . $replace . ');';
2612 $onClickInsert .= 'return false;';
2613 // Kasper's comment (kept for history): Maybe there is a better way to do this than store the HTML for the new element in rawurlencoded format - maybe it even breaks with certain charsets? But for now this works...
2614 $this->additionalJS_post
= $additionalJS_post_saved;
2615 $this->additionalJS_submit
= $additionalJS_submit_saved;
2616 $new = $GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:cm.new', 1);
2617 $newElementsLinks[]= '<a href="#" onclick="'.htmlspecialchars($onClickInsert).'">
2618 <img'.t3lib_iconWorks
::skinImg($this->backPath
,'gfx/new_el.gif','width="11" height="12"').' alt="' . $new . '" title="' . $new . '" align="absmiddle" />' .
2619 htmlspecialchars(t3lib_div
::fixed_lgd_cs($this->sL($nCfg['tx_templavoila']['title']),30)) . '</a>';
2622 // Reverting internal variables we don't want to change: