t3lib_BEfunc Class Reference

List of all members.

Public Member Functions

 deleteClause ($table, $tableAlias='')
 getRecord ($table, $uid, $fields='*', $where='')
 getRecordWSOL ($table, $uid, $fields='*', $where='')
 getRecordRaw ($table, $where='', $fields='*')
 getRecordsByField ($theTable, $theField, $theValue, $whereClause='', $groupBy='', $orderBy='', $limit='')
 searchQuery ($searchWords, $fields, $table='')
 listQuery ($field, $value)
 splitTable_Uid ($str)
 getSQLselectableList ($in_list, $tablename, $default_tablename)
 BEenableFields ($table, $inv=0)
 mm_query ($select, $local_table, $mm_table, $foreign_table, $whereClause='', $groupBy='', $orderBy='', $limit='')
 DBcompileInsert ($table, $fields_values)
 DBcompileUpdate ($table, $where, $fields_values)
 BEgetRootLine ($uid, $clause='', $workspaceOL=FALSE)
 openPageTree ($pid, $clearExpansion)
 getRecordPath ($uid, $clause, $titleLimit, $fullTitleLimit=0)
 getExcludeFields ()
 getExplicitAuthFieldValues ()
 getSystemLanguages ()
 readPageAccess ($id, $perms_clause)
 getTCAtypes ($table, $rec, $useFieldNameAsKey=0)
 getTCAtypeValue ($table, $rec)
 getSpecConfParts ($str, $defaultExtras)
 getSpecConfParametersFromArray ($pArr)
 getFlexFormDS ($conf, $row, $table, $fieldName='', $WSOL=TRUE)
 storeHash ($hash, $data, $ident)
 getHash ($hash, $expTime=0)
 getPagesTSconfig ($id, $rootLine='', $returnPartArray=0)
 updatePagesTSconfig ($id, $pageTS, $TSconfPrefix, $impParams='')
 implodeTSParams ($p, $k='')
 getUserNames ($fields='username, usergroup, usergroup_cached_list, uid', $where='')
 getGroupNames ($fields='title, uid', $where='')
 getListGroupNames ($fields='title, uid')
 blindUserNames ($usernames, $groupArray, $excludeBlindedFlag=0)
 blindGroupNames ($groups, $groupArray, $excludeBlindedFlag=0)
 daysUntil ($tstamp)
 date ($tstamp)
 datetime ($value)
 time ($value)
 calcAge ($seconds, $labels= 'min|hrs|days|yrs')
 dateTimeAge ($tstamp, $prefix=1, $date='')
 titleAttrib ($content='', $hsc=0)
 titleAltAttrib ($content)
 thumbCode ($row, $table, $field, $backPath, $thumbScript='', $uploaddir=NULL, $abs=0, $tparams='', $size='')
 getThumbNail ($thumbScript, $theFile, $tparams='', $size='')
 titleAttribForPages ($row, $perms_clause='', $includeAttrib=1)
 getRecordIconAltText ($row, $table='pages')
 getLabelFromItemlist ($table, $col, $key)
 getItemLabel ($table, $col, $printAllWrap='')
 getRecordTitle ($table, $row, $prep=0)
 getProcessedValue ($table, $col, $value, $fixed_lgd_chars=0, $defaultPassthrough=0, $noRecordLookup=FALSE, $uid=0)
 getProcessedValueExtra ($table, $fN, $fV, $fixed_lgd_chars=0, $uid=0)
 getFileIcon ($ext)
 getCommonSelectFields ($table, $prefix='')
 makeConfigForm ($configArray, $defaults, $dataPrefix)
 helpTextIcon ($table, $field, $BACK_PATH, $force=0)
 helpText ($table, $field, $BACK_PATH, $styleAttrib='')
 cshItem ($table, $field, $BACK_PATH, $wrap='', $onlyIconMode=FALSE, $styleAttrib='')
 editOnClick ($params, $backPath='', $requestUri='')
 viewOnClick ($id, $backPath='', $rootLine='', $anchor='', $altUrl='', $addGetVars='', $switchFocus=TRUE)
 getModTSconfig ($id, $TSref)
 getFuncMenu ($mainParams, $elementName, $currentValue, $menuItems, $script='', $addparams='')
 getFuncCheck ($mainParams, $elementName, $currentValue, $script='', $addparams='', $tagParams='')
 getFuncInput ($mainParams, $elementName, $currentValue, $size=10, $script="", $addparams="")
 unsetMenuItems ($modTSconfig, $itemArray, $TSref)
 getSetUpdateSignal ($set='')
 getModuleData ($MOD_MENU, $CHANGED_SETTINGS, $modName, $type='', $dontValidateList='', $setDefaultList='')
 compilePreviewKeyword ($getVarsStr, $beUserUid, $ttl=172800)
 lockRecords ($table='', $uid=0, $pid=0)
 isRecordLocked ($table, $uid)
 exec_foreign_table_where_query ($fieldValue, $field='', $TSconfig=array(), $prefix='')
 getTCEFORM_TSconfig ($table, $row)
 getTSconfig_pidValue ($table, $uid, $pid)
 getPidForModTSconfig ($table, $uid, $pid)
 getTSCpid ($table, $uid, $pid)
 firstDomainRecord ($rootLine)
 getDomainStartPage ($domain, $path='')
 RTEsetup ($RTEprop, $table, $field, $type='')
