typo3/class.db_list.inc

   1 <?php
   2 /***************************************************************
   3 *  Copyright notice
   4 *
   5 *  (c) 1999-2008 Kasper Skaarhoj (kasperYYYY@typo3.com)
   6 *  All rights reserved
   7 *
   8 *  This script is part of the TYPO3 project. The TYPO3 project is
   9 *  free software; you can redistribute it and/or modify
  10 *  it under the terms of the GNU General Public License as published by
  11 *  the Free Software Foundation; either version 2 of the License, or
  12 *  (at your option) any later version.
  13 *
  14 *  The GNU General Public License can be found at
  15 *  http://www.gnu.org/copyleft/gpl.html.
  16 *  A copy is found in the textfile GPL.txt and important notices to the license
  17 *  from the author is found in LICENSE.txt distributed with these scripts.
  18 *
  19 *
  20 *  This script is distributed in the hope that it will be useful,
  21 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  22 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23 *  GNU General Public License for more details.
  24 *
  25 *  This copyright notice MUST APPEAR in all copies of the script!
  26 ***************************************************************/
  27 /**
  28  * Include file extending t3lib_recordList
  29  * Shared between Web>List (db_list.php) and Web>Page (sysext/cms/layout/db_layout.php)
  30  *
  31  * $Id$
  32  * Revised for TYPO3 3.6 December/2003 by Kasper Skaarhoj
  33  * XHTML compliant
  34  *
  35  * @author      Kasper Skaarhoj <kasperYYYY@typo3.com>
  36  */
  37 /**
  38  * [CLASS/FUNCTION INDEX of SCRIPT]
  39  *
  40  *
  41  *
  42  *   86: class recordList extends t3lib_recordList
  43  *  148:     function start($id,$table,$pointer,$search="",$levels="",$showLimit=0)
  44  *  211:     function generateList()
  45  *  275:     function getSearchBox($formFields=1)
  46  *  319:     function showSysNotesForPage()
  47  *
  48  *              SECTION: Various helper functions
  49  *  396:     function setDispFields()
  50  *  421:     function thumbCode($row,$table,$field)
  51  *  434:     function makeQueryArray($table, $id, $addWhere="",$fieldList='*')
  52  *  481:     function setTotalItems($queryParts)
  53  *  497:     function makeSearchString($table)
  54  *  536:     function linkWrapTable($table,$code)
  55  *  553:     function linkWrapItems($table,$uid,$code,$row)
  56  *  617:     function linkUrlMail($code,$testString)
  57  *  644:     function listURL($altId='',$table=-1,$exclList='')
  58  *  663:     function requestUri()
  59  *  674:     function makeFieldList($table,$dontCheckUser=0)
  60  *  721:     function getTreeObject($id,$depth,$perms_clause)
  61  *  739:     function localizationRedirect($justLocalized)
  62  *
  63  * TOTAL FUNCTIONS: 17
  64  * (This index is automatically created/updated by the extension "extdeveval")
  65  *
  66  */
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78 /**
  79  * Child class for rendering of Web > List (not the final class. see class.db_list_extra)
  80  *
  81  * @author      Kasper Skaarhoj <kasperYYYY@typo3.com>
  82  * @package TYPO3
  83  * @subpackage core
  84  * @see localRecordList
  85  */
  86 class recordList extends t3lib_recordList {
  87
  88                 // External, static:
  89         var $tableList='';                              // Specify a list of tables which are the only ones allowed to be displayed.
  90         var $returnUrl='';                              // Return URL
  91         var $thumbs = 0;                                // Boolean. Thumbnails on records containing files (pictures)
  92         var $itemsLimitPerTable = 20;                   // default Max items shown per table in "multi-table mode", may be overridden by tables.php
  93         var $itemsLimitSingleTable = 100;               // default Max items shown per table in "single-table mode", may be overridden by tables.php
  94         var $widthGif = '<img src="clear.gif" width="1" height="4" hspace="160" alt="" />';
  95         var $script = 'db_list.php';                    // Current script name
  96         var $allFields=0;                               // Indicates if all available fields for a user should be selected or not.
  97         var $localizationView=FALSE;                    // Whether to show localization view or not.
  98
  99                 // Internal, static: GPvar:
 100         var $csvOutput=FALSE;                           // If set, csvList is outputted.
 101         var $sortField;                                 // Field, to sort list by
 102         var $sortRev;                                   // Field, indicating to sort in reverse order.
 103         var $displayFields;                             // Array, containing which fields to display in extended mode
 104         var $duplicateField;                            // String, can contain the field name from a table which must have duplicate values marked.
 105
 106                 // Internal, static:
 107         var $id;                                        // Page id
 108         var $table='';                                  // Tablename if single-table mode
 109         var $listOnlyInSingleTableMode=FALSE;           // If true, records are listed only if a specific table is selected.
 110         var $firstElementNumber=0;                      // Pointer for browsing list
 111         var $searchString='';                           // Search string
 112         var $searchLevels='';                           // Levels to search down.
 113         var $showLimit=0;                               // Number of records to show
 114         var $pidSelect='';                              // List of ids from which to select/search etc. (when search-levels are set high). See start()
 115         var $perms_clause='';                           // Page select permissions
 116         var $calcPerms=0;                               // Some permissions...
 117         var $clickTitleMode = '';                       // Mode for what happens when a user clicks the title of a record.
 118         var $modSharedTSconfig = array();               // Shared module configuration, used by localization features
 119         var $pageRecord = array();              // Loaded with page record with version overlay if any.
 120         var $hideTables = '';                   // Tables which should not get listed
 121         var $tableTSconfigOverTCA = array(); //TSconfig which overwrites TCA-Settings
 122         var $tablesCollapsed = array(); // Array of collapsed / uncollapsed tables in multi table view
 123
 124                 // Internal, dynamic:
 125         var $JScode = '';                               // JavaScript code accumulation
 126         var $HTMLcode = '';                             // HTML output
 127         var $iLimit=0;                                  // "LIMIT " in SQL...
 128         var $eCounter=0;                                // Counting the elements no matter what...
 129         var $totalItems='';                             // Set to the total number of items for a table when selecting.
 130         var $recPath_cache=array();                     // Cache for record path
 131         var $setFields=array();                         // Fields to display for the current table
 132         var $currentTable = array();                    // Used for tracking next/prev uids
 133         var $duplicateStack=array();                    // Used for tracking duplicate values of fields
 134
 135
 136
 137
 138
 139         /**
 140          * Initializes the list generation
 141          *
 142          * @param       integer         Page id for which the list is rendered. Must be >= 0
 143          * @param       string          Tablename - if extended mode where only one table is listed at a time.
 144          * @param       integer         Browsing pointer.
 145          * @param       string          Search word, if any
 146          * @param       integer         Number of levels to search down the page tree
 147          * @param       integer         Limit of records to be listed.
 148          * @return      void
 149          */
 150         function start($id,$table,$pointer,$search="",$levels="",$showLimit=0)  {
 151                 global $TCA;
 152
 153                         // Setting internal variables:
 154                 $this->id=intval($id);                                  // sets the parent id
 155                 if ($TCA[$table])       $this->table=$table;            // Setting single table mode, if table exists:
 156                 $this->firstElementNumber=$pointer;
 157                 $this->searchString=trim($search);
 158                 $this->searchLevels=trim($levels);
 159                 $this->showLimit=t3lib_div::intInRange($showLimit,0,10000);
 160
 161                         // Setting GPvars:
 162                 $this->csvOutput = t3lib_div::_GP('csv') ? TRUE : FALSE;
 163                 $this->sortField = t3lib_div::_GP('sortField');
 164                 $this->sortRev = t3lib_div::_GP('sortRev');
 165                 $this->displayFields = t3lib_div::_GP('displayFields');
 166                 $this->duplicateField = t3lib_div::_GP('duplicateField');
 167
 168                 if (t3lib_div::_GP('justLocalized'))    {
 169                         $this->localizationRedirect(t3lib_div::_GP('justLocalized'));
 170                 }
 171
 172                         // If thumbnails are disabled, set the "notfound" icon as default:
 173                 if (!$GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails'])  {
 174                         $this->thumbScript='gfx/notfound_thumb.gif';
 175                 }
 176
 177                         // Init dynamic vars:
 178                 $this->counter=0;
 179                 $this->JScode='';
 180                 $this->HTMLcode='';
 181
 182                         // Set select levels:
 183                 $sL=intval($this->searchLevels);
 184                 $this->perms_clause = $GLOBALS['BE_USER']->getPagePermsClause(1);
 185
 186                         // this will hide records from display - it has nothing todo with user rights!!
 187                 if ($pidList = $GLOBALS['BE_USER']->getTSConfigVal('options.hideRecords.pages')) {
 188                         if ($pidList = $GLOBALS['TYPO3_DB']->cleanIntList($pidList)) {
 189                                 $this->perms_clause .= ' AND pages.uid NOT IN ('.$pidList.')';
 190                         }
 191                 }
 192
 193                 // Get configuration of collapsed tables from user uc and merge with sanitized GP vars
 194                 $this->tablesCollapsed = is_array($GLOBALS['BE_USER']->uc['moduleData']['db_list.php']) ? $GLOBALS['BE_USER']->uc['moduleData']['db_list.php'] : array();
 195                 $collapseOverride = t3lib_div::_GP('collapse');
 196                 if (is_array($collapseOverride)) {
 197                         foreach($collapseOverride as $collapseTable => $collapseValue) {
 198                                 if (is_array($GLOBALS['TCA'][$collapseTable]) && ($collapseValue == 0 || $collapseValue == 1)) {
 199                                         $this->tablesCollapsed[$collapseTable] = $collapseValue;
 200                                 }
 201                         }
 202                         // Save modified user uc
 203                         $GLOBALS['BE_USER']->uc['moduleData']['db_list.php'] = $this->tablesCollapsed;
 204                         $GLOBALS['BE_USER']->writeUC($GLOBALS['BE_USER']->uc);
 205                 }
 206
 207                 if ($sL>0)      {
 208                         $tree = $this->getTreeObject($id,$sL,$this->perms_clause);
 209                         $this->pidSelect = 'pid IN ('.implode(',',$tree->ids).')';
 210                 } else {
 211                         $this->pidSelect = 'pid='.intval($id);
 212                 }
 213
 214                         // Initialize languages:
 215                 if ($this->localizationView)    {
 216                         $this->initializeLanguages();
 217                 }
 218         }
 219
 220         /**
 221          * Traverses the table(s) to be listed and renders the output code for each:
 222          * The HTML is accumulated in $this->HTMLcode
 223          * Finishes off with a stopper-gif
 224          *
 225          * @return      void
 226          */
 227         function generateList() {
 228                 global $TCA;
 229
 230                         // Set page record in header
 231                 $this->pageRecord = t3lib_BEfunc::getRecordWSOL('pages',$this->id);
 232
 233                         // Traverse the TCA table array:
 234                 reset($TCA);
 235                 while (list($tableName)=each($TCA))     {
 236
 237                                 // Checking if the table should be rendered:
 238                         if ((!$this->table || $tableName==$this->table) && (!$this->tableList || t3lib_div::inList($this->tableList,$tableName)) && $GLOBALS['BE_USER']->check('tables_select',$tableName))     {               // Checks that we see only permitted/requested tables:
 239
 240                                         // Load full table definitions:
 241                                 t3lib_div::loadTCA($tableName);
 242
 243                                         // Hide tables which are configured via TSConfig not to be shown (also works for admins):
 244                                 if (isset($this->tableTSconfigOverTCA[$tableName.'.']['hideTable']) ? $this->tableTSconfigOverTCA[$tableName.'.']['hideTable'] :
 245                                                 (t3lib_div::inList($this->hideTables, $tableName) ? true : $GLOBALS['TCA'][$tableName]['ctrl']['hideTable'])) {
 246                                         continue;
 247                                 }
 248
 249                                         // iLimit is set depending on whether we're in single- or multi-table mode
 250                                 if ($this->table)       {
 251                                         $this->iLimit=(isset($TCA[$tableName]['interface']['maxSingleDBListItems'])?intval($TCA[$tableName]['interface']['maxSingleDBListItems']):$this->itemsLimitSingleTable);
 252                                 } else {
 253                                         $this->iLimit=(isset($TCA[$tableName]['interface']['maxDBListItems'])?intval($TCA[$tableName]['interface']['maxDBListItems']):$this->itemsLimitPerTable);
 254                                 }
 255                                 if ($this->showLimit)   $this->iLimit = $this->showLimit;
 256
 257                                         // Setting fields to select:
 258                                 if ($this->allFields)   {
 259                                         $fields = $this->makeFieldList($tableName);
 260                                         $fields[]='tstamp';
 261                                         $fields[]='crdate';
 262                                         $fields[]='_PATH_';
 263                                         $fields[]='_CONTROL_';
 264                                         if (is_array($this->setFields[$tableName]))     {
 265                                                 $fields = array_intersect($fields,$this->setFields[$tableName]);
 266                                         } else {
 267                                                 $fields = array();
 268                                         }
 269                                 } else {
 270                                         $fields = array();
 271                                 }
 272
 273                                         // Find ID to use (might be different for "versioning_followPages" tables)
 274                                 if (intval($this->searchLevels)==0)     {
 275                                         if ($TCA[$tableName]['ctrl']['versioning_followPages'] && $this->pageRecord['_ORIG_pid']==-1 && $this->pageRecord['t3ver_swapmode']==0) {
 276                                                 $this->pidSelect = 'pid='.intval($this->pageRecord['_ORIG_uid']);
 277                                         } else {
 278                                                 $this->pidSelect = 'pid='.intval($this->id);
 279                                         }
 280                                 }
 281 #debug($this->pidSelect,$tableName);
 282                                         // Finally, render the list:
 283                                 $this->HTMLcode.=$this->getTable($tableName, $this->id, implode(',',$fields));
 284                         }
 285                 }
 286         }
 287
 288         /**
 289          * Creates the search box
 290          *
 291          * @param       boolean         If true, the search box is wrapped in its own form-tags
 292          * @return      string          HTML for the search box
 293          */
 294         function getSearchBox($formFields=1)    {
 295
 296                         // Setting form-elements, if applicable:
 297                 $formElements=array('','');
 298                 if ($formFields)        {
 299                         $formElements=array('<form action="'.htmlspecialchars($this->listURL()).'" method="post">','</form>');
 300                 }
 301
 302                         // Make level selector:
 303                 $opt=array();
 304                 $parts = explode('|',$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.enterSearchLevels'));
 305                 while(list($kv,$label)=each($parts))    {
 306                         $opt[] = '<option value="'.$kv.'"'.($kv==intval($this->searchLevels)?' selected="selected"':'').'>'.htmlspecialchars($label).'</option>';
 307                 }
 308                 $lMenu = '<select name="search_levels">'.implode('',$opt).'</select>';
 309
 310                         // Table with the search box:
 311                 $content.= '
 312                         '.$formElements[0].'
 313
 314                                 <!--
 315                                         Search box:
 316                                 -->
 317                                 <table border="0" cellpadding="0" cellspacing="0" class="bgColor4" id="typo3-dblist-search">
 318                                         <tr>
 319                                                 <td>'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.enterSearchString',1).'<input type="text" name="search_field" value="'.htmlspecialchars($this->searchString).'"'.$GLOBALS['TBE_TEMPLATE']->formWidth(10).' /></td>
 320                                                 <td>'.$lMenu.'</td>
 321                                                 <td><input type="submit" name="search" value="'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.search',1).'" /></td>
 322                                         </tr>
 323                                         <tr>
 324                                                 <td colspan="3">'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.showRecords',1).':<input type="text" name="showLimit" value="'.htmlspecialchars($this->showLimit?$this->showLimit:'').'"'.$GLOBALS['TBE_TEMPLATE']->formWidth(4).' /></td>
 325                                         </tr>
 326                                 </table>
 327                         '.$formElements[1];
 328                 $content.=t3lib_BEfunc::cshItem('xMOD_csh_corebe', 'list_searchbox', $GLOBALS['BACK_PATH'],'|<br/>');
 329                 return $content;
 330         }
 331
 332         /**
 333          * Creates the display of sys_notes for the page.
 334          * Relies on the "sys_note" extension to be loaded.
 335          *
 336          * @return      string          HTML for the sys-notes (if any)
 337          */
 338         function showSysNotesForPage()  {
 339                 global $TCA;
 340
 341                 $out='';
 342
 343                         // Checking if extension is loaded:
 344                 if (!t3lib_extMgm::isLoaded('sys_note'))        return '';
 345
 346                         // Create query for selecting the notes:
 347                 $result = $GLOBALS['TYPO3_DB']->exec_SELECTquery('*','sys_note','pid IN ('.$this->id.') AND (personal=0 OR cruser='.intval($GLOBALS['BE_USER']->user['uid']).')'.t3lib_BEfunc::deleteClause('sys_note').t3lib_BEfunc::versioningPlaceholderClause('sys_note'));
 348
 349                         // Executing query:
 350                 $dbCount = $GLOBALS['TYPO3_DB']->sql_num_rows($result);
 351
 352                         // If some notes were found, render them:
 353                 if ($dbCount)   {
 354                         $cat = array();
 355
 356                                 // Load full table description:
 357                         t3lib_div::loadTCA('sys_note');
 358
 359                                 // Traverse note-types and get labels:
 360                         if ($TCA['sys_note'] && $TCA['sys_note']['columns']['category'] && is_array($TCA['sys_note']['columns']['category']['config']['items']))        {
 361                                 foreach($TCA['sys_note']['columns']['category']['config']['items'] as $el)      {
 362                                         $cat[$el[1]]=$GLOBALS['LANG']->sL($el[0]);
 363                                 }
 364                         }
 365
 366                                 // For each note found, make rendering:
 367                         while($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($result))    {
 368
 369                                         // Create content:
 370                                 $iconImg = t3lib_iconWorks::getIconImage('sys_note',$row,$this->backPath,'');
 371                                 $subject = htmlspecialchars($row['subject']);
 372                                 $fields = array();
 373                                 $fields['Author:'] = htmlspecialchars($row['author'].($row['email'] && $row['author'] ? ', ':'').$row['email']);
 374                                 $fields['Category:'] = htmlspecialchars($cat[$row['category']]);
 375                                 $fields['Note:'] = nl2br(htmlspecialchars($row['message']));
 376
 377                                         // Compile content:
 378                                 $out.='
 379
 380
 381                                 <!--
 382                                         Sys-notes for the db_list.php:
 383                                 -->
 384                                         <table border="0" cellpadding="1" cellspacing="1" id="typo3-dblist-sysnotes">
 385                                                 <tr><td colspan="2" class="bgColor2">'.$iconImg.'<strong>'.$subject.'</strong></td></tr>
 386                                                 <tr><td class="bgColor4">'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.category',1).'</td><td class="bgColor4">'.$fields['Category:'].'</td></tr>
 387                                                 <tr><td class="bgColor4">'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.author',1).'</td><td class="bgColor4">'.$fields['Author:'].'</td></tr>
 388                                                 <tr><td class="bgColor4">'.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.note',1).'</td><td class="bgColor4">'.$fields['Note:'].'</td></tr>
 389                                         </table>
 390                                 ';
 391                         }
 392                 }
 393                 return $out;
 394         }
 395
 396
 397
 398
 399
 400
 401
 402
 403         /******************************
 404          *
 405          * Various helper functions
 406          *
 407          ******************************/
 408
 409         /**
 410          * Setting the field names to display in extended list.
 411          * Sets the internal variable $this->setFields
 412          *
 413          * @return      void
 414          */
 415         function setDispFields()        {
 416
 417                         // Getting from session:
 418                 $dispFields = $GLOBALS['BE_USER']->getModuleData('db_list.php/displayFields');
 419
 420                         // If fields has been inputted, then set those as the value and push it to session variable:
 421                 if (is_array($this->displayFields))     {
 422                         reset($this->displayFields);
 423                         $tKey = key($this->displayFields);
 424                         $dispFields[$tKey]=$this->displayFields[$tKey];
 425                         $GLOBALS['BE_USER']->pushModuleData('db_list.php/displayFields',$dispFields);
 426                 }
 427
 428                         // Setting result:
 429                 $this->setFields=$dispFields;
 430         }
 431
 432         /**
 433          * Create thumbnail code for record/field
 434          *
 435          * @param       array           Record array
 436          * @param       string          Table (record is from)
 437          * @param       string          Field name for which thumbsnail are to be rendered.
 438          * @return      string          HTML for thumbnails, if any.
 439          */
 440         function thumbCode($row,$table,$field)  {
 441                 return t3lib_BEfunc::thumbCode($row,$table,$field,$this->backPath,$this->thumbScript);
 442         }
 443
 444         /**
 445          * Returns the SQL-query array to select the records from a table $table with pid = $id
 446          *
 447          * @param       string          Table name
 448          * @param       integer         Page id (NOT USED! $this->pidSelect is used instead)
 449          * @param       string          Additional part for where clause
 450          * @param       string          Field list to select, * for all (for "SELECT [fieldlist] FROM ...")
 451          * @return      array           Returns query array
 452          */
 453         function makeQueryArray($table, $id, $addWhere="",$fieldList='*')       {
 454                 global $TCA;
 455
 456                         // Set ORDER BY:
 457                 $orderBy = ($TCA[$table]['ctrl']['sortby']) ? 'ORDER BY '.$TCA[$table]['ctrl']['sortby'] : $TCA[$table]['ctrl']['default_sortby'];
 458                 if ($this->sortField)   {
 459                         if (in_array($this->sortField,$this->makeFieldList($table,1)))  {
 460                                 $orderBy = 'ORDER BY '.$this->sortField;
 461                                 if ($this->sortRev)     $orderBy.=' DESC';
 462                         }
 463                 }
 464
 465                         // Set LIMIT:
 466                 $limit = $this->iLimit ? ($this->firstElementNumber ? $this->firstElementNumber.',' : '').($this->iLimit+1) : '';
 467
 468                         // Filtering on displayable pages (permissions):
 469                 $pC = ($table=='pages' && $this->perms_clause)?' AND '.$this->perms_clause:'';
 470
 471                         // Adding search constraints:
 472                 $search = $this->makeSearchString($table);
 473
 474                         // Compiling query array:
 475                 $queryParts = array(
 476                         'SELECT' => $fieldList,
 477                         'FROM' => $table,
 478                         'WHERE' => $this->pidSelect.
 479                                                 ' '.$pC.
 480                                                 t3lib_BEfunc::deleteClause($table).
 481                                                 t3lib_BEfunc::versioningPlaceholderClause($table).
 482                                                 ' '.$addWhere.
 483                                                 ' '.$search,
 484                         'GROUPBY' => '',
 485                         'ORDERBY' => $GLOBALS['TYPO3_DB']->stripOrderBy($orderBy),
 486                         'LIMIT' => $limit
 487                 );
 488
 489                         // Return query:
 490                 return $queryParts;
 491         }
 492
 493         /**
 494          * Based on input query array (query for selecting count(*) from a table) it will select the number of records and set the value in $this->totalItems
 495          *
 496          * @param       array           Query array
 497          * @return      void
 498          * @see makeQueryArray()
 499          */
 500         function setTotalItems($queryParts)     {
 501                 $result = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
 502                                         'count(*)',
 503                                         $queryParts['FROM'],
 504                                         $queryParts['WHERE']
 505                                 );
 506                 list($rCount) = $GLOBALS['TYPO3_DB']->sql_fetch_row($result);
 507                 $this->totalItems = $rCount;
 508         }
 509
 510         /**
 511          * Creates part of query for searching after a word ($this->searchString) fields in input table
 512          *
 513          * @param       string          Table, in which the fields are being searched.
 514          * @return      string          Returns part of WHERE-clause for searching, if applicable.
 515          */
 516         function makeSearchString($table)       {
 517                 global $TCA;
 518
 519                         // Make query, only if table is valid and a search string is actually defined:
 520                 if ($TCA[$table] && $this->searchString)        {
 521
 522                                 // Loading full table description - we need to traverse fields:
 523                         t3lib_div::loadTCA($table);
 524
 525                                 // Initialize field array:
 526                         $sfields=array();
 527                         $sfields[]='uid';       // Adding "uid" by default.
 528
 529                                 // Traverse the configured columns and add all columns that can be searched:
 530                         foreach($TCA[$table]['columns'] as $fieldName => $info) {
 531                                 if ($info['config']['type']=='text' || ($info['config']['type']=='input' && !ereg('date|time|int',$info['config']['eval'])))    {
 532                                         $sfields[]=$fieldName;
 533                                 }
 534                         }
 535
 536                                 // If search-fields were defined (and there always are) we create the query:
 537                         if (count($sfields))    {
 538                                 $like = ' LIKE \'%'.$GLOBALS['TYPO3_DB']->quoteStr($this->searchString, $table).'%\'';          // Free-text searching...
 539                                 $queryPart = ' AND ('.implode($like.' OR ',$sfields).$like.')';
 540
 541                                         // Return query:
 542                                 return $queryPart;
 543                         }
 544                 }
 545         }
 546
 547         /**
 548          * Returns the title (based on $code) of a table ($table) with the proper link around. For headers over tables.
 549          * The link will cause the display of all extended mode or not for the table.
 550          *
 551          * @param       string          Table name
 552          * @param       string          Table label
 553          * @return      string          The linked table label
 554          */
 555         function linkWrapTable($table,$code)    {
 556                 if ($this->table!=$table)       {
 557                         return '<a href="'.htmlspecialchars($this->listURL('',$table)).'">'.$code.'</a>';
 558                 } else {
 559                         return '<a href="'.htmlspecialchars($this->listURL('','','sortField,sortRev,table')).'">'.$code.'</a>';
 560                 }
 561         }
 562
 563         /**
 564          * Returns the title (based on $code) of a record (from table $table) with the proper link around (that is for 'pages'-records a link to the level of that record...)
 565          *
 566          * @param       string          Table name
 567          * @param       integer         Item uid
 568          * @param       string          Item title (not htmlspecialchars()'ed yet)
 569          * @param       array           Item row
 570          * @return      string          The item title. Ready for HTML output (is htmlspecialchars()'ed)
 571          */
 572         function linkWrapItems($table,$uid,$code,$row)  {
 573                 global $TCA, $LANG;
 574
 575                 $origCode = $code;
 576
 577                         // If the title is blank, make a "no title" label:
 578                 if (!strcmp($code,'')) {
 579                         $code = '<i>['.$GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.php:labels.no_title',1).']</i> - '.htmlspecialchars(t3lib_div::fixed_lgd_cs(t3lib_BEfunc::getRecordTitle($table,$row),$GLOBALS['BE_USER']->uc['titleLen']));
 580                 } else {
 581                         $code = htmlspecialchars(t3lib_div::fixed_lgd_cs($code, $this->fixedL));
 582                         if ($code != htmlspecialchars($origCode)) {
 583                                 $code = '<span title="'.htmlspecialchars($origCode).'">'.$code.'</span>';
 584                         }
 585                 }
 586
 587                 switch((string)$this->clickTitleMode)   {
 588                         case 'edit':
 589                                         // If the listed table is 'pages' we have to request the permission settings for each page:
 590                                 if ($table=='pages')    {
 591                                         $localCalcPerms = $GLOBALS['BE_USER']->calcPerms(t3lib_BEfunc::getRecord('pages',$row['uid']));
 592                                         $permsEdit = $localCalcPerms&2;
 593                                 } else {
 594                                         $permsEdit = $this->calcPerms&16;
 595                                 }
 596
 597                                         // "Edit" link: ( Only if permissions to edit the page-record of the content of the parent page ($this->id)
 598                                 if ($permsEdit) {
 599                                         $params='&edit['.$table.']['.$row['uid'].']=edit';
 600                                         $code = '<a href="#" onclick="'.htmlspecialchars(t3lib_BEfunc::editOnClick($params,$this->backPath,-1)).'" title="'.$LANG->getLL('edit',1).'">'.
 601                                                         $code.
 602                                                         '</a>';
 603                                 }
 604                         break;
 605                         case 'show':
 606                                         // "Show" link (only pages and tt_content elements)
 607                                 if ($table=='pages' || $table=='tt_content')    {
 608                                         $code = '<a href="#" onclick="'.htmlspecialchars(t3lib_BEfunc::viewOnClick($table=='tt_content'?$this->id.'#'.$row['uid']:$row['uid'])).'" title="'.$LANG->sL('LLL:EXT:lang/locallang_core.php:labels.showPage',1).'">'.
 609                                                         $code.
 610                                                         '</a>';
 611                                 }
 612                         break;
 613                         case 'info':
 614                                 // "Info": (All records)
 615                                 $code = '<a href="#" onclick="'.htmlspecialchars('top.launchView(\''.$table.'\', \''.$row['uid'].'\'); return false;').'" title="'.$LANG->getLL('showInfo',1).'">'.
 616                                         $code.
 617                                         '</a>';
 618                         break;
 619                         default:
 620                                         // Output the label now:
 621                                 if ($table=='pages')    {
 622                                         $code = '<a href="'.htmlspecialchars($this->listURL($uid,'')).'" onclick="setHighlight('.$uid.')">'.$code.'</a>';
 623                                 } else {
 624                                         $code = $this->linkUrlMail($code,$origCode);
 625                                 }
 626                         break;
 627                 }
 628
 629                 return $code;
 630         }
 631
 632         /**
 633          * Wrapping input code in link to URL or email if $testString is either.
 634          *
 635          * @param       string          code to wrap
 636          * @param       string          String which is tested for being a URL or email and which will be used for the link if so.
 637          * @return      string          Link-Wrapped $code value, if $testString was URL or email.
 638          */
 639         function linkUrlMail($code,$testString) {
 640
 641                         // Check for URL:
 642                 $schema = parse_url($testString);
 643                 if ($schema['scheme'] && t3lib_div::inList('http,https,ftp',$schema['scheme'])) {
 644                         return '<a href="'.htmlspecialchars($testString).'" target="_blank">'.$code.'</a>';
 645                 }
 646
 647                         // Check for email:
 648                 if (t3lib_div::validEmail($testString)) {
 649                         return '<a href="mailto:'.htmlspecialchars($testString).'" target="_blank">'.$code.'</a>';
 650                 }
 651
 652                         // Return if nothing else...
 653                 return $code;
 654         }
 655
 656         /**
 657          * Creates the URL to this script, including all relevant GPvars
 658          * Fixed GPvars are id, table, imagemode, returlUrl, search_field, search_levels and showLimit
 659          * The GPvars "sortField" and "sortRev" are also included UNLESS they are found in the $exclList variable.
 660          *
 661          * @param       string          Alternative id value. Enter blank string for the current id ($this->id)
 662          * @param       string          Tablename to display. Enter "-1" for the current table.
 663          * @param       string          Commalist of fields NOT to include ("sortField" or "sortRev")
 664          * @return      string          URL
 665          */
 666         function listURL($altId='',$table=-1,$exclList='')      {
 667                 return $GLOBALS['BACK_PATH'] . $this->script.
 668                         '?id='.(strcmp($altId,'')?$altId:$this->id).
 669                         '&table='.rawurlencode($table==-1?$this->table:$table).
 670                         ($this->thumbs?'&imagemode='.$this->thumbs:'').
 671                         ($this->returnUrl?'&returnUrl='.rawurlencode($this->returnUrl):'').
 672                         ($this->searchString?'&search_field='.rawurlencode($this->searchString):'').
 673                         ($this->searchLevels?'&search_levels='.rawurlencode($this->searchLevels):'').
 674                         ($this->showLimit?'&showLimit='.rawurlencode($this->showLimit):'').
 675                         ($this->firstElementNumber?'&pointer='.rawurlencode($this->firstElementNumber):'').
 676                         ((!$exclList || !t3lib_div::inList($exclList,'sortField')) && $this->sortField?'&sortField='.rawurlencode($this->sortField):'').
 677                         ((!$exclList || !t3lib_div::inList($exclList,'sortRev')) && $this->sortRev?'&sortRev='.rawurlencode($this->sortRev):'')
 678                         ;
 679         }
 680
 681         /**
 682          * Returns "requestUri" - which is basically listURL
 683          *
 684          * @return      string          Content of ->listURL()
 685          */
 686         function requestUri()   {
 687                 return $this->listURL();
 688         }
 689
 690         /**
 691          * Makes the list of fields to select for a table
 692          *
 693          * @param       string          Table name
 694          * @param       boolean         If set, users access to the field (non-exclude-fields) is NOT checked.
 695          * @param       boolean         If set, also adds crdate and tstamp fields (note: they will also be added if user is admin or dontCheckUser is set)
 696          * @return      array           Array, where values are fieldnames to include in query
 697          */
 698         function makeFieldList($table,$dontCheckUser=0,$addDateFields=0)        {
 699                 global $TCA,$BE_USER;
 700
 701                         // Init fieldlist array:
 702                 $fieldListArr = array();
 703
 704                         // Check table:
 705                 if (is_array($TCA[$table]))     {
 706                         t3lib_div::loadTCA($table);
 707
 708                                 // Traverse configured columns and add them to field array, if available for user.
 709                         foreach($TCA[$table]['columns'] as $fN => $fieldValue)  {
 710                                 if ($dontCheckUser ||
 711                                         ((!$fieldValue['exclude'] || $BE_USER->check('non_exclude_fields',$table.':'.$fN)) && $fieldValue['config']['type']!='passthrough'))    {
 712                                         $fieldListArr[]=$fN;
 713                                 }
 714                         }
 715
 716                                 // Add special fields:
 717                         if ($dontCheckUser || $BE_USER->isAdmin())      {
 718                                 $fieldListArr[]='uid';
 719                                 $fieldListArr[]='pid';
 720                         }
 721
 722                                 // Add date fields
 723                         if ($dontCheckUser || $BE_USER->isAdmin() || $addDateFields)    {
 724                                 if ($TCA[$table]['ctrl']['tstamp'])     $fieldListArr[]=$TCA[$table]['ctrl']['tstamp'];
 725                                 if ($TCA[$table]['ctrl']['crdate'])     $fieldListArr[]=$TCA[$table]['ctrl']['crdate'];
 726                         }
 727
 728                                 // Add more special fields:
 729                         if ($dontCheckUser || $BE_USER->isAdmin())      {
 730                                 if ($TCA[$table]['ctrl']['cruser_id'])  $fieldListArr[]=$TCA[$table]['ctrl']['cruser_id'];
 731                                 if ($TCA[$table]['ctrl']['sortby'])     $fieldListArr[]=$TCA[$table]['ctrl']['sortby'];
 732                                 if ($TCA[$table]['ctrl']['versioningWS'])       {
 733                                         $fieldListArr[]='t3ver_id';
 734                                         $fieldListArr[]='t3ver_state';
 735                                         $fieldListArr[]='t3ver_wsid';
 736                                         if ($table==='pages')   {
 737                                                 $fieldListArr[]='t3ver_swapmode';
 738                                         }
 739                                 }
 740                         }
 741                 }
 742                 return $fieldListArr;
 743         }
 744
 745         /**
 746          * Creates an instance of t3lib_pageTree which will select a page tree to $depth and return the object. In that object we will find the ids of the tree.
 747          *
 748          * @param       integer         Page id.
 749          * @param       integer         Depth to go down.
 750          * @param       string          Select clause
 751          * @return      object          t3lib_pageTree instance with created list of ids.
 752          */
 753         function getTreeObject($id,$depth,$perms_clause)        {
 754                 $tree = t3lib_div::makeInstance('t3lib_pageTree');
 755                 $tree->init('AND '.$perms_clause);
 756                 $tree->makeHTML=0;
 757                 $tree->fieldArray = Array('uid','php_tree_stop');
 758                 if ($depth)     {
 759                         $tree->getTree($id, $depth, '');
 760                 }
 761                 $tree->ids[]=$id;
 762                 return $tree;
 763         }
 764
 765         /**
 766          * Redirects to TCEforms (alt_doc) if a record is just localized.
 767          *
 768          * @param       string          string with table, orig uid and language separated by ":"
 769          * @return      void
 770          */
 771         function localizationRedirect($justLocalized)   {
 772                 global $TCA;
 773
 774                 list($table,$orig_uid,$language) = explode(':',$justLocalized);
 775
 776                 if ($TCA[$table] && $TCA[$table]['ctrl']['languageField'] && $TCA[$table]['ctrl']['transOrigPointerField'])     {
 777                         list($localizedRecord) = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows(
 778                                         'uid',
 779                                         $table,
 780                                         $TCA[$table]['ctrl']['languageField'].'='.intval($language).' AND '.
 781                                                 $TCA[$table]['ctrl']['transOrigPointerField'].'='.intval($orig_uid).
 782                                                 t3lib_BEfunc::deleteClause($table).
 783                                                 t3lib_BEfunc::versioningPlaceholderClause($table)
 784                                 );
 785
 786                         if (is_array($localizedRecord)) {
 787                                         // Create parameters and finally run the classic page module for creating a new page translation
 788                                 $params = '&edit['.$table.']['.$localizedRecord['uid'].']=edit';
 789                                 $returnUrl = '&returnUrl='.rawurlencode($this->listURL());
 790                                 $location = $GLOBALS['BACK_PATH'].'alt_doc.php?'.$params.$returnUrl;
 791
 792                                 header('Location: '.t3lib_div::locationHeaderUrl($location));
 793                                 exit;
 794                         }
 795                 }
 796         }
 797 }
 798
 799
 800 if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['typo3/class.db_list.inc']) {
 801         include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['typo3/class.db_list.inc']);
 802 }
 803
 804 ?>