/src/typo3_src-4.2.0alpha1/t3lib/class.t3lib_loaddbgroup.php

<?php
/***************************************************************
*  Copyright notice
*
*  (c) 1999-2006 Kasper Skaarhoj (kasperYYYY@typo3.com)
*  All rights reserved
*
*  This script is part of the TYPO3 project. The TYPO3 project is
*  free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  The GNU General Public License can be found at
*  http://www.gnu.org/copyleft/gpl.html.
*  A copy is found in the textfile GPL.txt and important notices to the license
*  from the author is found in LICENSE.txt distributed with these scripts.
*
*
*  This script is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
class t3lib_loadDBGroup {
                // External, static:
        var $fromTC = 1;                                        // Means that only uid and the label-field is returned
        var $registerNonTableValues=0;          // If set, values that are not ids in tables are normally discarded. By this options they will be preserved.

                // Internal, dynamic:
        var $tableArray=Array();                        // Contains the table names as keys. The values are the id-values for each table. Should ONLY contain proper table names.
        var $itemArray=Array();                         // Contains items in an numeric array (table/id for each). Tablenames here might be "_NO_TABLE"
        var $nonTableArray=array();                     // Array for NON-table elements
        var $additionalWhere=array();
        var $checkIfDeleted = 1;                        // deleted-column is added to additionalWhere... if this is set...
        var $dbPaths=Array();
        var $firstTable = '';                           // Will contain the first table name in the $tablelist (for positive ids)
        var $secondTable = '';                          // Will contain the second table name in the $tablelist (for negative ids)
                // private
        var $MM_is_foreign = 0;         // boolean - if 1, uid_local and uid_foreign are switched, and the current table is inserted as tablename - this means you display a foreign relation "from the opposite side"
        var $MM_oppositeField = '';     // field name at the "local" side of the MM relation
        var $MM_oppositeTable = ''; // only set if MM_is_foreign is set
        var $MM_oppositeFieldConf = ''; // only set if MM_is_foreign is set
        var $MM_isMultiTableRelationship = 0;   // is empty by default; if MM_is_foreign is set and there is more than one table allowed (on the "local" side), then it contains the first table (as a fallback)
        var $currentTable;      // current table => Only needed for reverse relations
        var $undeleteRecord;            // if a record should be undeleted (so do not use the $useDeleteClause on t3lib_BEfunc)


        var $MM_match_fields = array(); // array of fields value pairs that should match while SELECT and will be written into MM table if $MM_insert_fields is not set
        var $MM_insert_fields = array();        // array of fields and value pairs used for insert in MM table
        var $MM_table_where = ''; // extra MM table where


        function start($itemlist, $tablelist, $MMtable='', $MMuid=0, $currentTable='', $conf=array())   {
                        // SECTION: MM reverse relations
                $this->MM_is_foreign = ($conf['MM_opposite_field']?1:0);
                $this->MM_oppositeField = $conf['MM_opposite_field'];
                $this->MM_table_where = $conf['MM_table_where'];
                $this->MM_match_fields = is_array($conf['MM_match_fields']) ? $conf['MM_match_fields'] : array();
                $this->MM_insert_fields = is_array($conf['MM_insert_fields']) ? $conf['MM_insert_fields'] : $this->MM_match_fields;
                
                $this->currentTable = $currentTable;
                if ($this->MM_is_foreign)       {
                        $tmp = ($conf['type']==='group'?$conf['allowed']:$conf['foreign_table']);
                                // normally, $conf['allowed'] can contain a list of tables, but as we are looking at a MM relation from the foreign side, it only makes sense to allow one one table in $conf['allowed']
                        $tmp = t3lib_div::trimExplode(',', $tmp);
                        $this->MM_oppositeTable = $tmp[0];
                        unset($tmp);

                                // only add the current table name if there is more than one allowed field
                        $this->MM_oppositeFieldConf = $GLOBALS['TCA'][$this->MM_oppositeTable]['columns'][$this->MM_oppositeField]['config'];

                        if ($this->MM_oppositeFieldConf['allowed'])     {
                                $oppositeFieldConf_allowed = explode(',', $this->MM_oppositeFieldConf['allowed']);
                                if (count($oppositeFieldConf_allowed) > 1)      {
                                        $this->MM_isMultiTableRelationship = $oppositeFieldConf_allowed[0];
                                }
                        }
                }

                        // SECTION:     normal MM relations

                        // If the table list is "*" then all tables are used in the list:
                if (!strcmp(trim($tablelist),'*'))      {
                        $tablelist = implode(',',array_keys($GLOBALS['TCA']));
                }

                        // The tables are traversed and internal arrays are initialized:
                $tempTableArray = t3lib_div::trimExplode(',',$tablelist,1);
                foreach($tempTableArray as $key => $val)        {
                        $tName = trim($val);
                        $this->tableArray[$tName] = Array();
                        if ($this->checkIfDeleted && $GLOBALS['TCA'][$tName]['ctrl']['delete']) {
                                $fieldN = $tName.'.'.$GLOBALS['TCA'][$tName]['ctrl']['delete'];
                                $this->additionalWhere[$tName].=' AND '.$fieldN.'=0';
                        }
                }

                if (is_array($this->tableArray))        {
                        reset($this->tableArray);
                } else {return 'No tables!';}

                        // Set first and second tables:
                $this->firstTable = key($this->tableArray);             // Is the first table
                next($this->tableArray);
                $this->secondTable = key($this->tableArray);    // If the second table is set and the ID number is less than zero (later) then the record is regarded to come from the second table...

                        // Now, populate the internal itemArray and tableArray arrays:
                if ($MMtable)   {       // If MM, then call this function to do that:
                        $this->readMM($MMtable,$MMuid);
                } elseif ($MMuid && $conf['foreign_field']) {
                                // If not MM but foreign_field, the read the records by the foreign_field
                        $this->readForeignField($MMuid, $conf);
                } else {
                                // If not MM, then explode the itemlist by "," and traverse the list:
                        $this->readList($itemlist);
                                // do automatic default_sortby, if any
                        if ($conf['foreign_default_sortby']) {
                                $this->sortList($conf['foreign_default_sortby']);
                        }
                }
        }

        function readList($itemlist)    {
                if ((string)trim($itemlist)!='')        {
                        $tempItemArray = t3lib_div::trimExplode(',', $itemlist);        // Changed to trimExplode 31/3 04; HMENU special type "list" didn't work if there were spaces in the list... I suppose this is better overall...
                        foreach($tempItemArray as $key => $val) {
                                $isSet = 0;     // Will be set to "1" if the entry was a real table/id:

                                        // Extract table name and id. This is un the formular [tablename]_[id] where table name MIGHT contain "_", hence the reversion of the string!
                                $val = strrev($val);
                                $parts = explode('_',$val,2);
                                $theID = strrev($parts[0]);

                                        // Check that the id IS an integer:
                                if (t3lib_div::testInt($theID)) {
                                                // Get the table name: If a part of the exploded string, use that. Otherwise if the id number is LESS than zero, use the second table, otherwise the first table
                                        $theTable = trim($parts[1]) ? strrev(trim($parts[1])) : ($this->secondTable && $theID<0 ? $this->secondTable : $this->firstTable);
                                                // If the ID is not blank and the table name is among the names in the inputted tableList, then proceed:
                                        if ((string)$theID!='' && $theID && $theTable && isset($this->tableArray[$theTable]))   {
                                                        // Get ID as the right value:
                                                $theID = $this->secondTable ? abs(intval($theID)) : intval($theID);
                                                        // Register ID/table name in internal arrays:
                                                $this->itemArray[$key]['id'] = $theID;
                                                $this->itemArray[$key]['table'] = $theTable;
                                                $this->tableArray[$theTable][] = $theID;
                                                        // Set update-flag:
                                                $isSet=1;
                                        }
                                }

                                        // If it turns out that the value from the list was NOT a valid reference to a table-record, then we might still set it as a NO_TABLE value:
                                if (!$isSet && $this->registerNonTableValues)   {
                                        $this->itemArray[$key]['id'] = $tempItemArray[$key];
                                        $this->itemArray[$key]['table'] = '_NO_TABLE';
                                        $this->nonTableArray[] = $tempItemArray[$key];
                                }
                        }
                }
        }

        function sortList($sortby) {
                        // sort directly without fetching addional data
                if ($sortby == 'uid') {
                        usort($this->itemArray, create_function('$a,$b', 'return $a["id"] < $b["id"] ? -1 : 1;'));
                        // only useful if working on the same table
                } elseif (count($this->tableArray) == 1) {
                        reset($this->tableArray);
                        $table = key($this->tableArray);
                        $uidList = implode(',', current($this->tableArray));

                        if ($uidList) {
                                $this->itemArray = array();
                                $this->tableArray = array();
                                
                                $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('uid', $table, 'uid IN ('.$uidList.')', '', $sortby);
                                while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
                                        $this->itemArray[] = array('id' => $row['uid'], 'table' => $table);
                                        $this->tableArray[$table][] = $row['uid'];
                                }
                                $GLOBALS['TYPO3_DB']->sql_free_result($res);
                        }
                }
        }

        function readMM($tableName,$uid)        {
                $key=0;
                $additionalWhere = '';
                
                if ($this->MM_is_foreign)       {       // in case of a reverse relation
                        $uidLocal_field = 'uid_foreign';
                        $uidForeign_field = 'uid_local';
                        $sorting_field = 'sorting_foreign';

                        if ($this->MM_isMultiTableRelationship) {
                                $additionalWhere .= ' AND ( tablenames="'.$this->currentTable.'"';
                                if ($this->currentTable == $this->MM_isMultiTableRelationship)  {       // be backwards compatible! When allowing more than one table after having previously allowed only one table, this case applies.
                                        $additionalWhere .= ' OR tablenames=""';
                                }
                                $additionalWhere .= ' ) ';
                        }
                        $theTable = $this->MM_oppositeTable;
                } else {        // default
                        $uidLocal_field = 'uid_local';
                        $uidForeign_field = 'uid_foreign';
                        $sorting_field = 'sorting';
                }


                if ($this->MM_table_where) {
                        $additionalWhere.= "\n".str_replace('###THIS_UID###', intval($uid), $this->MM_table_where);
                }
                foreach ($this->MM_match_fields as $field => $value) {
                        $additionalWhere.= ' AND '.$field.'='.$GLOBALS['TYPO3_DB']->fullQuoteStr($value, $tableName);
                }
                
                        // Select all MM relations:
                $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('*', $tableName, $uidLocal_field.'='.intval($uid).$additionalWhere, '', $sorting_field);
                while($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res))       {
                        if (!$this->MM_is_foreign) {    // default
                                $theTable = $row['tablenames'] ? $row['tablenames'] : $this->firstTable;                // If tablesnames columns exists and contain a name, then this value is the table, else it's the firstTable...
                        }
                        if (($row[$uidForeign_field] || $theTable=='pages') && $theTable && isset($this->tableArray[$theTable]))        {

                                $this->itemArray[$key]['id'] = $row[$uidForeign_field];
                                $this->itemArray[$key]['table'] = $theTable;
                                $this->tableArray[$theTable][]= $row[$uidForeign_field];
                        } elseif ($this->registerNonTableValues)        {
                                $this->itemArray[$key]['id'] = $row[$uidForeign_field];
                                $this->itemArray[$key]['table'] = '_NO_TABLE';
                                $this->nonTableArray[] = $row[$uidForeign_field];
                        }
                        $key++;
                }
                $GLOBALS['TYPO3_DB']->sql_free_result($res);
        }

        function writeMM($tableName,$uid,$prependTableName=0)   {

                if ($this->MM_is_foreign)       {       // in case of a reverse relation
                        $uidLocal_field = 'uid_foreign';
                        $uidForeign_field = 'uid_local';
                        $sorting_field = 'sorting_foreign';
                } else {        // default
                        $uidLocal_field = 'uid_local';
                        $uidForeign_field = 'uid_foreign';
                        $sorting_field = 'sorting';
                }

                        // If there are tables...
                $tableC = count($this->tableArray);
                if ($tableC)    {
                        $prep = ($tableC>1||$prependTableName||$this->MM_isMultiTableRelationship) ? 1 : 0;     // boolean: does the field "tablename" need to be filled?
                        $c=0;

                        $additionalWhere_tablenames = '';
                        if ($this->MM_is_foreign && $prep)      {
                                $additionalWhere_tablenames = ' AND tablenames="'.$this->currentTable.'"';
                        }

                        $additionalWhere = '';
                                // add WHERE clause if configured
                        if ($this->MM_table_where) {
                                $additionalWhere.= "\n".str_replace('###THIS_UID###', intval($uid), $this->MM_table_where);
                        }
                                // Select, update or delete only those relations that match the configured fields
                        foreach ($this->MM_match_fields as $field => $value) {
                                $additionalWhere.= ' AND '.$field.'='.$GLOBALS['TYPO3_DB']->fullQuoteStr($value, $tableName);
                        }

                        $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery($uidForeign_field.($prep?', tablenames':''), $tableName, $uidLocal_field.'='.$uid.$additionalWhere_tablenames.$additionalWhere);

                        $oldMMs = array();
                        while($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
                                if (!$this->MM_is_foreign && $prep)     {
                                        $oldMMs[] = array($row['tablenames'], $row[$uidForeign_field]);
                                } else {
                                        $oldMMs[] = $row[$uidForeign_field];
                                }
                        }

                                // For each item, insert it:
                        foreach($this->itemArray as $val)       {
                                $c++;

                                if ($prep || $val['table']=='_NO_TABLE')        {
                                        if ($this->MM_is_foreign)       {       // insert current table if needed
                                                $tablename = $this->currentTable;
                                        } else {
                                                $tablename = $val['table'];
                                        }
                                } else {
                                        $tablename = '';
                                }

                                if(!$this->MM_is_foreign && $prep) {
                                        $item = array($val['table'], $val['id']);
                                } else {
                                        $item = $val['id'];
                                }

                                if (in_array($item, $oldMMs))   {
                                        unset($oldMMs[array_search($item, $oldMMs)]);   // remove the item from the $oldMMs array so after this foreach loop only the ones that need to be deleted are in there.

                                        $whereClause = $uidLocal_field.'='.$uid.' AND '.$uidForeign_field.'='.$val['id'];
                                        if ($tablename) {
                                                $whereClause .= ' AND tablenames="'.$tablename.'"';
                                        }
                                        $GLOBALS['TYPO3_DB']->exec_UPDATEquery($tableName, $whereClause.$additionalWhere, array($sorting_field => $c));
                                } else {

                                        $insertFields = $this->MM_insert_fields;
                                        $insertFields[$uidLocal_field] = $uid;
                                        $insertFields[$uidForeign_field] = $val['id'];
                                        $insertFields[$sorting_field] = $c;
                                        if($tablename)  {
                                                $insertFields['tablenames'] = $tablename;
                                        }

                                        $GLOBALS['TYPO3_DB']->exec_INSERTquery($tableName, $insertFields);
                                }
                        }

                                // Delete all not-used relations:
                        if(is_array($oldMMs) && count($oldMMs) > 0) {
                                $removeClauses = array();
                                foreach($oldMMs as $mmItem) {
                                        if(is_array($mmItem)) {
                                                $removeClauses[] = 'tablenames="'.$mmItem[0].'" AND '.$uidForeign_field.'='.$mmItem[1];
                                        } else {
                                                $removeClauses[] = $uidForeign_field.'='.$mmItem;
                                        }
                                }
                                $deleteAddWhere = ' AND ('.implode(' OR ', $removeClauses).')';
                                $GLOBALS['TYPO3_DB']->exec_DELETEquery($tableName, $uidLocal_field.'='.intval($uid).$deleteAddWhere.$additionalWhere_tablenames.$additionalWhere);
                        }
                }
        }

        function readForeignField($uid, $conf) {
                $key = 0;
                $uid = intval($uid);
                $whereClause = '';
                $foreign_table = $conf['foreign_table'];
                $foreign_table_field = $conf['foreign_table_field'];
                $useDeleteClause = $this->undeleteRecord ? false : true;

                        // search for $uid in foreign_field, and if we have symmetric relations, do this also on symmetric_field
                if ($conf['symmetric_field']) {
                        $whereClause = '('.$conf['foreign_field'].'='.$uid.' OR '.$conf['symmetric_field'].'='.$uid.')';
                } else {
                        $whereClause = $conf['foreign_field'].'='.$uid;
                }
                        // use the deleteClause (e.g. "deleted=0") on this table
                if ($useDeleteClause) {
                        $whereClause .= t3lib_BEfunc::deleteClause($foreign_table);
                }
                        // if it's requested to look for the parent uid AND the parent table,
                        // add an additional SQL-WHERE clause
                if ($foreign_table_field && $this->currentTable) {
                        $whereClause .= ' AND '.$foreign_table_field.'='.$GLOBALS['TYPO3_DB']->fullQuoteStr($this->currentTable, $foreign_table);
                }
                
                        // get the correct sorting field
                if ($conf['foreign_sortby']) {                                                                                  // specific manual sortby for data handled by this field
                        if ($conf['symmetric_sortby'] && $conf['symmetric_field']) {
                                        // sorting depends on, from which side of the relation we're looking at it
                                $sortby = '
                                        CASE
                                                WHEN '.$conf['foreign_field'].'='.$uid.'
                                                THEN '.$conf['foreign_sortby'].'
                                                ELSE '.$conf['symmetric_sortby'].'
                                        END';
                        } else {
                                        // regular single-side behaviour
                                $sortby = $conf['foreign_sortby'];
                        }
                } elseif ($conf['foreign_default_sortby']) {                                                    // specific default sortby for data handled by this field
                        $sortby = $conf['foreign_default_sortby'];
                } elseif ($GLOBALS['TCA'][$foreign_table]['ctrl']['sortby']) {                  // manual sortby for all table records
                        $sortby = $GLOBALS['TCA'][$foreign_table]['ctrl']['sortby'];
                } elseif ($GLOBALS['TCA'][$foreign_table]['ctrl']['default_sortby']) {  // default sortby for all table records
                        $sortby = $GLOBALS['TCA'][$foreign_table]['ctrl']['default_sortby'];
                }

                        // strip a possible "ORDER BY" in front of the $sortby value
                $sortby = $GLOBALS['TYPO3_DB']->stripOrderBy($sortby);
                        // get the rows from storage
                $rows = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows('uid', $foreign_table, $whereClause, '', $sortby);

                if (count($rows)) {
                        foreach ($rows as $row) {
                                $this->itemArray[$key]['id'] = $row['uid'];
                                $this->itemArray[$key]['table'] = $foreign_table;
                                $this->tableArray[$foreign_table][]= $row['uid'];
                                $key++;
                        }
                }
        }

        function writeForeignField($conf, $parentUid, $updateToUid=0, $skipSorting=false) {
                $c = 0;
                $foreign_table = $conf['foreign_table'];
                $foreign_field = $conf['foreign_field'];
                $symmetric_field = $conf['symmetric_field'];
                $foreign_table_field = $conf['foreign_table_field'];

                        // if there are table items and we have a proper $parentUid
                if (t3lib_div::testInt($parentUid) && count($this->tableArray)) {
                                // if updateToUid is not a positive integer, set it to '0', so it will be ignored
                        if (!(t3lib_div::testInt($updateToUid) && $updateToUid > 0)) {
                                $updateToUid = 0;
                        }
                        $fields = 'uid,'.$foreign_field.($symmetric_field ? ','.$symmetric_field : '');

                                // update all items
                        foreach ($this->itemArray as $val) {
                                $uid = $val['id'];
                                $table = $val['table'];

                                        // fetch the current (not overwritten) relation record if we should handle symmetric relations
                                if ($conf['symmetric_field']) {
                                        $row = t3lib_BEfunc::getRecord($table,$uid,$fields,'',false);
                                        $isOnSymmetricSide = t3lib_loadDBGroup::isOnSymmetricSide($parentUid, $conf, $row);
                                }

                                $updateValues = array();

                                        // no update to the uid is requested, so this is the normal behaviour
                                        // just update the fields and care about sorting
                                if (!$updateToUid) {
                                                // Always add the pointer to the parent uid
                                        if ($isOnSymmetricSide) {
                                                $updateValues[$symmetric_field] = $parentUid;
                                        } else {
                                                $updateValues[$foreign_field] = $parentUid;
                                        }
                                        
                                                // if it is configured in TCA also to store the parent table in the child record, just do it
                                        if ($foreign_table_field && $this->currentTable) {
                                                $updateValues[$foreign_table_field] = $this->currentTable;
                                        }

                                                // update sorting columns if not to be skipped
                                        if (!$skipSorting) {
                                                        // get the correct sorting field
                                                if ($conf['foreign_sortby']) {                                                                  // specific manual sortby for data handled by this field 
                                                        $sortby = $conf['foreign_sortby'];
                                                } elseif ($GLOBALS['TCA'][$foreign_table]['ctrl']['sortby']) {  // manual sortby for all table records
                                                        $sortby = $GLOBALS['TCA'][$foreign_table]['ctrl']['sortby'];
                                                }
                                                        // strip a possible "ORDER BY" in front of the $sortby value
                                                $sortby = $GLOBALS['TYPO3_DB']->stripOrderBy($sortby);
                                                $symSortby = $conf['symmetric_sortby'];
        
                                                        // set the sorting on the right side, it depends on who created the relation, so what uid is in the symmetric_field
                                                if ($isOnSymmetricSide && $symSortby) {
                                                        $updateValues[$symSortby] = ++$c;
                                                } elseif ($sortby) {
                                                        $updateValues[$sortby] = ++$c;
                                                }
                                        }

                                        // update to a foreign_field/symmetric_field pointer is requested, normally used on record copies
                                        // only update the fields, if the old uid is found somewhere - for select fields, TCEmain is doing this already!
                                } else {
                                        if ($isOnSymmetricSide) {
                                                $updateValues[$symmetric_field] = $updateToUid;
                                        } else {
                                                $updateValues[$foreign_field] = $updateToUid;
                                        }
                                }

                                if (count($updateValues)) {
                                        $GLOBALS['TYPO3_DB']->exec_UPDATEquery($table, 'uid=' . intval($uid), $updateValues);
                                        $this->updateRefIndex($table, $uid);
                                }
                        }
                }
        }

        function getValueArray($prependTableName='')    {
                        // INIT:
                $valueArray=Array();
                $tableC = count($this->tableArray);

                        // If there are tables in the table array:
                if ($tableC)    {
                                // If there are more than ONE table in the table array, then always prepend table names:
                        $prep = ($tableC>1||$prependTableName) ? 1 : 0;

                                // Traverse the array of items:
                        foreach($this->itemArray as $val)       {
                                $valueArray[]=(($prep && $val['table']!='_NO_TABLE') ? $val['table'].'_' : '').
                                                                        $val['id'];
                        }
                }
                        // Return the array
                return $valueArray;
        }

        function convertPosNeg($valueArray,$fTable,$nfTable)    {
                if (is_array($valueArray) && $fTable)   {
                        foreach($valueArray as $key => $val)    {
                                $val = strrev($val);
                                $parts = explode('_',$val,2);
                                $theID = strrev($parts[0]);
                                $theTable = strrev($parts[1]);

                                if ( t3lib_div::testInt($theID) && (!$theTable || !strcmp($theTable,$fTable) || !strcmp($theTable,$nfTable)) )  {
                                        $valueArray[$key]= $theTable && strcmp($theTable,$fTable) ? $theID*-1 : $theID;
                                }
                        }
                }
                return $valueArray;
        }

        function getFromDB()    {
                        // Traverses the tables listed:
                foreach($this->tableArray as $key => $val)      {
                        if (is_array($val))     {
                                $itemList = implode(',',$val);
                                if ($itemList)  {
                                        $from = '*';
                                        if ($this->fromTC)      {
                                                $from = 'uid,pid';
                                                if ($GLOBALS['TCA'][$key]['ctrl']['label'])     {
                                                        $from.= ','.$GLOBALS['TCA'][$key]['ctrl']['label'];     // Titel
                                                }
                                                if ($GLOBALS['TCA'][$key]['ctrl']['label_alt']) {
                                                        $from.= ','.$GLOBALS['TCA'][$key]['ctrl']['label_alt']; // Alternative Title-Fields
                                                }
                                                if ($GLOBALS['TCA'][$key]['ctrl']['thumbnail']) {
                                                        $from.= ','.$GLOBALS['TCA'][$key]['ctrl']['thumbnail']; // Thumbnail
                                                }
                                        }
                                        $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery($from, $key, 'uid IN ('.$itemList.')'.$this->additionalWhere[$key]);
                                        while($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res))       {
                                                $this->results[$key][$row['uid']]=$row;
                                        }
                                }
                        }
                }
                return $this->results;
        }

        function readyForInterface()    {
                global $TCA;

                if (!is_array($this->itemArray))        {return false;}

                $output=array();
                $perms_clause = $GLOBALS['BE_USER']->getPagePermsClause(1);             // For use when getting the paths....
                $titleLen=intval($GLOBALS['BE_USER']->uc['titleLen']);

                foreach($this->itemArray as $key => $val)       {
                        $theRow = $this->results[$val['table']][$val['id']];
                        if ($theRow && is_array($TCA[$val['table']]))   {
                                $label = t3lib_div::fixed_lgd_cs(strip_tags(t3lib_BEfunc::getRecordTitle($val['table'], $theRow)),$titleLen);
                                $label = ($label)?$label:'[...]';
                                $output[]=str_replace(',','',$val['table'].'_'.$val['id'].'|'.rawurlencode($label));
                        }
                }
                return implode(',',$output);
        }

        function countItems($returnAsArray = true) {
                $count = count($this->itemArray);
                if ($returnAsArray) $count = array($count);
                return $count;
        }

        function updateRefIndex($table,$id)     {
                $refIndexObj = t3lib_div::makeInstance('t3lib_refindex');
                $result = $refIndexObj->updateRefIndexTable($table,$id);
        }

        function isOnSymmetricSide($parentUid, $parentConf, $childRec) {
                return t3lib_div::testInt($childRec['uid']) && $parentConf['symmetric_field'] && $parentUid == $childRec[$parentConf['symmetric_field']]
                        ? true
                        : false;
        }
}


if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_loaddbgroup.php'])       {
        include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_loaddbgroup.php']);
}
?>

---

This documentation has been generated automatically from TYPO3 source code using Doxygen and is provided as is by Cast Iron Coding as a courtesy to other TYPO3 developers and users. Please consider Cast Iron Coding — a full-service web development agency in Portland, Oregon specializing in TYPO3 extension development — for all of your TYPO3 development and consulting needs!