& RTEgetObj ()
& softRefParserObj ($spKey)
 explodeSoftRefParserList ($parserList)
 isModuleSetInTBE_MODULES ($modName)
 referenceCount ($table, $ref, $msg='')
 selectVersionsOfRecord ($table, $uid, $fields='*', $workspace=0)
 fixVersioningPid ($table, &$rr, $ignoreWorkspaceMatch=FALSE)
 workspaceOL ($table, &$row, $wsid=-99)
 getWorkspaceVersionOfRecord ($workspace, $table, $uid, $fields='*')
 getLiveVersionOfRecord ($table, $uid, $fields='*')
 isPidInVersionizedBranch ($pid, $table='', $returnStage=FALSE)
 versioningPlaceholderClause ($table)
 countVersionsOfRecordsOnPage ($workspace, $pageId, $allTables=FALSE)
 wsMapId ($table, $uid)
 typo3PrintError ($header, $text, $js='', $head=1)
 TYPO3_copyRightNotice ()
 displayWarningMessages ()
 getPathType_web_nonweb ($path)
 ADMCMD_previewCmds ($pageinfo)
 processParams ($params)
 getListOfBackendModules ($name, $perms_clause, $backPath='', $script='index.php')

Detailed Description

Definition at line 183 of file class.t3lib_befunc.php.

Member Function Documentation

t3lib_BEfunc.ADMCMD_previewCmds (  $  pageinfo  ) 
 

Creates ADMCMD parameters for the "viewpage" extension / "cms" frontend Usage: 1

Parameters:
array Page record
Returns:
string Query-parameters

Definition at line 3538 of file class.t3lib_befunc.php.

t3lib_BEfunc.BEenableFields (  $  table,
$  inv = 0
) 
 

Backend implementation of enableFields() 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_EXEC_TIME"] is used for date. Usage: 5

Parameters:
string $table is the table from which to return enableFields WHERE clause. Table name must have a 'ctrl' section in $TCA.
boolean $inv means that the query will select all records NOT VISIBLE records (inverted selection)
Returns:
string WHERE clause part

Definition at line 403 of file class.t3lib_befunc.php.

t3lib_BEfunc.BEgetRootLine (  $  uid,
$  clause = '',
$  workspaceOL = FALSE
) 
 

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

Parameters:
integer Page id for which to create the root line.
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.
boolean If true, version overlay is applied. This must be requested specifically because it is usually only wanted when the rootline is used for visual output while for permission checking you want the raw thing!
Returns:
array Root line array, all the way to the page tree root (or as far as $clause allows!)

