[BUGFIX] Some methods in t3lib_TSparser should be static
[Packages/TYPO3.CMS.git] / t3lib / class.t3lib_befunc.php
index 5dee78e..3690b47 100644 (file)
  *
  *  This copyright notice MUST APPEAR in all copies of the script!
  ***************************************************************/
+
 /**
  * Standard functions available for the TYPO3 backend.
  * You are encouraged to use this class in your own applications (Backend Modules)
+ * Don't instantiate - call functions with "t3lib_BEfunc::" prefixed the function name.
  *
  * Call ALL methods without making an object!
  * Eg. to get a page-record 51 do this: 't3lib_BEfunc::getRecord('pages',51)'
  *
- * Usage counts are based on search 22/2 2003 through whole backend source of typo3/
- * Revised for TYPO3 3.6 July/2003 by Kasper Skårhøj
- * XHTML compliant
- *
- * @author     Kasper Skårhøj <kasperYYYY@typo3.com>
- */
-/**
- * [CLASS/FUNCTION INDEX of SCRIPT]
- *
- *
- *
- *  185: class t3lib_BEfunc
- *
- *                       SECTION: SQL-related, selecting records, searching
- *  206:        function deleteClause($table,$tableAlias='')
- *  230:        function getRecord($table,$uid,$fields='*',$where='',$useDeleteClause=TRUE)
- *  253:        function getRecordWSOL($table,$uid,$fields='*',$where='',$useDeleteClause=TRUE)
- *  286:        function getRecordRaw($table,$where='',$fields='*')
- *  309:        function getRecordsByField($theTable,$theField,$theValue,$whereClause='',$groupBy='',$orderBy='',$limit='',$useDeleteClause=TRUE)
- *  342:        function searchQuery($searchWords,$fields,$table='')
- *  357:        function listQuery($field,$value)
- *  369:        function splitTable_Uid($str)
- *  384:        function getSQLselectableList($in_list,$tablename,$default_tablename)
- *  412:        function BEenableFields($table,$inv=0)
- *
- *                       SECTION: SQL-related, DEPRECATED functions
- *  476:        function mm_query($select,$local_table,$mm_table,$foreign_table,$whereClause='',$groupBy='',$orderBy='',$limit='')
- *  498:        function DBcompileInsert($table,$fields_values)
- *  512:        function DBcompileUpdate($table,$where,$fields_values)
- *
- *                       SECTION: Page tree, TCA related
- *  542:        function BEgetRootLine($uid,$clause='',$workspaceOL=FALSE)
- *  598:        function openPageTree($pid,$clearExpansion)
- *  643:        function getRecordPath($uid, $clause, $titleLimit, $fullTitleLimit=0)
- *  686:        function getExcludeFields()
- *  716:        function getExplicitAuthFieldValues()
- *  787:        function getSystemLanguages()
- *  812:        function readPageAccess($id,$perms_clause)
- *  843:        function getTCAtypes($table,$rec,$useFieldNameAsKey=0)
- *  896:        function getTCAtypeValue($table,$rec)
- *  919:        function getSpecConfParts($str, $defaultExtras)
- *  950:        function getSpecConfParametersFromArray($pArr)
- *  978:        function getFlexFormDS($conf,$row,$table,$fieldName='',$WSOL=TRUE)
- *
- *                       SECTION: Caching related
- * 1105:        function storeHash($hash,$data,$ident)
- * 1125:        function getHash($hash)
- *
- *                       SECTION: TypoScript related
- * 1161:        function getPagesTSconfig($id,$rootLine='',$returnPartArray=0)
- * 1217:        function updatePagesTSconfig($id,$pageTS,$TSconfPrefix,$impParams='')
- * 1272:        function implodeTSParams($p,$k='')
- *
- *                       SECTION: Users / Groups related
- * 1309:        function getUserNames($fields='username,usergroup,usergroup_cached_list,uid',$where='')
- * 1327:        function getGroupNames($fields='title,uid', $where='')
- * 1344:        function getListGroupNames($fields='title,uid')
- * 1363:        function blindUserNames($usernames,$groupArray,$excludeBlindedFlag=0)
- * 1396:        function blindGroupNames($groups,$groupArray,$excludeBlindedFlag=0)
- *
- *                       SECTION: Output related
- * 1437:        function daysUntil($tstamp)
- * 1449:        function date($tstamp)
- * 1460:        function datetime($value)
- * 1472:        function time($value)
- * 1488:        function calcAge($seconds,$labels = ' min| hrs| days| yrs| min| hour| day| year')
- * 1514:        function dateTimeAge($tstamp,$prefix=1,$date='')
- * 1532:        function titleAttrib($content='',$hsc=0)
- * 1545:        function titleAltAttrib($content)
- * 1569:        function thumbCode($row,$table,$field,$backPath,$thumbScript='',$uploaddir=NULL,$abs=0,$tparams='',$size='')
- * 1637:        function getThumbNail($thumbScript,$theFile,$tparams='',$size='')
- * 1654:        function titleAttribForPages($row,$perms_clause='',$includeAttrib=1)
- * 1716:        function getRecordIconAltText($row,$table='pages')
- * 1758:        function getLabelFromItemlist($table,$col,$key)
- * 1784:        function getItemLabel($table,$col,$printAllWrap='')
- * 1809:        function getRecordTitle($table,$row,$prep=0)
- * 1847:        function getProcessedValue($table,$col,$value,$fixed_lgd_chars=0,$defaultPassthrough=0,$noRecordLookup=FALSE,$uid=0)
- * 2009:        function getProcessedValueExtra($table,$fN,$fV,$fixed_lgd_chars=0,$uid=0)
- * 2033:        function getFileIcon($ext)
- * 2047:        function getCommonSelectFields($table,$prefix='')
- * 2090:        function makeConfigForm($configArray,$defaults,$dataPrefix)
- *
- *                       SECTION: Backend Modules API functions
- * 2165:        function helpTextIcon($table,$field,$BACK_PATH,$force=0)
- * 2187:        function helpText($table,$field,$BACK_PATH,$styleAttrib='')
- * 2239:        function cshItem($table,$field,$BACK_PATH,$wrap='',$onlyIconMode=FALSE, $styleAttrib='')
- * 2277:        function editOnClick($params,$backPath='',$requestUri='')
- * 2296:        function viewOnClick($id,$backPath='',$rootLine='',$anchor='',$altUrl='',$additionalGetVars='',$switchFocus=TRUE)
- * 2328:        function getModTSconfig($id,$TSref)
- * 2349:        function getFuncMenu($mainParams,$elementName,$currentValue,$menuItems,$script='',$addparams='')
- * 2392:        function getFuncCheck($mainParams,$elementName,$currentValue,$script='',$addparams='',$tagParams='')
- * 2417:        function getFuncInput($mainParams,$elementName,$currentValue,$size=10,$script="",$addparams="")
- * 2438:        function unsetMenuItems($modTSconfig,$itemArray,$TSref)
- * 2461:        function getSetUpdateSignal($set='')
- * 2512:        function getModuleData($MOD_MENU, $CHANGED_SETTINGS, $modName, $type='', $dontValidateList='', $setDefaultList='')
- *
- *                       SECTION: Core
- * 2585:        function compilePreviewKeyword($getVarsStr, $beUserUid, $ttl=172800)
- * 2613:        function lockRecords($table='',$uid=0,$pid=0)
- * 2642:        function isRecordLocked($table,$uid)
- * 2682:        function exec_foreign_table_where_query($fieldValue,$field='',$TSconfig=array(),$prefix='')
- * 2763:        function getTCEFORM_TSconfig($table,$row)
- * 2814:        function getTSconfig_pidValue($table,$uid,$pid)
- * 2844:        function getPidForModTSconfig($table,$uid,$pid)
- * 2860:        function getTSCpid($table,$uid,$pid)
- * 2876:        function firstDomainRecord($rootLine)
- * 2898:        function getDomainStartPage($domain, $path='')
- * 2928:        function RTEsetup($RTEprop,$table,$field,$type='')
- * 2947:        function &RTEgetObj()
- * 2986:        function &softRefParserObj($spKey)
- * 3018:        function explodeSoftRefParserList($parserList)
- * 3050:        function isModuleSetInTBE_MODULES($modName)
- * 3073:        function referenceCount($table,$ref,$msg='')
- *
- *                       SECTION: Workspaces / Versioning
- * 3132:        function selectVersionsOfRecord($table, $uid, $fields='*', $workspace=0)
- * 3180:        function fixVersioningPid($table,&$rr,$ignoreWorkspaceMatch=FALSE)
- * 3220:        function workspaceOL($table,&$row,$wsid=-99)
- * 3268:        function getWorkspaceVersionOfRecord($workspace, $table, $uid, $fields='*')
- * 3297:        function getLiveVersionOfRecord($table,$uid,$fields='*')
- * 3319:        function isPidInVersionizedBranch($pid, $table='',$returnStage=FALSE)
- * 3342:        function versioningPlaceholderClause($table)
- * 3356:        function countVersionsOfRecordsOnPage($workspace,$pageId, $allTables=FALSE)
- * 3391:        function wsMapId($table,$uid)
- *
- *                       SECTION: Miscellaneous
- * 3421:        function typo3PrintError($header,$text,$js='',$head=1)
- * 3465:        function TYPO3_copyRightNotice()
- * 3489:        function displayWarningMessages()
- * 3546:        function getPathType_web_nonweb($path)
- * 3558:        function ADMCMD_previewCmds($pageinfo)
- * 3580:        function processParams($params)
- * 3606:        function getListOfBackendModules($name,$perms_clause,$backPath='',$script='index.php')
- *
- * TOTAL FUNCTIONS: 99
- * (This index is automatically created/updated by the extension "extdeveval")
- *
- */
-
-
-/**
- * Standard functions available for the TYPO3 backend.
- * Don't instantiate - call functions with "t3lib_BEfunc::" prefixed the function name.
- *
- * @author     Kasper Skårhøj <kasperYYYY@typo3.com>
+ * @author Kasper Skårhøj <kasperYYYY@typo3.com>
  * @package TYPO3
  * @subpackage t3lib
  */
 final class t3lib_BEfunc {
 
-
        /*******************************************
         *
         * SQL-related, selecting records, searching
@@ -193,7 +50,6 @@ final class t3lib_BEfunc {
         * Returns the WHERE clause " AND NOT [tablename].[deleted-field]" if a deleted-field is configured in $GLOBALS['TCA'] for the tablename, $table
         * This function should ALWAYS be called in the backend for selection on tables which are configured in $GLOBALS['TCA'] since it will ensure consistent selection of records, even if they are marked deleted (in which case the system must always treat them as non-existent!)
         * In the frontend a function, ->enableFields(), is known to filter hidden-field, start- and endtime and fe_groups as well. But that is a job of the frontend, not the backend. If you need filtering on those fields as well in the backend you can use ->BEenableFields() though.
-        * Usage: 71
         *
         * @param       string          Table name present in $GLOBALS['TCA']
         * @param       string          Table alias if any
@@ -213,7 +69,6 @@ final class t3lib_BEfunc {
         * Additional WHERE clauses can be added by $where (fx. ' AND blabla = 1')
         * Will automatically check if records has been deleted and if so, not return anything.
         * $table must be found in $GLOBALS['TCA']
-        * Usage: 99
         *
         * @param       string          Table name present in $GLOBALS['TCA']
         * @param       integer         UID of record
@@ -274,7 +129,6 @@ final class t3lib_BEfunc {
         * $table does NOT need to be configured in $GLOBALS['TCA']
         * The query used is simply this:
         * $query = 'SELECT '.$fields.' FROM '.$table.' WHERE '.$where;
-        * Usage: 5 (ext: sys_todos)
         *
         * @param       string          Table name (not necessarily in TCA)
         * @param       string          WHERE clause
@@ -294,7 +148,6 @@ final class t3lib_BEfunc {
         * Returns records from table, $theTable, where a field ($theField) equals the value, $theValue
         * The records are returned in an array
         * If no records were selected, the function returns nothing
-        * Usage: 8
         *
         * @param       string          Table name present in $GLOBALS['TCA']
         * @param       string          Field to select on
@@ -333,7 +186,6 @@ final class t3lib_BEfunc {
        /**
         * Makes an backwards explode on the $str and returns an array with ($table, $uid).
         * Example: tt_content_45 => array('tt_content', 45)
-        * Usage: 1
         *
         * @param       string          [tablename]_[uid] string to explode
         * @return      array
@@ -346,7 +198,6 @@ final class t3lib_BEfunc {
        /**
         * Returns a list of pure integers based on $in_list being a list of records with table-names prepended.
         * Ex: $in_list = "pages_4,tt_content_12,45" would result in a return value of "4,45" if $tablename is "pages" and $default_tablename is 'pages' as well.
-        * Usage: 1 (t3lib_userauthgroup)
         *
         * @param       string          Input list
         * @param       string          Table name from which ids is returned
@@ -377,7 +228,6 @@ final class t3lib_BEfunc {
         * Notice that "fe_groups" is not selected for - only disabled, starttime and endtime.
         * Notice that deleted-fields are NOT filtered - you must ALSO call deleteClause in addition.
         * $GLOBALS["SIM_ACCESS_TIME"] is used for date.
-        * Usage: 5
         *
         * @param       string          $table is the table from which to return enableFields WHERE clause. Table name must have a 'ctrl' section in $GLOBALS['TCA'].
         * @param       boolean         $inv means that the query will select all records NOT VISIBLE records (inverted selection)
@@ -448,7 +298,6 @@ final class t3lib_BEfunc {
         * Returns what is called the 'RootLine'. That is an array with information about the page records from a page id ($uid) and back to the root.
         * By default deleted pages are filtered.
         * This RootLine will follow the tree all the way to the root. This is opposite to another kind of root line known from the frontend where the rootline stops when a root-template is found.
-        * Usage: 1
         *
         * @param       integer         Page id for which to create the root line.
         * @param       string          $clause can be used to select other criteria. It would typically be where-clauses that stops the process if we meet a page, the user has no reading access to.
@@ -589,7 +438,6 @@ final class t3lib_BEfunc {
         * Returns the path (visually) of a page $uid, fx. "/First page/Second page/Another subpage"
         * Each part of the path will be limited to $titleLimit characters
         * Deleted pages are filtered out.
-        * Usage: 15
         *
         * @param       integer         Page uid for which to create record path
         * @param       string          $clause is additional where clauses, eg. "
@@ -634,7 +482,6 @@ final class t3lib_BEfunc {
        /**
         * Returns an array with the exclude-fields as defined in TCA and FlexForms
         * Used for listing the exclude-fields in be_groups forms
-        * Usage: 2 (t3lib_tceforms + t3lib_transferdata)
         *
         * @return      array           Array of arrays with excludeFields (fieldname, table:fieldname) from all TCA entries and from FlexForms (fieldname, table:extkey;sheetname;fieldname)
         */
@@ -836,7 +683,6 @@ final class t3lib_BEfunc {
         * Returns a page record (of page with $id) with an extra field "_thePath" set to the record path IF the WHERE clause, $perms_clause, selects the record. Thus is works as an access check that returns a page record if access was granted, otherwise not.
         * If $id is zero a pseudo root-page with "_thePath" set is returned IF the current BE_USER is admin.
         * In any case ->isInWebMount must return TRUE for the user (regardless of $perms_clause)
-        * Usage: 21
         *
         * @param       integer         Page uid for which to check read-access
         * @param       string          $perms_clause is typically a value generated with $GLOBALS['BE_USER']->getPagePermsClause(1);
@@ -868,7 +714,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns the "types" configuration parsed into an array for the record, $rec, from table, $table
-        * Usage: 6
         *
         * @param       string          Table name (present in TCA)
         * @param       array           Record from $table
@@ -919,7 +764,6 @@ final class t3lib_BEfunc {
         * Returns the "type" value of $rec from $table which can be used to look up the correct "types" rendering section in $GLOBALS['TCA']
         * If no "type" field is configured in the "ctrl"-section of the $GLOBALS['TCA'] for the table, zero is used.
         * If zero is not an index in the "types" section of $GLOBALS['TCA'] for the table, then the $fieldValue returned will default to 1 (no matter if that is an index or not)
-        * Usage: 7
         *
         * @param       string          Table name present in TCA
         * @param       array           Record from $table
@@ -944,7 +788,6 @@ final class t3lib_BEfunc {
         * Parses a part of the field lists in the "types"-section of $GLOBALS['TCA'] arrays, namely the "special configuration" at index 3 (position 4)
         * Elements are splitted by ":" and within those parts, parameters are splitted by "|".
         * Everything is returned in an array and you should rather see it visually than listen to me anymore now...  Check out example in Inside TYPO3
-        * Usage: 5
         *
         * @param       string          Content from the "types" configuration of TCA (the special configuration) - see description of function
         * @param       string          The ['defaultExtras'] value from field configuration
@@ -976,7 +819,6 @@ final class t3lib_BEfunc {
        /**
         * Takes an array of "[key] = [value]" strings and returns an array with the keys set as keys pointing to the value.
         * Better see it in action! Find example in Inside TYPO3
-        * Usage: 6
         *
         * @param       array           Array of "[key] = [value]" strings to convert.
         * @return      array
@@ -999,7 +841,6 @@ final class t3lib_BEfunc {
        /**
         * Finds the Data Structure for a FlexForm field
         * NOTE ON data structures for deleted records: This function may fail to deliver the data structure for a record for a few reasons: a) The data structure could be deleted (either with deleted-flagged or hard-deleted), b) the data structure is fetched using the ds_pointerField_searchParent in which case any deleted record on the route to the final location of the DS will make it fail. In theory, we can solve the problem in the case where records that are deleted-flagged keeps us from finding the DS - this is done at the markers ###NOTE_A### where we make sure to also select deleted records. However, we generally want the DS lookup to fail for deleted records since for the working website we expect a deleted-flagged record to be as inaccessible as one that is completely deleted from the DB. Any way we look at it, this may lead to integrity problems of the reference index and even lost files if attached. However, that is not really important considering that a single change to a data structure can instantly invalidate large amounts of the reference index which we do accept as a cost for the flexform features. Other than requiring a reference index update, deletion of/changes in data structure or the failure to look them up when completely deleting records may lead to lost files in the uploads/ folders since those are now without a proper reference.
-        * Usage: 5
         *
         * @param       array           Field config array
         * @param       array           Record data
@@ -1096,7 +937,7 @@ final class t3lib_BEfunc {
 
                                // If there is a srcPointer value:
                        if ($srcPointer) {
-                               if (t3lib_div::testInt($srcPointer)) { // If integer, then its a record we will look up:
+                               if (t3lib_utility_Math::canBeInterpretedAsInteger($srcPointer)) { // If integer, then its a record we will look up:
                                        list($tName, $fName) = explode(':', $ds_tableField, 2);
                                        if ($tName && $fName && is_array($GLOBALS['TCA'][$tName])) {
                                                $dataStructRec = self::getRecord($tName, $srcPointer);
@@ -1143,7 +984,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns all registered FlexForm definitions with title and fields
-        * Usage: 1
         *
         * @param       string          The content table
         * @return      array           The data structures with speaking extension title
@@ -1236,7 +1076,6 @@ final class t3lib_BEfunc {
         * Stores the string value $data in the 'cache_hash' cache with the
         * hash key, $hash, and visual/symbolic identification, $ident
         * IDENTICAL to the function by same name found in t3lib_page:
-        * Usage: 2
         *
         * @param       string          32 bit hash string (eg. a md5 hash of a serialized array identifying the data being stored)
         * @param       string          The data string. If you want to store an array, then just serialize it first.
@@ -1280,7 +1119,6 @@ final class t3lib_BEfunc {
        /**
         * Returns the Page TSconfig for page with id, $id
         * Requires class "t3lib_TSparser"
-        * Usage: 26 (spec. in ext info_pagetsconfig)
         *
         * @param       integer         Page uid for which to create Page TSconfig
         * @param       array           If $rootLine is an array, that is used as rootline, otherwise rootline is just calculated
@@ -1343,8 +1181,6 @@ final class t3lib_BEfunc {
         * THIS DOES NOT CHECK ANY PERMISSIONS. SHOULD IT?
         * More documentation is needed.
         *
-        * Usage: 1 (ext. direct_mail)
-        *
         * @param       integer         Page id
         * @param       array           Page TS array to write
         * @param       string          Prefix for object paths
@@ -1399,7 +1235,6 @@ final class t3lib_BEfunc {
 
        /**
         * Implodes a multi dimensional TypoScript array, $p, into a one-dimentional array (return value)
-        * Usage: 3
         *
         * @param       array           TypoScript structure
         * @param       string          Prefix string
@@ -1429,7 +1264,6 @@ final class t3lib_BEfunc {
        /**
         * Returns an array with be_users records of all user NOT DELETED sorted by their username
         * Keys in the array is the be_users uid
-        * Usage: 14 (spec. ext. "beuser" and module "web_perm")
         *
         * @param       string          Optional $fields list (default: username,usergroup,usergroup_cached_list,uid) can be used to set the selected fields
         * @param       string          Optional $where clause (fx. "AND username='pete'") can be used to limit query
@@ -1449,7 +1283,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns an array with be_groups records (title, uid) of all groups NOT DELETED sorted by their title
-        * Usage: 8 (spec. ext. "beuser" and module "web_perm")
         *
         * @param       string          Field list
         * @param       string          WHERE clause
@@ -1470,7 +1303,6 @@ final class t3lib_BEfunc {
        /**
         * Returns an array with be_groups records (like ->getGroupNames) but:
         * - if the current BE_USER is admin, then all groups are returned, otherwise only groups that the current user is member of (usergroup_cached_list) will be returned.
-        * Usage: 2 (module "web_perm" and ext. taskcenter)
         *
         * @param       string          Field list; $fields specify the fields selected (default: title,uid)
         * @return      array
@@ -1487,7 +1319,6 @@ final class t3lib_BEfunc {
         * Returns the array $usernames with the names of all users NOT IN $groupArray changed to the uid (hides the usernames!).
         * If $excludeBlindedFlag is set, then these records are unset from the array $usernames
         * Takes $usernames (array made by t3lib_BEfunc::getUserNames()) and a $groupArray (array with the groups a certain user is member of) as input
-        * Usage: 8
         *
         * @param       array           User names
         * @param       array           Group names
@@ -1521,7 +1352,6 @@ final class t3lib_BEfunc {
 
        /**
         * Corresponds to blindUserNames but works for groups instead
-        * Usage: 2 (module web_perm)
         *
         * @param       array           Group names
         * @param       array           Group names (reference)
@@ -1555,7 +1385,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns the difference in days between input $tstamp and $EXEC_TIME
-        * Usage: 2 (class t3lib_BEfunc)
         *
         * @param       integer         Time stamp, seconds
         * @return      integer
@@ -1567,7 +1396,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns $tstamp formatted as "ddmmyy" (According to $GLOBALS['TYPO3_CONF_VARS']['SYS']['ddmmyy'])
-        * Usage: 11
         *
         * @param       integer         Time stamp, seconds
         * @return      string          Formatted time
@@ -1578,7 +1406,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns $tstamp formatted as "ddmmyy hhmm" (According to $GLOBALS['TYPO3_CONF_VARS']['SYS']['ddmmyy'] AND $GLOBALS['TYPO3_CONF_VARS']['SYS']['hhmm'])
-        * Usage: 28
         *
         * @param       integer         Time stamp, seconds
         * @return      string          Formatted time
@@ -1590,7 +1417,6 @@ final class t3lib_BEfunc {
        /**
         * Returns $value (in seconds) formatted as hh:mm:ss
         * For instance $value = 3600 + 60*2 + 3 should return "01:02:03"
-        * Usage: 1 (class t3lib_BEfunc)
         *
         * @param       integer         Time stamp, seconds
         * @param       boolean         Output hh:mm:ss. If FALSE: hh:mm
@@ -1609,7 +1435,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns the "age" in minutes / hours / days / years of the number of $seconds inputted.
-        * Usage: 15
         *
         * @param       integer         $seconds could be the difference of a certain timestamp and time()
         * @param       string          $labels should be something like ' min| hrs| days| yrs| min| hour| day| year'. This value is typically delivered by this function call: $GLOBALS["LANG"]->sL("LLL:EXT:lang/locallang_core.php:labels.minutesHoursDaysYears")
@@ -1638,7 +1463,6 @@ final class t3lib_BEfunc {
        /**
         * Returns a formatted timestamp if $tstamp is set.
         * The date/datetime will be followed by the age in parenthesis.
-        * Usage: 3
         *
         * @param       integer         Time stamp, seconds
         * @param       integer         1/-1 depending on polarity of age.
@@ -1654,7 +1478,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns alt="" and title="" attributes with the value of $content.
-        * Usage: 7
         *
         * @param       string          Value for 'alt' and 'title' attributes (will be htmlspecialchars()'ed before output)
         * @return      string
@@ -1670,7 +1493,6 @@ final class t3lib_BEfunc {
         * Returns a linked image-tag for thumbnail(s)/fileicons/truetype-font-previews from a database row with a list of image files in a field
         * All $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] extension are made to thumbnails + ttf file (renders font-example)
         * Thumbsnails are linked to the show_item.php script which will display further details.
-        * Usage: 7
         *
         * @param       array           $row is the database row from the table, $table.
         * @param       string          Table name for $row (present in TCA)
@@ -1776,7 +1598,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns single image tag to thumbnail using a thumbnail script (like thumbs.php)
-        * Usage: 3
         *
         * @param       string          $thumbScript must point to "thumbs.php" relative to the script position
         * @param       string          $theFile must be the proper reference to the file thumbs.php should show
@@ -1797,7 +1618,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns title-attribute information for a page-record informing about id, alias, doktype, hidden, starttime, endtime, fe_group etc.
-        * Usage: 8
         *
         * @param       array           Input must be a page row ($row) with the proper fields set (be sure - send the full range of fields for the table)
         * @param       string          $perms_clause is used to get the record path of the shortcut page, if any (and doktype==4)
@@ -1838,8 +1658,9 @@ final class t3lib_BEfunc {
                        if ($perms_clause) {
                                $label = self::getRecordPath(intval($row['shortcut']), $perms_clause, 20);
                        } else {
-                               $lRec = self::getRecordWSOL('pages', intval($row['shortcut']), 'title');
-                               $label = $lRec['title'];
+                               $row['shortcut'] = intval($row['shortcut']);
+                               $lRec = self::getRecordWSOL('pages', $row['shortcut'], 'title');
+                               $label = $lRec['title'] . ' (id=' . $row['shortcut'] . ')';
                        }
                        if ($row['shortcut_mode'] != t3lib_pageSelect::SHORTCUT_MODE_NONE) {
                                $label .= ', ' . $GLOBALS['LANG']->sL($GLOBALS['TCA']['pages']['columns']['shortcut_mode']['label']) . ' ' .
@@ -1891,7 +1712,6 @@ final class t3lib_BEfunc {
         * Returns title-attribute information for ANY record (from a table defined in TCA of course)
         * The included information depends on features of the table, but if hidden, starttime, endtime and fe_group fields are configured for, information about the record status in regard to these features are is included.
         * "pages" table can be used as well and will return the result of ->titleAttribForPages() for that page.
-        * Usage: 10
         *
         * @param       array           Table row; $row is a row from the table, $table
         * @param       string          Table name
@@ -1951,7 +1771,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns the label of the first found entry in an "items" array from $GLOBALS['TCA'] (tablename = $table/fieldname = $col) where the value is $key
-        * Usage: 9
         *
         * @param       string          Table name, present in $GLOBALS['TCA']
         * @param       string          Field name, present in $GLOBALS['TCA']
@@ -1977,7 +1796,6 @@ final class t3lib_BEfunc {
        /**
         * Returns the label-value for fieldname $col in table, $table
         * If $printAllWrap is set (to a "wrap") then it's wrapped around the $col value IF THE COLUMN $col DID NOT EXIST in TCA!, eg. $printAllWrap = '<strong>|</strong>' and the fieldname was 'not_found_field' then the return value would be '<strong>not_found_field</strong>'
-        * Usage: 17
         *
         * @param       string          Table name, present in $GLOBALS['TCA']
         * @param       string          Field name
@@ -2001,7 +1819,6 @@ final class t3lib_BEfunc {
        /**
         * Returns the "title"-value in record, $row, from table, $table
         * The field(s) from which the value is taken is determined by the "ctrl"-entries 'label', 'label_alt' and 'label_alt_force'
-        * Usage: 26
         *
         * @param       string          Table name, present in TCA
         * @param       array           Row from table
@@ -2071,7 +1888,7 @@ final class t3lib_BEfunc {
         */
        public static function getRecordTitlePrep($title, $titleLength = 0) {
                        // If $titleLength is not a valid positive integer, use BE_USER->uc['titleLen']:
-               if (!$titleLength || !t3lib_div::testInt($titleLength) || $titleLength < 0) {
+               if (!$titleLength || !t3lib_utility_Math::canBeInterpretedAsInteger($titleLength) || $titleLength < 0) {
                        $titleLength = $GLOBALS['BE_USER']->uc['titleLen'];
                }
                $titleOrig = htmlspecialchars($title);
@@ -2102,7 +1919,6 @@ final class t3lib_BEfunc {
         * For instance a database record relation would be looked up to display the title-value of that record. A checkbox with a "1" value would be "Yes", etc.
         * $table/$col is tablename and fieldname
         * REMEMBER to pass the output through htmlspecialchars() if you output it to the browser! (To protect it from XSS attacks and be XHTML compliant)
-        * Usage: 24
         *
         * @param       string          Table name, present in TCA
         * @param       string          Field name, present in TCA
@@ -2228,24 +2044,28 @@ final class t3lib_BEfunc {
                                        }
                                        break;
                                case 'input':
-                                               // currently, this feature does not show "0" or the date
-                                               // "1970-01-01", but this is a DB limitation, as we cannot
-                                               // differentiate between "0" and "NULL" in the DB
-                                               // however, this solution is the most "user-friendly" for
-                                               // 99.9% percent of all use-cases.
-                                       if (!empty($value)) {
+                                               // hide value 0 for dates, but show it for everything else
+                                       if (isset($value)) {
                                                if (t3lib_div::inList($theColConf['eval'], 'date')) {
-                                                       $l = self::date($value) .
-                                                               ' (' .
-                                                               ($GLOBALS['EXEC_TIME'] - $value > 0 ? '-' : '') .
-                                                               self::calcAge(abs($GLOBALS['EXEC_TIME'] - $value), $GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.minutesHoursDaysYears')) .
-                                                               ')';
+                                                       if (!empty($value)) {
+                                                               $l = self::date($value) .
+                                                                       ' (' .
+                                                                       ($GLOBALS['EXEC_TIME'] - $value > 0 ? '-' : '') .
+                                                                       self::calcAge(abs($GLOBALS['EXEC_TIME'] - $value), $GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.minutesHoursDaysYears')) .
+                                                                       ')';
+                                                       }
                                                } elseif (t3lib_div::inList($theColConf['eval'], 'time')) {
-                                                       $l = self::time($value, FALSE);
+                                                       if (!empty($value)) {
+                                                               $l = self::time($value, FALSE);
+                                                       }
                                                } elseif (t3lib_div::inList($theColConf['eval'], 'timesec')) {
-                                                       $l = self::time($value);
+                                                       if (!empty($value)) {
+                                                               $l = self::time($value);
+                                                       }
                                                } elseif (t3lib_div::inList($theColConf['eval'], 'datetime')) {
-                                                       $l = self::datetime($value);
+                                                       if (!empty($value)) {
+                                                               $l = self::datetime($value);
+                                                       }
                                                } else {
                                                        $l = $value;
                                                }
@@ -2299,7 +2119,6 @@ final class t3lib_BEfunc {
 
        /**
         * Same as ->getProcessedValue() but will go easy on fields like "tstamp" and "pid" which are not configured in TCA - they will be formatted by this function instead.
-        * Usage: 2
         *
         * @param       string          Table name, present in TCA
         * @param       string          Field name
@@ -2328,7 +2147,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns file icon name (from $FILEICONS) for the fileextension $ext
-        * Usage: 10
         *
         * @param       string          File extension, lowercase
         * @return      string          File icon filename
@@ -2341,7 +2159,6 @@ final class t3lib_BEfunc {
         * Returns fields for a table, $table, which would typically be interesting to select
         * This includes uid, the fields defined for title, icon-field.
         * Returned as a list ready for query ($prefix can be set to eg. "pages." if you are selecting from the pages table and want the table name prefixed)
-        * Usage: 3
         *
         * @param       string          Table name, present in $GLOBALS['TCA']
         * @param       string          Table prefix
@@ -2394,7 +2211,6 @@ final class t3lib_BEfunc {
         * Makes a form for configuration of some values based on configuration found in the array $configArray, with default values from $defaults and a data-prefix $dataPrefix
         * <form>-tags must be supplied separately
         * Needs more documentation and examples, in particular syntax for configuration array. See Inside TYPO3. That's were you can expect to find example, if anywhere.
-        * Usage: 1 (ext. direct_mail)
         *
         * @param       array           Field configuration code.
         * @param       array           Defaults
@@ -2460,7 +2276,6 @@ final class t3lib_BEfunc {
         * Returns help-text icon if configured for.
         * TCA_DESCR must be loaded prior to this function and $GLOBALS['BE_USER'] must
         * have 'edit_showFieldHelp' set to 'icon', otherwise nothing is returned
-        * Usage: 6
         *
         * Please note: since TYPO3 4.5 the UX team decided to not use CSH in its former way,
         * but to wrap the given text (where before the help icon was, and you could hover over it)
@@ -2522,7 +2337,6 @@ final class t3lib_BEfunc {
         * $GLOBALS['TCA_DESCR'] must be loaded prior to this function and $GLOBALS['BE_USER'] must have "edit_showFieldHelp" set to "text",
         * otherwise nothing is returned
         * Will automatically call t3lib_BEfunc::helpTextIcon() to get the icon for the text.
-        * Usage: 4
         *
         * @param       string          Table name
         * @param       string          Field name
@@ -2608,7 +2422,6 @@ final class t3lib_BEfunc {
        /**
         * API for getting CSH icons/text for use in backend modules.
         * TCA_DESCR will be loaded if it isn't already
-        * Usage: ?
         *
         * @param       string          Table name ('_MOD_'+module name)
         * @param       string          Field name (CSH locallang main key)
@@ -2660,7 +2473,6 @@ final class t3lib_BEfunc {
        /**
         * Returns a JavaScript string (for an onClick handler) which will load the alt_doc.php script that shows the form for editing of the record(s) you have send as params.
         * REMEMBER to always htmlspecialchar() content in href-properties to ampersands get converted to entities (XHTML requirement and XSS precaution)
-        * Usage: 35
         *
         * @param       string          $params is parameters sent along to alt_doc.php. This requires a much more details description which you must seek in Inside TYPO3s documentation of the alt_doc.php API. And example could be '&edit[pages][123] = edit' which will show edit form for page record 123.
         * @param       string          $backPath must point back to the TYPO3_mainDir directory (where alt_doc.php is)
@@ -2676,7 +2488,6 @@ final class t3lib_BEfunc {
        /**
         * Returns a JavaScript string for viewing the page id, $id
         * It will detect the correct domain name if needed and provide the link with the right back path. Also it will re-use any window already open.
-        * Usage: 8
         *
         * @param       integer         $pageUid is page id
         * @param       string          $backPath must point back to TYPO3_mainDir (where the site is assumed to be one level above)
@@ -2781,7 +2592,6 @@ final class t3lib_BEfunc {
        /**
         * Returns the merged User/Page TSconfig for page id, $id.
         * Please read details about module programming elsewhere!
-        * Usage: 15
         *
         * @param       integer         Page uid
         * @param       string          $TSref is an object string which determines the path of the TSconfig to return.
@@ -2798,7 +2608,6 @@ final class t3lib_BEfunc {
         * Returns a selector box "function menu" for a module
         * Requires the JS function jumpToUrl() to be available
         * See Inside TYPO3 for details about how to use / make Function menus
-        * Usage: 50
         *
         * @param       mixed           $id is the "&id=" parameter value to be sent to the module, but it can be also a parameter array which will be passed instead of the &id=...
         * @param       string          $elementName it the form elements name, probably something like "SET[...]"
@@ -2843,7 +2652,6 @@ final class t3lib_BEfunc {
        /**
         * Checkbox function menu.
         * Works like ->getFuncMenu() but takes no $menuItem array since this is a simple checkbox.
-        * Usage: 34
         *
         * @param       mixed           $mainParams $id is the "&id=" parameter value to be sent to the module, but it can be also a parameter array which will be passed instead of the &id=...
         * @param       string          $elementName it the form elements name, probably something like "SET[...]"
@@ -2872,7 +2680,6 @@ final class t3lib_BEfunc {
        /**
         * Input field function menu
         * Works like ->getFuncMenu() / ->getFuncCheck() but displays a input field instead which updates the script "onchange"
-        * Usage: 1
         *
         * @param       mixed           $id is the "&id=" parameter value to be sent to the module, but it can be also a parameter array which will be passed instead of the &id=...
         * @param       string          $elementName it the form elements name, probably something like "SET[...]"
@@ -2901,7 +2708,6 @@ final class t3lib_BEfunc {
        /**
         * Removes menu items from $itemArray if they are configured to be removed by TSconfig for the module ($modTSconfig)
         * See Inside TYPO3 about how to program modules and use this API.
-        * Usage: 4
         *
         * @param       array           Module TS config array
         * @param       array           Array of items from which to remove items.
@@ -2924,7 +2730,6 @@ final class t3lib_BEfunc {
        /**
         * Call to update the page tree frame (or something else..?) after
         * use 'updatePageTree' as a first parameter will set the page tree to be updated.
-        * Usage: 10
         *
         * @param       string          Key to set the update signal. When setting, this value contains strings telling WHAT to set. At this point it seems that the value "updatePageTree" is the only one it makes sense to set. If empty, all update signals will be removed.
         * @param       mixed           Additional information for the update signal, used to only refresh a branch of the tree
@@ -2948,7 +2753,6 @@ final class t3lib_BEfunc {
        /**
         * Call to update the page tree frame (or something else..?) if this is set by the function
         * setUpdateSignal(). It will return some JavaScript that does the update (called in the typo3/template.php file, end() function)
-        * Usage: 1
         *
         * @return      string          HTML javascript code
         * @see t3lib_BEfunc::setUpdateSignal()
@@ -3011,7 +2815,6 @@ final class t3lib_BEfunc {
         * This is kind of session variable management framework for the backend users.
         * If a key from MOD_MENU is set in the CHANGED_SETTINGS array (eg. a value is passed to the script from the outside), this value is put into the settings-array
         * Ultimately, see Inside TYPO3 for how to use this function in relation to your modules.
-        * Usage: 23
         *
         * @param       array           MOD_MENU is an array that defines the options in menus.
         * @param       array           CHANGED_SETTINGS represents the array used when passing values to the script from the menus.
@@ -3166,8 +2969,10 @@ final class t3lib_BEfunc {
         * @param       integer         Time-To-Live for keyword
         * @param       integer         Which workspace to preview. Workspace UID, -1 or >0. If set, the getVars is ignored in the frontend, so that string can be empty
         * @return      string          Returns keyword to use in URL for ADMCMD_prev=
+        * @deprecated since TYPO3 4.6, will be removed in TYPO3 4.8, functionality is now in Tx_Version_Preview
         */
        public static function compilePreviewKeyword($getVarsStr, $beUserUid, $ttl = 172800, $fullWorkspace = NULL) {
+               t3lib_div::logDeprecatedFunction();
                $field_array = array(
                        'keyword' => md5(uniqid(microtime())),
                        'tstamp' => $GLOBALS['EXEC_TIME'],
@@ -3187,7 +2992,6 @@ final class t3lib_BEfunc {
        /**
         * Unlock or Lock a record from $table with $uid
         * If $table and $uid is not set, then all locking for the current BE_USER is removed!
-        * Usage: 5
         *
         * @param       string          Table name
         * @param       integer         Record uid
@@ -3218,7 +3022,6 @@ final class t3lib_BEfunc {
        /**
         * Returns information about whether the record from table, $table, with uid, $uid is currently locked (edited by another user - which should issue a warning).
         * Notice: Locking is not strictly carried out since locking is abandoned when other backend scripts are activated - which means that a user CAN have a record "open" without having it locked. So this just serves as a warning that counts well in 90% of the cases, which should be sufficient.
-        * Usage: 5
         *
         * @param       string          Table name
         * @param       integer         Record uid
@@ -3275,7 +3078,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns select statement for MM relations (as used by TCEFORMs etc)
-        * Usage: 3
         *
         * @param       array           Configuration array for the field, taken from $GLOBALS['TCA']
         * @param       string          Field name
@@ -3363,7 +3165,6 @@ final class t3lib_BEfunc {
        /**
         * Returns TSConfig for the TCEFORM object in Page TSconfig.
         * Used in TCEFORMs
-        * Usage: 4
         *
         * @param       string          Table name present in TCA
         * @param       array           Row from table
@@ -3415,7 +3216,6 @@ final class t3lib_BEfunc {
        /**
         * Find the real PID of the record (with $uid from $table). This MAY be impossible if the pid is set as a reference to the former record or a page (if two records are created at one time).
         * NOTICE: Make sure that the input PID is never negative because the record was an offline version! Therefore, you should always use t3lib_BEfunc::fixVersioningPid($table,$row); on the data you input before calling this function!
-        * Usage: 2
         *
         * @param       string          Table name
         * @param       integer         Record uid
@@ -3426,7 +3226,7 @@ final class t3lib_BEfunc {
         */
        public static function getTSconfig_pidValue($table, $uid, $pid) {
 
-               if (t3lib_div::testInt($pid)) { // If pid is an integer this takes precedence in our lookup.
+               if (t3lib_utility_Math::canBeInterpretedAsInteger($pid)) { // If pid is an integer this takes precedence in our lookup.
                        $thePidValue = intval($pid);
                        if ($thePidValue < 0) { // If ref to another record, look that record up.
                                $pidRec = self::getRecord($table, abs($thePidValue), 'pid');
@@ -3458,7 +3258,6 @@ final class t3lib_BEfunc {
 
        /**
         * Return $uid if $table is pages and $uid is integer - otherwise the $pid
-        * Usage: 1
         *
         * @param       string          Table name
         * @param       integer         Record uid
@@ -3468,13 +3267,12 @@ final class t3lib_BEfunc {
         * @see t3lib_TCEforms::getTSCpid()
         */
        public static function getPidForModTSconfig($table, $uid, $pid) {
-               $retVal = ($table == 'pages' && t3lib_div::testInt($uid)) ? $uid : $pid;
+               $retVal = ($table == 'pages' && t3lib_utility_Math::canBeInterpretedAsInteger($uid)) ? $uid : $pid;
                return $retVal;
        }
 
        /**
         * Returns the REAL pid of the record, if possible. If both $uid and $pid is strings, then pid=-1 is returned as an error indication.
-        * Usage: 8
         *
         * @param       string          Table name
         * @param       integer         Record uid
@@ -3494,7 +3292,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns first found domain record "domainName" (without trailing slash) if found in the input $rootLine
-        * Usage: 2
         *
         * @param       array           Root line array
         * @return      string          Domain name, if found.
@@ -3513,7 +3310,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns the sys_domain record for $domain, optionally with $path appended.
-        * Usage: 2
         *
         * @param       string          Domain name
         * @param       string          Appended path
@@ -3542,7 +3338,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns overlayered RTE setup from an array with TSconfig. Used in TCEforms and TCEmain
-        * Usage: 8
         *
         * @param       array           The properties of Page TSconfig in the key "RTE."
         * @param       string          Table name
@@ -3670,7 +3465,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns TRUE if $modName is set and is found as a main- or submodule in $TBE_MODULES array
-        * Usage: 1
         *
         * @param       string          Module name
         * @return      boolean
@@ -4220,7 +4014,6 @@ final class t3lib_BEfunc {
 
        /**
         * Print error message with header, text etc.
-        * Usage: 19
         *
         * @param       string          Header string
         * @param       string          Content string
@@ -4442,10 +4235,13 @@ final class t3lib_BEfunc {
                        }
 
                        if (count($warnings)) {
-                               $style = ' style="margin-bottom:10px;"';
-                               $securityWarnings = '<ul><li' . $style . '>'
-                                               . implode('</li><li' . $style . '>', $warnings)
-                                               . '</li></ul>';
+                               if (count($warnings) > 1) {
+                                       $securityWarnings = '<ul><li>' .
+                                                       implode('</li><li>', $warnings) .
+                                                       '</li></ul>';
+                               } else {
+                                       $securityWarnings = '<p>' . implode('', $warnings) . '</p>';
+                               }
 
                                $securityMessage = t3lib_div::makeInstance(
                                        't3lib_FlashMessage',
@@ -4466,7 +4262,6 @@ final class t3lib_BEfunc {
 
        /**
         * Returns "web" if the $path (absolute) is within the DOCUMENT ROOT - and thereby qualifies as a "web" folder.
-        * Usage: 4
         *
         * @param       string          Path to evaluate
         * @return      boolean
@@ -4477,7 +4272,6 @@ final class t3lib_BEfunc {
 
        /**
         * Creates ADMCMD parameters for the "viewpage" extension / "cms" frontend
-        * Usage: 1
         *
         * @param       array           Page record
         * @return      string          Query-parameters
@@ -4500,7 +4294,6 @@ final class t3lib_BEfunc {
         * Returns an array with key=>values based on input text $params
         * $params is exploded by line-breaks and each line is supposed to be on the syntax [key] = [some value]
         * These pairs will be parsed into an array an returned.
-        * Usage: 1
         *
         * @param       string          String of parameters on multiple lines to parse into key-value pairs (see function description)
         * @return      array
@@ -4571,4 +4364,4 @@ final class t3lib_BEfunc {
        }
 }
 
-?>
+?>
\ No newline at end of file