Definition at line 533 of file class.t3lib_befunc.php.

t3lib_BEfunc.blindGroupNames (  $  groups,
$  groupArray,
$  excludeBlindedFlag = 0
) 
 

Corresponds to blindUserNames but works for groups instead Usage: 2 (module web_perm)

Parameters:
array Group names
array Group names (reference)
boolean If $excludeBlindedFlag is set, then these records are unset from the array $usernames
Returns:
array

Definition at line 1387 of file class.t3lib_befunc.php.

t3lib_BEfunc.blindUserNames (  $  usernames,
$  groupArray,
$  excludeBlindedFlag = 0
) 
 

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

Parameters:
array User names
array Group names
boolean If $excludeBlindedFlag is set, then these records are unset from the array $usernames
Returns:
array User names, blinded

Definition at line 1354 of file class.t3lib_befunc.php.

t3lib_BEfunc.calcAge (  $  seconds,
$  labels = 'min|hrs|days|yrs'
) 
 

Returns the "age" in minutes / hours / days / years of the number of $seconds inputted. Usage: 15

Parameters:
integer $seconds could be the difference of a certain timestamp and time()
string $labels should be something like ' min| hrs| days| yrs'. This value is typically delivered by this function call: $GLOBALS["LANG"]->sL("LLL:EXT:lang/locallang_core.php:labels.minutesHoursDaysYears")
Returns:
string Formatted time

Definition at line 1479 of file class.t3lib_befunc.php.

t3lib_BEfunc.compilePreviewKeyword (  $  getVarsStr,
$  beUserUid,
$  ttl = 172800
) 
 

Set preview keyword, eg: $previewUrl = t3lib_div.getIndpEnv('TYPO3_SITE_URL').'?ADMCMD_prev='.t3lib_BEfunc.compilePreviewKeyword('id='.$pageId.'&L='.$language.'&ADMCMD_view=1&ADMCMD_editIcons=1&ADMCMD_previewWS='.$this->workspace, $GLOBALS['BE_USER']->user['uid'], 120);

todo for sys_preview:

  • Add a comment which can be shown to previewer in frontend in some way (plus maybe ability to write back, take other action?)
  • Add possibility for the preview keyword to work in the backend as well: So it becomes a quick way to a certain action of sorts?

Parameters:
string Get variables to preview, eg. 'id=1150&L=0&ADMCMD_view=1&ADMCMD_editIcons=1&ADMCMD_previewWS=8'
string 32 byte MD5 hash keyword for the URL: "?ADMCMD_prev=[keyword]"
integer Time-To-Live for keyword
Returns:
string Returns keyword to use in URL for ADMCMD_prev=

Definition at line 2565 of file class.t3lib_befunc.php.

t3lib_BEfunc.countVersionsOfRecordsOnPage (  $  workspace,
$  pageId,
$  allTables = FALSE
) 
 

Count number of versions on a page

Parameters:
integer Workspace ID
integer Page ID
boolean If set, then all tables and not only "versioning_followPages" are found (except other pages)
Returns:
array Overview of records

Definition at line 3336 of file class.t3lib_befunc.php.

t3lib_BEfunc.cshItem (  $  table,
$  field,
$  BACK_PATH,
$  wrap = '',
$  onlyIconMode = FALSE,
$  styleAttrib = ''
) 
 

API for getting CSH icons/text for use in backend modules. TCA_DESCR will be loaded if it isn't already Usage: ?

Parameters:
string Table name ('_MOD_'+module name)
string Field name (CSH locallang main key)
string Back path
string Wrap code for icon-mode, splitted by "|". Not used for full-text mode.
boolean If set, the full text will never be shown (only icon). Useful for places where it will break the page if the table with full text is shown.
string Additional style-attribute content for wrapping table (full text mode only)
Returns:
string HTML content for help text
See also:
helpText(), helpTextIcon()

Definition at line 2219 of file class.t3lib_befunc.php.

t3lib_BEfunc.date (  $  tstamp  ) 
 

Returns $tstamp formatted as "ddmmyy" (According to $TYPO3_CONF_VARS['SYS']['ddmmyy']) Usage: 11

Parameters:
integer Time stamp, seconds
Returns:
string Formatted time

Definition at line 1440 of file class.t3lib_befunc.php.

t3lib_BEfunc.datetime (  $  value  ) 
 

Returns $tstamp formatted as "ddmmyy hhmm" (According to $TYPO3_CONF_VARS['SYS']['ddmmyy'] AND $TYPO3_CONF_VARS['SYS']['hhmm']) Usage: 28

Parameters:
integer Time stamp, seconds
Returns:
string Formatted time

Definition at line 1451 of file class.t3lib_befunc.php.

t3lib_BEfunc.dateTimeAge (  $  tstamp,
$  prefix = 1,
$  date = ''
) 
 

Returns a formatted timestamp if $tstamp is set. The date/datetime will be followed by the age in parenthesis. Usage: 3

Parameters:
integer Time stamp, seconds
integer 1/-1 depending on polarity of age.
string $date=="date" will yield "dd:mm:yy" formatting, otherwise "dd:mm:yy hh:mm"
Returns:
string

Definition at line 1505 of file class.t3lib_befunc.php.

t3lib_BEfunc.daysUntil (  $  tstamp  ) 
 

Returns the difference in days between input $tstamp and $EXEC_TIME Usage: 2 (class t3lib_BEfunc)

Parameters:
integer Time stamp, seconds
Returns:
integer

Definition at line 1428 of file class.t3lib_befunc.php.

t3lib_BEfunc.DBcompileInsert (  $  table,
$  fields_values
) 
 

Creates an INSERT SQL-statement for $table from the array with field/value pairs $fields_values. DEPRECATED - $GLOBALS['TYPO3_DB']->INSERTquery() directly instead! But better yet, use $GLOBALS['TYPO3_DB']->exec_INSERTquery()

Parameters:
string Table name
array Field values as key=>value pairs.
Returns:
string Full SQL query for INSERT
Deprecated:

Definition at line 489 of file class.t3lib_befunc.php.

t3lib_BEfunc.DBcompileUpdate (  $  table,
$  where,
$  fields_values
) 
 

Creates an UPDATE SQL-statement for $table where $where-clause (typ. 'uid=...') from the array with field/value pairs $fields_values. DEPRECATED - $GLOBALS['TYPO3_DB']->UPDATEquery() directly instead! But better yet, use $GLOBALS['TYPO3_DB']->exec_UPDATEquery()

Parameters:
string Database tablename
string WHERE clause, eg. "uid=1"
array Field values as key=>value pairs.
Returns:
string Full SQL query for UPDATE
Deprecated:

Definition at line 503 of file class.t3lib_befunc.php.

t3lib_BEfunc.deleteClause (  $  table,
$  tableAlias = ''
) 
 

Returns the WHERE clause " AND NOT [tablename].[deleted-field]" if a deleted-field is configured in $TCA for the tablename, $table This function should ALWAYS be called in the backend for selection on tables which are configured in 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

Parameters:
string Table name present in $TCA
string Table alias if any
Returns:
string WHERE clause for filtering out deleted records, eg " AND tablename.deleted=0"

Definition at line 204 of file class.t3lib_befunc.php.

t3lib_BEfunc.displayWarningMessages (   ) 
 

Display some warning messages if this installation is obviously insecure!! These warnings are only displayed to admin users

Returns:
void

Definition at line 3469 of file class.t3lib_befunc.php.

t3lib_BEfunc.editOnClick (  $  params,
$  backPath = '',
$  requestUri = ''
) 
 

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

Parameters:
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.
string $backPath must point back to the TYPO3_mainDir directory (where alt_doc.php is)
string $requestUri is an optional returnUrl you can set - automatically set to REQUEST_URI.
Returns:
string
See also:
template.issueCommand()

Definition at line 2257 of file class.t3lib_befunc.php.

t3lib_BEfunc.exec_foreign_table_where_query (  $  fieldValue,
$  field = '',
$  TSconfig = array(),
$  prefix = ''
) 
 

Returns select statement for MM relations (as used by TCEFORMs etc) Usage: 3

Parameters:
array Configuration array for the field, taken from $TCA
string Field name
array TSconfig array from which to get further configuration settings for the field name
string Prefix string for the key "*foreign_table_where" from $fieldValue array
Returns:
string Part of query

Definition at line 2662 of file class.t3lib_befunc.php.

t3lib_BEfunc.explodeSoftRefParserList (  $  parserList  ) 
 

Returns array of soft parser references

Parameters:
string softRef parser list
string Table name
string Field name
Returns:
array Array where the parser key is the key and the value is the parameter string

Definition at line 2998 of file class.t3lib_befunc.php.

t3lib_BEfunc.firstDomainRecord (  $  rootLine  ) 
 

Returns first found domain record "domainName" (without trailing slash) if found in the input $rootLine Usage: 2

Parameters:
array Root line array
Returns:
string Domain name, if found.

Definition at line 2856 of file class.t3lib_befunc.php.

t3lib_BEfunc.fixVersioningPid (  $  table,
&$  rr,
$  ignoreWorkspaceMatch = FALSE
) 
 

Find page-tree PID for versionized record Will look if the "pid" value of the input record is -1 and if the table supports versioning - if so, it will translate the -1 PID into the PID of the original record Used whenever you are tracking something back, like making the root line. Will only translate if the workspace of the input record matches that of the current user (unless flag set) Principle; Record offline! => Find online?

Parameters:
string Table name
array Record array passed by reference. As minimum, "pid" and "uid" fields must exist! "t3ver_oid" and "t3ver_wsid" is nice and will save you a DB query.
boolean Ignore workspace match
Returns:
void (Passed by ref). If the record had its pid corrected to the online versions pid, then "_ORIG_pid" is set to the original pid value (-1 of course). The field "_ORIG_pid" is used by various other functions to detect if a record was in fact in a versionized branch.
See also:
t3lib_page.fixVersioningPid()

Definition at line 3160 of file class.t3lib_befunc.php.

t3lib_BEfunc.getCommonSelectFields (  $  table,
$  prefix = ''
) 
 

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

Parameters:
string Table name, present in TCA
string Table prefix
Returns:
string List of fields.

Definition at line 2027 of file class.t3lib_befunc.php.

t3lib_BEfunc.getDomainStartPage (  $  domain,
$  path = ''
) 
 

Returns the sys_domain record for $domain, optionally with $path appended. Usage: 2

Parameters:
string Domain name
string Appended path
Returns:
array Domain record, if found

Definition at line 2878 of file class.t3lib_befunc.php.

t3lib_BEfunc.getExcludeFields (   ) 
 

Returns an array with the exclude-fields as defined in TCA Used for listing the exclude-fields in be_groups forms Usage: 2 (t3lib_tceforms + t3lib_transferdata)

Returns:
array Array of arrays with excludeFields (fieldname, table:fieldname) from all TCA entries

Definition at line 677 of file class.t3lib_befunc.php.

t3lib_BEfunc.getExplicitAuthFieldValues (   ) 
 

Returns an array with explicit Allow/Deny fields. Used for listing these field/value pairs in be_groups forms

Returns:
array Array with information from all of $TCA

Definition at line 707 of file class.t3lib_befunc.php.

t3lib_BEfunc.getFileIcon (  $  ext  ) 
 

Returns file icon name (from $FILEICONS) for the fileextension $ext Usage: 10

Parameters:
string File extension, lowercase
Returns:
string File icon filename

Definition at line 2013 of file class.t3lib_befunc.php.

t3lib_BEfunc.getFlexFormDS (  $  conf,
$  row,
$  table,
$  fieldName = '',
$  WSOL = TRUE
) 
 

Finds the Data Structure for a FlexForm field Usage: 5

Parameters:
array Field config array
array Record data
string The table name
string Optional fieldname passed to hook object
boolean Boolean; If set, workspace overlay is applied to records. This is correct behaviour for all presentation and export, but NOT if you want a true reflection of how things are in the live workspace.
Returns:
mixed If array, the data structure was found and returned as an array. Otherwise (string) it is an error message.
See also:
t3lib_TCEforms.getSingleField_typeFlex()

Definition at line 969 of file class.t3lib_befunc.php.

t3lib_BEfunc.getFuncCheck (  $  mainParams,
$  elementName,
$  currentValue,
$  script = '',
$  addparams = '',
$  tagParams = ''
) 
 

Checkbox function menu. Works like ->getFuncMenu() but takes no $menuItem array since this is a simple checkbox. Usage: 34

Parameters:
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=...
string $elementName it the form elements name, probably something like "SET[...]"
string $currentValue is the value to be selected currently.
string $script is the script to send the &id to, if empty it's automatically found
string $addParams is additional parameters to pass to the script.
string Additional attributes for the checkbox input tag
Returns:
string HTML code for checkbox
See also:
getFuncMenu()

Definition at line 2372 of file class.t3lib_befunc.php.

t3lib_BEfunc.getFuncInput (  $  mainParams,
$  elementName,
$  currentValue,
$  size = 10,
$  script = "",
$  addparams = ""
) 
 

Input field function menu Works like ->getFuncMenu() / ->getFuncCheck() but displays a input field instead which updates the script "onchange" Usage: 1

Parameters:
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=...
string $elementName it the form elements name, probably something like "SET[...]"
string $currentValue is the value to be selected currently.
integer Relative size of input field, max is 48
string $script is the script to send the &id to, if empty it's automatically found
string $addParams is additional parameters to pass to the script.
Returns:
string HTML code for input text field.
See also:
getFuncMenu()

Definition at line 2397 of file class.t3lib_befunc.php.

t3lib_BEfunc.getFuncMenu (  $  mainParams,
$  elementName,
$  currentValue,
$  menuItems,
$  script = '',
$  addparams = ''
) 
 

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

Parameters:
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=...
string $elementName it the form elements name, probably something like "SET[...]"
string $currentValue is the value to be selected currently.
array $menuItems is an array with the menu items for the selector box
string $script is the script to send the &id to, if empty it's automatically found
string $addParams is additional parameters to pass to the script.
Returns:
string HTML code for selector box

Definition at line 2329 of file class.t3lib_befunc.php.

t3lib_BEfunc.getGroupNames (  $  fields = 'title,
uid'  ,
$  where = ''
) 
 

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")

Parameters:
string Field list
string WHERE clause
Returns:
array

Definition at line 1318 of file class.t3lib_befunc.php.

t3lib_BEfunc.getHash (  $  hash,
$  expTime = 0
) 
 

Retrieves the string content stored with hash key, $hash, in cache_hash IDENTICAL to the function by same name found in t3lib_page: Usage: 2

Parameters:
string Hash key, 32 bytes hex
integer $expTime represents the expire time in seconds. For instance a value of 3600 would allow cached content within the last hour, otherwise nothing is returned.
Returns:
string

Definition at line 1116 of file class.t3lib_befunc.php.

t3lib_BEfunc.getItemLabel (  $  table,
$  col,
$  printAllWrap = ''
) 
 

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='|' and the fieldname was 'not_found_field' then the return value would be 'not_found_field' Usage: 17

Parameters:
string Table name, present in $TCA
string Field name
string Wrap value - set function description
Returns:
string

Definition at line 1775 of file class.t3lib_befunc.php.

t3lib_BEfunc.getLabelFromItemlist (  $  table,
$  col,
$  key
) 
 

Returns the label of the first found entry in an "items" array from $TCA (tablename=$table/fieldname=$col) where the value is $key Usage: 9

Parameters:
string Table name, present in $TCA
string Field name, present in $TCA
string items-array value to match
Returns:
string Label for item entry

Definition at line 1749 of file class.t3lib_befunc.php.

t3lib_BEfunc.getListGroupNames (  $  fields = 'title,
uid' 
) 
 

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)

Parameters:
string Field list; $fields specify the fields selected (default: title,uid)
Returns:
array

Definition at line 1335 of file class.t3lib_befunc.php.

t3lib_BEfunc.getListOfBackendModules (  $  name,
$  perms_clause,
$  backPath = '',
$  script = 'index.php'
) 
 

Returns "list of backend modules". Most likely this will be obsolete soon / removed. Don't use. Usage: 3

Parameters:
array Module names in array. Must be "addslashes()"ed
string Perms clause for SQL query
string Backpath
string The URL/script to jump to (used in A tag)
Returns:
array Two keys, rows and list

Definition at line 3586 of file class.t3lib_befunc.php.

t3lib_BEfunc.getLiveVersionOfRecord (  $  table,
$  uid,
$  fields = '*'
) 
 

Returns live version of record

Parameters:
string Table name
integer Record UID of draft, offline version
string Field list, default is *
Returns:
array If found, the record, otherwise nothing.

Definition at line 3277 of file class.t3lib_befunc.php.

t3lib_BEfunc.getModTSconfig (  $  id,
$  TSref
) 
 

Returns the merged User/Page TSconfig for page id, $id. Please read details about module programming elsewhere! Usage: 15

Parameters:
integer Page uid
string $TSref is an object string which determines the path of the TSconfig to return.
Returns:
array

Definition at line 2308 of file class.t3lib_befunc.php.

t3lib_BEfunc.getModuleData (  $  MOD_MENU,
$  CHANGED_SETTINGS,
$  modName,
$  type = '',
$  dontValidateList = '',
$  setDefaultList = ''
) 
 

Returns an array which is most backend modules becomes MOD_SETTINGS containing values from function menus etc. determining the function of the module. 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

Parameters:
array MOD_MENU is an array that defines the options in menus.
array CHANGED_SETTINGS represents the array used when passing values to the script from the menus.
string modName is the name of this module. Used to get the correct module data.
string If type is 'ses' then the data is stored as session-lasting data. This means that it'll be wiped out the next time the user logs in.
string dontValidateList can be used to list variables that should not be checked if their value is found in the MOD_MENU array. Used for dynamically generated menus.
string List of default values from $MOD_MENU to set in the output array (only if the values from MOD_MENU are not arrays)
Returns:
array The array $settings, which holds a key for each MOD_MENU key and the values of each key will be within the range of values for each menuitem

Definition at line 2492 of file class.t3lib_befunc.php.

t3lib_BEfunc.getPagesTSconfig (  $  id,
$  rootLine = '',
$  returnPartArray = 0
) 
 

Returns the Page TSconfig for page with id, $id Requires class "t3lib_TSparser" Usage: 26 (spec. in ext info_pagetsconfig)

Parameters:
integer Page uid for which to create Page TSconfig
array If $rootLine is an array, that is used as rootline, otherwise rootline is just calculated
boolean If $returnPartArray is set, then the array with accumulated Page TSconfig is returned non-parsed. Otherwise the output will be parsed by the TypoScript parser.
Returns:
array Page TSconfig
See also:
t3lib_TSparser

Definition at line 1152 of file class.t3lib_befunc.php.

t3lib_BEfunc.getPathType_web_nonweb (  $  path  ) 
 

Returns "web" if the $path (absolute) is within the DOCUMENT ROOT - and thereby qualifies as a "web" folder. Usage: 4

Parameters:
string Path to evaluate
Re