class.tslib_content.php

Go to the documentation of this file.

<?php
/***************************************************************
 * Copyright notice
 *
 * (c) 1999-2011 Kasper Skårhøj (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!
 ***************************************************************/
/**
 * Contains classes for Content Rendering based on TypoScript Template configuration
 *
 * $Id: class.tslib_content.php 10547 2011-02-22 20:03:57Z lolli $
 * Revised for TYPO3 3.6 June/2003 by Kasper Skårhøj
 * XHTML compliant
 *
 * class tslib_cObj         :       All main TypoScript features, rendering of content objects (cObjects). This class is the backbone of TypoScript Template rendering.
 * class tslib_controlTable     :       Makes a table CTABLE (TS cObject)
 * class tslib_tableOffset      :       Makes a table-offset (TS)
 * class tslib_frameset         :       Generates framesets (TS)
 *
 * @author  Kasper Skårhøj <kasperYYYY@typo3.com>
 */
/**
 * [CLASS/FUNCTION INDEX of SCRIPT]
 *
 *
 *
 * 256: class tslib_cObj
 * 353:     function start($data,$table='')
 * 387:     function setParent($data,$currentRecord)
 *
 * SECTION: CONTENT_OBJ:
 * 412:     function getCurrentVal()
 * 423:     function setCurrentVal($value)
 * 436:     function cObjGet($setup,$addKey='')
 * 460:     function cObjGetSingle($name,$conf,$TSkey='__')
 *
 * SECTION: Functions rendering content objects (cObjects)
 * 629:     function HTML($conf)
 * 640:     function TEXT($conf)
 * 651:     function CLEARGIF($conf)
 * 670:     function COBJ_ARRAY($conf,$ext='')
 * 706:     function USER($conf,$ext='')
 * 733:     function FILE($conf)
 * 749:     function IMAGE($conf)
 * 768:     function IMG_RESOURCE($conf)
 * 780:     function IMGTEXT($conf)
 * 1203:     function CONTENT($conf)
 * 1290:     function RECORDS($conf)
 * 1370:     function HMENU($conf)
 * 1402:     function CTABLE ($conf)
 * 1440:     function OTABLE ($conf)
 * 1455:     function COLUMNS ($conf)
 * 1534:     function HRULER ($conf)
 * 1559:     function CASEFUNC ($conf)
 * 1584:     function LOAD_REGISTER($conf,$name)
 * 1624:     function FORM($conf,$formData='')
 * 2145:     function SEARCHRESULT($conf)
 * 2311:     function PHP_SCRIPT($conf,$ext='')
 * 2354:     function TEMPLATE($conf)
 * 2505:     function MULTIMEDIA($conf)
 *
 * SECTION: Various helper functions for content objects:
 * 2592:     function getSlidePids($pidList, $pidConf)
 * 2623:     function getFieldDefaultValue($noValueInsert, $fieldName, $defaultVal)
 * 2641:     function cImage($file,$conf)
 * 2669:     function getBorderAttr($borderAttr)
 * 2685:     function imageLinkWrap($string,$imageFile,$conf)
 * 2765:     function fileResource($fName, $addParams='alt="" title=""')
 * 2788:     function lastChanged($tstamp)
 * 2805:     function linkWrap($content,$wrap)
 * 2824:     function getAltParam($conf, $longDesc=TRUE)
 * 2859:     function cleanFormName($name)
 * 2875:     function getATagParams($conf, $addGlobal=1)
 *
 * SECTION: HTML template processing functions
 * 2922:     function getSubpart($content, $marker)
 * 2938:     function substituteSubpart($content,$marker,$subpartContent,$recursive=1)
 * 2951:     function substituteMarker($content,$marker,$markContent)
 * 2971:     function substituteMarkerArrayCached($content,$markContentArray=array(),$subpartContentArray=array(),$wrappedSubpartContentArray=array())
 * 3069:     function substituteMarkerArray($content,$markContentArray,$wrap='',$uppercase=0)
 * 3081:     function substituteMarkerInObject(&$tree, $markContentArray)
 * 3104:     function fillInMarkerArray($markContentArray, $row, $fieldList='', $nl2br=TRUE, $prefix='FIELD_', $HSC=FALSE)
 *
 * SECTION: "stdWrap" + sub functions
 * 3167:     function stdWrap($content,$conf)
 * 3364:     function numRows($conf)
 * 3388:     function listNum($content,$listNum,$char)
 * 3408:     function checkIf($conf)
 * 3471:     function filelist($data)
 * 3553:     function clean_directory($theDir)
 * 3571:     function HTMLparser_TSbridge($theValue, $conf)
 * 3585:     function dataWrap($content,$wrap)
 * 3598:     function insertData($str)
 * 3628:     function prefixComment($str,$conf,$content)
 * 3652:     function substring($content,$options)
 * 3670:     function crop($content,$options)
 * 3702:     function removeBadHTML($text, $conf)
 * 3746:     function textStyle($theValue, $conf)
 * 3813:     function tableStyle($theValue, $conf)
 * 3854:     function addParams($content,$conf)
 * 3895:     function filelink($theValue, $conf)
 * 3966:     function locDataJU($jumpUrl,$conf)
 * 3997:     function calc($val)
 * 4026:     function calcIntExplode($delim, $string)
 * 4046:     function splitObj($value, $conf)
 * 4108:     function parseFunc($theValue, $conf, $ref='')
 * 4218:     function _parseFunc ($theValue, $conf)
 * 4424:     function encaps_lineSplit($theValue, $conf)
 * 4507:     function http_makelinks($data,$conf)
 * 4574:     function mailto_makelinks($data,$conf)
 * 4617:     function getImgResource($file,$fileArray)
 *
 * SECTION: Data retrieval etc.
 * 4810:     function getFieldVal($field)
 * 4830:     function getData($string,$fieldArray)
 * 4975:     function rootLineValue($key,$field,$slideBack=0,$altRootLine='')
 * 4997:     function getGlobal($var, $source=NULL)
 * 5033:     function getKey($key,$arr)
 * 5056:     function TCAlookup($inputValue,$conf)
 *
 * SECTION: Link functions (typolink)
 * 5116:     function typoLink($linktxt, $conf)
 * 5481:     function typoLink_URL($conf)
 * 5499:     function getTypoLink($label,$params,$urlParameters=array(),$target='')
 * 5526:     function getTypoLink_URL($params,$urlParameters=array(),$target='')
 * 5538:     function typolinkWrap($conf)
 * 5551:     function currentPageUrl($urlParameters=array(),$id=0)
 * 5564:     function getClosestMPvalueForPage($pageId, $raw=FALSE)
 * 5619:     function getMailTo($mailAddress,$linktxt,$initP='?')
 * 5658:     function getQueryArguments($conf,$overruleQueryArgs=array(),$forceArgs=FALSE)
 *
 * SECTION: Miscellaneous functions, stand alone
 * 5754:     function wrap($content,$wrap,$char='|')
 * 5770:     function noTrimWrap($content,$wrap)
 * 5784:     function wrapSpace($content, $wrap)
 * 5810:     function callUserFunction($funcName,$conf,$content)
 * 5851:     function processParams($params)
 * 5869:     function keywords($content)
 * 5886:     function caseshift($theValue, $case)
 * 5911:     function HTMLcaseshift($theValue, $case)
 * 5940:     function bytes($sizeInBytes,$labels)
 * 5951:     function calcAge($seconds,$labels)
 * 5983:     function sendNotifyEmail($msg, $recipients, $cc, $email_from, $email_fromName='', $replyTo='')
 * 6010:     function URLqMark($url,$params)
 * 6026:     function checkEmail($email)
 * 6038:     function clearTSProperties($TSArr,$propList)
 * 6057:     function mergeTSRef($confArr,$prop)
 * 6080:     function joinTSarrays($conf,$old_conf)
 * 6103:     function gifBuilderTextBox($gifbuilderConf, $conf, $text)
 * 6159:     function linebreaks($string,$chars,$maxLines=0)
 * 6190:     function getUpdateJS($dataArray, $formName, $arrPrefix, $fieldList)
 *
 * SECTION: Database functions, making of queries
 * 6260:     function DBgetDelete($table, $uid, $doExec=FALSE)
 * 6292:     function DBgetUpdate($table, $uid, $dataArr, $fieldList, $doExec=FALSE)
 * 6334:     function DBgetInsert($table, $pid, $dataArr, $fieldList, $doExec=FALSE)
 * 6371:     function DBmayFEUserEdit($table,$row, $feUserRow, $allowedGroups='',$feEditSelf=0)
 * 6411:     function DBmayFEUserEditSelect($table,$feUserRow,$allowedGroups='',$feEditSelf=0)
 * 6451:     function enableFields($table,$show_hidden=0)
 * 6475:     function getTreeList($id,$depth,$begin=0,$dontCheckEnableFields=FALSE,$addSelectFields='',$moreWhereClauses='', $prevId_array=array(), $recursionLevel=0)
 * 6583:     function whereSelectFromList($field,$value)
 * 6601:     function exec_mm_query($select,$local_table,$mm_table,$foreign_table,$whereClause='',$groupBy='',$orderBy='',$limit='')
 * 6628:     function exec_mm_query_uidList($select,$local_table_uidlist,$mm_table,$foreign_table='',$whereClause='',$groupBy='',$orderBy='',$limit='')
 * 6649:     function searchWhere($sw,$searchFieldList,$searchTable='')
 * 6685:     function exec_getQuery($table, $conf)
 * 6703:     function getQuery($table, $conf, $returnQueryArray=FALSE)
 * 6783:     function getWhere($table,$conf, $returnQueryArray=FALSE)
 * 6878:     function checkPidArray($listArr)
 * 6902:     function checkPid($uid)
 *
 * SECTION: Frontend editing functions
 * 6959:     function editPanel($content, $conf, $currentRecord='', $dataArr=array())
 * 7146:     function editIcons($content,$params, $conf=array(), $currentRecord='', $dataArr=array(),$addUrlParamStr='')
 * 7228:     function editPanelLinkWrap($string,$formName,$cmd,$currentRecord='',$confirm='',$nPid='')
 * 7270:     function editPanelLinkWrap_doWrap($string,$url,$currentRecord)
 * 7298:     function editPanelPreviewBorder($table,$row,$content,$thick,$conf=array())
 * 7320:     function isDisabled($table,$row)
 *
 *
 * 7351: class tslib_frameset
 * 7361:     function make($setup)
 * 7398:     function frameParams($setup, $typeNum)
 * 7426:     function framesetParams($setup)
 *
 *
 * 7459: class tslib_tableOffset
 * 7471:     function start($content,$offset)
 *
 *
 * 7549: class tslib_controlTable
 * 7584:     function start($offset,$cMargins)
 *
 * TOTAL FUNCTIONS: 135
 * (This index is automatically created/updated by the extension "extdeveval")
 *
 */



/**
 * This class contains all main TypoScript features.
 * This includes the rendering of TypoScript content objects (cObjects).
 * Is the backbone of TypoScript Template rendering.
 *
 * There are lots of functions you can use from your include-scripts.
 * The class "tslib_cObj" is normally instantiated and referred to as "cObj".
 * When you call your own PHP-code typically through a USER or USER_INT cObject then it is this class that instantiates the object and calls the main method. Before it does so it will set (if you are using classes) a reference to itself in the internal variable "cObj" of the object. Thus you can access all functions and data from this class by $this->cObj->... from within you classes written to be USER or USER_INT content objects.
 *
 * @author  Kasper Skårhøj <kasperYYYY@typo3.com>
 * @package TYPO3
 * @subpackage tslib
 */
class tslib_cObj {

    var $align = array(
        'center',
        'right',
        'left'
    );

    /**
     * stdWrap functions in their correct order
     *
     * @see stdWrap()
     */
    var $stdWrapOrder = array(
        'stdWrapPreProcess' => 'hook', // this is a placeholder for the first Hook
        'setContentToCurrent' => 'boolean',
        'setContentToCurrent.' => 'array',
        'setCurrent' => 'string',
        'setCurrent.' => 'array',
        'lang.' => 'array',
        'data' => 'getText',
        'data.' => 'array',
        'field' => 'fieldName',
        'field.' => 'array',
        'current' => 'boolean',
        'current.' => 'array',
        'cObject' => 'cObject',
        'cObject.' => 'array',
        'numRows.' => 'array',
        'filelist' => 'dir',
        'filelist.' => 'array',
        'preUserFunc' => 'functionName',
        'stdWrapOverride' => 'hook', // this is a placeholder for the second Hook
        'override' => 'string',
        'override.' => 'array',
        'preIfEmptyListNum' => 'listNum',
        'preIfEmptyListNum.' => 'array',
        'ifEmpty' => 'string',
        'ifEmpty.' => 'array',
        'ifBlank' => 'string',
        'ifBlank.' => 'array',
        'listNum' => 'listNum',
        'listNum.' => 'array',
        'trim' => 'boolean',
        'trim.' => 'array',
        'stdWrap' => 'stdWrap',
        'stdWrap.' => 'array',
        'stdWrapProcess' => 'hook', // this is a placeholder for the third Hook
        'required' => 'boolean',
        'required.' => 'array',
        'if.' => 'array',
        'fieldRequired' => 'fieldName',
        'fieldRequired.' => 'array',
        'csConv' => 'string',
        'csConv.' => 'array',
        'parseFunc' => 'objectpath',
        'parseFunc.' => 'array',
        'HTMLparser' => 'boolean',
        'HTMLparser.' => 'array',
        'split.' => 'array',
        'prioriCalc' => 'boolean',
        'prioriCalc.' => 'array',
        'char' => 'integer',
        'char.' => 'array',
        'intval' => 'boolean',
        'intval.' => 'array',
        'numberFormat.' => 'array',
        'date' => 'dateconf',
        'date.' => 'array',
        'strftime' => 'strftimeconf',
        'strftime.' => 'array',
        'age' => 'boolean',
        'age.' => 'array',
        'case' => 'case',
        'case.' => 'array',
        'bytes' => 'boolean',
        'bytes.' => 'array',
        'substring' => 'parameters',
        'substring.' => 'array',
        'removeBadHTML' => 'boolean',
        'removeBadHTML.' => 'array',
        'cropHTML' => 'crop',
        'cropHTML.' => 'array',
        'stripHtml' => 'boolean',
        'stripHtml.' => 'array',
        'crop' => 'crop',
        'crop.' => 'array',
        'rawUrlEncode' => 'boolean',
        'rawUrlEncode.' => 'array',
        'htmlSpecialChars' => 'boolean',
        'htmlSpecialChars.' => 'array',
        'doubleBrTag' => 'string',
        'doubleBrTag.' => 'array',
        'br' => 'boolean',
        'br.' => 'array',
        'brTag' => 'string',
        'brTag.' => 'array',
        'encapsLines.' => 'array',
        'keywords' => 'boolean',
        'keywords.' => 'array',
        'innerWrap' => 'wrap',
        'innerWrap.' => 'array',
        'innerWrap2' => 'wrap',
        'innerWrap2.' => 'array',
        'fontTag' => 'wrap',
        'fontTag.' => 'array',
        'addParams.' => 'array',
        'textStyle.' => 'array',
        'tableStyle.' => 'array',
        'filelink.' => 'array',
        'preCObject' => 'cObject',
        'preCObject.' => 'array',
        'postCObject' => 'cObject',
        'postCObject.' => 'array',
        'wrapAlign' => 'align',
        'wrapAlign.' => 'array',
        'typolink.' => 'array',
        'TCAselectItem.' => 'array',
        'space' => 'space',
        'space.' => 'array',
        'spaceBefore' => 'int',
        'spaceBefore.' => 'array',
        'spaceAfter' => 'int',
        'spaceAfter.' => 'array',
        'wrap' => 'wrap',
        'wrap.' => 'array',
        'noTrimWrap' => 'wrap',
        'noTrimWrap.' => 'array',
        'wrap2' => 'wrap',
        'wrap2.' => 'array',
        'dataWrap' => 'dataWrap',
        'dataWrap.' => 'array',
        'prepend' => 'cObject',
        'prepend.' => 'array',
        'append' => 'cObject',
        'append.' => 'array',
        'wrap3' => 'wrap',
        'wrap3.' => 'array',
        'outerWrap' => 'wrap',
        'outerWrap.' => 'array',
        'insertData' => 'boolean',
        'insertData.' => 'array',
        'offsetWrap' => 'space',
        'offsetWrap.' => 'array',
        'postUserFunc' => 'functionName',
        'postUserFuncInt' => 'functionName',
        'prefixComment' => 'string',
        'prefixComment.' => 'array',
        'editIcons' => 'string',
        'editIcons.' => 'array',
        'editPanel' => 'boolean',
        'editPanel.' => 'array',
        'stdWrapPostProcess' => 'hook', // this is a placeholder for the last Hook
        'debug' => 'boolean',
        'debug.' => 'array',
        'debugFunc' => 'boolean',
        'debugFunc.' => 'array',
        'debugData' => 'boolean',
        'debugData.' => 'array'
    );

    /**
     * Holds ImageMagick parameters and extensions used for compression
     *
     * @see IMGTEXT()
     *
     * 0= Default
     * 1= Dont change! (removes all parameters for the image_object!!)
     * 1x = GIFs
     * 2x = JPGs
     */
    var $image_compression = array(
        10 => array(
            'params' => '', 'ext' => 'gif'
        ),
        11 => array(
            'params' => '-colors 128', 'ext' => 'gif'
        ),
        12 => array(
            'params' => '-colors 64', 'ext' => 'gif'
        ),
        13 => array(
            'params' => '-colors 32', 'ext' => 'gif'
        ),
        14 => array(
            'params' => '-colors 16', 'ext' => 'gif'
        ),
        15 => array(
            'params' => '-colors 8', 'ext' => 'gif'
        ),

        20 => array(
            'params' => '-quality 100', 'ext' => 'jpg'
        ),
        21 => array(
            'params' => '-quality 90', 'ext' => 'jpg'
        ),
        22 => array(
            'params' => '-quality 80', 'ext' => 'jpg'
        ),
        23 => array(
            'params' => '-quality 70', 'ext' => 'jpg'
        ),
        24 => array(
            'params' => '-quality 60', 'ext' => 'jpg'
        ),
        25 => array(
            'params' => '-quality 50', 'ext' => 'jpg'
        ),
        26 => array(
            'params' => '-quality 40', 'ext' => 'jpg'
        ),
        27 => array(
            'params' => '-quality 30', 'ext' => 'jpg'
        ),
        28 => array(
            'params' => '-quality 20', 'ext' => 'jpg'
        ),

        30 => array(
            'params' => '-colors 256', 'ext' => 'png'
        ),
        31 => array(
            'params' => '-colors 128', 'ext' => 'png'
        ),
        32 => array(
            'params' => '-colors 64', 'ext' => 'png'
        ),
        33 => array(
            'params' => '-colors 32', 'ext' => 'png'
        ),
        34 => array(
            'params' => '-colors 16', 'ext' => 'png'
        ),
        35 => array(
            'params' => '-colors 8', 'ext' => 'png'
        ),
        39 => array(
            'params' => '', 'ext' => 'png'
        ),
    );

    /**
     * ImageMagick parameters for image effects
     *
     * @see IMGTEXT()
     */
    var $image_effects = array(
        1 => '-rotate 90',
        2 => '-rotate 270',
        3 => '-rotate 180',
        10 => '-colorspace GRAY',
        11 => '-sharpen 70',
        20 => '-normalize',
        23 => '-contrast',
        25 => '-gamma 1.3',
        26 => '-gamma 0.8'
    );

    /**
     * Loaded with the current data-record.
     *
     * If the instance of this class is used to render records from the database those records are found in this array.
     * The function stdWrap has TypoScript properties that fetch field-data from this array.
     * @see init()
     */
    var $data = array();
    protected $table = '';
    var $oldData = array(); // Used for backup...
    var $alternativeData = ''; // If this is set with an array before stdWrap, it's used instead of $this->data in the data-property in stdWrap
    var $parameters = array(); // Used by the parseFunc function and is loaded with tag-parameters when parsing tags.
    var $currentValKey = 'currentValue_kidjls9dksoje';
    var $currentRecord = ''; // This is set to the [table]:[uid] of the record delivered in the $data-array, if the cObjects CONTENT or RECORD is in operation. Note that $GLOBALS['TSFE']->currentRecord is set to an equal value but always indicating the latest record rendered.
    var $currentRecordTotal = 0; // Set in cObj->RECORDS and cObj->CONTENT to the current number of records selected in a query.
    var $currentRecordNumber = 0; // Incremented in cObj->RECORDS and cObj->CONTENT before each record rendering.
    var $parentRecordNumber = 0; // Incremented in parent cObj->RECORDS and cObj->CONTENT before each record rendering.
    var $parentRecord = array(); // If the tslib_cObj was started from CONTENT, RECORD or SEARCHRESULT cObject's this array has two keys, 'data' and 'currentRecord' which indicates the record and data for the parent cObj.
    var $regObj; // This may be set as a reference to the calling object of eg. cObjGetSingle. Anyway, just use it as you like. It's used in productsLib.inc for example.


        // internal
    var $INT_include = 0; // Is set to 1 if the instance of this cObj is executed from a PHP_SCRIPT_INT -include script (see pagegen, bottom of document)
    var $checkPid_cache = array(); // This is used by checkPid, that checks if pages are accessible. The $checkPid_cache['page_uid'] is set TRUE or FALSE upon this check featuring a caching function for the next request.
    var $checkPid_badDoktypeList = '255';
    var $lastTypoLinkUrl = ''; // This will be set by typoLink() to the url of the most recent link created.
    var $lastTypoLinkTarget = ''; // DO. link target.
    var $lastTypoLinkLD = array();
    var $substMarkerCache = array(); // Caching substituteMarkerArrayCached function
    var $recordRegister = array(); // array that registers rendered content elements (or any table) to make sure they are not rendered recursively!
    var $cObjHookObjectsArr = array(); // Containig hooks for userdefined cObjects
    protected $stdWrapHookObjects = array(); // Containing hook objects for stdWrap
    protected $getImgResourceHookObjects; // Containing hook objects for getImgResource

    /**
     * @var array with members of tslib_content_abstract
     */
    protected $contentObjects = array();

    /**
     * Set to TRUE by doConvertToUserIntObject() if USER object wants to become USER_INT
     */
    public $doConvertToUserIntObject = FALSE;

    /**
     * Indicates current object type. Can hold one of OBJECTTYPE_ constants or FALSE.
     * The value is set and reset inside USER() function. Any time outside of
     * USER() it is FALSE.
     */
    protected $userObjectType = FALSE;

    /**
     * Indicates that object type is USER.
     *
     * @see tslib_cObjh::$userObjectType
     */
    const OBJECTTYPE_USER_INT = 1;

    /**
     * Indicates that object type is USER.
     *
     * @see tslib_cObjh::$userObjectType
     */
    const OBJECTTYPE_USER = 2;

    /**
     * Class constructor.
     * Well, it has to be called manually since it is not a real constructor function.
     * So after making an instance of the class, call this function and pass to it a database record and the tablename from where the record is from. That will then become the "current" record loaded into memory and accessed by the .fields property found in eg. stdWrap.
     *
     * @param   array       $data   the record data that is rendered.
     * @param   string      $table  the table that the data record is from.
     * @return  void
     */
    function start($data, $table = '') {
        global $TYPO3_CONF_VARS;
        $this->data = $data;
        $this->table = $table;
        $this->currentRecord = $table ? $table . ':' . $this->data['uid'] : '';
        $this->parameters = array();
        if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['cObjTypeAndClass'])) {
            foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['cObjTypeAndClass'] as $classArr) {
                $this->cObjHookObjectsArr[$classArr[0]] = t3lib_div::getUserObj($classArr[1]);
            }
        }

        $this->stdWrapHookObjects = array();
        if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['stdWrap'])) {
            foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['stdWrap'] as $classData) {
                $hookObject = t3lib_div::getUserObj($classData);

                if (!($hookObject instanceof tslib_content_stdWrapHook)) {
                    throw new UnexpectedValueException(
                        $classData . ' must implement interface tslib_content_stdWrapHook',
                        1195043965
                    );
                }

                $this->stdWrapHookObjects[] = $hookObject;
            }
        }

        if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['postInit'])) {
            foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['postInit'] as $classData) {
                $postInitializationProcessor = t3lib_div::getUserObj($classData);

                if (!($postInitializationProcessor instanceof tslib_content_PostInitHook)) {
                    throw new UnexpectedValueException(
                        $classData . ' must implement interface tslib_content_PostInitHook',
                        1274563549
                    );
                }

                $postInitializationProcessor->postProcessContentObjectInitialization($this);
            }
        }
    }

    /**
     * Clone helper.
     *
     * Resets the references to the TypoScript Content Object implementation
     * objects of tslib_content_*. Otherwise they would still point to the
     * original tslib_cObj instance's tslib_content_* instances, they in return
     * would back-reference to the original tslib_cObj instance instead of the
     * newly cloned tslib_cObj instance.
     *
     * @see http://bugs.typo3.org/view.php?id=16568
     */
    public function __clone() {
        $this->contentObjects = array();
    }

    /**
     * Gets the 'getImgResource' hook objects.
     * The first call initializes the accordant objects.
     *
     * @return  array       The 'getImgResource' hook objects (if any)
     */
    protected function getGetImgResourceHookObjects() {
        if (!isset($this->getImgResourceHookObjects)) {
            $this->getImgResourceHookObjects = array();

            if (is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['getImgResource'])) {
                foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['getImgResource'] as $classData) {
                    $hookObject = t3lib_div::getUserObj($classData);

                    if (!($hookObject instanceof tslib_cObj_getImgResourceHook)) {
                        throw new UnexpectedValueException(
                            '$hookObject must implement interface tslib_cObj_getImgResourceHook',
                            1218636383
                        );
                    }

                    $this->getImgResourceHookObjects[] = $hookObject;
                }
            }
        }

        return $this->getImgResourceHookObjects;
    }

    /**
     * Sets the internal variable parentRecord with information about current record.
     * If the tslib_cObj was started from CONTENT, RECORD or SEARCHRESULT cObject's this array has two keys, 'data' and 'currentRecord' which indicates the record and data for the parent cObj.
     *
     * @param   array       $data: The record array
     * @param   string      $currentRecord: This is set to the [table]:[uid] of the record delivered in the $data-array, if the cObjects CONTENT or RECORD is in operation. Note that $GLOBALS['TSFE']->currentRecord is set to an equal value but always indicating the latest record rendered.
     * @return  void
     * @access private
     */
    function setParent($data, $currentRecord) {
        $this->parentRecord = array(
            'data' => $data,
            'currentRecord' => $currentRecord
        );
    }



    /***********************************************
     *
     * CONTENT_OBJ:
     *
     ***********************************************/

    /**
     * Returns the "current" value.
     * The "current" value is just an internal variable that can be used by functions to pass a single value on to another function later in the TypoScript processing.
     * It's like "load accumulator" in the good old C64 days... basically a "register" you can use as you like.
     * The TSref will tell if functions are setting this value before calling some other object so that you know if it holds any special information.
     *
     * @return  mixed       The "current" value
     */
    function getCurrentVal() {
        return $this->data[$this->currentValKey];
    }

    /**
     * Sets the "current" value.
     *
     * @param   mixed       The variable that you want to set as "current"
     * @return  void
     * @see getCurrentVal()
     */
    function setCurrentVal($value) {
        $this->data[$this->currentValKey] = $value;
    }

    /**
     * Rendering of a "numerical array" of cObjects from TypoScript
     * Will call ->cObjGetSingle() for each cObject found and accumulate the output.
     *
     * @param   array       $setup: array with cObjects as values.
     * @param   string      $addKey: A prefix for the debugging information
     * @return  string      Rendered output from the cObjects in the array.
     * @see cObjGetSingle()
     */
    function cObjGet($setup, $addKey = '') {
        if (is_array($setup)) {
            $sKeyArray = t3lib_TStemplate::sortedKeyList($setup);
            $content = '';
            foreach ($sKeyArray as $theKey) {
                $theValue = $setup[$theKey];
                if (intval($theKey) && !strstr($theKey, '.')) {
                    $conf = $setup[$theKey . '.'];
                    $content .= $this->cObjGetSingle($theValue, $conf, $addKey . $theKey); // Get the contentObject
                }
            }
            return $content;
        }
    }

    /**
     * Renders a content object
     *
     * @param   string      The content object name, eg. "TEXT" or "USER" or "IMAGE"
     * @param   array       The array with TypoScript properties for the content object
     * @param   string      A string label used for the internal debugging tracking.
     * @return  string      cObject output
     */
    function cObjGetSingle($name, $conf, $TSkey = '__') {
        global $TYPO3_CONF_VARS;

        $content = '';
            // Checking that the function is not called eternally. This is done by interrupting at a depth of 100
        $GLOBALS['TSFE']->cObjectDepthCounter--;
        if ($GLOBALS['TSFE']->cObjectDepthCounter > 0) {
            $name = trim($name);
            if ($GLOBALS['TT']->LR)
                $GLOBALS['TT']->push($TSkey, $name);

                // Checking if the COBJ is a reference to another object. (eg. name of 'blabla.blabla = < styles.something')
            if (substr($name, 0, 1) == '<') {
                $key = trim(substr($name, 1));
                $cF = t3lib_div::makeInstance('t3lib_TSparser');
                    // $name and $conf is loaded with the referenced values.
                $old_conf = $conf;
                list ($name, $conf) = $cF->getVal($key, $GLOBALS['TSFE']->tmpl->setup);
                if (is_array($old_conf) && count($old_conf)) {
                    $conf = $this->joinTSarrays($conf, $old_conf);
                }
                    // Getting the cObject
                $GLOBALS['TT']->incStackPointer();
                $content .= $this->cObjGetSingle($name, $conf, $key);
                $GLOBALS['TT']->decStackPointer();
            } else {

                $hooked = FALSE;
                    // Application defined cObjects
                foreach ($this->cObjHookObjectsArr as $cObjName => $hookObj) {
                    if (($name === $cObjName) && method_exists($hookObj, 'cObjGetSingleExt')) {
                        $content .= $hookObj->cObjGetSingleExt($name, $conf, $TSkey, $this);
                        $hooked = TRUE;
                    }
                }
                if (!$hooked) {
                    $contentObject = $this->getContentObject($name);
                    if ($contentObject) {
                        $content .= $contentObject->render($conf);
                    } else {
                                // call hook functions for extra processing
                            if ($name && is_array($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['cObjTypeAndClassDefault'])) {
                                foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['cObjTypeAndClassDefault'] as $classData) {
                                    $hookObject = t3lib_div::getUserObj($classData);

                                    if (!($hookObject instanceof tslib_content_cObjGetSingleHook)) {
                                        throw new UnexpectedValueException(
                                            '$hookObject must implement interface tslib_content_cObjGetSingleHook',
                                            1195043731
                                        );
                                    }
                                    /* @var $hookObject tslib_content_cObjGetSingleHook */
                                    $content .= $hookObject->getSingleContentObject($name, (array) $conf, $TSkey, $this);
                                }
                        } else {
                                // log error in AdminPanel
                            $warning = sprintf('Content Object "%s" does not exist', $name);
                            $GLOBALS['TT']->setTSlogMessage($warning, 2);
                        }
                    }
                }
            }
            if ($GLOBALS['TT']->LR)
                $GLOBALS['TT']->pull($content);
        }
            // Increasing on exit...
        $GLOBALS['TSFE']->cObjectDepthCounter++;
        return $content;
    }

    /**
     * Returns a new content object of type $name.
     *
     * @param string $name
     * @return tslib_content_abstract
     */
    public function getContentObject($name) {
        $classMapping = array(
            'HTML' => 'Html',
            'TEXT' => 'Text',
            'CASE' => 'Case',
            'CLEARGIF' => 'ClearGif',
            'COBJ_ARRAY' => 'ContentObjectArray',
            'COA' => 'ContentObjectArray',
            'COA_INT' => 'ContentObjectArrayInternal',
            'USER' => 'User',
            'USER_INT' => 'UserInternal',
            'FILE' => 'File',
            'IMAGE' => 'Image',
            'IMG_RESOURCE' => 'ImageResource',
            'IMGTEXT' => 'ImageText',
            'CONTENT' => 'Content',
            'RECORDS' => 'Records',
            'HMENU' => 'HierarchicalMenu',
            'CTABLE' => 'ContentTable',
            'OTABLE' => 'OffsetTable',
            'COLUMNS' => 'Columns',
            'HRULER' => 'HorizontalRuler',
            'CASEFUNC' => 'Case',
            'LOAD_REGISTER' => 'LoadRegister',
            'RESTORE_REGISTER' => 'RestoreRegister',
            'FORM' => 'Form',
            'SEARCHRESULT' => 'SearchResult',
            'PHP_SCRIPT' => 'PhpScript',
            'PHP_SCRIPT_INT' => 'PhpScriptInternal',
            'PHP_SCRIPT_EXT' => 'PhpScriptExternal',
            'TEMPLATE' => 'Template',
            'FLUIDTEMPLATE' => 'FluidTemplate',
            'MULTIMEDIA' => 'Multimedia',
            'MEDIA' => 'Media',
            'SWFOBJECT' => 'ShockwaveFlashObject',
            'QTOBJECT' => 'QuicktimeObject',
            'SVG' => 'ScalableVectorGraphics',
            'EDITPANEL' => 'EditPanel',
        );
        $name = $classMapping[$name];

        if (!array_key_exists($name, $this->contentObjects)) {
            try {
                $this->contentObjects[$name] = t3lib_div::makeInstance('tslib_content_' . $name, $this);
            } catch (ReflectionException $e) {
                $this->contentObjects[$name] = NULL;
            }
        }
        return $this->contentObjects[$name];
    }


    /********************************************
     *
     * Functions rendering content objects (cObjects)
     *
     ********************************************/

    /**
     * Rendering the cObject, HTML
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function HTML($conf) {
        return $this->getContentObject('HTML')->render($conf);
    }

    /**
     * Rendering the cObject, TEXT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function TEXT($conf) {
        return $this->getContentObject('TEXT')->render($conf);
    }

    /**
     * Rendering the cObject, CLEARGIF
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function CLEARGIF($conf) {
        return $this->getContentObject('CLEARGIF')->render($conf);
    }

    /**
     * Rendering the cObject, COBJ_ARRAY / COA and COBJ_ARRAY_INT
     *
     * @param   array       array of TypoScript properties
     * @param   string      If "INT" then the cObject is a "COBJ_ARRAY_INT" (non-cached), otherwise just "COBJ_ARRAY" (cached)
     * @return  string      Output
     */
    function COBJ_ARRAY($conf, $ext = '') {
        if ($ext === 'INT') {
            return $this->getContentObject('COA_INT')->render($conf);
        } else {
            return $this->getContentObject('COA')->render($conf);
        }
    }

    /**
     * Rendering the cObject, USER and USER_INT
     *
     * @param   array       array of TypoScript properties
     * @param   string      If "INT" then the cObject is a "USER_INT" (non-cached), otherwise just "USER" (cached)
     * @return  string      Output
     */
    function USER($conf, $ext = '') {
        if ($ext === 'INT') {
            return $this->getContentObject('USER_INT')->render($conf);
        } else {
            return $this->getContentObject('USER')->render($conf);
        }
    }

    /**
     * Retrieves a type of object called as USER or USER_INT. Object can detect their
     * type by using this call. It returns OBJECTTYPE_USER_INT or OBJECTTYPE_USER depending on the
     * current object execution. In all other cases it will return FALSE to indicate
     * a call out of context.
     *
     * @return  mixed   One of OBJECTTYPE_ class constants or FALSE
     */
    public function getUserObjectType() {
        return $this->userObjectType;
    }

    /**
     * Sets the user object type
     *
     * @param mixed $userObjectType
     * @return void
     */
    public function setUserObjectType($userObjectType) {
        $this->userObjectType = $userObjectType;
    }

    /**
     * Requests the current USER object to be converted to USER_INT.
     *
     * @return  void
     */
    public function convertToUserIntObject() {
        if ($this->userObjectType !== self::OBJECTTYPE_USER) {
            $GLOBALS['TT']->setTSlogMessage('tslib_cObj::convertToUserIntObject() ' . 'is called in the wrong context or for the wrong object type', 2);
        } else {
            $this->doConvertToUserIntObject = TRUE;
        }
    }

    /**
     * Rendering the cObject, FILE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function FILE($conf) {
        return $this->getContentObject('FILE')->render($conf);
    }

    /**
     * Rendering the cObject, IMAGE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     * @see cImage()
     */
    function IMAGE($conf) {
        return $this->getContentObject('IMAGE')->render($conf);
    }

    /**
     * Rendering the cObject, IMG_RESOURCE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     * @see getImgResource()
     */
    function IMG_RESOURCE($conf) {
        return $this->getContentObject('IMG_RESOURCE')->render($conf);
    }

    /**
     * Rendering the cObject, IMGTEXT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function IMGTEXT($conf) {
        return $this->getContentObject('IMGTEXT')->render($conf);
    }

    /**
     * Rendering the cObject, CONTENT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function CONTENT($conf) {
        return $this->getContentObject('CONTENT')->render($conf);
    }

    /**
     * Rendering the cObject, RECORDS
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function RECORDS($conf) {
        return $this->getContentObject('RECORDS')->render($conf);
    }

    /**
     * Rendering the cObject, HMENU
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function HMENU($conf) {
        return $this->getContentObject('HMENU')->render($conf);
    }

    /**
     * Rendering the cObject, CTABLE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function CTABLE($conf) {
        return $this->getContentObject('CTABLE')->render($conf);
    }

    /**
     * Rendering the cObject, OTABLE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function OTABLE($conf) {
        return $this->getContentObject('OTABLE')->render($conf);
    }

    /**
     * Rendering the cObject, COLUMNS
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function COLUMNS($conf) {
        return $this->getContentObject('COLUMNS')->render($conf);
    }

    /**
     * Rendering the cObject, HRULER
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function HRULER($conf) {
        return $this->getContentObject('HRULER')->render($conf);
    }

    /**
     * Rendering the cObject, CASE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function CASEFUNC($conf) {
        return $this->getContentObject('CASE')->render($conf);
    }

    /**
     * Rendering the cObject, LOAD_REGISTER and RESTORE_REGISTER
     * NOTICE: This cObject does NOT return any content since it just sets internal data based on the TypoScript properties.
     *
     * @param   array       array of TypoScript properties
     * @param   string      If "RESTORE_REGISTER" then the cObject rendered is "RESTORE_REGISTER", otherwise "LOAD_REGISTER"
     * @return  string      Empty string (the cObject only sets internal data!)
     */
    function LOAD_REGISTER($conf, $name) {
        if ($name === 'RESTORE_REGISTER') {
            return $this->getContentObject('RESTORE_REGISTER')->render($conf);
        } else {
            return $this->getContentObject('LOAD_REGISTER')->render($conf);
        }
    }

    /**
     * Rendering the cObject, FORM
     *
     * @param   array       array of TypoScript properties
     * @param   array       Alternative formdata overriding whatever comes from TypoScript
     * @return  string      Output
     */
    function FORM($conf, $formData = '') {
        return $this->getContentObject('FORM')->render($conf, $formData);
    }

    /**
     * Rendering the cObject, SEARCHRESULT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function SEARCHRESULT($conf) {
        return $this->getContentObject('SEARCHRESULT')->render($conf);
    }

    /**
     * Rendering the cObject, PHP_SCRIPT, PHP_SCRIPT_INT and PHP_SCRIPT_EXT
     *
     * @param   array       array of TypoScript properties
     * @param   string      If "INT", then rendering "PHP_SCRIPT_INT"; If "EXT", then rendering "PHP_SCRIPT_EXT"; Default is rendering "PHP_SCRIPT" (cached)
     * @return  string      Output
     */
    function PHP_SCRIPT($conf, $ext = '') {
        if ($ext === 'INT' || $ext === 'EXT') {
            $conf['scriptSuffix'] = $ext;
            return $this->getContentObject('PHP_SCRIPT_INT')->render($conf);
        } else {
            return $this->getContentObject('PHP_SCRIPT')->render($conf);
        }
    }

    /**
     * Rendering the cObject, TEMPLATE
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     * @see substituteMarkerArrayCached()
     */
    function TEMPLATE($conf) {
        return $this->getContentObject('TEMPLATE')->render($conf);
    }

    /**
     * Rendering the cObject, FLUIDTEMPLATE
     *
     * @param   array       array of TypoScript properties
     * @return  string      the HTML output
     * @author  Steffen Ritter  <info@steffen-ritter.net>
     * @author  Benjamin Mack   <benni@typo3.org>
     */
    protected function FLUIDTEMPLATE(array $conf) {
        return $this->getContentObject('FLUIDTEMPLATE')->render($conf);
    }

        /**
     * Rendering the cObject, MULTIMEDIA
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    function MULTIMEDIA($conf) {
        return $this->getContentObject('MULTIMEDIA')->render($conf);
    }

    /**
     * Rendering the cObject, MEDIA
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    public function MEDIA($conf) {
        return $this->getContentObject('MEDIA')->render($conf);
    }

    /**
     * Rendering the cObject, SWFOBJECT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    public function SWFOBJECT($conf) {
        return $this->getContentObject('SWFOBJECT')->render($conf);
    }

    /**
     * Rendering the cObject, QTOBJECT
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    public function QTOBJECT($conf) {
        return $this->getContentObject('QTOBJECT')->render($conf);
    }

    /**
     * Rendering the cObject, SVG
     *
     * @param   array       array of TypoScript properties
     * @return  string      Output
     */
    public function SVG($conf) {
        return $this->getContentObject('SVG')->render($conf);
    }

    /************************************
     *
     * Various helper functions for content objects:
     *
     ************************************/


    /**
     * Converts a given config in Flexform to a conf-array
     * @param   string      Flexform data
     * @param   array       array to write the data into, by reference
     * @param   boolean     is set if called recursive. Don't call function with this parameter, it's used inside the function only
     * @access  public
     *
     */
    public function readFlexformIntoConf($flexData, &$conf, $recursive = FALSE) {
        if ($recursive === FALSE) {
            $flexData = t3lib_div::xml2array($flexData, 'T3');
        }

        if (is_array($flexData)) {
            if (isset($flexData['data']['sDEF']['lDEF'])) {
                $flexData = $flexData['data']['sDEF']['lDEF'];
            }

            foreach ($flexData as $key => $value) {
                if (is_array($value['el']) && count($value['el']) > 0) {
                    foreach ($value['el'] as $ekey => $element) {
                        if (isset($element['vDEF'])) {
                            $conf[$ekey] = $element['vDEF'];
                        } else {
                            if (is_array($element)) {
                                $this->readFlexformIntoConf($element, $conf[$key][key($element)][$ekey], TRUE);
                            } else {
                                $this->readFlexformIntoConf($element, $conf[$key][$ekey], TRUE);
                            }
                        }
                    }
                } else {
                    $this->readFlexformIntoConf($value['el'], $conf[$key], TRUE);
                }
                if ($value['vDEF']) {
                    $conf[$key] = $value['vDEF'];
                }
            }
        }
    }


    /**
     * Returns all parents of the given PID (Page UID) list
     *
     * @param   string      A list of page Content-Element PIDs (Page UIDs) / stdWrap
     * @param   array       stdWrap array for the list
     * @return  string      A list of PIDs
     * @access private
     */
    function getSlidePids($pidList, $pidConf) {
        $pidList = isset($pidConf)
            ? trim($this->stdWrap($pidList, $pidConf))
            : trim($pidList);
        if (!strcmp($pidList, '')) {
            $pidList = 'this';
        }
        if (trim($pidList)) {
            $listArr = t3lib_div::intExplode(',', str_replace('this', $GLOBALS['TSFE']->contentPid, $pidList));
            $listArr = $this->checkPidArray($listArr);
        }
        $pidList = array();
        if (is_array($listArr) && count($listArr)) {
            foreach ($listArr as $uid) {
                $page = $GLOBALS['TSFE']->sys_page->getPage($uid);
                if (!$page['is_siteroot']) {
                    $pidList[] = $page['pid'];
                }
            }
        }
        return implode(',', $pidList);
    }

    /**
     * Returns a default value for a form field in the FORM cObject.
     * Page CANNOT be cached because that would include the inserted value for the current user.
     *
     * @param   boolean     If noValueInsert OR if the no_cache flag for this page is NOT set, the original default value is returned.
     * @param   string      $fieldName: The POST var name to get default value for
     * @param   string      $defaultVal: The current default value
     * @return  string      The default value, either from INPUT var or the current default, based on whether caching is enabled or not.
     * @access private
     */
    function getFieldDefaultValue($noValueInsert, $fieldName, $defaultVal) {
        if (!$GLOBALS['TSFE']->no_cache || (!isset($_POST[$fieldName]) && !isset($_GET[$fieldName])) || $noValueInsert) {
            return $defaultVal;
        } else {
            return t3lib_div::_GP($fieldName);
        }
    }

    /**
     * Returns a <img> tag with the image file defined by $file and processed according to the properties in the TypoScript array.
     * Mostly this function is a sub-function to the IMAGE function which renders the IMAGE cObject in TypoScript.
     * This function is called by "$this->cImage($conf['file'],$conf);" from IMAGE().
     *
     * @param   string      File TypoScript resource
     * @param   array       TypoScript configuration properties
     * @return  string      <img> tag, (possibly wrapped in links and other HTML) if any image found.
     * @access private
     * @see IMAGE()
     */
    function cImage($file, $conf) {
        $info = $this->getImgResource($file, $conf['file.']);
        $GLOBALS['TSFE']->lastImageInfo = $info;
        if (is_array($info)) {
            $info[3] = t3lib_div::png_to_gif_by_imagemagick($info[3]);
            $GLOBALS['TSFE']->imagesOnPage[] = $info[3]; // This array is used to collect the image-refs on the page...


                // Backwards compatibility if altText is not set and alttext is set
                // @deprecated since TYPO3 4.3, will be removed in TYPO3 4.6
            if (strlen($conf['alttext']) || is_array($conf['alttext.'])) {
                $GLOBALS['TSFE']->logDeprecatedTyposcript(
                    'IMAGE.alttext',
                    'use IMAGE.altText instead - src: ' . $info[3] . ' - original image: ' . $info['origFile']
                );
                if (!strlen($conf['altText']) && !is_array($conf['altText.'])) {
                    $conf['altText'] = $conf['alttext'];
                    $conf['altText.'] = $conf['alttext.'];
                }
            }

            $altParam = $this->getAltParam($conf);
            if($conf['params'] && !isset($conf['params.'])) {
                $params = ' ' . $conf['params'];
            } else {
                $params = isset($conf['params.'])
                    ? ' ' . $this->stdWrap($conf['params'], $conf['params.'])
                    : '';
            }
            $theValue = '<img src="' . htmlspecialchars($GLOBALS['TSFE']->absRefPrefix .
                t3lib_div::rawUrlEncodeFP($info[3])) . '" width="' . $info[0] . '" height="' . $info[1] . '"' .
                $this->getBorderAttr(' border="' . intval($conf['border']) . '"') .
                $params .
                ($altParam) . ' />';
            $linkWrap = isset($conf['linkWrap.'])
                ? $this->stdWrap($conf['linkWrap'], $conf['linkWrap.'])
                : $conf['linkWrap'];
            if ($linkWrap) {
                $theValue = $this->linkWrap($theValue, $linkWrap);
            } elseif ($conf['imageLinkWrap']) {
                $theValue = $this->imageLinkWrap($theValue, $info['origFile'], $conf['imageLinkWrap.']);
            }
            $wrap = isset($conf['wrap.'])
                ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                : $conf['wrap'];
            if($wrap) {
                $theValue = $this->wrap($theValue, $conf['wrap']);
            }
            return $theValue;
        }
    }

    /**
     * Returns the 'border' attribute for an <img> tag only if the doctype is not xhtml_strict, xhtml_11, xhtml_2 or html5
     * or if the config parameter 'disableImgBorderAttr' is not set.
     *
     * @param   string      the border attribute
     * @return  string      the border attribute
     */
    function getBorderAttr($borderAttr) {
        if (! t3lib_div::inList('xhtml_strict,xhtml_11,xhtml_2', $GLOBALS['TSFE']->xhtmlDoctype) &&
                $GLOBALS['TSFE']->config['config']['doctype'] != 'html5' &&
                ! $GLOBALS['TSFE']->config['config']['disableImgBorderAttr']) {
            return $borderAttr;
        }
    }

    /**
     * Wraps the input string in link-tags that opens the image in a new window.
     *
     * @param   string      String to wrap, probably an <img> tag
     * @param   string      The original image file
     * @param   array       TypoScript properties for the "imageLinkWrap" function
     * @return  string      The input string, $string, wrapped as configured.
     * @see cImage()
     */
    function imageLinkWrap($string, $imageFile, $conf) {
        $a1 = '';
        $a2 = '';
        $content = $string;
        $enable = isset($conf['enable.'])
            ? $this->stdWrap($conf['enable'], $conf['enable.'])
            : $conf['enable'];
        if ($enable) {
            $content = $this->typolink($string, $conf['typolink.']);
            if(isset($conf['file.'])) {
                $imageFile = $this->stdWrap($imageFile, $conf['file.']);
            }

                // imageFileLink:
            if ($content == $string && @is_file($imageFile)) {
                $parameterNames = array('width', 'height', 'effects', 'alternativeTempPath', 'bodyTag', 'title', 'wrap');
                $parameters = array();

                $sample = isset($conf['sample.'])
                    ? $this->stdWrap($conf['sample'], $conf['sample.'])
                    : $conf['sample'];
                if ($sample) {
                    $parameters['sample'] = 1;
                }

                foreach ($parameterNames as $parameterName) {
                    if(isset($conf[$parameterName.'.'])) {
                        $conf[$parameterName] = $this->stdWrap($conf[$parameterName], $conf[$parameterName.'.']);
                    }
                    if (isset($conf[$parameterName]) && $conf[$parameterName]) {
                        $parameters[$parameterName] = $conf[$parameterName];
                    }
                }

                $parametersEncoded = base64_encode(serialize($parameters));

                $md5_value = t3lib_div::hmac(
                    implode(
                        '|',
                        array($imageFile, $parametersEncoded)
                    )
                );

                $params = '&md5=' . $md5_value;
                foreach (str_split($parametersEncoded, 64) as $index => $chunk) {
                    $params .= '&parameters[' . $index . ']=' . rawurlencode($chunk);
                }

                $url = $GLOBALS['TSFE']->absRefPrefix . 'index.php?eID=tx_cms_showpic&file=' . rawurlencode($imageFile) . $params;

                $directImageLink = isset($conf['directImageLink.'])
                    ? $this->stdWrap($conf['directImageLink'], $conf['directImageLink.'])
                    : $conf['directImageLink'];
                if ($directImageLink) {
                    $imgResourceConf = array(
                        'file' => $imageFile,
                        'file.' => $conf
                    );
                    $url = $this->IMG_RESOURCE($imgResourceConf);
                    if (!$url) {
                            // if no imagemagick / gm is available
                        $url = $imageFile;
                    }
                }

                    // Create TARGET-attribute only if the right doctype is used
                if (!t3lib_div::inList('xhtml_strict,xhtml_11,xhtml_2', $GLOBALS['TSFE']->xhtmlDoctype)) {
                    $target = isset($conf['target.'])
                        ? $this-stdWrap($conf['target'], $conf['target.'])
                        : $conf['target'];
                    if(!$target) {
                        $target = sprintf(' target="%s"', $target);
                    } else {
                        $target = ' target="thePicture"';
                    }
                } else {
                    $target = '';
                }
                $conf['JSwindow'] = isset($conf['JSwindow.'])
                    ? $this->stdWrap($conf['JSwindow'], $conf['JSwindow.'])
                    : $conf['JSwindow'];
                if ($conf['JSwindow']) {
                    if ($conf['JSwindow.']['altUrl'] || $conf['JSwindow.']['altUrl.']) {
                        $altUrl = isset($conf['JSwindow.']['altUrl.'])
                            ? $this->stdWrap($conf['JSwindow.']['altUrl'], $conf['JSwindow.']['altUrl.'])
                            : $conf['JSwindow.']['altUrl'];
                        if ($altUrl) {
                            $url = $altUrl .
                                ($conf['JSwindow.']['altUrl_noDefaultParams'] ? '' : '?file=' .
                                rawurlencode($imageFile) . $params);
                        }
                    }
                    $gifCreator = t3lib_div::makeInstance('tslib_gifbuilder');
                    $gifCreator->init();
                    $gifCreator->mayScaleUp = 0;

                    $dims = $gifCreator->getImageScale($gifCreator->getImageDimensions($imageFile), $conf['width'], $conf['height'], '');
                    $JSwindowExpand = isset($conf['JSwindow.']['expand.'])
                        ? $this->stdWrap($conf['JSwindow.']['expand'], $conf['JSwindow.']['expand.'])
                        : $conf['JSwindow.']['expand'];
                    $offset = t3lib_div::intExplode(',', $JSwindowExpand . ',');

                    $newWindow = isset($conf['JSwindow.']['newWindow.'])
                        ? $this->stdWrap($conf['JSwindow.']['newWindow'], $conf['JSwindow.']['newWindow.'])
                        : $conf['JSwindow.']['newWindow'];
                    $a1 = '<a href="' . htmlspecialchars($url) . '" onclick="' .
                        htmlspecialchars('openPic(\'' . $GLOBALS['TSFE']->baseUrlWrap($url) . '\',\'' .
                        ($newWindow ? md5($url) : 'thePicture') . '\',\'width=' .
                        ($dims[0] + $offset[0]) . ',height=' . ($dims[1] + $offset[1]) .
                        ',status=0,menubar=0\'); return false;') . '"' .
                        $target . $GLOBALS['TSFE']->ATagParams . '>';
                    $a2 = '</a>';
                    $GLOBALS['TSFE']->setJS('openPic');
                } else {
                    $conf['linkParams.']['parameter'] = $url;
                    $string = $this->typoLink($string, $conf['linkParams.']);
                }

                if(isset($conf['stdWrap.'])) {
                    $string = $this->stdWrap($string, $conf['stdWrap.']);
                }

                $content = $a1 . $string . $a2;
            }
        }

        return $content;
    }

    /**
     * Returns content of a file. If it's an image the content of the file is not returned but rather an image tag is.
     *
     * @param   string      The filename, being a TypoScript resource data type
     * @param   string      Additional parameters (attributes). Default is empty alt and title tags.
     * @return  string      If jpg,gif,jpeg,png: returns image_tag with picture in. If html,txt: returns content string
     * @see FILE()
     */
    function fileResource($fName, $addParams = 'alt="" title=""') {
        $incFile = $GLOBALS['TSFE']->tmpl->getFileName($fName);
        if ($incFile) {
            $fileinfo = t3lib_div::split_fileref($incFile);
            if (t3lib_div::inList('jpg,gif,jpeg,png', $fileinfo['fileext'])) {
                $imgFile = $incFile;
                $imgInfo = @getImageSize($imgFile);
                return '<img src="' . $GLOBALS['TSFE']->absRefPrefix . $imgFile .
                    '" width="' . $imgInfo[0] . '" height="' . $imgInfo[1] . '"' .
                    $this->getBorderAttr(' border="0"') . ' ' . $addParams . ' />';
            } elseif (filesize($incFile) < 1024 * 1024) {
                return $GLOBALS['TSFE']->tmpl->fileContent($incFile);
            }
        }
    }

    /**
     * Sets the SYS_LASTCHANGED timestamp if input timestamp is larger than current value.
     * The SYS_LASTCHANGED timestamp can be used by various caching/indexing applications to determine if the page has new content.
     * Therefore you should call this function with the last-changed timestamp of any element you display.
     *
     * @param   integer     Unix timestamp (number of seconds since 1970)
     * @return  void
     * @see tslib_fe::setSysLastChanged()
     */
    function lastChanged($tstamp) {
        $tstamp = intval($tstamp);
        if ($tstamp > intval($GLOBALS['TSFE']->register['SYS_LASTCHANGED'])) {
            $GLOBALS['TSFE']->register['SYS_LASTCHANGED'] = $tstamp;
        }
    }

    /**
     * Wraps the input string by the $wrap value and implements the "linkWrap" data type as well.
     * The "linkWrap" data type means that this function will find any integer encapsulated in {} (curly braces) in the first wrap part and substitute it with the corresponding page uid from the rootline where the found integer is pointing to the key in the rootline. See link below.
     *
     * @param   string      Input string
     * @param   string      A string where the first two parts separated by "|" (vertical line) will be wrapped around the input string
     * @return  string      Wrapped output string
     * @see wrap(), cImage(), FILE()
     */
    function linkWrap($content, $wrap) {
        $wrapArr = explode('|', $wrap);
        if (preg_match('/\{([0-9]*)\}/', $wrapArr[0], $reg)) {
            if ($uid = $GLOBALS['TSFE']->tmpl->rootLine[$reg[1]]['uid']) {
                $wrapArr[0] = str_replace($reg[0], $uid, $wrapArr[0]);
            }
        }
        return trim($wrapArr[0]) . $content . trim($wrapArr[1]);
    }

    /**
     * An abstraction method which creates an alt or title parameter for an HTML img, applet, area or input element and the FILE content element.
     * From the $conf array it implements the properties "altText", "titleText" and "longdescURL"
     *
     * @param   array       TypoScript configuration properties
     * @param   boolean     If set, the longdesc attribute will be generated - must only be used for img elements!
     * @return  string      Parameter string containing alt and title parameters (if any)
     * @see IMGTEXT(), FILE(), FORM(), cImage(), filelink()
     */
    function getAltParam($conf, $longDesc = TRUE) {
        $altText = isset($conf['altText.'])
            ? trim($this->stdWrap($conf['altText'], $conf['altText.']))
            : trim($conf['altText']);
        $titleText = isset($conf['titleText.'])
            ? trim($this->stdWrap($conf['titleText'], $conf['titleText.']))
            : trim($conf['titleText']);
        $longDesc = isset($conf['longdescURL.'])
            ? trim($this->stdWrap($conf['longdescURL'], $conf['longdescURL.']))
            : trim($conf['longdescURL']);

            // "alt":
        $altParam = ' alt="' . htmlspecialchars($altText) . '"';

            // "title":
        $emptyTitleHandling = 'useAlt';
        $emptyTitleHandling = isset($conf['emptyTitleHandling.'])
            ? $this->stdWrap($conf['emptyTitleHandling'], $conf['emptyTitleHandling.'])
            : $conf['emptyTitleHandling'];
                // choices: 'keepEmpty' | 'useAlt' | 'removeAttr'
        if ($titleText || $emptyTitleHandling == 'keepEmpty') {
            $altParam .= ' title="' . htmlspecialchars($titleText) . '"';
        } elseif (!$titleText && $emptyTitleHandling == 'useAlt') {
            $altParam .= ' title="' . htmlspecialchars($altText) . '"';
        }

            // "longDesc" URL
        if ($longDesc) {
            $altParam .= ' longdesc="' . htmlspecialchars(strip_tags($longDesc)) . '"';
        }

        return $altParam;
    }

    /**
     * Removes forbidden characters and spaces from name/id attributes in the form tag and formfields
     *
     * @param   string      Input string
     * @return  string      the cleaned string
     * @see FORM()
     */
    function cleanFormName($name) {
            // turn data[x][y] into data:x:y:
        $name = preg_replace('/\[|\]\[?/', ':', trim($name));
            // remove illegal chars like _
        return preg_replace('#[^:a-zA-Z0-9]#', '', $name);
    }

    /**
     * An abstraction method to add parameters to an A tag.
     * Uses the ATagParams property.
     *
     * @param   array       TypoScript configuration properties
     * @param   boolean     If set, will add the global config.ATagParams to the link
     * @return  string      String containing the parameters to the A tag (if non empty, with a leading space)
     * @see IMGTEXT(), filelink(), makelinks(), typolink()
     */
    function getATagParams($conf, $addGlobal = 1) {
        $aTagParams = '';
        if ($conf['ATagParams.']) {
            $aTagParams = ' ' . $this->stdWrap($conf['ATagParams'], $conf['ATagParams.']);
        } elseif ($conf['ATagParams']) {
            $aTagParams = ' ' . $conf['ATagParams'];
        }
        if ($addGlobal) {
            $aTagParams = ' ' . trim($GLOBALS['TSFE']->ATagParams . $aTagParams);
        }
        return $aTagParams;
    }

    /**
     * All extension links should ask this function for additional properties to their tags.
     * Designed to add for instance an "onclick" property for site tracking systems.
     *
     * @param   string  URL of the website
     * @return  string  the additional tag properties
     */
    function extLinkATagParams($URL, $TYPE) {
        $out = '';

        if ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['extLinkATagParamsHandler']) {
            $extLinkATagParamsHandler = t3lib_div::getUserObj(
                $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['extLinkATagParamsHandler']
            );

            if (method_exists($extLinkATagParamsHandler, 'main')) {
                $out .= trim($extLinkATagParamsHandler->main($URL, $TYPE, $this));
            }
        }

        return trim($out) ? ' ' . trim($out) : '';
    }



    /***********************************************
     *
     * HTML template processing functions
     *
     ***********************************************/

    /**
     * Returns a subpart from the input content stream.
     * A subpart is a part of the input stream which is encapsulated in a
     * string matching the input string, $marker. If this string is found
     * inside of HTML comment tags the start/end points of the content block
     * returned will be that right outside that comment block.
     * Example: The contennt string is
     * "Hello <!--###sub1### begin--> World. How are <!--###sub1### end--> you?"
     * If $marker is "###sub1###" then the content returned is
     * " World. How are ". The input content string could just as well have
     * been "Hello ###sub1### World. How are ###sub1### you?" and the result
     * would be the same
     * Wrapper for t3lib_parsehtml::getSubpart which behaves identical
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   string      The marker string, typically on the form "###[the marker string]###"
     * @return  string      The subpart found, if found.
     * @see substituteSubpart(), t3lib_parsehtml::getSubpart()
     */
    public function getSubpart($content, $marker) {
        return t3lib_parsehtml::getSubpart($content, $marker);
    }

    /**
     * Substitute subpart in input template stream.
     * This function substitutes a subpart in $content with the content of
     * $subpartContent.
     * Wrapper for t3lib_parsehtml::substituteSubpart which behaves identical
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   string      The marker string, typically on the form "###[the marker string]###"
     * @param   mixed       The content to insert instead of the subpart found. If a string, then just plain substitution happens (includes removing the HTML comments of the subpart if found). If $subpartContent happens to be an array, it's [0] and [1] elements are wrapped around the EXISTING content of the subpart (fetched by getSubpart()) thereby not removing the original content.
     * @param   boolean     If $recursive is set, the function calls itself with the content set to the remaining part of the content after the second marker. This means that proceding subparts are ALSO substituted!
     * @return  string      The processed HTML content string.
     * @see getSubpart(), t3lib_parsehtml::substituteSubpart()
     */
    public function substituteSubpart($content, $marker, $subpartContent, $recursive = 1) {
        return t3lib_parsehtml::substituteSubpart($content, $marker, $subpartContent, $recursive);
    }

    /**
     * Substitues multiple subparts at once
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   array       The array of key/value pairs being subpart/content values used in the substitution. For each element in this array the function will substitute a subpart in the content stream with the content.
     * @return  string      The processed HTML content string.
     */
    public function substituteSubpartArray($content, array $subpartsContent) {
        return t3lib_parsehtml::substituteSubpartArray($content, $subpartsContent);
    }

    /**
     * Substitutes a marker string in the input content
     * (by a simple str_replace())
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   string      The marker string, typically on the form "###[the marker string]###"
     * @param   mixed       The content to insert instead of the marker string found.
     * @return  string      The processed HTML content string.
     * @see substituteSubpart()
     */
    public function substituteMarker($content, $marker, $markContent) {
        return t3lib_parsehtml::substituteMarker($content, $marker, $markContent);
    }

    /**
     * Multi substitution function with caching.
     *
     * This function should be a one-stop substitution function for working
     * with HTML-template. It does not substitute by str_replace but by
     * splitting. This secures that the value inserted does not themselves
     * contain markers or subparts.
     *
     * Note that the "caching" won't cache the content of the substition,
     * but only the splitting of the template in various parts. So if you
     * want only one cache-entry per template, make sure you always pass the
     * exact same set of marker/subpart keys. Else you will be flooding the
     * users cache table.
     *
     * This function takes three kinds of substitutions in one:
     * $markContentArray is a regular marker-array where the 'keys' are
     * substituted in $content with their values
     *
     * $subpartContentArray works exactly like markContentArray only is whole
     * subparts substituted and not only a single marker.
     *
     * $wrappedSubpartContentArray is an array of arrays with 0/1 keys where
     * the subparts pointed to by the main key is wrapped with the 0/1 value
     * alternating.
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   array       Regular marker-array where the 'keys' are substituted in $content with their values
     * @param   array       Exactly like markContentArray only is whole subparts substituted and not only a single marker.
     * @param   array       An array of arrays with 0/1 keys where the subparts pointed to by the main key is wrapped with the 0/1 value alternating.
     * @return  string      The output content stream
     * @see substituteSubpart(), substituteMarker(), substituteMarkerInObject(), TEMPLATE()
     */
    public function substituteMarkerArrayCached($content, array $markContentArray = NULL, array $subpartContentArray = NULL, array $wrappedSubpartContentArray = NULL) {
        $GLOBALS['TT']->push('substituteMarkerArrayCached');

            // If not arrays then set them
        if (is_null($markContentArray))
            $markContentArray = array(); // Plain markers
        if (is_null($subpartContentArray))
            $subpartContentArray = array(); // Subparts being directly substituted
        if (is_null($wrappedSubpartContentArray))
            $wrappedSubpartContentArray = array(); // Subparts being wrapped
            // Finding keys and check hash:
        $sPkeys = array_keys($subpartContentArray);
        $wPkeys = array_keys($wrappedSubpartContentArray);
        $aKeys = array_merge(array_keys($markContentArray), $sPkeys, $wPkeys);
        if (!count($aKeys)) {
            $GLOBALS['TT']->pull();
            return $content;
        }
        asort($aKeys);
        $storeKey = md5('substituteMarkerArrayCached_storeKey:' . serialize(array(
            $content, $aKeys
        )));
        if ($this->substMarkerCache[$storeKey]) {
            $storeArr = $this->substMarkerCache[$storeKey];
            $GLOBALS['TT']->setTSlogMessage('Cached', 0);
        } else {
            $storeArrDat = $GLOBALS['TSFE']->sys_page->getHash($storeKey);
            if (!isset($storeArrDat)) {
                    // Initialize storeArr
                $storeArr = array();

                    // Finding subparts and substituting them with the subpart as a marker
                foreach ($sPkeys as $sPK) {
                    $content = $this->substituteSubpart($content, $sPK, $sPK);
                }

                    // Finding subparts and wrapping them with markers
                foreach ($wPkeys as $wPK) {
                    $content = $this->substituteSubpart($content, $wPK, array(
                        $wPK, $wPK
                    ));
                }

                    // traverse keys and quote them for reg ex.
                foreach ($aKeys as $tK => $tV) {
                    $aKeys[$tK] = preg_quote($tV, '/');
                }
                $regex = '/' . implode('|', $aKeys) . '/';
                    // Doing regex's
                $storeArr['c'] = preg_split($regex, $content);
                preg_match_all($regex, $content, $keyList);
                $storeArr['k'] = $keyList[0];
                    // Setting cache:
                $this->substMarkerCache[$storeKey] = $storeArr;

                    // Storing the cached data:
                $GLOBALS['TSFE']->sys_page->storeHash($storeKey, serialize($storeArr), 'substMarkArrayCached');

                $GLOBALS['TT']->setTSlogMessage('Parsing', 0);
            } else {
                    // Unserializing
                $storeArr = unserialize($storeArrDat);
                    // Setting cache:
                $this->substMarkerCache[$storeKey] = $storeArr;
                $GLOBALS['TT']->setTSlogMessage('Cached from DB', 0);
            }
        }

            // Substitution/Merging:
            // Merging content types together, resetting
        $valueArr = array_merge($markContentArray, $subpartContentArray, $wrappedSubpartContentArray);

        $wSCA_reg = array();
        $content = '';
            // traversing the keyList array and merging the static and dynamic content
        foreach ($storeArr['k'] as $n => $keyN) {
            $content .= $storeArr['c'][$n];
            if (!is_array($valueArr[$keyN])) {
                $content .= $valueArr[$keyN];
            } else {
                $content .= $valueArr[$keyN][(intval($wSCA_reg[$keyN]) % 2)];
                $wSCA_reg[$keyN]++;
            }
        }
        $content .= $storeArr['c'][count($storeArr['k'])];

        $GLOBALS['TT']->pull();
        return $content;
    }

    /**
     * Traverses the input $markContentArray array and for each key the marker
     * by the same name (possibly wrapped and in upper case) will be
     * substituted with the keys value in the array.
     *
     * This is very useful if you have a data-record to substitute in some
     * content. In particular when you use the $wrap and $uppercase values to
     * pre-process the markers. Eg. a key name like "myfield" could effectively
     * be represented by the marker "###MYFIELD###" if the wrap value
     * was "###|###" and the $uppercase boolean TRUE.
     *
     * @param   string      The content stream, typically HTML template content.
     * @param   array       The array of key/value pairs being marker/content values used in the substitution. For each element in this array the function will substitute a marker in the content stream with the content.
     * @param   string      A wrap value - [part 1] | [part 2] - for the markers before substitution
     * @param   boolean     If set, all marker string substitution is done with upper-case markers.
     * @param   boolean     If set, all unused marker are deleted.
     * @return  string      The processed output stream
     * @see substituteMarker(), substituteMarkerInObject(), TEMPLATE()
     */
    public function substituteMarkerArray($content, array $markContentArray, $wrap = '', $uppercase = FALSE, $deleteUnused = FALSE) {
        return t3lib_parsehtml::substituteMarkerArray($content, $markContentArray, $wrap, $uppercase, $deleteUnused);
    }

    /**
     * Substitute marker array in an array of values
     *
     * @param   mixed       If string, then it just calls substituteMarkerArray. If array(and even multi-dim) then for each key/value pair the marker array will be substituted (by calling this function recursively)
     * @param   array       The array of key/value pairs being marker/content values used in the substitution. For each element in this array the function will substitute a marker in the content string/array values.
     * @return  mixed       The processed input variable.
     * @see substituteMarker()
     */
    public function substituteMarkerInObject(&$tree, array $markContentArray) {
        if (is_array($tree)) {
            foreach ($tree as $key => $value) {
                $this->substituteMarkerInObject($tree[$key], $markContentArray);
            }
        } else {
            $tree = $this->substituteMarkerArray($tree, $markContentArray);
        }

        return $tree;
    }

    /**
     * Adds elements to the input $markContentArray based on the values from
     * the fields from $fieldList found in $row
     *
     * @param   array       array with key/values being marker-strings/substitution values.
     * @param   array       An array with keys found in the $fieldList (typically a record) which values should be moved to the $markContentArray
     * @param   string      A list of fields from the $row array to add to the $markContentArray array. If empty all fields from $row will be added (unless they are integers)
     * @param   boolean     If set, all values added to $markContentArray will be nl2br()'ed
     * @param   string      Prefix string to the fieldname before it is added as a key in the $markContentArray. Notice that the keys added to the $markContentArray always start and end with "###"
     * @param   boolean     If set, all values are passed through htmlspecialchars() - RECOMMENDED to avoid most obvious XSS and maintain XHTML compliance.
     * @return  array       The modified $markContentArray
     */
    public function fillInMarkerArray(array $markContentArray, array $row, $fieldList = '', $nl2br = TRUE, $prefix = 'FIELD_', $HSC = FALSE) {
        if ($fieldList) {
            $fArr = t3lib_div::trimExplode(',', $fieldList, 1);
            foreach ($fArr as $field) {
                $markContentArray['###' . $prefix . $field . '###'] = $nl2br ? nl2br($row[$field]) : $row[$field];
            }
        } else {
            if (is_array($row)) {
                foreach ($row as $field => $value) {
                    if (!t3lib_div::testInt($field)) {
                        if ($HSC) {
                            $value = htmlspecialchars($value);
                        }

                        $markContentArray['###' . $prefix . $field . '###'] = $nl2br ? nl2br($value) : $value;
                    }
                }
            }
        }

        return $markContentArray;
    }

    /***********************************************
     *
     * "stdWrap" + sub functions
     *
     ***********************************************/

    /**
     * The "stdWrap" function. This is the implementation of what is known as "stdWrap properties" in TypoScript.
     * Basically "stdWrap" performs some processing of a value based on properties in the input $conf array(holding the TypoScript "stdWrap properties")
     * See the link below for a complete list of properties and what they do. The order of the table with properties found in TSref (the link) follows the actual order of implementation in this function.
     *
     * If $this->alternativeData is an array it's used instead of the $this->data array in ->getData
     *
     * @param   string      Input value undergoing processing in this function. Possibly substituted by other values fetched from another source.
     * @param   array       TypoScript "stdWrap properties".
     * @return  string      The processed input value
     */
    public function stdWrap($content = '', $conf = array()) {
        if (count($this->stdWrapHookObjects)) {
            foreach ($this->stdWrapHookObjects as $hookObject) {
                if (is_callable(array($hookObject, 'stdWrapPreProcess'))) {
                    $conf['stdWrapPreProcess'] = 1;
                }
                ;
                if (is_callable(array($hookObject, 'stdWrapOverride'))) {
                    $conf['stdWrapOverride'] = 1;
                }
                ;
                if (is_callable(array($hookObject, 'stdWrapProcess'))) {
                    $conf['stdWrapProcess'] = 1;
                }
                ;
                if (is_callable(array($hookObject, 'stdWrapPostProcess'))) {
                    $conf['stdWrapPostProcess'] = 1;
                }
                ;
            }
        }
        if (is_array($conf) && count($conf)) {
            // check, which of the available stdWrap functions is needed for the current conf Array
            // and keep only those but still in the same order
            $sortedConf = array_intersect_key($this->stdWrapOrder, $conf);
            // functions types that should not make use of nested stdWrap function calls to avoid conflicts with internal TypoScript used by these functions
            $stdWrapDisabledFunctionTypes = 'cObject,functionName,stdWrap';
            // additional Array to check whether a function has already been executed
            $isExecuted = array();
            // additional switch to make sure 'required', 'if' and 'fieldRequired'
            // will still stop rendering immediately in case they return false

            $this->stdWrapRecursionLevel++;
            $this->stopRendering[$this->stdWrapRecursionLevel] = false;

            // execute each funtion in the predefined order
            foreach ($sortedConf as $stdWrapName => $functionType) {
                // eliminate the second key of a pair 'key'|'key.' to make sure functions get called only once and check if rendering has been stopped
                if (!$isExecuted[$stdWrapName] &&
                        !$this->stopRendering[$this->stdWrapRecursionLevel]) {
                    $functionName = rtrim($stdWrapName, '.');
                    $functionProperties = $functionName . '.';
                    // if there is any code one the next level, check if it contains "official" stdWrap functions
                    // if yes, execute them first - will make each function stdWrap aware
                    // so additional stdWrap calls within the functions can be removed, since the result will be the same
                    // exception: the recursive stdWrap function and cObject will still be using their own stdWrap call, since it modifies the content and not a property
                    if (count($conf[$functionProperties]) &&
                            !t3lib_div::inList($stdWrapDisabledFunctionTypes, $functionType)) {
                        if (array_intersect_key($this->stdWrapOrder, $conf[$functionProperties])) {
                            $conf[$functionName] = $this->stdWrap($conf[$functionName], $conf[$functionProperties]);
                        }
                    }
                    // get just that part of $conf that is needed for the particular function
                    $singleConf = array(
                        $functionName => $conf[$functionName],
                        $functionProperties => $conf[$functionProperties]
                    );

                    // in this special case 'spaceBefore' and 'spaceAfter' need additional stuff from 'space.''
                    if ($functionName == 'spaceBefore' || $functionName == 'spaceAfter') {
                        $singleConf['space.'] = $conf['space.'];
                    }

                    // hand over the whole $conf array to the stdWrapHookObjects
                    if ($functionType === 'hook') {
                        $singleConf = $conf;
                    }
                    // check if key is still containing something, since it might have been changed by next level stdWrap before
                    if ((isset($conf[$functionName]) || $conf[$functionProperties]) &&
                            !($functionType == 'boolean' && $conf[$functionName] === '0')) {
                        //add both keys - with and without the dot - to the set of executed functions
                        $isExecuted[$functionName] = true;
                        $isExecuted[$functionProperties] = true;
                        // call the function with the prefix stdWrap_ to make sure nobody can execute functions just by adding their name to the TS Array
                        $functionName = 'stdWrap_' . $functionName;
                        $content = $this->$functionName(
                            $content,
                            $singleConf
                        );
                    }
                }
            }

            unset($this->stopRendering[$this->stdWrapRecursionLevel]);
            $this->stdWrapRecursionLevel--;

        }
        return $content;
    }

    /**
     * stdWrap pre process hook
     * can be used by extensions authors to modify the behaviour of stdWrap functions to their needs
     * this hook will execute functions before any other stdWrap function can modify anything
     *
     * @param   string      Input value undergoing processing in these functions.
     * @param   array       All stdWrap properties, not just the ones for a particular function.
     * @return  string      The processed input value
     */
    public function stdWrap_stdWrapPreProcess($content = '', $conf = array()) {
        foreach ($this->stdWrapHookObjects as $hookObject) {
            $content = $hookObject->stdWrapPreProcess($content, $conf, $this);
        }
        return $content;
    }

    /**
     * setContentToCurrent
     * actually it just does the contrary: Sets the value of 'current' based on current content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for setContentToCurrent.
     * @return  string      The processed input value
     */
    public function stdWrap_setContentToCurrent($content = '', $conf = array()) {
        $this->data[$this->currentValKey] = $content;
        return $content;
    }

    /**
     * setCurrent
     * Sets the value of 'current' based on the outcome of stdWrap operations
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for setCurrent.
     * @return  string      The processed input value
     */
    public function stdWrap_setCurrent($content = '', $conf = array()) {
        $this->data[$this->currentValKey] = $conf['setCurrent'];
        return $content;
    }

    /**
     * lang
     * Translates content based on the language currently used by the FE
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for lang.
     * @return  string      The processed input value
     */
    public function stdWrap_lang($content = '', $conf = array()) {
        if (isset($conf['lang.']) && $GLOBALS['TSFE']->config['config']['language'] && isset($conf['lang.'][$GLOBALS['TSFE']->config['config']['language']])) {
            $content = $conf['lang.'][$GLOBALS['TSFE']->config['config']['language']];
        }
        return $content;
    }

    /**
     * data
     * Gets content from different sources based on getText functions, makes use of alternativeData, when set
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for data.
     * @return  string      The processed input value
     */
    public function stdWrap_data($content = '', $conf = array()) {
        $content = $this->getData($conf['data'], is_array($this->alternativeData) ? $this->alternativeData : $this->data);
        $this->alternativeData = ''; // This must be unset directly after
        return $content;
    }

    /**
     * field
     * Gets content from a DB field
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for field.
     * @return  string      The processed input value
     */
    public function stdWrap_field($content = '', $conf = array()) {
        $content = $this->getFieldVal($conf['field']);
        return $content;
    }

    /**
     * current
     * Gets content that has been perviously set as 'current'
     * Can be set via setContentToCurrent or setCurrent or will be set automatically i.e. inside the split function
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for current.
     * @return  string      The processed input value
     */
    public function stdWrap_current($content = '', $conf = array()) {
        $content = $this->data[$this->currentValKey];
        return $content;
    }

    /**
     * cObject
     * Will replace the content with the value of a any official TypoScript cObject
     * like TEXT, COA, HMENU
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for cObject.
     * @return  string      The processed input value
     */
    public function stdWrap_cObject($content = '', $conf = array()) {
        $content = $this->cObjGetSingle($conf['cObject'], $conf['cObject.'], '/stdWrap/.cObject');
        return $content;
    }

    /**
     * numRows
     * Counts the number of returned records of a DB operation
     * makes use of select internally
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for numRows.
     * @return  string      The processed input value
     */
    public function stdWrap_numRows($content = '', $conf = array()) {
        $content = $this->numRows($conf['numRows.']);
        return $content;
    }

    /**
     * filelist
     * Will create a list of files based on some additional parameters
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for filelist.
     * @return  string      The processed input value
     */
    public function stdWrap_filelist($content = '', $conf = array()) {
        $content = $this->filelist($conf['filelist']);
        return $content;
    }

    /**
     * preUserFunc
     * Will execute a user public function before the content will be modified by any other stdWrap function
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for preUserFunc.
     * @return  string      The processed input value
     */
    public function stdWrap_preUserFunc($content = '', $conf = array()) {
        $content = $this->callUserFunction($conf['preUserFunc'], $conf['preUserFunc.'], $content);
        return $content;
    }

    /**
     * stdWrap override hook
     * can be used by extensions authors to modify the behaviour of stdWrap functions to their needs
     * this hook will execute functions on existing content but still before the content gets modified or replaced
     *
     * @param   string      Input value undergoing processing in these functions.
     * @param   array       All stdWrap properties, not just the ones for a particular function.
     * @return  string      The processed input value
     */
    public function stdWrap_stdWrapOverride($content = '', $conf = array()) {
        foreach ($this->stdWrapHookObjects as $hookObject) {
            $content = $hookObject->stdWrapOverride($content, $conf, $this);
        }
        return $content;
    }

    /**
     * override
     * Will override the current value of content with its own value'
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for override.
     * @return  string      The processed input value
     */
    public function stdWrap_override($content = '', $conf = array()) {
        if (trim($conf['override'])) {
            $content = $conf['override'];
        }
        return $content;
    }

    /**
     * preIfEmptyListNum
     * Gets a value off a CSV list before the following ifEmpty check
     * Makes sure that the result of ifEmpty will be true in case the CSV does not contain a value at the position given by preIfEmptyListNum
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for preIfEmptyListNum.
     * @return  string      The processed input value
     */
    public function stdWrap_preIfEmptyListNum($content = '', $conf = array()) {
        $content = $this->listNum($content, $conf['preIfEmptyListNum'], $conf['preIfEmptyListNum.']['splitChar']);
        return $content;
    }

    /**
     * ifEmpty
     * Will set content to a replacement value in case the trimmed value of content returns false
     * 0 (zero) will be replaced as well
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for ifEmpty.
     * @return  string      The processed input value
     */
    public function stdWrap_ifEmpty($content = '', $conf = array()) {
        if (!trim($content)) {
            $content = $conf['ifEmpty'];
        }
        return $content;
    }

    /**
     * ifBlank
     * Will set content to a replacement value in case the trimmed value of content has no length
     * 0 (zero) will not be replaced
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for ifBlank.
     * @return  string      The processed input value
     */
    public function stdWrap_ifBlank($content = '', $conf = array()) {
        if (!strlen(trim($content))) {
            $content = $conf['ifBlank'];
        }
        return $content;
    }

    /**
     * listNum
     * Gets a value off a CSV list after ifEmpty check
     * Might return an empty value in case the CSV does not contain a value at the position given by listNum
     * Use preIfEmptyListNum to avoid that behaviour
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for listNum.
     * @return  string      The processed input value
     */
    public function stdWrap_listNum($content = '', $conf = array()) {
        $content = $this->listNum($content, $conf['listNum'], $conf['listNum.']['splitChar']);
        return $content;
    }

    /**
     * trim
     * Cuts off any whitespace at the beginning and the end of the content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for trim.
     * @return  string      The processed input value
     */
    public function stdWrap_trim($content = '', $conf = array()) {
        $content = trim($content);
        return $content;
    }

    /**
     * stdWrap
     * A recursive call of the stdWrap function set
     * This enables the user to execute stdWrap functions in another than the predefined order
     * It modifies the content, not the property
     * while the new feature of chained stdWrap functions modifies the property and not the content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for stdWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_stdWrap($content = '', $conf = array()) {
        $content = $this->stdWrap($content, $conf['stdWrap.']);
        return $content;
    }

    /**
     * stdWrap process hook
     * can be used by extensions authors to modify the behaviour of stdWrap functions to their needs
     * this hook executes functions directly after the recursive stdWrap function call but still before the content gets modified
     *
     * @param   string      Input value undergoing processing in these functions.
     * @param   array       All stdWrap properties, not just the ones for a particular function.
     * @return  string      The processed input value
     */
    public function stdWrap_stdWrapProcess($content = '', $conf = array()) {
        foreach ($this->stdWrapHookObjects as $hookObject) {
            $content = $hookObject->stdWrapProcess($content, $conf, $this);
        }
        return $content;
    }

    /**
     * required
     * Will immediately stop rendering and return an empty value
     * when there is no content at this point
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for required.
     * @return  string      The processed input value
     */
    public function stdWrap_required($content = '', $conf = array()) {
        if ((string) $content == '') {
            $content = '';
            $this->stopRendering[$this->stdWrapRecursionLevel] = TRUE;
        }
        return $content;
    }

    /**
     * if
     * Will immediately stop rendering and return an empty value
     * when the result of the checks returns false
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for if.
     * @return  string      The processed input value
     */
    public function stdWrap_if($content = '', $conf = array()) {
        if (!$this->checkIf($conf['if.'])) {
            $content = '';
            $this->stopRendering[$this->stdWrapRecursionLevel] = TRUE;
        }
        return $content;
    }

    /**
     * fieldRequired
     * Will immediately stop rendering and return an empty value
     * when there is no content in the field given by fieldRequired
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for fieldRequired.
     * @return  string      The processed input value
     */
    public function stdWrap_fieldRequired($content = '', $conf = array()) {
        if (!trim($this->data[$conf['fieldRequired']])) {
            $content = '';
            $this->stopRendering[$this->stdWrapRecursionLevel] = TRUE;
        }
        return $content;
    }

    /**
     * csConv
     * Will convert the current chracter set of the content to the one given in csConv
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for csConv.
     * @return  string      The processed input value
     */
    public function stdWrap_csConv($content = '', $conf = array()) {
        $content = $GLOBALS['TSFE']->csConv($content, $conf['csConv']);
        return $content;
    }

    /**
     * parseFunc
     * Will parse the content based on functions given as stdWrap properties
     * Heavily used together with RTE based content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for parseFunc.
     * @return  string      The processed input value
     */
    public function stdWrap_parseFunc($content = '', $conf = array()) {
        $content = $this->parseFunc($content, $conf['parseFunc.'], $conf['parseFunc']);
        return $content;
    }

    /**
     * HTMLparser
     * Will parse HTML content based on functions given as stdWrap properties
     * Heavily used together with RTE based content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for HTMLparser.
     * @return  string      The processed input value
     */
    public function stdWrap_HTMLparser($content = '', $conf = array()) {
        if (is_array($conf['HTMLparser.'])) {
            $content = $this->HTMLparser_TSbridge($content, $conf['HTMLparser.']);
        }
        return $content;
    }

    /**
     * split
     * Will split the content by a given token and treat the results separately
     * Automatically fills 'current' with a single result
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for split.
     * @return  string      The processed input value
     */
    public function stdWrap_split($content = '', $conf = array()) {
        $content = $this->splitObj($content, $conf['split.']);
        return $content;
    }

    /**
     * prioriCalc
     * Will use the content as a mathematical term and calculate the result
     * Can be set to 1 to just get a calculated value or 'intval' to get the integer of the result
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for prioriCalc.
     * @return  string      The processed input value
     */
    public function stdWrap_prioriCalc($content = '', $conf = array()) {
        $content = t3lib_div::calcParenthesis($content);
        if ($conf['prioriCalc'] == 'intval')
            $content = intval($content);
        return $content;
    }

    /**
     * char
     * Will return a character based on its position within the current character set
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for char.
     * @return  string      The processed input value
     */
    public function stdWrap_char($content = '', $conf = array()) {
        $content = chr(intval($conf['char']));
        return $content;
    }

    /**
     * intval
     * Will return an integer value of the current content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for intval.
     * @return  string      The processed input value
     */
    public function stdWrap_intval($content = '', $conf = array()) {
        $content = intval($content);
        return $content;
    }

    /**
     * numberFormat
     * Will return a formatted number based on configuration given as stdWrap properties
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for numberFormat.
     * @return  string      The processed input value
     */
    public function stdWrap_numberFormat($content = '', $conf = array()) {
        $content = $this->numberFormat($content, $conf['numberFormat.']);
        return $content;
    }

    /**
     * date
     * Will return a formatted date based on configuration given according to PHP date/gmdate properties
     * Will return gmdate when the property GMT returns true
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for date.
     * @return  string      The processed input value
     */
    public function stdWrap_date($content = '', $conf = array()) {
        $content = ($conf['date.']['GMT'] ? gmdate($conf['date'], $content) : date($conf['date'], $content));
        return $content;
    }

    /**
     * strftime
     * Will return a formatted date based on configuration given according to PHP strftime/gmstrftime properties
     * Will return gmstrftime when the property GMT returns true
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for strftime.
     * @return  string      The processed input value
     */
    public function stdWrap_strftime($content = '', $conf = array()) {
        $content = ($conf['strftime.']['GMT'] ? gmstrftime($conf['strftime'], $content) : strftime($conf['strftime'], $content));
        $tmp_charset = $conf['strftime.']['charset'] ? $conf['strftime.']['charset'] : $GLOBALS['TSFE']->localeCharset;
        if ($tmp_charset) {
            $content = $GLOBALS['TSFE']->csConv($content, $tmp_charset);
        }
        return $content;
    }

    /**
     * age
     * Will return the age of a given timestamp based on configuration given by stdWrap properties
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for age.
     * @return  string      The processed input value
     */
    public function stdWrap_age($content = '', $conf = array()) {
        $content = $this->calcAge($GLOBALS['EXEC_TIME'] - $content, $conf['age']);
        return $content;
    }

    /**
     * case
     * Will transform the content to be upper or lower case only
     * Leaves HTML tags untouched
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for case.
     * @return  string      The processed input value
     */
    public function stdWrap_case($content = '', $conf = array()) {
        $content = $this->HTMLcaseshift($content, $conf['case']);
        return $content;
    }

    /**
     * bytes
     * Will return the size of a given number in Bytes   *
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for bytes.
     * @return  string      The processed input value
     */
    public function stdWrap_bytes($content = '', $conf = array()) {
        $content = t3lib_div::formatSize($content, $conf['bytes.']['labels']);
        return $content;
    }

    /**
     * substring
     * Will return a substring based on position information given by stdWrap properties
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for substring.
     * @return  string      The processed input value
     */
    public function stdWrap_substring($content = '', $conf = array()) {
        $content = $this->substring($content, $conf['substring']);
        return $content;
    }

    /**
     * removeBadHTML
     * Removes HTML tags based on stdWrap properties
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for removeBadHTML.
     * @return  string      The processed input value
     */
    public function stdWrap_removeBadHTML($content = '', $conf = array()) {
        $content = $this->removeBadHTML($content, $conf['removeBadHTML.']);
        return $content;
    }

    /**
     * cropHTML
     * Crops content to a given size while leaving HTML tags untouched
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for cropHTML.
     * @return  string      The processed input value
     */
    public function stdWrap_cropHTML($content = '', $conf = array()) {
        $content = $this->cropHTML($content, $conf['cropHTML']);
        return $content;
    }

    /**
     * stripHtml
     * Copmletely removes HTML tags from content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for stripHtml.
     * @return  string      The processed input value
     */
    public function stdWrap_stripHtml($content = '', $conf = array()) {
        $content = strip_tags($content);
        return $content;
    }

    /**
     * cropHTML
     * Crops content to a given size without caring abhout HTML tags
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for crop.
     * @return  string      The processed input value
     */
    public function stdWrap_crop($content = '', $conf = array()) {
        $content = $this->crop($content, $conf['crop']);
        return $content;
    }

    /**
     * rawUrlEncode
     * Encodes content to be used within URLs
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for rawUrlEncode.
     * @return  string      The processed input value
     */
    public function stdWrap_rawUrlEncode($content = '', $conf = array()) {
        $content = rawurlencode($content);
        return $content;
    }

    /**
     * htmlSpecialChars
     * Transforms HTML tags to readable text by replacing special characters with their HTML entity
     * When preserveEntities returns true, existing entities will be left untouched
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for htmlSpecalChars.
     * @return  string      The processed input value
     */
    public function stdWrap_htmlSpecialChars($content = '', $conf = array()) {
        $content = htmlSpecialChars($content);
        if ($conf['htmlSpecialChars.']['preserveEntities'])
            $content = t3lib_div::deHSCentities($content);
        return $content;
    }

    /**
     * doubleBrTag
     * Searches for double line breaks and replaces them with the given value
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for doubleBrTag.
     * @return  string      The processed input value
     */
    public function stdWrap_doubleBrTag($content = '', $conf = array()) {
        $content = preg_replace("/\r?\n[\t ]*\r?\n/", $conf['doubleBrTag'], $content);
        return $content;
    }

    /**
     * br
     * Searches for single line breaks and replaces them with a <br /> tag
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for br.
     * @return  string      The processed input value
     */
    public function stdWrap_br($content = '', $conf = array()) {
        $content = nl2br($content);
        return $content;
    }

    /**
     * brTag
     * Searches for single line feeds and replaces them with the given value
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for brTag.
     * @return  string      The processed input value
     */
    public function stdWrap_brTag($content = '', $conf = array()) {
        $content = str_replace(LF, $conf['brTag'], $content);
        return $content;
    }

    /**
     * encapsLines
     * Modifies text blocks by searching for lines which are not surrounded by HTML tags yet
     * and wrapping them with values given by stdWrap properties
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for erncapsLines.
     * @return  string      The processed input value
     */
    public function stdWrap_encapsLines($content = '', $conf = array()) {
        $content = $this->encaps_lineSplit($content, $conf['encapsLines.']);
        return $content;
    }

    /**
     * keywords
     * Transforms content into a CSV list to be used i.e. as keywords within a meta tag
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for keywords.
     * @return  string      The processed input value
     */
    public function stdWrap_keywords($content = '', $conf = array()) {
        $content = $this->keywords($content);
        return $content;
    }

    /**
     * innerWrap
     * First of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for innerWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_innerWrap($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['innerWrap']);
        return $content;
    }

    /**
     * innerWrap2
     * Second of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for innerWrap2.
     * @return  string      The processed input value
     */
    public function stdWrap_innerWrap2($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['innerWrap2']);
        return $content;
    }

    /**
     * fontTag
     * A wrap formerly used to apply font tags to format the content
     * Still used by lib.stdheader although real font tags are not state of the art anymore
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for fontTag.
     * @return  string      The processed input value
     */
    public function stdWrap_fontTag($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['fontTag']);
        return $content;
    }

    /**
     * addParams
     * Adds tag attributes to any content that is a tag
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for addParams.
     * @return  string      The processed input value
     */
    public function stdWrap_addParams($content = '', $conf = array()) {
        $content = $this->addParams($content, $conf['addParams.']);
        return $content;
    }

    /**
     * textStyle
     * Wraps content in font tags
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for textStyle.
     * @return  string      The processed input value
     */
    public function stdWrap_textStyle($content = '', $conf = array()) {
        $content = $this->textStyle($content, $conf['textStyle.']);
        return $content;
    }

    /**
     * tableStyle
     * Wraps content with table tags
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for tableStyle.
     * @return  string      The processed input value
     */
    public function stdWrap_tableStyle($content = '', $conf = array()) {
        $content = $this->tableStyle($content, $conf['tableStyle.']);
        return $content;
    }

    /**
     * filelink
     * Used to make lists of links to files
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for filelink.
     * @return  string      The processed input value
     */
    public function stdWrap_filelink($content = '', $conf = array()) {
        $content = $this->filelink($content, $conf['filelink.']);
        return $content;
    }

    /**
     * preCObject
     * A content object that is prepended to the current content but between the innerWraps and the rest of the wraps
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for preCObject.
     * @return  string      The processed input value
     */
    public function stdWrap_preCObject($content = '', $conf = array()) {
        $content = $this->cObjGetSingle($conf['preCObject'], $conf['preCObject.'], '/stdWrap/.preCObject') . $content;
        return $content;
    }

    /**
     * postCObject
     * A content object that is appended to the current content but between the innerWraps and the rest of the wraps
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for postCObject.
     * @return  string      The processed input value
     */
    public function stdWrap_postCObject($content = '', $conf = array()) {
        $content .= $this->cObjGetSingle($conf['postCObject'], $conf['postCObject.'], '/stdWrap/.postCObject');
        return $content;
    }

    /**
     * wrapAlign
     * Wraps content with a div container having the style attribute text-align set to the given value
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for wrapAlign.
     * @return  string      The processed input value
     */
    public function stdWrap_wrapAlign($content = '', $conf = array()) {
        $wrapAlign = trim($conf['wrapAlign']);
        if ($wrapAlign) {
            $content = $this->wrap($content, '<div style="text-align:' . $wrapAlign . ';">|</div>');
        }
        return $content;
    }

    /**
     * typolink
     * Wraps the content with a link tag
     * URLs and other attributes are created automatically by the values given in the stdWrap properties
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for typolink.
     * @return  string      The processed input value
     */
    public function stdWrap_typolink($content = '', $conf = array()) {
        $content = $this->typolink($content, $conf['typolink.']);
        return $content;
    }

    /**
     * TCAselectItem
     * Returns a list of options available for a given field in the DB which has to be of the type select
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for TCAselectItem.
     * @return  string      The processed input value
     */
    public function stdWrap_TCAselectItem($content = '', $conf = array()) {
        if (is_array($conf['TCAselectItem.'])) {
            $content = $this->TCAlookup($content, $conf['TCAselectItem.']);
        }
        return $content;
    }

    /**
     * spaceBefore
     * Will add space before the current content
     * By default this is done with a clear.gif but it can be done with CSS margins by setting the property space.useDiv to true
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for spaceBefore and space.
     * @return  string      The processed input value
     */
    public function stdWrap_spaceBefore($content = '', $conf = array()) {
        $content = $this->wrapSpace($content, trim($conf['spaceBefore']) . '|', $conf['space.']);
        return $content;
    }

    /**
     * spaceAfter
     * Will add space after the current content
     * By default this is done with a clear.gif but it can be done with CSS margins by setting the property space.useDiv to true
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for spaceAfter and space.
     * @return  string      The processed input value
     */
    public function stdWrap_spaceAfter($content = '', $conf = array()) {
        $content = $this->wrapSpace($content, '|' . trim($conf['spaceAfter']), $conf['space.']);
        return $content;
    }

    /**
     * space
     * Will add space before or after the current content
     * By default this is done with a clear.gif but it can be done with CSS margins by setting the property space.useDiv to true
     * See wrap
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for space.
     * @return  string      The processed input value
     */
    public function stdWrap_space($content = '', $conf = array()) {
        $content = $this->wrapSpace($content, trim($conf['space']), $conf['space.']);
        return $content;
    }

    /**
     * wrap
     * This is the "mother" of all wraps
     * Third of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * Basically it will put additional content before and after the current content using a split character as a placeholder for the current content
     * The default split character is | but it can be replaced with other characters by the property splitChar
     * Any other wrap that does not have own splitChar settings will be using the default split char though
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for wrap.
     * @return  string      The processed input value
     */
    public function stdWrap_wrap($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['wrap'], ($conf['wrap.']['splitChar'] ? $conf['wrap.']['splitChar'] : '|'));
        return $content;
    }

    /**
     * noTrimWrap
     * Fourth of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * The major difference to any other wrap is, that this one can make use of whitespace without trimming  *
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for noTrimWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_noTrimWrap($content = '', $conf = array()) {
        $content = $this->noTrimWrap($content, $conf['noTrimWrap']);
        return $content;
    }

    /**
     * wrap2
     * Fifth of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * The default split character is | but it can be replaced with other characters by the property splitChar
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for wrap2.
     * @return  string      The processed input value
     */
    public function stdWrap_wrap2($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['wrap2'], ($conf['wrap2.']['splitChar'] ? $conf['wrap2.']['splitChar'] : '|'));
        return $content;
    }

    /**
     * dataWrap
     * Sixth of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * Can fetch additional content the same way data does (i.e. {field:whatever}) and apply it to the wrap before that is applied to the content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for dataWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_dataWrap($content = '', $conf = array()) {
        $content = $this->dataWrap($content, $conf['dataWrap']);
        return $content;
    }

    /**
     * prepend
     * A content object that will be prepended to the current content after most of the wraps have already been applied
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for prepend.
     * @return  string      The processed input value
     */
    public function stdWrap_prepend($content = '', $conf = array()) {
        $content = $this->cObjGetSingle($conf['prepend'], $conf['prepend.'], '/stdWrap/.prepend') . $content;
        return $content;
    }

    /**
     * append
     * A content object that will be appended to the current content after most of the wraps have already been applied
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for append.
     * @return  string      The processed input value
     */
    public function stdWrap_append($content = '', $conf = array()) {
        $content .= $this->cObjGetSingle($conf['append'], $conf['append.'], '/stdWrap/.append');
        return $content;
    }

    /**
     * wrap3
     * Seventh of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     * The default split character is | but it can be replaced with other characters by the property splitChar
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for wrap3.
     * @return  string      The processed input value
     */
    public function stdWrap_wrap3($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['wrap3'], ($conf['wrap3.']['splitChar'] ? $conf['wrap3.']['splitChar'] : '|'));
        return $content;
    }

    /**
     * outerWrap
     * Eighth of a set of different wraps which will be applied in a certain order before or after other functions that modify the content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for outerWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_outerWrap($content = '', $conf = array()) {
        $content = $this->wrap($content, $conf['outerWrap']);
        return $content;
    }

    /**
     * inserData
     * Can fetch additional content the same way data does and replaces any occurence of {field:whatever} with this content
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for insertData.
     * @return  string      The processed input value
     */
    public function stdWrap_insertData($content = '', $conf = array()) {
        $content = $this->insertData($content);
        return $content;
    }

    /**
     * offsetWrap
     * Creates a so called offset table around the content
     * Still here for historical reasons even not used too much nowadays
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for offsetWrap.
     * @return  string      The processed input value
     */
    public function stdWrap_offsetWrap($content = '', $conf = array()) {
        $controlTable = t3lib_div::makeInstance('tslib_tableOffset');
        if ($conf['offsetWrap.']['tableParams'] || $conf['offsetWrap.']['tableParams.']) {
            $controlTable->tableParams = isset($conf['offsetWrap.']['tableParams.'])
                ? $this->stdWrap($conf['offsetWrap.']['tableParams'], $conf['offsetWrap.']['tableParams.'])
                : $conf['offsetWrap.']['tableParams'];
        }
        if ($conf['offsetWrap.']['tdParams'] || $conf['offsetWrap.']['tdParams.']) {
            $controlTable->tdParams = ' ' . isset($conf['offsetWrap.']['tdParams.'])
                ? $this->stdWrap($conf['offsetWrap.']['tdParams'], $conf['offsetWrap.']['tdParams.'])
                : $conf['offsetWrap.']['tdParams'];
        }
        $content = $controlTable->start($content, $conf['offsetWrap']);
        if ($conf['offsetWrap.']['stdWrap.']) {
            $content = $this->stdWrap($content, $conf['offsetWrap.']['stdWrap.']);
        }
        return $content;
    }

    /**
     * postUserFunc
     * Will execute a user function after the content has been modified by any other stdWrap function
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for postUserFunc.
     * @return  string      The processed input value
     */
    public function stdWrap_postUserFunc($content = '', $conf = array()) {
        $content = $this->callUserFunction($conf['postUserFunc'], $conf['postUserFunc.'], $content);
        return $content;
    }

    /**
     * postUserFuncInt
     * Will execute a user function after the content has been created and each time it is fetched from Cache
     * The result of this function itself will not be cached
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for postUserFuncInt.
     * @return  string      The processed input value
     */
    public function stdWrap_postUserFuncInt($content = '', $conf = array()) {
        $substKey = 'INT_SCRIPT.' . $GLOBALS['TSFE']->uniqueHash();
        $GLOBALS['TSFE']->config['INTincScript'][$substKey] = array(
            'content' => $content, 'postUserFunc' => $conf['postUserFuncInt'], 'conf' => $conf['postUserFuncInt.'], 'type' => 'POSTUSERFUNC', 'cObj' => serialize($this)
        );
        $content = '<!--' . $substKey . '-->';
        return $content;
    }

    /**
     * prefixComment
     * Will add HTML comments to the content to make it easier to identify certain content elements within the HTML output later on
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for prefixComment.
     * @return  string      The processed input value
     */
    public function stdWrap_prefixComment($content = '', $conf = array()) {
        if (!$GLOBALS['TSFE']->config['config']['disablePrefixComment']) {
            $content = $this->prefixComment($conf['prefixComment'], $conf['prefixComment.'], $content);
        }
        return $content;
    }

    /**
     * editIcons
     * Will render icons for frontend editing as long as there is a BE user logged in
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for editIcons.
     * @return  string      The processed input value
     */
    public function stdWrap_editIcons($content = '', $conf = array()) {
        if ($GLOBALS['TSFE']->beUserLogin && $conf['editIcons']) {
            if(!is_array($conf['editIcons.'])) {
                $conf['editIcons.'] = array();
            }
            $content = $this->editIcons($content, $conf['editIcons'], $conf['editIcons.']);
        }
        return $content;
    }

    /**
     * editPanel
     * Will render the edit panel for frontend editing as long as there is a BE user logged in
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for editPanel.
     * @return  string      The processed input value
     */
    public function stdWrap_editPanel($content = '', $conf = array()) {
        if ($GLOBALS['TSFE']->beUserLogin) {
            $content = $this->editPanel($content, $conf['editPanel.']);
        }
        return $content;
    }

    /**
     * stdWrap post process hook
     * can be used by extensions authors to modify the behaviour of stdWrap functions to their needs
     * this hook executes functions at after the content has been modified by the rest of the stdWrap functions but still before debugging
     *
     * @param   string      Input value undergoing processing in these functions.
     * @param   array       All stdWrap properties, not just the ones for a particular function.
     * @return  string      The processed input value
     */
    public function stdWrap_stdWrapPostProcess($content = '', $conf = array()) {
        foreach ($this->stdWrapHookObjects as $hookObject) {
            $content = $hookObject->stdWrapPostProcess($content, $conf, $this);
        }
        return $content;
    }

    /**
     * debug
     * Will output the content as readable HTML code
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for debug.
     * @return  string      The processed input value
     */
    public function stdWrap_debug($content = '', $conf = array()) {
        $content = '<pre>' . htmlspecialchars($content) . '</pre>';
        return $content;
    }

    /**
     * debugFunc
     * Will output the content in a debug table
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for debugFunc.
     * @return  string      The processed input value
     */
    public function stdWrap_debugFunc($content = '', $conf = array()) {
        debug($conf['debugFunc'] == 2 ? array(
            $content
        ) : $content);
        return $content;
    }

    /**
     * debugData
     * Will output the data used by the current record in a debug table
     *
     * @param   string      Input value undergoing processing in this function.
     * @param   array       stdWrap properties for debugData.
     * @return  string      The processed input value
     */
    public function stdWrap_debugData($content = '', $conf = array()) {
        debug($this->data, '$cObj->data:');
        if (is_array($this->alternativeData)) {
            debug($this->alternativeData, '$this->alternativeData');
        }
        return $content;
    }

    /**
     * Returns number of rows selected by the query made by the properties set.
     * Implements the stdWrap "numRows" property
     *
     * @param   array       TypoScript properties for the property (see link to "numRows")
     * @return  integer     The number of rows found by the select (FALSE on error)
     * @access private
     * @see stdWrap()
     */
    function numRows($conf) {
        $result = FALSE;
        $conf['select.']['selectFields'] = 'count(*)';

        $res = $this->exec_getQuery($conf['table'], $conf['select.']);

        if ($error = $GLOBALS['TYPO3_DB']->sql_error()) {
            $GLOBALS['TT']->setTSlogMessage($error, 3);
        } else {
            $row = $GLOBALS['TYPO3_DB']->sql_fetch_row($res);
            $result = intval($row[0]);
        }
        $GLOBALS['TYPO3_DB']->sql_free_result($res);
        return $result;
    }

    /**
     * Exploding a string by the $char value (if integer its an ASCII value) and returning index $listNum
     *
     * @param   string      String to explode
     * @param   string      Index-number. You can place the word "last" in it and it will be substituted with the pointer to the last value. You can use math operators like "+-/*" (passed to calc())
     * @param   string      Either a string used to explode the content string or an integer value which will then be changed into a character, eg. "10" for a linebreak char.
     * @return  string
     */
    function listNum($content, $listNum, $char) {
        $char = $char ? $char : ',';
        if (t3lib_div::testInt($char)) {
            $char = chr($char);
        }
        $temp = explode($char, $content);
        $last = '' . (count($temp) - 1);
        $index = $this->calc(str_ireplace('last', $last, $listNum));
        return $temp[$index];
    }

    /**
     * Compares values together based on the settings in the input TypoScript array and returns TRUE or FALSE based on the comparison result.
     * Implements the "if" function in TYPO3 TypoScript
     *
     * @param   array       TypoScript properties defining what to compare
     * @return  boolean
     * @see HMENU(), CASEFUNC(), IMAGE(), COLUMN(), stdWrap(), _parseFunc()
     */
    function checkIf($conf) {
        if (!is_array($conf)) {
            return TRUE;
        }
        if (isset($conf['directReturn'])) {
            return $conf['directReturn'] ? 1 : 0;
        }
        $flag = TRUE;
        if (isset($conf['isTrue']) || isset($conf['isTrue.'])) {
            $isTrue = isset($conf['isTrue.'])
                ? trim($this->stdWrap($conf['isTrue'], $conf['isTrue.']))
                : trim($conf['isTrue']);
            if (!$isTrue) {
                $flag = 0;
            }
        }
        if (isset($conf['isFalse']) || isset($conf['isFalse.'])) {
            $isFalse = isset($conf['isFalse.'])
                ? trim($this->stdWrap($conf['isFalse'], $conf['isFalse.']))
                : trim($conf['isFalse']);
            if ($isFalse) {
                $flag = 0;
            }
        }
        if (isset($conf['isPositive']) || isset($conf['isPositive.'])) {
            $number = isset($conf['isPositive.'])
                ? $this->calc($this->stdWrap($conf['isPositive'], $conf['isPositive.']))
                : $this->calc($conf['isPositive']);
            if ($number < 1) {
                $flag = 0;
            }
        }
        if ($flag) {
            $value = isset($conf['value.'])
                ? trim($this->stdWrap($conf['value'], $conf['value.']))
                : trim($conf['value']);

            if (isset($conf['isGreaterThan']) || isset($conf['isGreaterThan.'])) {
                $number = isset($conf['isGreaterThan.'])
                    ? trim($this->stdWrap($conf['isGreaterThan'], $conf['isGreaterThan.']))
                    : trim($conf['isGreaterThan']);
                if ($number <= $value) {
                    $flag = 0;
                }
            }
            if (isset($conf['isLessThan']) || isset($conf['isLessThan.'])) {
                $number = isset($conf['isLessThan.'])
                    ? trim($this->stdWrap($conf['isLessThan'], $conf['isLessThan.']))
                    : trim($conf['isLessThan']);
                if ($number >= $value) {
                    $flag = 0;
                }
            }
            if (isset($conf['equals']) || isset($conf['equals.'])) {
                $number = isset($conf['equals.'])
                    ? trim($this->stdWrap($conf['equals'], $conf['equals.']))
                    : trim($conf['equals']);
                if ($number != $value) {
                    $flag = 0;
                }
            }
            if (isset($conf['isInList']) || isset($conf['isInList.'])) {
                $number = isset($conf['isInList.'])
                    ? trim($this->stdWrap($conf['isInList'], $conf['isInList.']))
                    : trim($conf['isInList']);
                if (!t3lib_div::inList($value, $number)) {
                    $flag = 0;
                }
            }
        }
        if ($conf['negate']) {
            $flag = $flag ? 0 : 1;
        }
        return $flag;
    }

    /**
     * Reads a directory for files and returns the filepaths in a string list separated by comma.
     * Implements the stdWrap property "filelist"
     *
     * @param   string      The command which contains information about what files/directory listing to return. See the "filelist" property of stdWrap for details.
     * @return  string      Comma list of files.
     * @access private
     * @see stdWrap()
     */
    function filelist($data) {
        $data = trim($data);
        if ($data) {
            $data_arr = explode('|', $data);
                // read directory:
            if ($GLOBALS['TSFE']->lockFilePath) { // MUST exist!
                $path = $this->clean_directory($data_arr[0]); // Cleaning name..., only relative paths accepted.
                    // see if path starts with lockFilePath, the additional '/' is needed because clean_directory gets rid of it
                $path = (t3lib_div::isFirstPartOfStr($path . '/', $GLOBALS['TSFE']->lockFilePath) ? $path : '');
            }
            if ($path) {
                $items = array(
                    'files' => array(),
                    'sorting' => array()
                );
                $ext_list = strtolower(t3lib_div::uniqueList($data_arr[1]));
                $sorting = trim($data_arr[2]);
                    // read dir:
                $d = @dir($path);
                $tempArray = array();
                if (is_object($d)) {
                    $count = 0;
                    while ($entry = $d->read()) {
                        if ($entry != '.' && $entry != '..') {
                            $wholePath = $path . '/' . $entry; // Because of odd PHP-error where  <br />-tag is sometimes placed after a filename!!
                            if (file_exists($wholePath) && filetype($wholePath) == 'file') {
                                $info = t3lib_div::split_fileref($wholePath);
                                if (!$ext_list || t3lib_div::inList($ext_list, $info['fileext'])) {
                                    $items['files'][] = $info['file'];
                                    switch ($sorting) {
                                        case 'name' :
                                            $items['sorting'][] = strtolower($info['file']);
                                        break;
                                        case 'size' :
                                            $items['sorting'][] = filesize($wholePath);
                                        break;
                                        case 'ext' :
                                            $items['sorting'][] = $info['fileext'];
                                        break;
                                        case 'date' :
                                            $items['sorting'][] = filectime($wholePath);
                                        break;
                                        case 'mdate' :
                                            $items['sorting'][] = filemtime($wholePath);
                                        break;
                                        default :
                                            $items['sorting'][] = $count;
                                        break;
                                    }
                                    $count++;
                                }
                            }
                        }
                    }
                    $d->close();
                }
                    // Sort if required
                if (count($items['sorting'])) {
                    if (strtolower(trim($data_arr[3])) != 'r') {
                        asort($items['sorting']);
                    } else {
                        arsort($items['sorting']);
                    }
                }
                if (count($items['files'])) {
                        // make list
                    reset($items['sorting']);
                    $fullPath = trim($data_arr[4]);
                    $list_arr = array();
                    foreach ($items['sorting'] as $key => $v) {
                        $list_arr[] = $fullPath ? $path . '/' . $items['files'][$key] : $items['files'][$key];
                    }
                    return implode(',', $list_arr);
                }
            }
        }
    }

    /**
     * Cleans $theDir for slashes in the end of the string and returns the new path, if it exists on the server.
     *
     * @param   string      Absolute path to directory
     * @return  string      The directory path if it existed as was valid to access.
     * @access private
     * @see filelist()
     */
    function clean_directory($theDir) {
        if (t3lib_div::validPathStr($theDir)) { // proceeds if no '//', '..' or '\' is in the $theFile
            $theDir = preg_replace('/[\/\. ]*$/', '', $theDir); // Removes all dots, slashes and spaces after a path...
            if (!t3lib_div::isAbsPath($theDir) && @is_dir($theDir)) {
                return $theDir;
            }
        }
    }

    /**
     * Passes the input value, $theValue, to an instance of "t3lib_parsehtml" together with the TypoScript options which are first converted from a TS style array to a set of arrays with options for the t3lib_parsehtml class.
     *
     * @param   string      The value to parse by the class "t3lib_parsehtml"
     * @param   array       TypoScript properties for the parser. See link.
     * @return  string      Return value.
     * @see stdWrap(), t3lib_parsehtml::HTMLparserConfig(), t3lib_parsehtml::HTMLcleaner()
     */
    function HTMLparser_TSbridge($theValue, $conf) {
        $htmlParser = t3lib_div::makeInstance('t3lib_parsehtml');
        $htmlParserCfg = $htmlParser->HTMLparserConfig($conf);
        return $htmlParser->HTMLcleaner($theValue, $htmlParserCfg[0], $htmlParserCfg[1], $htmlParserCfg[2], $htmlParserCfg[3]);
    }

    /**
     * Wrapping input value in a regular "wrap" but parses the wrapping value first for "insertData" codes.
     *
     * @param   string      Input string being wrapped
     * @param   string      The wrap string, eg. "<strong></strong>" or more likely here '<a href="index.php?id={TSFE:id}"> | </a>' which will wrap the input string in a <a> tag linking to the current page.
     * @return  string      Output string wrapped in the wrapping value.
     * @see insertData(), stdWrap()
     */
    function dataWrap($content, $wrap) {
        return $this->wrap($content, $this->insertData($wrap));
    }

    /**
     * Implements the "insertData" property of stdWrap meaning that if strings matching {...} is found in the input string they will be substituted with the return value from getData (datatype) which is passed the content of the curly braces.
     * Example: If input string is "This is the page title: {page:title}" then the part, '{page:title}', will be substituted with the current pages title field value.
     *
     * @param   string      Input value
     * @return  string      Processed input value
     * @see getData(), stdWrap(), dataWrap()
     */
    function insertData($str) {
        $inside = 0;
        $newVal = '';
        $pointer = 0;
        $totalLen = strlen($str);
        do {
            if (!$inside) {
                $len = strcspn(substr($str, $pointer), '{');
                $newVal .= substr($str, $pointer, $len);
                $inside = 1;
            } else {
                $len = strcspn(substr($str, $pointer), '}') + 1;
                $newVal .= $this->getData(substr($str, $pointer + 1, $len - 2), $this->data);
                $inside = 0;
            }
            $pointer += $len;
        } while ($pointer < $totalLen);
        return $newVal;
    }

    /**
     * Returns a HTML comment with the second part of input string (divided by "|") where first part is an integer telling how many trailing tabs to put before the comment on a new line.
     * Notice; this function (used by stdWrap) can be disabled by a "config.disablePrefixComment" setting in TypoScript.
     *
     * @param   string      Input value
     * @param   array       TypoScript Configuration (not used at this point.)
     * @param   string      The content to wrap the comment around.
     * @return  string      Processed input value
     * @see stdWrap()
     */
    function prefixComment($str, $conf, $content) {
        $parts = explode('|', $str);

        $output = LF . str_pad('', $parts[0], TAB) .
            '<!-- ' . htmlspecialchars($this->insertData($parts[1])) . ' [begin] -->' . LF .
            str_pad('', $parts[0] + 1, TAB) .
            $content . LF .
            str_pad('', $parts[0], TAB) .
            '<!-- ' . htmlspecialchars($this->insertData($parts[1])) . ' [end] -->' . LF .
            str_pad('', $parts[0] + 1, TAB);

        return $output;
    }

    /**
     * Implements the stdWrap property "substring" which is basically a TypoScript implementation of the PHP function, substr()
     *
     * @param   string      The string to perform the operation on
     * @param   string      The parameters to substring, given as a comma list of integers where the first and second number is passed as arg 1 and 2 to substr().
     * @return  string      The processed input value.
     * @access private
     * @see stdWrap()
     */
    function substring($content, $options) {
        $options = t3lib_div::intExplode(',', $options . ',');
        if ($options[1]) {
            return $GLOBALS['TSFE']->csConvObj->substr($GLOBALS['TSFE']->renderCharset, $content, $options[0], $options[1]);
        } else {
            return $GLOBALS['TSFE']->csConvObj->substr($GLOBALS['TSFE']->renderCharset, $content, $options[0]);
        }
    }

    /**
     * Implements the stdWrap property "crop" which is a modified "substr" function allowing to limit a string lenght to a certain number of chars (from either start or end of string) and having a pre/postfix applied if the string really was cropped.
     *
     * @param   string      The string to perform the operation on
     * @param   string      The parameters splitted by "|": First parameter is the max number of chars of the string. Negative value means cropping from end of string. Second parameter is the pre/postfix string to apply if cropping occurs. Third parameter is a boolean value. If set then crop will be applied at nearest space.
     * @return  string      The processed input value.
     * @access private
     * @see stdWrap()
     */
    function crop($content, $options) {
        $options = explode('|', $options);
        $chars = intval($options[0]);
        $afterstring = trim($options[1]);
        $crop2space = trim($options[2]);
        if ($chars) {
            if ($GLOBALS['TSFE']->csConvObj->strlen($GLOBALS['TSFE']->renderCharset, $content) > abs($chars)) {
                $truncatePosition = FALSE;
                if ($chars < 0) {
                    $content = $GLOBALS['TSFE']->csConvObj->substr($GLOBALS['TSFE']->renderCharset, $content, $chars);
                    if ($crop2space) {
                        $truncatePosition = strpos($content, ' ');
                    }
                    $content = ($truncatePosition) ? $afterstring . substr($content, $truncatePosition) : $afterstring . $content;
                } else {
                    $content = $GLOBALS['TSFE']->csConvObj->substr($GLOBALS['TSFE']->renderCharset, $content, 0, $chars);
                    if ($crop2space) {
                        $truncatePosition = strrpos($content, ' ');
                    }
                    $content = ($truncatePosition) ? substr($content, 0, $truncatePosition) . $afterstring : $content . $afterstring;
                }
            }
        }
        return $content;
    }

    /**
     * Implements the stdWrap property "cropHTML" which is a modified "substr" function allowing to limit a string length
     * to a certain number of chars (from either start or end of string) and having a pre/postfix applied if the string
     * really was cropped.
     *
     * Compared to stdWrap.crop it respects HTML tags and entities.
     *
     * @param   string      The string to perform the operation on
     * @param   string      The parameters splitted by "|": First parameter is the max number of chars of the string. Negative value means cropping from end of string. Second parameter is the pre/postfix string to apply if cropping occurs. Third parameter is a boolean value. If set then crop will be applied at nearest space.
     * @return  string      The processed input value.
     * @access private
     * @see stdWrap()
     */
    function cropHTML($content, $options) {
        $options = explode('|', $options);
        $chars = intval($options[0]);
        $absChars = abs($chars);
        $replacementForEllipsis = trim($options[1]);
        $crop2space = trim($options[2]) === '1' ? TRUE : FALSE;

            // Split $content into an array(even items in the array are outside the tags, odd numbers are tag-blocks).
        $tags = 'a|b|blockquote|body|div|em|font|form|h1|h2|h3|h4|h5|h6|i|li|map|ol|option|p|pre|sub|sup|select|span|strong|table|thead|tbody|tfoot|td|textarea|tr|u|ul|br|hr|img|input|area|link';
            // TODO We should not crop inside <script> tags.
        $tagsRegEx = "
            (
                (?:
                    <!--.*?-->                  # a comment
                )
                |
                </?(?:" . $tags . ")+           # opening tag ('<tag') or closing tag ('</tag')
                (?:
                    (?:
                        \s+\w+                  # EITHER spaces, followed by word characters (attribute names)
                        (?:
                            \s*=?\s*            # equals
                            (?>
                                \".*?\"         # attribute values in double-quotes
                                |
                                '.*?'           # attribute values in single-quotes
                                |
                                [^'\">\s]+      # plain attribute values
                            )
                        )?
                    )+\s*
                    |                           # OR only spaces
                    \s*
                )
                /?>                             # closing the tag with '>' or '/>'
            )";
        $splittedContent = preg_split('%' . $tagsRegEx . '%xs', $content, -1, PREG_SPLIT_DELIM_CAPTURE);

            // Reverse array if we are cropping from right.
        if ($chars < 0) {
            $splittedContent = array_reverse($splittedContent);
        }

            // Crop the text (chars of tag-blocks are not counted).
        $strLen = 0;
        $croppedOffset = NULL; // This is the offset of the content item which was cropped.
        $countSplittedContent = count($splittedContent);
        for ($offset = 0; $offset < $countSplittedContent; $offset++) {
            if ($offset % 2 === 0) {
                $tempContent = $GLOBALS['TSFE']->csConvObj->utf8_encode($splittedContent[$offset], $GLOBALS['TSFE']->renderCharset);
                $thisStrLen = $GLOBALS['TSFE']->csConvObj->strlen('utf-8', html_entity_decode($tempContent, ENT_COMPAT, 'UTF-8'));
                if (($strLen + $thisStrLen > $absChars)) {
                    $croppedOffset = $offset;
                    $cropPosition = $absChars - $strLen;
                        // The snippet "&[^&\s;]{2,8};" in the RegEx below represents entities.
                    $patternMatchEntityAsSingleChar = '(&[^&\s;]{2,8};|.)';
                    if ($crop2space) {
                        $cropRegEx = $chars < 0
                            ? '#(?<=\s)' . $patternMatchEntityAsSingleChar . '{0,' . $cropPosition . '}$#ui'
                            : '#^' . $patternMatchEntityAsSingleChar . '{0,' . $cropPosition . '}(?=\s)#ui';
                    } else {
                        $cropRegEx = $chars < 0
                            ? '#' . $patternMatchEntityAsSingleChar . '{0,' . $cropPosition . '}$#ui'
                            : '#^' . $patternMatchEntityAsSingleChar . '{0,' . $cropPosition . '}#ui';
                    }
                    if (preg_match($cropRegEx, $tempContent, $croppedMatch)) {
                        $tempContent = $croppedMatch[0];
                    }
                    $splittedContent[$offset] = $GLOBALS['TSFE']->csConvObj->utf8_decode($tempContent, $GLOBALS['TSFE']->renderCharset);
                    break;
                } else {
                    $strLen += $thisStrLen;
                }
            }
        }

            // Close cropped tags.
        $closingTags = array();
        if ($croppedOffset !== NULL) {
            $tagName = '';
            $openingTagRegEx = '#^<(\w+)(?:\s|>)#';
            $closingTagRegEx = '#^</(\w+)(?:\s|>)#';
            for ($offset = $croppedOffset - 1; $offset >= 0; $offset = $offset - 2) {
                if (substr($splittedContent[$offset], -2) === '/>') {
                        // Ignore empty element tags (e.g. <br />).
                    continue;
                }
                preg_match($chars < 0 ? $closingTagRegEx : $openingTagRegEx, $splittedContent[$offset], $matches);
                $tagName = isset($matches[1]) ? $matches[1] : NULL;
                if ($tagName !== NULL) {
                        // Seek for the closing (or opening) tag.
                    $seekingTagName = '';
                    $countSplittedContent = count($splittedContent);
                    for ($seekingOffset = $offset + 2; $seekingOffset < $countSplittedContent; $seekingOffset = $seekingOffset + 2) {
                        preg_match($chars < 0 ? $openingTagRegEx : $closingTagRegEx, $splittedContent[$seekingOffset], $matches);
                        $seekingTagName = isset($matches[1]) ? $matches[1] : NULL;
                        if ($tagName === $seekingTagName) { // We found a matching tag.
                                // Add closing tag only if it occurs after the cropped content item.
                            if ($seekingOffset > $croppedOffset) {
                                $closingTags[] = $splittedContent[$seekingOffset];
                            }
                            break;
                        }
                    }
                }
            }
                // Drop the cropped items of the content array. The $closingTags will be added later on again.
            array_splice($splittedContent, $croppedOffset + 1);
        }
        $splittedContent = array_merge($splittedContent, array(
            $croppedOffset !== NULL ? $replacementForEllipsis : ''
        ), $closingTags);

            // Reverse array once again if we are cropping from the end.
        if ($chars < 0) {
            $splittedContent = array_reverse($splittedContent);
        }

        return implode('', $splittedContent);
    }

    /**
     * Function for removing malicious HTML code when you want to provide some HTML code user-editable.
     * The purpose is to avoid XSS attacks and the code will be continously modified to remove such code.
     * For a complete reference with javascript-on-events, see http://www.wdvl.com/Authoring/JavaScript/Events/events_target.html
     *
     * @param   string      Input string to be cleaned.
     * @param   array       TypoScript configuration.
     * @return  string      Return string
     * @author  Thomas Bley (all from moregroupware cvs code / readmessage.inc.php, published under gpl by Thomas)
     * @author  Kasper Sk�rh�j
     */
    function removeBadHTML($text, $conf) {

            // Copyright 2002-2003 Thomas Bley
        $text = preg_replace(
            array(
                "'<script[^>]*?>.*?</script[^>]*?>'si", "'<applet[^>]*?>.*?</applet[^>]*?>'si", "'<object[^>]*?>.*?</object[^>]*?>'si", "'<iframe[^>]*?>.*?</iframe[^>]*?>'si", "'<frameset[^>]*?>.*?</frameset[^>]*?>'si", "'<style[^>]*?>.*?</style[^>]*?>'si", "'<marquee[^>]*?>.*?</marquee[^>]*?>'si", "'<script[^>]*?>'si", "'<meta[^>]*?>'si", "'<base[^>]*?>'si", "'<applet[^>]*?>'si", "'<object[^>]*?>'si", "'<link[^>]*?>'si", "'<iframe[^>]*?>'si", "'<frame[^>]*?>'si", "'<frameset[^>]*?>'si", "'<input[^>]*?>'si", "'<form[^>]*?>'si", "'<embed[^>]*?>'si", "'background-image:url'si", "'<\w+.*?(onabort|onbeforeunload|onblur|onchange|onclick|ondblclick|ondragdrop|onerror|onfilterchange|onfocus|onhelp|onkeydown|onkeypress|onkeyup|onload|onmousedown|onmousemove|onmouseout|onmouseover|onmouseup|onmove|onreadystatechange|onreset|onresize|onscroll|onselect|onselectstart|onsubmit|onunload).*?>'si"
            ),
            '',
            $text
        );

        $text = preg_replace(
            '/<a[^>]*href[[:space:]]*=[[:space:]]*["\']?[[:space:]]*javascript[^>]*/i',
            '',
            $text
        );

            // Return clean content
        return $text;
    }

    /**
     * Implements the stdWrap property "textStyle"; This generates a <font>-tag (and a <div>-tag for align-attributes) which is wrapped around the input value.
     *
     * @param   string      The input value
     * @param   array       TypoScript properties for the "TypoScript function" '->textStyle'
     * @return  string      The processed output value
     * @access private
     * @see stdWrap()
     */
    function textStyle($theValue, $conf) {
        $conf['face.'][1] = 'Times New Roman';
        $conf['face.'][2] = 'Verdana,Arial,Helvetica,Sans serif';
        $conf['face.'][3] = 'Arial,Helvetica,Sans serif';

        $conf['size.'][1] = 1;
        $conf['size.'][2] = 2;
        $conf['size.'][3] = 3;
        $conf['size.'][4] = 4;
        $conf['size.'][5] = 5;
        $conf['size.'][10] = '+1';
        $conf['size.'][11] = '-1';

        $conf['color.'][240] = 'black';
        $conf['color.'][241] = 'white';
        $conf['color.'][242] = '#333333';
        $conf['color.'][243] = 'gray';
        $conf['color.'][244] = 'silver';
        $conf['color.'][245] = 'red';
        $conf['color.'][246] = 'navy';
        $conf['color.'][247] = 'yellow';
        $conf['color.'][248] = 'green';
        $conf['color.'][249] = 'olive';
        $conf['color.'][250] = 'maroon';

        $face = $this->data[$conf['face.']['field']];
        $size = $this->data[$conf['size.']['field']];
        $color = $this->data[$conf['color.']['field']];
        $align = $this->data[$conf['align.']['field']];
        $properties = $this->data[$conf['properties.']['field']];
        if (!$properties) {
            $properties = isset($conf['properties.']['default.'])
                ? $this->stdWrap($conf['properties.']['default'], $conf['properties.']['default.'])
                : $conf['properties.']['default'];
        }

            // properties
        if (($properties & 8)) {
            $theValue = $this->HTMLcaseshift($theValue, 'upper');
        }
        if (($properties & 1)) {
            $theValue = '<strong>' . $theValue . '</strong>';
        }
        if (($properties & 2)) {
            $theValue = '<i>' . $theValue . '</i>';
        }
        if (($properties & 4)) {
            $theValue = '<u>' . $theValue . '</u>';
        }

            // Fonttag
        $theFace = $conf['face.'][$face];
        if(!$theFace) {
            $theFace = isset($conf['face.']['default.'])
                ? $this->stdWrap($conf['face.']['default'], $conf['face.']['default.'])
                : $conf['face.']['default'];
        }

        $theSize = $conf['size.'][$size];
        if(!$theSize) {
            $theSize = isset($conf['size.']['default.'])
                ? $this->stdWrap($conf['size.']['default'], $conf['size.']['default.'])
                : $conf['size.']['default'];
        }

        $theColor = $conf['color.'][$color];
        if(!$theColor) {
            $theColor = isset($conf['color.']['default.'])
                ? $this->stdWrap($conf['color.']['default'], $conf['color.']['default.'])
                : $conf['color.']['default.'];
        }

        if ($conf['altWrap']) {
            $theValue = $this->wrap($theValue, $conf['altWrap']);
        } elseif ($theFace || $theSize || $theColor) {
            $fontWrap = '<font' . ($theFace ? ' face="' . $theFace . '"' : '') .
                ($theSize ? ' size="' . $theSize . '"' : '') .
                ($theColor ? ' color="' . $theColor . '"' : '') .
                '>|</font>';
            $theValue = $this->wrap($theValue, $fontWrap);
        }
            // align
        if ($align) {
            $theValue = $this->wrap($theValue, '<div style="text-align:' . $align . ';">|</div>');
        }
            // return
        return $theValue;
    }

    /**
     * Implements the stdWrap property "tableStyle"; Basically this generates a <table>-tag with properties which is wrapped around the input value.
     *
     * @param   string      The input value
     * @param   array       TypoScript properties for the "TypoScript function" '->textStyle'
     * @return  string      The processed output value
     * @access private
     * @see stdWrap()
     */
    function tableStyle($theValue, $conf) {
        $conf['color.'][240] = 'black';
        $conf['color.'][241] = 'white';
        $conf['color.'][242] = '#333333';
        $conf['color.'][243] = 'gray';
        $conf['color.'][244] = 'silver';

        $align = isset($conf['align.'])
            ? $this->stdWrap($conf['align'], $conf['align.'])
            : $conf['align'];
        $border = isset($conf['border.'])
            ? intval($this->stdWrap($conf['border'], $conf['border.']))
            : intval($conf['border']);
        $cellspacing = isset($conf['cellspacing.'])
            ? intval($this->stdWrap($conf['cellspacing'], $conf['cellspacing.']))
            : intval($conf['cellspacing']);
        $cellpadding = isset($conf['cellpadding.'])
            ? intval($this->stdWrap($conf['cellpadding'], $conf['cellpadding.']))
            : intval($conf['cellpadding']);

        $color = $this->data[$conf['color.']['field']];
        $theColor = $conf['color.'][$color] ? $conf['color.'][$color] : $conf['color.']['default'];
            // Assembling the table tag
        $tableTagArray = array(
            '<table'
        );
        $tableTagArray[] = 'border="' . $border . '"';
        $tableTagArray[] = 'cellspacing="' . $cellspacing . '"';
        $tableTagArray[] = 'cellpadding="' . $cellpadding . '"';
        if ($align) {
            $tableTagArray[] = 'align="' . $align . '"';
        }
        if ($theColor) {
            $tableTagArray[] = 'bgcolor="' . $theColor . '"';
        }

        if ($conf['params']) {
            $tableTagArray[] = $conf['params'];
        }

        $tableWrap = implode(' ', $tableTagArray) . '> | </table>';
        $theValue = $this->wrap($theValue, $tableWrap);
        // return
        return $theValue;
    }

    /**
     * Implements the TypoScript function "addParams"
     *
     * @param   string      The string with the HTML tag.
     * @param   array       The TypoScript configuration properties
     * @return  string      The modified string
     * @todo    Make it XHTML compatible. Will not present "/>" endings of tags right now. Further getting the tagname might fail if it is not separated by a normal space from the attributes.
     */
    function addParams($content, $conf) {
        $lowerCaseAttributes = TRUE; // For XHTML compliance.


        if (!is_array($conf)) {
            return $content;
        }

        $key = 1;
        $parts = explode('<', $content);
        if (intval($conf['_offset']))
            $key = intval($conf['_offset']) < 0 ? count($parts) + intval($conf['_offset']) : intval($conf['_offset']);
        $subparts = explode('>', $parts[$key]);
        if (trim($subparts[0])) {
                // Get attributes and name
            $attribs = t3lib_div::get_tag_attributes('<' . $subparts[0] . '>');
            list ($tagName) = explode(' ', $subparts[0], 2);
                // adds/overrides attributes
            foreach ($conf as $pkey => $val) {
                if (substr($pkey, -1) != '.' && substr($pkey, 0, 1) != '_') {
                    $tmpVal = isset($conf[$pkey . '.'])
                        ? $this->stdWrap($conf[$pkey], $conf[$pkey . '.'])
                        : $conf[$pkey];
                    if ($lowerCaseAttributes) {
                        $pkey = strtolower($pkey);
                    }
                    if (strcmp($tmpVal, '')) {
                        $attribs[$pkey] = $tmpVal;
                    }
                }
            }

                // Re-assembles the tag and content
            $subparts[0] = trim($tagName . ' ' . t3lib_div::implodeAttributes($attribs));
            $parts[$key] = implode('>', $subparts);
            $content = implode('<', $parts);
        }
        return $content;
    }

    /**
     * Creates a list of links to files.
     * Implements the stdWrap property "filelink"
     *
     * @param   string      The filename to link to, possibly prefixed with $conf[path]
     * @param   array       TypoScript parameters for the TypoScript function ->filelink
     * @return  string      The link to the file possibly with icons, thumbnails, size in bytes shown etc.
     * @access private
     * @see stdWrap()
     */
    function filelink($theValue, $conf) {
        $conf['path'] = isset($conf['path.'])
            ? $this->stdWrap($conf['path'], $conf['path.'])
            : $conf['path'];
        $theFile = trim($conf['path']) . $theValue;
        if (@is_file($theFile)) {
            $theFileEnc = str_replace('%2F', '/', rawurlencode($theFile));

                // the jumpURL feature will be taken care of by typoLink, only "jumpurl.secure = 1" is applyable needed for special link creation
            if ($conf['jumpurl.']['secure']) {
                $alternativeJumpUrlParameter = isset($conf['jumpurl.']['parameter.'])
                    ? $this->stdWrap($conf['jumpurl.']['parameter'], $conf['jumpurl.']['parameter.'])
                    : $conf['jumpurl.']['parameter'];
                $typoLinkConf = array(
                    'parameter' => ($alternativeJumpUrlParameter ? $alternativeJumpUrlParameter : ($GLOBALS['TSFE']->id . ',' . $GLOBALS['TSFE']->type)),
                    'fileTarget' => $conf['target'],
                    'ATagParams' => $this->getATagParams($conf),
                    'additionalParams' => '&jumpurl=' . rawurlencode($theFileEnc) . $this->locDataJU($theFileEnc, $conf['jumpurl.']['secure.']) . $GLOBALS['TSFE']->getMethodUrlIdToken
                );
            } else {
                $typoLinkConf = array(
                    'parameter' => $theFileEnc,
                    'fileTarget' => $conf['target'],
                    'ATagParams' => $this->getATagParams($conf)
                );
            }

                // if the global jumpURL feature is activated, but is disabled for this
                // filelink, the global parameter needs to be disabled as well for this link creation
            $globalJumpUrlEnabled = $GLOBALS['TSFE']->config['config']['jumpurl_enable'];
            if ($globalJumpUrlEnabled && isset($conf['jumpurl']) && $conf['jumpurl'] == 0) {
                $GLOBALS['TSFE']->config['config']['jumpurl_enable'] = 0;
                    // if the global jumpURL feature is deactivated, but is wanted for this link, then activate it for now
            } else if (!$globalJumpUrlEnabled && $conf['jumpurl']) {
                $GLOBALS['TSFE']->config['config']['jumpurl_enable'] = 1;
            }
            $theLinkWrap = $this->typoLink('|', $typoLinkConf);

                // now the original value is set again
            $GLOBALS['TSFE']->config['config']['jumpurl_enable'] = $globalJumpUrlEnabled;

            $theSize = filesize($theFile);
            $fI = t3lib_div::split_fileref($theFile);
            if ($conf['icon']) {
                $iconP = t3lib_extMgm::siteRelPath('cms') . 'tslib/media/fileicons/';
                $icon = @is_file($iconP . $fI['fileext'] . '.gif') ? $iconP . $fI['fileext'] . '.gif' : $iconP . 'default.gif';
                    // Checking for images: If image, then return link to thumbnail.
                $IEList = isset($conf['icon_image_ext_list.'])
                    ? $this->stdWrap($conf['icon_image_ext_list'], $conf['icon_image_ext_list.'])
                    : $conf['icon_image_ext_list'];
                $image_ext_list = str_replace(' ', '', strtolower($IEList));
                if ($fI['fileext'] && t3lib_div::inList($image_ext_list, $fI['fileext'])) {
                    if ($conf['iconCObject']) {
                        $icon = $this->cObjGetSingle($conf['iconCObject'], $conf['iconCObject.'], 'iconCObject');
                    } else {
                        if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails']) {
                            $thumbSize = '';
                            if ($conf['icon_thumbSize'] || $conf['icon_thumbSize.']) {
                                $thumbSize = '&size=' . isset($conf['icon_thumbSize.'])
                                    ? $this->stdWrap($conf['icon_thumbSize'], $conf['icon_thumbSize.'])
                                    : $conf['icon_thumbSize'];
                            }
                            $check = basename($theFile) . ':' . filemtime($theFile) . ':' . $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey'];
                            $md5sum = '&md5sum=' . t3lib_div::shortMD5($check);
                            $icon = 't3lib/thumbs.php?dummy=' . $GLOBALS['EXEC_TIME'] . '&file=' .
                                rawurlencode('../' . $theFile) . $thumbSize . $md5sum;
                        } else {
                            $icon = t3lib_extMgm::siteRelPath('cms') . 'tslib/media/miscicons/notfound_thumb.gif';
                        }
                        $icon = '<img src="' . htmlspecialchars($GLOBALS['TSFE']->absRefPrefix . $icon) . '"' .
                            $this->getBorderAttr(' border="0"') . '' . $this->getAltParam($conf) . ' />';
                    }
                } else {
                    $icon = '<img src="' . htmlspecialchars($GLOBALS['TSFE']->absRefPrefix . $icon) .
                        '" width="18" height="16"' . $this->getBorderAttr(' border="0"') .
                        $this->getAltParam($conf) . ' />';
                }
                if ($conf['icon_link']) {
                    $icon = $this->wrap($icon, $theLinkWrap);
                }
                $icon = isset($conf['icon.'])
                    ? $this->stdWrap($icon, $conf['icon.'])
                    : $icon;
            }
            if ($conf['size']) {
                $size = isset($conf['size.'])
                    ? $this->stdWrap($theSize, $conf['size.'])
                    : $theSize;
            }

                // Wrapping file label
            if ($conf['removePrependedNumbers']) {
                $theValue = preg_replace('/_[0-9][0-9](\.[[:alnum:]]*)$/', '\1', $theValue);
            }
            if(isset($conf['labelStdWrap.'])) {
                $theValue = $this->stdWrap($theValue, $conf['labelStdWrap.']);
            }

                // Wrapping file
            $wrap = isset($conf['wrap.'])
                ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                : $conf['wrap'];
            if ($conf['ATagBeforeWrap']) {
                $theValue = $this->wrap($this->wrap($theValue, $wrap), $theLinkWrap);
            } else {
                $theValue = $this->wrap($this->wrap($theValue, $theLinkWrap), $wrap);
            }
            $file = isset($conf['file.'])
                ? $this->stdWrap($theValue, $conf['file.'])
                : $theValue;
                // output
            $output = $icon . $file . $size;
            if(isset($conf['stdWrap.'])) {
                $output = $this->stdWrap($output, $conf['stdWrap.']);
            }

            return $output;
        }
    }

    /**
     * Returns a URL parameter string setting parameters for secure downloads by "jumpurl".
     * Helper function for filelink()
     *
     * @param   string      The URL to jump to, basically the filepath
     * @param   array       TypoScript properties for the "jumpurl.secure" property of "filelink"
     * @return  string      URL parameters like "&juSecure=1....."
     * @access private
     * @see filelink()
     */
    function locDataJU($jumpUrl, $conf) {
        $fI = pathinfo($jumpUrl);
        $mimetype = '';
        $mimetypeValue = '';
        if ($fI['extension']) {
            $mimeTypes = t3lib_div::trimExplode(',', $conf['mimeTypes'], 1);
            foreach ($mimeTypes as $v) {
                $parts = explode('=', $v, 2);
                if (strtolower($fI['extension']) == strtolower(trim($parts[0]))) {
                    $mimetypeValue = trim($parts[1]);
                    $mimetype = '&mimeType=' . rawurlencode($mimetypeValue);
                    break;
                }
            }
        }
        $locationData = $GLOBALS['TSFE']->id . ':' . $this->currentRecord;
        $rec = '&locationData=' . rawurlencode($locationData);
        $hArr = array(
            $jumpUrl, $locationData, $mimetypeValue
        );
        $juHash = '&juHash=' . t3lib_div::hmac(serialize($hArr));
        return '&juSecure=1' . $mimetype . $rec . $juHash;
    }

    /**
     * Performs basic mathematical evaluation of the input string. Does NOT take parathesis and operator precedence into account! (for that, see t3lib_div::calcPriority())
     *
     * @param   string      The string to evaluate. Example: "3+4*10/5" will generate "35". Only integer numbers can be used.
     * @return  integer     The result (might be a float if you did a division of the numbers).
     * @see t3lib_div::calcPriority()
     */
    function calc($val) {
        $parts = t3lib_div::splitCalc($val, '+-*/');
        $value = 0;
        foreach ($parts as $part) {
            $theVal = $part[1];
            $sign = $part[0];
            if ((string) intval($theVal) == (string) $theVal) {
                $theVal = intval($theVal);
            } else {
                $theVal = 0;
            }
            if ($sign == '-') {
                $value -= $theVal;
            }
            if ($sign == '+') {
                $value += $theVal;
            }
            if ($sign == '/') {
                if (intval($theVal))
                    $value /= intval($theVal);
            }
            if ($sign == '*') {
                $value *= $theVal;
            }
        }
        return $value;
    }

    /**
     * This explodes a comma-list into an array where the values are parsed through tslib_cObj::calc() and intval() (so you are sure to have integers in the output array)
     * Used to split and calculate min and max values for GMENUs.
     *
     * @param   string      Delimited to explode by
     * @param   string      The string with parts in (where each part is evaluated by ->calc())
     * @return  array       And array with evaluated values.
     * @see calc(), tslib_gmenu::makeGifs()
     */
    function calcIntExplode($delim, $string) {
        $temp = explode($delim, $string);
        foreach ($temp as $key => $val) {
            $temp[$key] = intval(tslib_cObj::calc($val));
        }
        return $temp;
    }

    /**
     * Implements the "split" property of stdWrap; Splits a string based on a token (given in TypoScript properties), sets the "current" value to each part and then renders a content object pointer to by a number.
     * In classic TypoScript (like 'content (default)'/'styles.content (default)') this is used to render tables, splitting rows and cells by tokens and putting them together again wrapped in <td> tags etc.
     * Implements the "optionSplit" processing of the TypoScript options for each splitted value to parse.
     *
     * @param   string      The string value to explode by $conf[token] and process each part
     * @param   array       TypoScript properties for "split"
     * @return  string      Compiled result
     * @access private
     * @see stdWrap(), t3lib_menu::procesItemStates()
     */
    function splitObj($value, $conf) {
        $conf['token'] = isset($conf['token.'])
            ? $this->stdWrap($conf['token'], $conf['token.'])
            : $conf['token'];
        if (!$conf['token']) {
            return $value;
        }
        $conf['max'] = isset($conf['max.'])
            ? intval($this->stdWrap($conf['max'], $conf['max.']))
            : intval($conf['max']);
        $conf['min'] = isset($conf['min.'])
            ? intval($this->stdWrap($conf['min'], $conf['min.']))
            : intval($conf['min']);

        $valArr = explode($conf['token'], $value);

        if (count($valArr) && (t3lib_div::testInt($conf['returnKey']) || $conf['returnKey.'])) {
            $key = isset($conf['returnKey.'])
                ? intval($this->stdWrap($conf['returnKey'], $conf['returnKey.']))
                : intval($conf['returnKey']);
            $content = isset($valArr[$key]) ? $valArr[$key] : '';
        } else {
                // calculate splitCount
            $splitCount = count($valArr);
            $max = isset($conf['max.'])
                ? $this->stdWrap($conf['max'],$conf['max.'])
                : $conf['max'];
            if ($max && $splitCount > $max) {
                $splitCount = $max;
            }
            $min = isset($conf['min.'])
                ? $this->stdWrap($conf['min'],$conf['min.'])
                : $conf['min'];
            if ($min && $splitCount < $min) {
                $splitCount = $min;
            }

            $wrap = isset($conf['wrap.'])
                ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                : $conf['wrap'];
            $cObjNum = isset($conf['cObjNum.'])
                ? $this->stdWrap($conf['cObjNum'], $conf['cObjNum.'])
                : $conf['cObjNum'];
            if ($wrap || $cObjNum) {
                $splitArr = array();
                $splitArr['wrap'] = $wrap;
                $splitArr['cObjNum'] = $cObjNum;
                $splitArr = $GLOBALS['TSFE']->tmpl->splitConfArray($splitArr, $splitCount);
            }

            $content = '';
            for ($a = 0; $a < $splitCount; $a++) {
                $GLOBALS['TSFE']->register['SPLIT_COUNT'] = $a;
                $value = '' . $valArr[$a];
                $this->data[$this->currentValKey] = $value;
                if ($splitArr[$a]['cObjNum']) {
                    $objName = intval($splitArr[$a]['cObjNum']);
                    $value = isset($conf[$objName . '.'])
                        ? $this->stdWrap($this->cObjGet($conf[$objName . '.'], $objName . '.'), $conf[$objName . '.'])
                        : $this->cObjGet($conf[$objName . '.'], $objName . '.');
                }
                $wrap = isset($splitArr[$a]['wrap.'])
                    ? $this->stdWrap($splitArr[$a]['wrap'], $splitArr[$a]['wrap.'])
                    : $splitArr[$a]['wrap'];
                if ($wrap) {
                    $value = $this->wrap($value, $wrap);
                }
                $content .= $value;
            }
        }
        return $content;
    }

    /**
     * Implements the stdWrap property "numberFormat"
     * This is a Wrapper function for php's number_format()
     *
     * @param   float   Value to process
     * @param   array   TypoScript Configuration for numberFormat
     * @return  string  The formated number
     */
    function numberFormat($content, $conf) {
        $decimals = isset($conf['decimals.'])
            ? $this->stdWrap($conf['decimals'], $conf['decimals.'])
            : $conf['decimals'];
        $dec_point = isset($conf['dec_point.'])
            ? $this->stdWrap($conf['dec_point'], $conf['dec_point.'])
            : $conf['dec_point'];
        $thousands_sep = isset($conf['thousands_sep.'])
            ? $this->stdWrap($conf['thousands_sep'], $conf['thousands_sep.'])
            : $conf['thousands_sep'];
        return number_format($content, $decimals, $dec_point, $thousands_sep);
    }

    /**
     * Implements the stdWrap property, "parseFunc".
     * This is a function with a lot of interesting uses. In classic TypoScript this is used to process text
     * from the bodytext field; This included highlighting of search words, changing http:// and mailto: prefixed strings into links,
     * parsing <typolist>, <typohead> and <typocode> tags etc.
     * It is still a very important function for processing of bodytext which is normally stored in the database
     * in a format which is not fully ready to be outputted.
     * This situation has not become better by having a RTE around...
     *
     * This function is actually just splitting the input content according to the configuration of "external blocks".
     * This means that before the input string is actually "parsed" it will be splitted into the parts configured to BE parsed
     * (while other parts/blocks should NOT be parsed).
     * Therefore the actual processing of the parseFunc properties goes on in ->_parseFunc()
     *
     * @param   string      The value to process.
     * @param   array       TypoScript configuration for parseFunc
     * @param   string      Reference to get configuration from. Eg. "< lib.parseFunc" which means that the configuration of the object path "lib.parseFunc" will be retrieved and MERGED with what is in $conf!
     * @return  string      The processed value
     * @see _parseFunc()
     */
    function parseFunc($theValue, $conf, $ref = '') {

            // Fetch / merge reference, if any
        if ($ref) {
            $temp_conf = array(
                'parseFunc' => $ref, 'parseFunc.' => $conf
            );
            $temp_conf = $this->mergeTSRef($temp_conf, 'parseFunc');
            $conf = $temp_conf['parseFunc.'];
        }

            // Process:
        if (strcmp($conf['externalBlocks'], '')) {
            $tags = strtolower(implode(',', t3lib_div::trimExplode(',', $conf['externalBlocks'])));
            $htmlParser = t3lib_div::makeInstance('t3lib_parsehtml');
            $parts = $htmlParser->splitIntoBlock($tags, $theValue);

            foreach ($parts as $k => $v) {
                if ($k % 2) { // font:
                    $tagName = strtolower($htmlParser->getFirstTagName($v));
                    $cfg = $conf['externalBlocks.'][$tagName . '.'];
                    if ($cfg['stripNLprev'] || $cfg['stripNL']) {
                        $parts[$k - 1] = preg_replace('/' . CR . '?' . LF . '[ ]*$/', '', $parts[$k - 1]);
                    }
                    if ($cfg['stripNLnext'] || $cfg['stripNL']) {
                        $parts[$k + 1] = preg_replace('/^[ ]*' . CR . '?' . LF . '/', '', $parts[$k + 1]);
                    }
                }
            }

            foreach ($parts as $k => $v) {
                if ($k % 2) {
                    $tag = $htmlParser->getFirstTag($v);
                    $tagName = strtolower($htmlParser->getFirstTagName($v));
                    $cfg = $conf['externalBlocks.'][$tagName . '.'];
                    if ($cfg['callRecursive']) {
                        $parts[$k] = $this->parseFunc($htmlParser->removeFirstAndLastTag($v), $conf);
                        if (!$cfg['callRecursive.']['dontWrapSelf']) {
                            if ($cfg['callRecursive.']['alternativeWrap']) {
                                $parts[$k] = $this->wrap($parts[$k], $cfg['callRecursive.']['alternativeWrap']);
                            } else {
                                if (is_array($cfg['callRecursive.']['tagStdWrap.'])) {
                                    $tag = $this->stdWrap($tag, $cfg['callRecursive.']['tagStdWrap.']);
                                }
                                $parts[$k] = $tag . $parts[$k] . '</' . $tagName . '>';
                            }
                        }
                    } elseif ($cfg['HTMLtableCells']) {
                        $rowParts = $htmlParser->splitIntoBlock('tr', $parts[$k]);
                        foreach ($rowParts as $kk => $vv) {
                            if ($kk % 2) {
                                $colParts = $htmlParser->splitIntoBlock('td,th', $vv);
                                $cc = 0;
                                foreach ($colParts as $kkk => $vvv) {
                                    if ($kkk % 2) {
                                        $cc++;
                                        $tag = $htmlParser->getFirstTag($vvv);
                                        $tagName = strtolower($htmlParser->getFirstTagName($vvv));
                                        $colParts[$kkk] = $htmlParser->removeFirstAndLastTag($vvv);

                                        if ($cfg['HTMLtableCells.'][$cc . '.']['callRecursive'] || (!isset($cfg['HTMLtableCells.'][$cc . '.']['callRecursive']) && $cfg['HTMLtableCells.']['default.']['callRecursive'])) {
                                            if ($cfg['HTMLtableCells.']['addChr10BetweenParagraphs'])
                                                $colParts[$kkk] = str_replace('</p><p>', '</p>' . LF . '<p>', $colParts[$kkk]);
                                            $colParts[$kkk] = $this->parseFunc($colParts[$kkk], $conf);
                                        }

                                        $tagStdWrap = is_array($cfg['HTMLtableCells.'][$cc . '.']['tagStdWrap.']) ? $cfg['HTMLtableCells.'][$cc . '.']['tagStdWrap.'] : $cfg['HTMLtableCells.']['default.']['tagStdWrap.'];
                                        if (is_array($tagStdWrap)) {
                                            $tag = $this->stdWrap($tag, $tagStdWrap);
                                        }

                                        $stdWrap = is_array($cfg['HTMLtableCells.'][$cc . '.']['stdWrap.']) ? $cfg['HTMLtableCells.'][$cc . '.']['stdWrap.'] : $cfg['HTMLtableCells.']['default.']['stdWrap.'];
                                        if (is_array($stdWrap)) {
                                            $colParts[$kkk] = $this->stdWrap($colParts[$kkk], $stdWrap);
                                        }

                                        $colParts[$kkk] = $tag . $colParts[$kkk] . '</' . $tagName . '>';
                                    }
                                }
                                $rowParts[$kk] = implode('', $colParts);
                            }
                        }
                        $parts[$k] = implode('', $rowParts);
                    }

                    if (is_array($cfg['stdWrap.'])) {
                        $parts[$k] = $this->stdWrap($parts[$k], $cfg['stdWrap.']);
                    }
                } else {
                    $parts[$k] = $this->_parseFunc($parts[$k], $conf);
                }
            }

            return implode('', $parts);
        } else
            return $this->_parseFunc($theValue, $conf);
    }

    /**
     * Helper function for parseFunc()
     *
     * @param   string      The value to process.
     * @param   array       TypoScript configuration for parseFunc
     * @return  string      The processed value
     * @access private
     * @see parseFunc()
     */
    function _parseFunc($theValue, $conf) {
        if (!$this->checkIf($conf['if.'])) {
            return $theValue;
        }
        $inside = 0; // Indicates that the data is from within a tag.
        $pointer = 0; // Pointer to the total string position
        $currentTag = ''; // Loaded with the current typo-tag if any.
        $stripNL = 0;
        $contentAccum = array();
        $contentAccumP = 0;

        $allowTags = strtolower(str_replace(' ', '', $conf['allowTags']));
        $denyTags = strtolower(str_replace(' ', '', $conf['denyTags']));

        $totalLen = strlen($theValue);
        do {
            if (!$inside) {
                if (!is_array($currentTag)) {
                        // These operations should only be performed on code outside the typotags...
                        // data: this checks that we enter tags ONLY if the first char in the tag is alphanumeric OR '/'
                    $len_p = 0;
                    $c = 100;
                    do {
                        $len = strcspn(substr($theValue, $pointer + $len_p), '<');
                        $len_p += $len + 1;
                        $endChar = ord(strtolower(substr($theValue, $pointer + $len_p, 1)));
                        $c--;
                    } while ($c > 0 && $endChar && ($endChar < 97 || $endChar > 122) && $endChar != 47);
                    $len = $len_p - 1;
                } else {
                    // If we're inside a currentTag, just take it to the end of that tag!
                    $tempContent = strtolower(substr($theValue, $pointer));
                    $len = strpos($tempContent, '</' . $currentTag[0]);
                    if (is_string($len) && !$len) {
                        $len = strlen($tempContent);
                    }
                }

                $data = substr($theValue, $pointer, $len); // $data is the content until the next <tag-start or end is detected. In case of a currentTag set, this would mean all data between the start- and end-tags
                if ($data != '') {
                    if ($stripNL) {
                            // If the previous tag was set to strip NewLines in the beginning of the next data-chunk.
                        $data = preg_replace('/^[ ]*' . CR . '?' . LF . '/', '', $data);
                    }

                    if (!is_array($currentTag)) { // These operations should only be performed on code outside the tags...
                            // Constants
                        $tmpConstants = $GLOBALS['TSFE']->tmpl->setup['constants.'];
                        if ($conf['constants'] && is_array($tmpConstants)) {
                            foreach ($tmpConstants as $key => $val) {
                                if (is_string($val)) {
                                    $data = str_replace('###' . $key . '###', $val, $data);
                                }
                            }
                        }
                            // Short
                        if (is_array($conf['short.'])) {
                            $shortWords = $conf['short.'];
                            krsort($shortWords);
                            foreach ($shortWords as $key => $val) {
                                if (is_string($val)) {
                                    $data = str_replace($key, $val, $data);
                                }
                            }
                        }

                            // stdWrap
                        if (is_array($conf['plainTextStdWrap.'])) {
                            $data = $this->stdWrap($data, $conf['plainTextStdWrap.']);
                        }
                            // userFunc
                        if ($conf['userFunc']) {
                            $data = $this->callUserFunction($conf['userFunc'], $conf['userFunc.'], $data);
                        }

                            // Makelinks: (Before search-words as we need the links to be generated when searchwords go on...!)
                        if ($conf['makelinks']) {
                            $data = $this->http_makelinks($data, $conf['makelinks.']['http.']);
                            $data = $this->mailto_makelinks($data, $conf['makelinks.']['mailto.']);
                        }

                            // Search Words:
                        if ($GLOBALS['TSFE']->no_cache && $conf['sword'] && is_array($GLOBALS['TSFE']->sWordList) && $GLOBALS['TSFE']->sWordRegEx) {
                            $newstring = '';
                            do {
                                $pregSplitMode = 'i';
                                if (isset($GLOBALS['TSFE']->config['config']['sword_noMixedCase']) && !empty($GLOBALS['TSFE']->config['config']['sword_noMixedCase'])) {
                                    $pregSplitMode = '';
                                }
                                $pieces = preg_split('/' . $GLOBALS['TSFE']->sWordRegEx . '/' . $pregSplitMode, $data, 2);
                                $newstring .= $pieces[0];
                                $match_len = strlen($data) - (strlen($pieces[0]) + strlen($pieces[1]));
                                if (strstr($pieces[0], '<') || strstr($pieces[0], '>')) {
                                    $inTag = strrpos($pieces[0], '<') > strrpos($pieces[0], '>'); // Returns TRUE, if a '<' is closer to the string-end than '>'. This is the case if we're INSIDE a tag (that could have been made by makelinks...) and we must secure, that the inside of a tag is not marked up.
                                }
                                    // The searchword:
                                $match = substr($data, strlen($pieces[0]), $match_len);

                                if (trim($match) && strlen($match) > 1 && !$inTag) {
                                    $match = $this->wrap($match, $conf['sword']);
                                }
                                    // Concatenate the Search Word again.
                                $newstring .= $match;
                                $data = $pieces[1];
                            } while ($pieces[1]);
                            $data = $newstring;
                        }
                    }
                    $contentAccum[$contentAccumP] .= $data;
                }
                $inside = 1;
            } else {
                    // tags
                $len = strcspn(substr($theValue, $pointer), '>') + 1;
                $data = substr($theValue, $pointer, $len);

                $tag = explode(' ', trim(substr($data, 1, -1)), 2);
                $tag[0] = strtolower($tag[0]);
                if (substr($tag[0], 0, 1) == '/') {
                    $tag[0] = substr($tag[0], 1);
                    $tag['out'] = 1;
                }
                if ($conf['tags.'][$tag[0]]) {
                    $treated = 0;
                    $stripNL = 0;
                        // in-tag
                    if (!$currentTag && !$tag['out']) {
                        $currentTag = $tag; // $currentTag (array!) is the tag we are currently processing
                        $contentAccumP++;
                        $treated = 1;
                            // in-out-tag: img and other empty tags
                        if (preg_match('/^(area|base|br|col|hr|img|input|meta|param)$/i', $tag[0])) {
                            $tag['out'] = 1;
                        }
                    }
                        // out-tag
                    if ($currentTag[0] == $tag[0] && $tag['out']) {
                        $theName = $conf['tags.'][$tag[0]];
                        $theConf = $conf['tags.'][$tag[0] . '.'];
                        $stripNL = ($theConf['stripNL'] ? 1 : 0); // This flag indicates, that NL- (13-10-chars) should be stripped first and last.
                        $breakOut = ($theConf['breakoutTypoTagContent'] ? 1 : 0); // This flag indicates, that this TypoTag section should NOT be included in the nonTypoTag content.


                        $this->parameters = array();
                        if ($currentTag[1]) {
                            $params = t3lib_div::get_tag_attributes($currentTag[1]);
                            if (is_array($params)) {
                                foreach ($params as $option => $val) {
                                    $this->parameters[strtolower($option)] = $val;
                                }
                            }
                        }
                        $this->parameters['allParams'] = trim($currentTag[1]);
                        if ($stripNL) { // Removes NL in the beginning and end of the tag-content AND at the end of the currentTagBuffer. $stripNL depends on the configuration of the current tag
                            $contentAccum[$contentAccumP - 1] = preg_replace('/' . CR . '?' . LF . '[ ]*$/', '', $contentAccum[$contentAccumP - 1]);
                            $contentAccum[$contentAccumP] = preg_replace('/^[ ]*' . CR . '?' . LF . '/', '', $contentAccum[$contentAccumP]);
                            $contentAccum[$contentAccumP] = preg_replace('/' . CR . '?' . LF . '[ ]*$/', '', $contentAccum[$contentAccumP]);
                        }
                        $this->data[$this->currentValKey] = $contentAccum[$contentAccumP];
                        $newInput = $this->cObjGetSingle($theName, $theConf, '/parseFunc/.tags.' . $tag[0]); // fetch the content object


                        $contentAccum[$contentAccumP] = $newInput;
                        $contentAccumP++;

                            // If the TypoTag section
                        if (!$breakOut) {
                            $contentAccum[$contentAccumP - 2] .= $contentAccum[$contentAccumP - 1] . $contentAccum[$contentAccumP];
                            unset($contentAccum[$contentAccumP]);
                            unset($contentAccum[$contentAccumP - 1]);
                            $contentAccumP -= 2;
                        }

                        unset($currentTag);
                        $treated = 1;
                    }
                        // other tags...
                    if (!$treated) {
                        $contentAccum[$contentAccumP] .= $data;
                    }
                } else {
                        // If a tag was not a typo tag, then it is just added to the content
                    $stripNL = 0;
                    if (t3lib_div::inList($allowTags, $tag[0]) || ($denyTags != '*' && !t3lib_div::inList($denyTags, $tag[0]))) {
                        $contentAccum[$contentAccumP] .= $data;
                    } else {
                        $contentAccum[$contentAccumP] .= HTMLSpecialChars($data);
                    }
                }
                $inside = 0;
            }
            $pointer += $len;
        } while ($pointer < $totalLen);

            // Parsing nonTypoTag content (all even keys):
        reset($contentAccum);
        for ($a = 0; $a < count($contentAccum); $a++) {
            if ($a % 2 != 1) {
                    // stdWrap
                if (is_array($conf['nonTypoTagStdWrap.'])) {
                    $contentAccum[$a] = $this->stdWrap($contentAccum[$a], $conf['nonTypoTagStdWrap.']);
                }
                    // userFunc
                if ($conf['nonTypoTagUserFunc']) {
                    $contentAccum[$a] = $this->callUserFunction(
                        $conf['nonTypoTagUserFunc'],
                        $conf['nonTypoTagUserFunc.'],
                        $contentAccum[$a]
                    );
                }
            }
        }
        return implode('', $contentAccum);
    }

    /**
     * Lets you split the content by LF and proces each line independently. Used to format content made with the RTE.
     *
     * @param   string      The input value
     * @param   array       TypoScript options
     * @return  string      The processed input value being returned; Splitted lines imploded by LF again.
     * @access private
     */
    function encaps_lineSplit($theValue, $conf) {
        $lParts = explode(LF, $theValue);

        $encapTags = t3lib_div::trimExplode(',', strtolower($conf['encapsTagList']), 1);
        $nonWrappedTag = $conf['nonWrappedTag'];
        $defaultAlign = isset($conf['defaultAlign.'])
            ? trim($this->stdWrap($conf['defaultAlign'], $conf['defaultAlign.']))
            : trim($conf['defaultAlign']);

        if (!strcmp('', $theValue))
            return '';

        foreach ($lParts as $k => $l) {
            $sameBeginEnd = 0;
            $emptyTag = 0;
            $l = trim($l);
            $attrib = array();
            $nWrapped = 0;
            if (substr($l, 0, 1) == '<' && substr($l, -1) == '>') {
                $fwParts = explode('>', substr($l, 1), 2);
                list($tagName, $tagParams) = explode(' ',$fwParts[0], 2);
                if (!$fwParts[1]) {
                    if (substr($tagName, -1) == '/') {
                        $tagName = substr($tagName, 0, -1);
                    }
                    if (substr($fwParts[0], -1) == '/') {
                        $sameBeginEnd = 1;
                        $emptyTag = 1;
                        $attrib = t3lib_div::get_tag_attributes('<'.substr($fwParts[0], 0, -1).'>');
                    }
                } else {
                    $backParts = t3lib_div::revExplode('<', substr($fwParts[1],0,-1), 2);
                    $attrib = t3lib_div::get_tag_attributes('<'.$fwParts[0].'>');
                    $str_content = $backParts[0];
                    $sameBeginEnd = (substr(strtolower($backParts[1]),1,strlen($tagName))==strtolower($tagName));
                }
            }

            if ($sameBeginEnd && in_array(strtolower($tagName), $encapTags)) {
                $uTagName = strtoupper($tagName);
                $uTagName = strtoupper($conf['remapTag.'][$uTagName] ? $conf['remapTag.'][$uTagName] : $uTagName);
            } else {
                $uTagName = strtoupper($nonWrappedTag);
                    // The line will be wrapped: $uTagName should not be an empty tag
                $emptyTag = 0;
                $str_content = $lParts[$k];
                $nWrapped = 1;
                $attrib = array();
            }

                // Wrapping all inner-content:
            if (is_array($conf['innerStdWrap_all.'])) {
                $str_content = $this->stdWrap($str_content, $conf['innerStdWrap_all.']);
            }

            if ($uTagName) {
                    // Setting common attributes
                if (is_array($conf['addAttributes.'][$uTagName . '.'])) {
                    foreach ($conf['addAttributes.'][$uTagName . '.'] as $kk => $vv) {
                        if (!is_array($vv)) {
                            if ((string) $conf['addAttributes.'][$uTagName . '.'][$kk . '.']['setOnly'] == 'blank') {
                                if (!strcmp($attrib[$kk], ''))
                                    $attrib[$kk] = $vv;
                            } elseif ((string) $conf['addAttributes.'][$uTagName . '.'][$kk . '.']['setOnly'] == 'exists') {
                                if (!isset($attrib[$kk]))
                                    $attrib[$kk] = $vv;
                            } else {
                                $attrib[$kk] = $vv;
                            }
                        }
                    }
                }
                    // Wrapping all inner-content:
                if (is_array($conf['encapsLinesStdWrap.'][$uTagName . '.'])) {
                    $str_content = $this->stdWrap($str_content, $conf['encapsLinesStdWrap.'][$uTagName . '.']);
                }
                    // Default align
                if (!$attrib['align'] && $defaultAlign)
                    $attrib['align'] = $defaultAlign;

                $params = t3lib_div::implodeAttributes($attrib, 1);
                if ($conf['removeWrapping'] && !($emptyTag && $conf['removeWrapping.']['keepSingleTag'])) {
                    $str_content = $str_content;
                } else {
                    if ($emptyTag) {
                        $str_content='<'.strtolower($uTagName).(trim($params)?' '.trim($params):'').' />';
                    } else {
                        $str_content='<'.strtolower($uTagName).(trim($params)?' '.trim($params):'').'>'.$str_content.'</'.strtolower($uTagName).'>';
                    }
                }
            }

            if ($nWrapped && $conf['wrapNonWrappedLines']) {
                $str_content = $this->wrap($str_content, $conf['wrapNonWrappedLines']);
            }
            $lParts[$k] = $str_content;
        }

        return implode(LF, $lParts);
    }

    /**
     * Finds URLS in text and makes it to a real link.
     * Will find all strings prefixed with "http://" in the $data string and make them into a link, linking to the URL we should have found.
     *
     * @param   string      The string in which to search for "http://"
     * @param   array       Configuration for makeLinks, see link
     * @return  string      The processed input string, being returned.
     * @see _parseFunc()
     */
    function http_makelinks($data, $conf) {
        $aTagParams = $this->getATagParams($conf);
        $textpieces = explode('http://', $data);
        $pieces = count($textpieces);
        $textstr = $textpieces[0];
        $initP = '?id=' . $GLOBALS['TSFE']->id . '&type=' . $GLOBALS['TSFE']->type;
        for ($i = 1; $i < $pieces; $i++) {
            $len = strcspn($textpieces[$i], chr(32) . TAB . CRLF);
            if (trim(substr($textstr, -1)) == '' && $len) {

                $lastChar = substr($textpieces[$i], $len - 1, 1);
                if (!preg_match('/[A-Za-z0-9\/#_-]/', $lastChar)) {
                    $len--;
                } // Included '\/' 3/12


                $parts[0] = substr($textpieces[$i], 0, $len);
                $parts[1] = substr($textpieces[$i], $len);

                $keep = $conf['keep'];
                $linkParts = parse_url('http://' . $parts[0]);
                $linktxt = '';
                if (strstr($keep, 'scheme')) {
                    $linktxt = 'http://';
                }
                $linktxt .= $linkParts['host'];
                if (strstr($keep, 'path')) {
                    $linktxt .= $linkParts['path'];
                    if (strstr($keep, 'query') && $linkParts['query']) { // added $linkParts['query'] 3/12
                        $linktxt .= '?' . $linkParts['query'];
                    } elseif ($linkParts['path'] == '/') { // If query is NOT added and the path is '/' then remove the slash ('/')   (added 3/12)
                        $linktxt = substr($linktxt, 0, -1);
                    }
                }
                $target = isset($conf['extTarget']) ? $conf['extTarget'] : $GLOBALS['TSFE']->extTarget;
                if ($GLOBALS['TSFE']->config['config']['jumpurl_enable']) {
                    $res = '<a' . ' href="' . htmlspecialchars($GLOBALS['TSFE']->absRefPrefix .
                        $GLOBALS['TSFE']->config['mainScript'] . $initP .
                        '&jumpurl=' . rawurlencode('http://' . $parts[0]) . $GLOBALS['TSFE']->getMethodUrlIdToken) . '"' .
                        ($target ? ' target="' . $target . '"' : '') .
                        $aTagParams . $this->extLinkATagParams('http://' . $parts[0], 'url') .
                        '>';
                } else {
                    $res = '<a' . ' href="http://' . htmlspecialchars($parts[0]) . '"' .
                        ($target ? ' target="' . $target . '"' : '') .
                        $aTagParams . $this->extLinkATagParams('http://' . $parts[0], 'url') .
                        '>';
                }
                $wrap = isset($conf['wrap.'])
                    ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                    : $conf['wrap'];
                if ($conf['ATagBeforeWrap']) {
                    $res = $res . $this->wrap($linktxt, $wrap) . '</a>';
                } else {
                    $res = $this->wrap($res . $linktxt . '</a>', $wrap);
                }
                $textstr .= $res . $parts[1];
            } else {
                $textstr .= 'http://' . $textpieces[$i];
            }
        }
        return $textstr;
    }

    /**
     * Will find all strings prefixed with "mailto:" in the $data string and make them into a link,
     * linking to the email address they point to.
     *
     * @param   string      The string in which to search for "mailto:"
     * @param   array       Configuration for makeLinks, see link
     * @return  string      The processed input string, being returned.
     * @see _parseFunc()
     */
    function mailto_makelinks($data, $conf) {
            // http-split
        $aTagParams = $this->getATagParams($conf);
        $textpieces = explode('mailto:', $data);
        $pieces = count($textpieces);
        $textstr = $textpieces[0];
        $initP = '?id=' . $GLOBALS['TSFE']->id . '&type=' . $GLOBALS['TSFE']->type;
        for ($i = 1; $i < $pieces; $i++) {
            $len = strcspn($textpieces[$i], chr(32) . TAB . CRLF);
            if (trim(substr($textstr, -1)) == '' && $len) {
                $lastChar = substr($textpieces[$i], $len - 1, 1);
                if (!preg_match('/[A-Za-z0-9]/', $lastChar)) {
                    $len--;
                }

                $parts[0] = substr($textpieces[$i], 0, $len);
                $parts[1] = substr($textpieces[$i], $len);
                $linktxt = preg_replace('/\?.*/', '', $parts[0]);
                list ($mailToUrl, $linktxt) = $this->getMailTo($parts[0], $linktxt, $initP);
                $mailToUrl = $GLOBALS['TSFE']->spamProtectEmailAddresses === 'ascii' ? $mailToUrl : htmlspecialchars($mailToUrl);
                $res = '<a href="' . $mailToUrl . '"' . $aTagParams . '>';
                $wrap = isset($conf['wrap.'])
                    ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                    : $conf['wrap'];
                if ($conf['ATagBeforeWrap']) {
                    $res = $res . $this->wrap($linktxt, $wrap) . '</a>';
                } else {
                    $res = $this->wrap($res . $linktxt . '</a>', $wrap);
                }
                $textstr .= $res . $parts[1];
            } else {
                $textstr .= 'mailto:' . $textpieces[$i];
            }
        }
        return $textstr;
    }

    /**
     * Creates and returns a TypoScript "imgResource".
     * The value ($file) can either be a file reference (TypoScript resource) or the string "GIFBUILDER".
     * In the first case a current image is returned, possibly scaled down or otherwise processed.
     * In the latter case a GIFBUILDER image is returned; This means an image is made by TYPO3 from layers of elements as GIFBUILDER defines.
     * In the function IMG_RESOURCE() this function is called like $this->getImgResource($conf['file'],$conf['file.']);
     *
     * @param   string      A "imgResource" TypoScript data type. Either a TypoScript file resource or the string GIFBUILDER. See description above.
     * @param   array       TypoScript properties for the imgResource type
     * @return  array       Returns info-array. info[origFile] = original file.
     * @see IMG_RESOURCE(), cImage(), tslib_gifBuilder
     */
    function getImgResource($file, $fileArray) {
        if (is_array($fileArray)) {
            switch ($file) {
                case 'GIFBUILDER' :
                    $gifCreator = t3lib_div::makeInstance('tslib_gifbuilder');
                    $gifCreator->init();
                    $theImage = '';
                    if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib']) {
                        $gifCreator->start($fileArray, $this->data);
                        $theImage = $gifCreator->gifBuild();
                    }
                    $imageResource = $gifCreator->getImageDimensions($theImage);
                break;
                default :
                    if ($fileArray['import.']) {
                        $ifile = $this->stdWrap('', $fileArray['import.']);
                        if ($ifile) {
                            $file = $fileArray['import'] . $ifile;
                        }
                    }
                    $theImage = $GLOBALS['TSFE']->tmpl->getFileName($file);
                    if ($theImage) {
                        $fileArray['width'] = isset($fileArray['width.'])
                            ? $this->stdWrap($fileArray['width'], $fileArray['width.'])
                            : $fileArray['width'];
                        $fileArray['height'] = isset($fileArray['height.'])
                            ? $this->stdWrap($fileArray['height'], $fileArray['height.'])
                            : $fileArray['height'];
                        $fileArray['ext'] = isset($fileArray['ext.'])
                            ? $this->stdWrap($fileArray['ext'], $fileArray['ext.'])
                            : $fileArray['ext'];
                        $fileArray['maxW'] = isset($fileArray['maxW.'])
                            ? intval($this->stdWrap($fileArray['maxW'], $fileArray['maxW.']))
                            : intval($fileArray['maxW']);
                        $fileArray['maxH'] = isset($fileArray['maxH.'])
                            ? intval($this->stdWrap($fileArray['maxH'], $fileArray['maxH.']))
                            : intval($fileArray['maxH']);
                        $fileArray['minW'] = isset($fileArray['minW.'])
                            ? intval($this->stdWrap($fileArray['minW'], $fileArray['minW.']))
                            : intval($fileArray['minW']);
                        $fileArray['minH'] = isset($fileArray['minH.'])
                            ? intval($this->stdWrap($fileArray['minH'], $fileArray['minH.']))
                            : intval($fileArray['minH']);
                        $fileArray['noScale'] = isset($fileArray['noScale.'])
                            ? $this->stdWrap($fileArray['noScale'], $fileArray['noScale.'])
                            : $fileArray['noScale'];
                        $maskArray = $fileArray['m.'];
                        $maskImages = array();
                        if (is_array($fileArray['m.'])) { // Must render mask images and include in hash-calculating - else we cannot be sure the filename is unique for the setup!
                            $maskImages['m_mask'] = $this->getImgResource($maskArray['mask'], $maskArray['mask.']);
                            $maskImages['m_bgImg'] = $this->getImgResource($maskArray['bgImg'], $maskArray['bgImg.']);
                            $maskImages['m_bottomImg'] = $this->getImgResource($maskArray['bottomImg'], $maskArray['bottomImg.']);
                            $maskImages['m_bottomImg_mask'] = $this->getImgResource($maskArray['bottomImg_mask'], $maskArray['bottomImg_mask.']);
                        }
                        $hash = t3lib_div::shortMD5($theImage . serialize($fileArray) . serialize($maskImages));
                        if (!isset($GLOBALS['TSFE']->tmpl->fileCache[$hash])) {
                            $gifCreator = t3lib_div::makeInstance('tslib_gifbuilder');
                            $gifCreator->init();

                            if ($GLOBALS['TSFE']->config['config']['meaningfulTempFilePrefix']) {
                                $filename = basename($theImage);
                                    // remove extension
                                $filename = substr($filename, 0, strrpos($filename, '.'));
                                    // strip everything non-ascii
                                $filename = preg_replace('/[^A-Za-z0-9_-]/', '', trim($filename));
                                $gifCreator->filenamePrefix = substr($filename, 0, intval($GLOBALS['TSFE']->config['config']['meaningfulTempFilePrefix'])) . '_';
                                unset($filename);
                            }

                            if ($fileArray['sample']) {
                                $gifCreator->scalecmd = '-sample';
                                $GLOBALS['TT']->setTSlogMessage('Sample option: Images are scaled with -sample.');
                            }
                            if ($fileArray['alternativeTempPath'] && t3lib_div::inList($GLOBALS['TYPO3_CONF_VARS']['FE']['allowedTempPaths'], $fileArray['alternativeTempPath'])) {
                                $gifCreator->tempPath = $fileArray['alternativeTempPath'];
                                $GLOBALS['TT']->setTSlogMessage('Set alternativeTempPath: ' . $fileArray['alternativeTempPath']);
                            }

                            if (!trim($fileArray['ext'])) {
                                $fileArray['ext'] = 'web';
                            }
                            $options = array();
                            if ($fileArray['maxW']) {
                                $options['maxW'] = $fileArray['maxW'];
                            }
                            if ($fileArray['maxH']) {
                                $options['maxH'] = $fileArray['maxH'];
                            }
                            if ($fileArray['minW']) {
                                $options['minW'] = $fileArray['minW'];
                            }
                            if ($fileArray['minH']) {
                                $options['minH'] = $fileArray['minH'];
                            }
                            if ($fileArray['noScale']) {
                                $options['noScale'] = $fileArray['noScale'];
                            }

                                // checks to see if m (the mask array) is defined
                            if (is_array($maskArray) && $GLOBALS['TYPO3_CONF_VARS']['GFX']['im']) {
                                    // Filename:
                                $fI = t3lib_div::split_fileref($theImage);
                                $imgExt = (strtolower($fI['fileext']) == $gifCreator->gifExtension ? $gifCreator->gifExtension : 'jpg');
                                $dest = $gifCreator->tempPath . $hash . '.' . $imgExt;
                                if (!file_exists($dest)) { // Generate!
                                    $m_mask = $maskImages['m_mask'];
                                    $m_bgImg = $maskImages['m_bgImg'];
                                    if ($m_mask && $m_bgImg) {
                                        $negate = $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask'] ? ' -negate' : '';

                                        $temp_ext = 'png';
                                        if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_mask_temp_ext_gif']) { // If ImageMagick version 5+
                                            $temp_ext = $gifCreator->gifExtension;
                                        }

                                        $tempFileInfo = $gifCreator->imageMagickConvert($theImage, $temp_ext, $fileArray['width'], $fileArray['height'], $fileArray['params'], $fileArray['frame'], $options);
                                        if (is_array($tempFileInfo)) {
                                            $m_bottomImg = $maskImages['m_bottomImg'];
                                            if ($m_bottomImg) {
                                                $m_bottomImg_mask = $maskImages['m_bottomImg_mask'];
                                            }
                                                //  Scaling:    ****
                                            $tempScale = array();
                                            $command = '-geometry ' . $tempFileInfo[0] . 'x' . $tempFileInfo[1] . '!';
                                            $command = $this->modifyImageMagickStripProfileParameters($command, $fileArray);
                                            $tmpStr = $gifCreator->randomName();

                                                //  m_mask
                                            $tempScale['m_mask'] = $tmpStr . '_mask.' . $temp_ext;
                                            $gifCreator->imageMagickExec($m_mask[3], $tempScale['m_mask'], $command . $negate);
                                                //  m_bgImg
                                            $tempScale['m_bgImg'] = $tmpStr . '_bgImg.' . trim($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_mask_temp_ext_noloss']);
                                            $gifCreator->imageMagickExec($m_bgImg[3], $tempScale['m_bgImg'], $command);

                                                //  m_bottomImg / m_bottomImg_mask
                                            if ($m_bottomImg && $m_bottomImg_mask) {
                                                $tempScale['m_bottomImg'] = $tmpStr . '_bottomImg.' . $temp_ext;
                                                $gifCreator->imageMagickExec($m_bottomImg[3], $tempScale['m_bottomImg'], $command);
                                                $tempScale['m_bottomImg_mask'] = $tmpStr . '_bottomImg_mask.' . $temp_ext;
                                                $gifCreator->imageMagickExec($m_bottomImg_mask[3], $tempScale['m_bottomImg_mask'], $command . $negate);

                                                    // BEGIN combining:
                                                    // The image onto the background
                                                $gifCreator->combineExec($tempScale['m_bgImg'], $tempScale['m_bottomImg'], $tempScale['m_bottomImg_mask'], $tempScale['m_bgImg']);
                                            }
                                                // The image onto the background
                                            $gifCreator->combineExec($tempScale['m_bgImg'], $tempFileInfo[3], $tempScale['m_mask'], $dest);
                                                // Unlink the temp-images...
                                            foreach ($tempScale as $file) {
                                                if (@is_file($file)) {
                                                    unlink($file);
                                                }
                                            }
                                        }
                                    }
                                }
                                    // Finish off
                                if (($fileArray['reduceColors'] || ($imgExt == 'png' && !$gifCreator->png_truecolor)) && is_file($dest)) {
                                    $reduced = $gifCreator->IMreduceColors($dest, t3lib_div::intInRange($fileArray['reduceColors'], 256, $gifCreator->truecolorColors, 256));
                                    if (is_file($reduced)) {
                                        unlink($dest);
                                        rename($reduced, $dest);
                                    }
                                }
                                $GLOBALS['TSFE']->tmpl->fileCache[$hash] = $gifCreator->getImageDimensions($dest);
                            } else { // Normal situation:
                                $fileArray['params'] = $this->modifyImageMagickStripProfileParameters($fileArray['params'], $fileArray);
                                $GLOBALS['TSFE']->tmpl->fileCache[$hash] = $gifCreator->imageMagickConvert($theImage, $fileArray['ext'], $fileArray['width'], $fileArray['height'], $fileArray['params'], $fileArray['frame'], $options);
                                if (($fileArray['reduceColors'] || ($imgExt == 'png' && !$gifCreator->png_truecolor)) && is_file($GLOBALS['TSFE']->tmpl->fileCache[$hash][3])) {
                                    $reduced = $gifCreator->IMreduceColors($GLOBALS['TSFE']->tmpl->fileCache[$hash][3], t3lib_div::intInRange($fileArray['reduceColors'], 256, $gifCreator->truecolorColors, 256));
                                    if (is_file($reduced)) {
                                        unlink($GLOBALS['TSFE']->tmpl->fileCache[$hash][3]);
                                        rename($reduced, $GLOBALS['TSFE']->tmpl->fileCache[$hash][3]);
                                    }
                                }
                            }
                            $GLOBALS['TSFE']->tmpl->fileCache[$hash]['origFile'] = $theImage;
                            $GLOBALS['TSFE']->tmpl->fileCache[$hash]['origFile_mtime'] = @filemtime($theImage); // This is needed by tslib_gifbuilder, ln 100ff in order for the setup-array to create a unique filename hash.
                            $GLOBALS['TSFE']->tmpl->fileCache[$hash]['fileCacheHash'] = $hash;
                        }
                        $imageResource = $GLOBALS['TSFE']->tmpl->fileCache[$hash];
                    }

                break;
            }
        }
        $theImage = $GLOBALS['TSFE']->tmpl->getFileName($file);
            // If image was processed by GIFBUILDER:
            // ($imageResource indicates that it was processed the regular way)
        if (!isset($imageResource) && $theImage) {
            $gifCreator = t3lib_div::makeInstance('tslib_gifbuilder');
            /* @var $gifCreator tslib_gifbuilder */
            $gifCreator->init();
            $info = $gifCreator->imageMagickConvert($theImage, 'WEB', '', '', '', '', '');
            $info['origFile'] = $theImage;
            $info['origFile_mtime'] = @filemtime($theImage); // This is needed by tslib_gifbuilder, ln 100ff in order for the setup-array to create a unique filename hash.
            $imageResource = $info;
        }

            // Hook 'getImgResource': Post-processing of image resources
        if (isset($imageResource)) {
            foreach ($this->getGetImgResourceHookObjects() as $hookObject) {
                $imageResource = $hookObject->getImgResourcePostProcess($file, (array) $fileArray, $imageResource, $this);
            }
        }

        return $imageResource;
    }

    /**
     * Modifies the parameters for ImageMagick for stripping of profile information.
     *
     * @param   string      $parameters: The parameters to be modified (if required)
     * @param   array       $configuration: The TypoScript configuration of [IMAGE].file
     * @param   string      The modified parameters
     */
    protected function modifyImageMagickStripProfileParameters($parameters, array $configuration) {
            // Strips profile information of image to save some space:
        if (isset($configuration['stripProfile'])) {
            if ($configuration['stripProfile']) {
                $parameters = $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_stripProfileCommand'] . $parameters;
            } else {
                $parameters .= '###SkipStripProfile###';
            }
        }
        return $parameters;
    }



    /***********************************************
     *
     * Data retrieval etc.
     *
     ***********************************************/


    /**
     * Returns the value for the field from $this->data. If "//" is found in the $field value that token will split the field values apart and the first field having a non-blank value will be returned.
     *
     * @param   string      The fieldname, eg. "title" or "navtitle // title" (in the latter case the value of $this->data[navtitle] is returned if not blank, otherwise $this->data[title] will be)
     * @return  string
     */
    function getFieldVal($field) {
        if (!strstr($field, '//')) {
            return $this->data[trim($field)];
        } else {
            $sections = t3lib_div::trimExplode('//', $field, 1);
            foreach ($sections as $k) {
                if (strcmp($this->data[$k], ''))
                    return $this->data[$k];
            }
        }
    }

    /**
     * Implements the TypoScript data type "getText". This takes a string with parameters and based on those a value from somewhere in the system is returned.
     *
     * @param   string      The parameter string, eg. "field : title" or "field : navtitle // field : title" (in the latter case and example of how the value is FIRST splitted by "//" is shown)
     * @param   mixed       Alternative field array; If you set this to an array this variable will be used to look up values for the "field" key. Otherwise the current page record in $GLOBALS['TSFE']->page is used.
     * @return  string      The value fetched
     * @see getFieldVal()
     */
    function getData($string, $fieldArray) {
        global $TYPO3_CONF_VARS;

        if (!is_array($fieldArray)) {
            $fieldArray = $GLOBALS['TSFE']->page;
        }
        $retVal = '';
        $sections = explode('//', $string);

        while (!$retVal and list ($secKey, $secVal) = each($sections)) {
            $parts = explode(':', $secVal, 2);
            $key = trim($parts[1]);
            if ((string) $key != '') {
                $type = strtolower(trim($parts[0]));
                switch ($type) {
                    case 'gpvar' :
                        t3lib_div::deprecationLog('Using gpvar in TypoScript getText is deprecated since TYPO3 4.3 - Use gp instead of gpvar.');
                        // Fall Through
                    case 'gp' :
                            // Merge GET and POST and get $key out of the merged array
                        $retVal = $this->getGlobal($key, t3lib_div::array_merge_recursive_overrule(t3lib_div::_GET(), t3lib_div::_POST()));
                    break;
                    case 'tsfe' :
                        $retVal = $this->getGlobal('TSFE|' . $key);
                    break;
                    case 'getenv' :
                        $retVal = getenv($key);
                    break;
                    case 'getindpenv' :
                        $retVal = t3lib_div::getIndpEnv($key);
                    break;
                    case 'field' :
                        $retVal = $fieldArray[$key];
                    break;
                    case 'parameters' :
                        $retVal = $this->parameters[$key];
                    break;
                    case 'register' :
                        $retVal = $GLOBALS['TSFE']->register[$key];
                    break;
                    case 'global' :
                        $retVal = $this->getGlobal($key);
                    break;
                    case 'leveltitle' :
                        $nkey = $this->getKey($key, $GLOBALS['TSFE']->tmpl->rootLine);
                        $retVal = $this->rootLineValue($nkey, 'title', stristr($key, 'slide'));
                    break;
                    case 'levelmedia' :
                        $nkey = $this->getKey($key, $GLOBALS['TSFE']->tmpl->rootLine);
                        $retVal = $this->rootLineValue($nkey, 'media', stristr($key, 'slide'));
                    break;
                    case 'leveluid' :
                        $nkey = $this->getKey($key, $GLOBALS['TSFE']->tmpl->rootLine);
                        $retVal = $this->rootLineValue($nkey, 'uid', stristr($key, 'slide'));
                    break;
                    case 'levelfield' :
                        $keyP = t3lib_div::trimExplode(',', $key);
                        $nkey = $this->getKey($keyP[0], $GLOBALS['TSFE']->tmpl->rootLine);
                        $retVal = $this->rootLineValue($nkey, $keyP[1], strtolower($keyP[2]) == 'slide');
                    break;
                    case 'fullrootline' :
                        $keyP = t3lib_div::trimExplode(',', $key);
                        $fullKey = intval($keyP[0]) - count($GLOBALS['TSFE']->tmpl->rootLine) + count($GLOBALS['TSFE']->rootLine);
                        if ($fullKey >= 0) {
                            $retVal = $this->rootLineValue($fullKey, $keyP[1], stristr($keyP[2], 'slide'), $GLOBALS['TSFE']->rootLine);
                        }
                    break;
                    case 'date' :
                        if (!$key) {
                            $key = 'd/m Y';
                        }
                        $retVal = date($key, $GLOBALS['EXEC_TIME']);
                    break;
                    case 'page' :
                        $retVal = $GLOBALS['TSFE']->page[$key];
                    break;
                    case 'current' :
                        $retVal = $this->data[$this->currentValKey];
                    break;
                    case 'level' :
                        $retVal = count($GLOBALS['TSFE']->tmpl->rootLine) - 1;
                    break;
                    case 'db' :
                        $selectParts = t3lib_div::trimExplode(':', $key);
                        $db_rec = $GLOBALS['TSFE']->sys_page->getRawRecord($selectParts[0], $selectParts[1]);
                        if (is_array($db_rec) && $selectParts[2]) {
                            $retVal = $db_rec[$selectParts[2]];
                        }
                    break;
                    case 'lll' :
                        $retVal = $GLOBALS['TSFE']->sL('LLL:' . $key);
                    break;
                    case 'path' :
                        $retVal = $GLOBALS['TSFE']->tmpl->getFileName($key);
                    break;
                    case 'cobj' :
                        switch ((string) $key) {
                            case 'parentRecordNumber' :
                                $retVal = $this->parentRecordNumber;
                            break;
                        }
                    break;
                    case 'debug' :
                        switch ((string) $key) {
                            case 'rootLine' :
                                $retVal = t3lib_utility_Debug::viewArray($GLOBALS['TSFE']->tmpl->rootLine);
                            break;
                            case 'fullRootLine' :
                                $retVal = t3lib_utility_Debug::viewArray($GLOBALS['TSFE']->rootLine);
                            break;
                            case 'data' :
                                $retVal = t3lib_utility_Debug::viewArray($this->data);
                            break;
                        }
                    break;
                }
            }

            if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['getData'])) {
                foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_content.php']['getData'] as $classData) {
                    $hookObject = t3lib_div::getUserObj($classData);

                    if (!($hookObject instanceof tslib_content_getDataHook)) {
                        throw new UnexpectedValueException('$hookObject must implement interface tslib_content_getDataHook', 1195044480);
                    }

                    $retVal = $hookObject->getDataExtension($string, $fieldArray, $secVal, $retVal, $this);
                }
            }
        }

        return $retVal;
    }

    /**
     * Returns a value from the current rootline (site) from $GLOBALS['TSFE']->tmpl->rootLine;
     *
     * @param   string      Which level in the root line
     * @param   string      The field in the rootline record to return (a field from the pages table)
     * @param   boolean     If set, then we will traverse through the rootline from outer level towards the root level until the value found is TRUE
     * @param   mixed       If you supply an array for this it will be used as an alternative root line array
     * @return  string      The value from the field of the rootline.
     * @access private
     * @see getData()
     */
    function rootLineValue($key, $field, $slideBack = 0, $altRootLine = '') {
        $rootLine = is_array($altRootLine) ? $altRootLine : $GLOBALS['TSFE']->tmpl->rootLine;
        if (!$slideBack) {
            return $rootLine[$key][$field];
        } else {
            for ($a = $key; $a >= 0; $a--) {
                $val = $rootLine[$a][$field];
                if ($val) {
                    return $val;
                }
            }
        }
    }

    /**
     * Return global variable where the input string $var defines array keys separated by "|"
     * Example: $var = "HTTP_SERVER_VARS | something" will return the value $GLOBALS['HTTP_SERVER_VARS']['something'] value
     *
     * @param   string      Global var key, eg. "HTTP_GET_VAR" or "HTTP_GET_VARS|id" to get the GET parameter "id" back.
     * @param   array       Alternative array than $GLOBAL to get variables from.
     * @return  mixed       Whatever value. If none, then blank string.
     * @see getData()
     */
    function getGlobal($keyString, $source = NULL) {
        $keys = explode('|', $keyString);
        $numberOfLevels = count($keys);
        $rootKey = trim($keys[0]);
        $value = isset($source) ? $source[$rootKey] : $GLOBALS[$rootKey];

        for ($i = 1; $i < $numberOfLevels && isset($value); $i++) {
            $currentKey = trim($keys[$i]);
            if (is_object($value)) {
                $value = $value->$currentKey;
            } elseif (is_array($value)) {
                $value = $value[$currentKey];
            } else {
                $value = '';
                break;
            }
        }

        if (!is_scalar($value)) {
            $value = '';
        }
        return $value;
    }

    /**
     * Processing of key values pointing to entries in $arr; Here negative values are converted to positive keys pointer to an entry in the array but from behind (based on the negative value).
     * Example: entrylevel = -1 means that entryLevel ends up pointing at the outermost-level, -2 means the level before the outermost...
     *
     * @param   integer     The integer to transform
     * @param   array       array in which the key should be found.
     * @return  integer     The processed integer key value.
     * @access private
     * @see getData()
     */
    function getKey($key, $arr) {
        $key = intval($key);
        if (is_array($arr)) {
            if ($key < 0) {
                $key = count($arr) + $key;
            }
            if ($key < 0) {
                $key = 0;
            }
        }
        return $key;
    }


    /**
     * Looks up the incoming value in the defined TCA configuration
     * Works only with TCA-type 'select' and options defined in 'items'
     *
     * @param   mixed       Comma-separated list of values to look up
     * @param   array       TS-configuration array, see TSref for details
     * @return  string      String of translated values, seperated by $delimiter. If no matches were found, the input value is simply returned.
     * @todo    It would be nice it this function basically looked up any type of value, db-relations etc.
     */
    function TCAlookup($inputValue, $conf) {
        global $TCA;

        $table = $conf['table'];
        $field = $conf['field'];
        $delimiter = $conf['delimiter'] ? $conf['delimiter'] : ' ,';

        $GLOBALS['TSFE']->includeTCA();
        t3lib_div::loadTCA($table);

        if (is_array($TCA[$table]) && is_array($TCA[$table]['columns'][$field]) && is_array($TCA[$table]['columns'][$field]['config']['items'])) {
            $values = t3lib_div::trimExplode(',', $inputValue);
            $output = array();
            foreach ($values as $value) {
                    // Traverse the items-array...
                foreach ($TCA[$table]['columns'][$field]['config']['items'] as $item) {
                        // ... and return the first found label where the value was equal to $key
                    if (!strcmp($item[1], trim($value))) {
                        $output[] = $GLOBALS['TSFE']->sL($item[0]);
                    }
                }
            }
            $returnValue = implode($delimiter, $output);
        } else {
            $returnValue = $inputValue;
        }
        return $returnValue;
    }



    /***********************************************
     *
     * Link functions (typolink)
     *
     ***********************************************/


    /**
     * Implements the "typolink" property of stdWrap (and others)
     * Basically the input string, $linktext, is (typically) wrapped in a <a>-tag linking to some page, email address, file or URL based on a parameter defined by the configuration array $conf.
     * This function is best used from internal functions as is. There are some API functions defined after this function which is more suited for general usage in external applications.
     * Generally the concept "typolink" should be used in your own applications as an API for making links to pages with parameters and more. The reason for this is that you will then automatically make links compatible with all the centralized functions for URL simulation and manipulation of parameters into hashes and more.
     * For many more details on the parameters and how they are intepreted, please see the link to TSref below.
     *
     * @param   string      The string (text) to link
     * @param   array       TypoScript configuration (see link below)
     * @return  string      A link-wrapped string.
     * @see stdWrap(), tslib_pibase::pi_linkTP()
     */
    function typoLink($linktxt, $conf) {
        $LD = array();
        $finalTagParts = array();
        $finalTagParts['aTagParams'] = $this->getATagParams($conf);

        $link_param = isset($conf['parameter.'])
            ? trim($this->stdWrap($conf['parameter'], $conf['parameter.']))
            : trim($conf['parameter']);

        $sectionMark = isset($conf['section.'])
            ? trim($this->stdWrap($conf['section'], $conf['section.']))
            : trim($conf['section']);
        $sectionMark = $sectionMark ? (t3lib_div::testInt($sectionMark) ? '#c' : '#') . $sectionMark : '';
        $initP = '?id=' . $GLOBALS['TSFE']->id . '&type=' . $GLOBALS['TSFE']->type;
        $this->lastTypoLinkUrl = '';
        $this->lastTypoLinkTarget = '';
        if ($link_param) {
            $enableLinksAcrossDomains = $GLOBALS['TSFE']->config['config']['typolinkEnableLinksAcrossDomains'];
            $link_paramA = t3lib_div::unQuoteFilenames($link_param, TRUE);

                // Check for link-handler keyword:
            list ($linkHandlerKeyword, $linkHandlerValue) = explode(':', trim($link_paramA[0]), 2);
            if ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['typolinkLinkHandler'][$linkHandlerKeyword] && strcmp($linkHandlerValue, '')) {
                $linkHandlerObj = t3lib_div::getUserObj($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['typolinkLinkHandler'][$linkHandlerKeyword]);

                if (method_exists($linkHandlerObj, 'main')) {
                    return $linkHandlerObj->main($linktxt, $conf, $linkHandlerKeyword, $linkHandlerValue, $link_param, $this);
                }
            }

            $link_param = trim($link_paramA[0]); // Link parameter value
            $linkClass = trim($link_paramA[2]); // Link class
            if ($linkClass == '-')
                $linkClass = ''; // The '-' character means 'no class'. Necessary in order to specify a title as fourth parameter without setting the target or class!
            $forceTarget = trim($link_paramA[1]); // Target value
            if ($forceTarget == '-') {
                $forceTarget = '';  // The '-' character means 'no target'. Necessary in order to specify a class as third parameter without setting the target!
            }
            $forceTitle = trim($link_paramA[3]); // Title value
            if ($forceTitle == '-') {
                $forceTitle = '';   // The '-' character means 'no title'. Necessary in order to specify further parameters without setting the title!
            }
            if (isset($link_paramA[4]) && strlen(trim($link_paramA[4])) > 0) {
                $forceParams = trim($link_paramA[4]);   // params value
                $conf['additionalParams'] .= $forceParams[0] == '&' ? $forceParams : '&' . $forceParams;
            }

                // Check, if the target is coded as a JS open window link:
            $JSwindowParts = array();
            $JSwindowParams = '';
            $onClick = '';
            if ($forceTarget && preg_match('/^([0-9]+)x([0-9]+)(:(.*)|.*)$/', $forceTarget, $JSwindowParts)) {
                    // Take all pre-configured and inserted parameters and compile parameter list, including width+height:
                $JSwindow_tempParamsArr = t3lib_div::trimExplode(',', strtolower($conf['JSwindow_params'] . ',' . $JSwindowParts[4]), TRUE);
                $JSwindow_paramsArr = array();
                foreach ($JSwindow_tempParamsArr as $JSv) {
                    list ($JSp, $JSv) = explode('=', $JSv);
                    $JSwindow_paramsArr[$JSp] = $JSp . '=' . $JSv;
                }
                    // Add width/height:
                $JSwindow_paramsArr['width'] = 'width=' . $JSwindowParts[1];
                $JSwindow_paramsArr['height'] = 'height=' . $JSwindowParts[2];
                    // Imploding into string:
                $JSwindowParams = implode(',', $JSwindow_paramsArr);
                $forceTarget = ''; // Resetting the target since we will use onClick.
            }

                // Internal target:
            $target = isset($conf['target']) ? $conf['target'] : $GLOBALS['TSFE']->intTarget;
            if ($conf['target.']) {
                $target = $this->stdWrap($target, $conf['target.']);
            }

                // Title tag
            $title = $conf['title'];
            if ($conf['title.']) {
                $title = $this->stdWrap($title, $conf['title.']);
            }

                // Parse URL:
            $pU = parse_url($link_param);

                // Detecting kind of link:
            if (strstr($link_param, '@') && (!$pU['scheme'] || $pU['scheme'] == 'mailto')) { // If it's a mail address:
                $link_param = preg_replace('/^mailto:/i', '', $link_param);
                list ($this->lastTypoLinkUrl, $linktxt) = $this->getMailTo($link_param, $linktxt, $initP);
                $finalTagParts['url'] = $this->lastTypoLinkUrl;
                $finalTagParts['TYPE'] = 'mailto';
            } else {
                $isLocalFile = 0;
                $fileChar = intval(strpos($link_param, '/'));
                $urlChar = intval(strpos($link_param, '.'));

                    // Firsts, test if $link_param is numeric and page with such id exists. If yes, do not attempt to link to file
                if (!t3lib_div::testInt($link_param) || count($GLOBALS['TSFE']->sys_page->getPage_noCheck($link_param)) == 0) {
                        // Detects if a file is found in site-root (or is a 'virtual' simulateStaticDocument file!) and if so it will be treated like a normal file.
                    list ($rootFileDat) = explode('?', rawurldecode($link_param));
                    $containsSlash = strstr($rootFileDat, '/');
                    $rFD_fI = pathinfo($rootFileDat);
                    if (trim($rootFileDat) && !$containsSlash && (@is_file(PATH_site . $rootFileDat) || t3lib_div::inList('php,html,htm', strtolower($rFD_fI['extension'])))) {
                        $isLocalFile = 1;
                    } elseif ($containsSlash) {
                        $isLocalFile = 2; // Adding this so realurl directories are linked right (non-existing).
                    }
                }

                if ($pU['scheme'] || ($isLocalFile != 1 && $urlChar && (!$containsSlash || $urlChar < $fileChar))) { // url (external): If doubleSlash or if a '.' comes before a '/'.
                    $target = isset($conf['extTarget']) ? $conf['extTarget'] : $GLOBALS['TSFE']->extTarget;
                    if ($conf['extTarget.']) {
                        $target = $this->stdWrap($target, $conf['extTarget.']);
                    }
                    if ($forceTarget) {
                        $target = $forceTarget;
                    }
                    if ($linktxt == '')
                        $linktxt = $link_param;
                    if (!$pU['scheme']) {
                        $scheme = 'http://';
                    } else {
                        $scheme = '';
                    }
                    if ($GLOBALS['TSFE']->config['config']['jumpurl_enable']) {
                        $this->lastTypoLinkUrl = $GLOBALS['TSFE']->absRefPrefix .
                            $GLOBALS['TSFE']->config['mainScript'] . $initP .
                            '&jumpurl=' . rawurlencode($scheme . $link_param) .
                            $GLOBALS['TSFE']->getMethodUrlIdToken;
                    } else {
                        $this->lastTypoLinkUrl = $scheme . $link_param;
                    }
                    $this->lastTypoLinkTarget = $target;
                    $finalTagParts['url'] = $this->lastTypoLinkUrl;
                    $finalTagParts['targetParams'] = $target ? ' target="' . $target . '"' : '';
                    $finalTagParts['TYPE'] = 'url';
                    $finalTagParts['aTagParams'] .= $this->extLinkATagParams($finalTagParts['url'], $finalTagParts['TYPE']);
                } elseif ($containsSlash || $isLocalFile) { // file (internal)
                    $splitLinkParam = explode('?', $link_param);
                    if (file_exists(rawurldecode($splitLinkParam[0])) || $isLocalFile) {
                        if ($linktxt == '')
                            $linktxt = rawurldecode($link_param);
                        if ($GLOBALS['TSFE']->config['config']['jumpurl_enable'] || $conf['jumpurl']) {
                            $theFileEnc = str_replace('%2F', '/', rawurlencode(rawurldecode($link_param)));
                            $this->lastTypoLinkUrl = $GLOBALS['TSFE']->absRefPrefix .
                                $GLOBALS['TSFE']->config['mainScript'] . $initP .
                                '&jumpurl=' . rawurlencode($link_param) .
                                ($conf['jumpurl.']['secure'] ? $this->locDataJU($theFileEnc, $conf['jumpurl.']['secure.']) : '') .
                                $GLOBALS['TSFE']->getMethodUrlIdToken;
                        } else {
                            $this->lastTypoLinkUrl = $GLOBALS['TSFE']->absRefPrefix . $link_param;
                        }
                        $this->lastTypoLinkUrl = $this->forceAbsoluteUrl($this->lastTypoLinkUrl, $conf);
                        $target = isset($conf['fileTarget']) ? $conf['fileTarget'] : $GLOBALS['TSFE']->fileTarget;
                        if ($conf['fileTarget.']) {
                            $target = $this->stdWrap($target, $conf['fileTarget.']);
                        }
                        if ($forceTarget) {
                            $target = $forceTarget;
                        }
                        $this->lastTypoLinkTarget = $target;

                        $finalTagParts['url'] = $this->lastTypoLinkUrl;
                        $finalTagParts['targetParams'] = $target ? ' target="' . $target . '"' : '';
                        $finalTagParts['TYPE'] = 'file';
                        $finalTagParts['aTagParams'] .= $this->extLinkATagParams($finalTagParts['url'], $finalTagParts['TYPE']);
                    } else {
                        $GLOBALS['TT']->setTSlogMessage(
                            "typolink(): File '" . $splitLinkParam[0] . "' did not exist, so '" . $linktxt . "' was not linked.", 1
                        );
                        return $linktxt;
                    }
                } else { // integer or alias (alias is without slashes or periods or commas, that is 'nospace,alphanum_x,lower,unique' according to definition in $TCA!)
                    if ($conf['no_cache.']) {
                        $conf['no_cache'] = $this->stdWrap($conf['no_cache'], $conf['no_cache.']);
                    }
                        // Splitting the parameter by ',' and if the array counts more than 1 element it's a id/type/parameters triplet
                    $pairParts = t3lib_div::trimExplode(',', $link_param, TRUE);
                    $link_param = $pairParts[0];
                    $link_params_parts = explode('#', $link_param);
                    $link_param = trim($link_params_parts[0]); // Link-data del
                    if (!strcmp($link_param, '')) {
                        $link_param = $GLOBALS['TSFE']->id;
                    } // If no id or alias is given
                    if ($link_params_parts[1] && !$sectionMark) {
                        $sectionMark = trim($link_params_parts[1]);
                        $sectionMark = (t3lib_div::testInt($sectionMark) ? '#c' : '#') . $sectionMark;
                    }

                    if (count($pairParts) > 1) {
                        $theTypeP = isset($pairParts[1]) ? $pairParts[1] : 0; // Overruling 'type'
                        $conf['additionalParams'] .= isset($pairParts[2]) ? $pairParts[2] : '';
                    }
                        // Checking if the id-parameter is an alias.
                    if (!t3lib_div::testInt($link_param)) {
                        $link_param = $GLOBALS['TSFE']->sys_page->getPageIdFromAlias($link_param);
                    }

                        // Link to page even if access is missing?
                    if (strlen($conf['linkAccessRestrictedPages'])) {
                        $disableGroupAccessCheck = ($conf['linkAccessRestrictedPages'] ? TRUE : FALSE);
                    } else {
                        $disableGroupAccessCheck = ($GLOBALS['TSFE']->config['config']['typolinkLinkAccessRestrictedPages'] ? TRUE : FALSE);
                    }

                        // Looking up the page record to verify its existence:
                    $page = $GLOBALS['TSFE']->sys_page->getPage($link_param, $disableGroupAccessCheck);

                    if (count($page)) {
                            // MointPoints, look for closest MPvar:
                        $MPvarAcc = array();
                        if (!$GLOBALS['TSFE']->config['config']['MP_disableTypolinkClosestMPvalue']) {
                            $temp_MP = $this->getClosestMPvalueForPage($page['uid'], TRUE);
                            if ($temp_MP)
                                $MPvarAcc['closest'] = $temp_MP;
                        }
                            // Look for overlay Mount Point:
                        $mount_info = $GLOBALS['TSFE']->sys_page->getMountPointInfo($page['uid'], $page);
                        if (is_array($mount_info) && $mount_info['overlay']) {
                            $page = $GLOBALS['TSFE']->sys_page->getPage($mount_info['mount_pid'], $disableGroupAccessCheck);
                            if (!count($page)) {
                                $GLOBALS['TT']->setTSlogMessage(
                                    "typolink(): Mount point '" . $mount_info['mount_pid'] . "' was not available, so '" .
                                    $linktxt . "' was not linked.", 1
                                );
                                return $linktxt;
                            }
                            $MPvarAcc['re-map'] = $mount_info['MPvar'];
                        }

                            // Setting title if blank value to link:
                        if ($linktxt == '')
                            $linktxt = $page['title'];

                            // Query Params:
                        $addQueryParams = $conf['addQueryString'] ? $this->getQueryArguments($conf['addQueryString.']) : '';
                        $addQueryParams .= isset($conf['additionalParams.'])
                            ? trim($this->stdWrap($conf['additionalParams'], $conf['additionalParams.']))
                            : trim($conf['additionalParams']);
                        if ($addQueryParams == '&' || substr($addQueryParams, 0, 1) != '&') {
                            $addQueryParams = '';
                        }
                        if ($conf['useCacheHash']) {
                                // Mind the order below! See http://bugs.typo3.org/view.php?id=5117
                            $params = $GLOBALS['TSFE']->linkVars . $addQueryParams;
                            if (trim($params, '& ') != '') {
                                $addQueryParams .= '&cHash=' . t3lib_div::generateCHash($params);
                            }
                            unset($params);
                        }

                        $targetDomain = '';
                        $currentDomain = t3lib_div::getIndpEnv('HTTP_HOST');
                            // Mount pages are always local and never link to another domain
                        if (count($MPvarAcc)) {
                                // Add "&MP" var:
                            $addQueryParams .= '&MP=' . rawurlencode(implode(',', $MPvarAcc));
                        } elseif (strpos($addQueryParams, '&MP=') === FALSE && $GLOBALS['TSFE']->config['config']['typolinkCheckRootline']) {

                                // We do not come here if additionalParams had '&MP='. This happens when typoLink is called from
                                // menu. Mount points always work in the content of the current domain and we must not change
                                // domain if MP variables exist.


                                // If we link across domains and page is free type shortcut, we must resolve the shortcut first!
                                // If we do not do it, TYPO3 will fail to (1) link proper page in RealURL/CoolURI because
                                // they return relative links and (2) show proper page if no RealURL/CoolURI exists when link is clicked
                            if ($enableLinksAcrossDomains && $page['doktype'] == t3lib_pageSelect::DOKTYPE_SHORTCUT && $page['shortcut_mode'] == t3lib_pageSelect::SHORTCUT_MODE_NONE) {
                                $page2 = $page; // Save in case of broken destination or endless loop
                                $maxLoopCount = 20; // Same as in RealURL, seems enough
                                while ($maxLoopCount && is_array($page) && $page['doktype'] == t3lib_pageSelect::DOKTYPE_SHORTCUT && $page['shortcut_mode'] == t3lib_pageSelect::SHORTCUT_MODE_NONE) {
                                    $page = $GLOBALS['TSFE']->sys_page->getPage($page['shortcut'], $disableGroupAccessCheck);
                                    $maxLoopCount--;
                                }
                                if (count($page) == 0 || $maxLoopCount == 0) {
                                        // We revert if shortcut is broken or maximum number of loops is exceeded (indicates endless loop)
                                    $page = $page2;
                                }
                            }

                                // Find all domain records in the rootline of the target page
                            $targetPageRootline = $GLOBALS['TSFE']->sys_page->getRootLine($page['uid']);
                            $foundDomains = array();
                            $firstFoundDomains = array();
                            $firstFoundForcedDomains = array();
                            $targetPageRootlinePids = array();
                            foreach ($targetPageRootline as $data) {
                                $targetPageRootlinePids[] = intval($data['uid']);
                            }
                            $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
                                'pid, domainName, forced',
                                'sys_domain',
                                'pid IN (' . implode(',', $targetPageRootlinePids) . ') ' . ' AND redirectTo=\'\' ' . $this->enableFields('sys_domain'),
                                '',
                                'sorting ASC'
                            );
                                // TODO maybe it makes sense to hold all sys_domain records in a cache to save additional DB querys on each typolink
                            while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
                                $foundDomains[] = preg_replace('/\/$/', '', $row['domainName']);
                                if (!isset($firstFoundDomains[$row['pid']])) {
                                    $firstFoundDomains[$row['pid']] = preg_replace('/\/$/', '', $row['domainName']);
                                }
                                if ($row['forced'] && !isset($firstFoundForcedDomains[$row['pid']])) {
                                    $firstFoundForcedDomains[$row['pid']] = preg_replace('/\/$/', '', $row['domainName']);
                                }
                            }
                            $GLOBALS['TYPO3_DB']->sql_free_result($res);

                                // Set targetDomain to first found domain record if the target page cannot be reached within the current domain
                            if (count($foundDomains) > 0 && (!in_array($currentDomain, $foundDomains) || count($firstFoundForcedDomains) > 0)) {
                                foreach ($targetPageRootlinePids as $pid) {
                                        // Always use the 'forced' domain if we found one
                                    if (isset($firstFoundForcedDomains[$pid])) {
                                        $targetDomain = $firstFoundForcedDomains[$pid];
                                        break;
                                    }
                                        // Use the first found domain record
                                    if ($targetDomain === '' && isset($firstFoundDomains[$pid])) {
                                        $targetDomain = $firstFoundDomains[$pid];
                                    }
                                }
                                    // Do not prepend the domain if its the current hostname
                                if ($targetDomain === $currentDomain) {
                                    $targetDomain = '';
                                }
                            }
                        }

                        $absoluteUrlScheme = 'http';
                            // URL shall be absolute:
                        if (isset($conf['forceAbsoluteUrl']) && $conf['forceAbsoluteUrl'] || $page['url_scheme'] > 0) {
                                // Override scheme:
                            if (isset($conf['forceAbsoluteUrl.']['scheme']) && $conf['forceAbsoluteUrl.']['scheme']) {
                                $absoluteUrlScheme = $conf['forceAbsoluteUrl.']['scheme'];
                            } elseif ($page['url_scheme'] > 0) {
                                $absoluteUrlScheme = ((int) $page['url_scheme'] === t3lib_utility_http::SCHEME_HTTP) ? 'http' : 'https';
                            }

                                // If no domain records are defined, use current domain:
                            if ($targetDomain === '' && $conf['forceAbsoluteUrl'] ||
                                    $absoluteUrlScheme !== parse_url(t3lib_div::getIndpEnv('TYPO3_REQUEST_URL'), PHP_URL_SCHEME)) {
                                $targetDomain = $currentDomain;
                            }
                        }

                            // If target page has a different domain and the current domain's linking scheme (e.g. simulateStaticDocuments/RealURL/...) should not be used
                        if (strlen($targetDomain) && $targetDomain !== $currentDomain && !$enableLinksAcrossDomains) {
                            $target = isset($conf['extTarget']) ? $conf['extTarget'] : $GLOBALS['TSFE']->extTarget;
                            if ($conf['extTarget.']) {
                                $target = $this->stdWrap($target, $conf['extTarget.']);
                            }
                            if ($forceTarget) {
                                $target = $forceTarget;
                            }
                            $LD['target'] = $target;
                            $this->lastTypoLinkUrl = $this->URLqMark(
                                $absoluteUrlScheme . '://' . $targetDomain . '/index.php?id=' . $page['uid'], $addQueryParams
                            ) . $sectionMark;
                        } else { // Internal link or current domain's linking scheme should be used
                            if ($forceTarget) {
                                $target = $forceTarget;
                            }
                            $LD = $GLOBALS['TSFE']->tmpl->linkData(
                                $page,
                                $target,
                                $conf['no_cache'],
                                '',
                                '',
                                $addQueryParams,
                                $theTypeP,
                                $targetDomain
                            );
                            if (strlen($targetDomain)) {
                                    // We will add domain only if URL does not have it already.


                                    if ($enableLinksAcrossDomains) {
                                        // Get rid of the absRefPrefix if necessary. absRefPrefix is applicable only
                                        // to the current web site. If we have domain here it means we link across
                                        // domains. absRefPrefix can contain domain name, which will screw up
                                        // the link to the external domain.
                                    $prefixLength = strlen($GLOBALS['TSFE']->config['config']['absRefPrefix']);
                                    if (substr($LD['totalURL'], 0, $prefixLength) == $GLOBALS['TSFE']->config['config']['absRefPrefix']) {
                                        $LD['totalURL'] = substr($LD['totalURL'], $prefixLength);
                                    }
                                }
                                $urlParts = parse_url($LD['totalURL']);
                                if ($urlParts['host'] == '') {
                                    $LD['totalURL'] = $absoluteUrlScheme . '://' . $targetDomain .
                                        ($LD['totalURL']{0} == '/' ? '' : '/') . $LD['totalURL'];
                                }
                            }
                            $this->lastTypoLinkUrl = $this->URLqMark($LD['totalURL'], '') . $sectionMark;
                        }

                        $this->lastTypoLinkTarget = $LD['target'];
                        $targetPart = $LD['target'] ? ' target="' . $LD['target'] . '"' : '';

                            // If sectionMark is set, there is no baseURL AND the current page is the page the link is to, check if there are any additional parameters or addQueryString parameters and if not, drop the url.
                        if ($sectionMark && !$GLOBALS['TSFE']->config['config']['baseURL']
                            && $page['uid'] == $GLOBALS['TSFE']->id && !trim($addQueryParams)
                            && !($conf['addQueryString'] && $conf['addQueryString.'])) {

                            list (, $URLparams) = explode('?', $this->lastTypoLinkUrl);
                            list ($URLparams) = explode('#', $URLparams);
                            parse_str($URLparams . $LD['orig_type'], $URLparamsArray);
                            if (intval($URLparamsArray['type']) == $GLOBALS['TSFE']->type) { // type nums must match as well as page ids
                                unset($URLparamsArray['id']);
                                unset($URLparamsArray['type']);
                                if (!count($URLparamsArray)) { // If there are no parameters left.... set the new url.
                                    $this->lastTypoLinkUrl = $sectionMark;
                                }
                            }
                        }

                            // If link is to a access restricted page which should be redirected, then find new URL:
                        if ($GLOBALS['TSFE']->config['config']['typolinkLinkAccessRestrictedPages']
                            && $GLOBALS['TSFE']->config['config']['typolinkLinkAccessRestrictedPages'] !== 'NONE'
                            && !$GLOBALS['TSFE']->checkPageGroupAccess($page)) {

                            $thePage = $GLOBALS['TSFE']->sys_page->getPage($GLOBALS['TSFE']->config['config']['typolinkLinkAccessRestrictedPages']);

                            $addParams = $GLOBALS['TSFE']->config['config']['typolinkLinkAccessRestrictedPages_addParams'];
                            $addParams = str_replace('###RETURN_URL###', rawurlencode($this->lastTypoLinkUrl), $addParams);
                            $addParams = str_replace('###PAGE_ID###', $page['uid'], $addParams);
                            $this->lastTypoLinkUrl = $this->getTypoLink_URL(
                                $thePage['uid'] . ($theTypeP ? ',' . $theTypeP : ''),
                                $addParams,
                                $target
                            );
                            $this->lastTypoLinkUrl = $this->forceAbsoluteUrl($this->lastTypoLinkUrl, $conf);
                            $this->lastTypoLinkLD['totalUrl'] = $this->lastTypoLinkUrl;
                            $LD = $this->lastTypoLinkLD;
                        }

                            // Rendering the tag.
                        $finalTagParts['url'] = $this->lastTypoLinkUrl;
                        $finalTagParts['targetParams'] = $targetPart;
                        $finalTagParts['TYPE'] = 'page';
                    } else {
                        $GLOBALS['TT']->setTSlogMessage(
                            "typolink(): Page id '" . $link_param . "' was not found, so '" . $linktxt . "' was not linked.", 1
                        );
                        return $linktxt;
                    }
                }
            }

            $this->lastTypoLinkLD = $LD;

            if ($forceTitle) {
                $title = $forceTitle;
            }

            if ($JSwindowParams) {

                    // Create TARGET-attribute only if the right doctype is used
                if (!t3lib_div::inList('xhtml_strict,xhtml_11,xhtml_2', $GLOBALS['TSFE']->xhtmlDoctype)) {
                    $target = ' target="FEopenLink"';
                } else {
                    $target = '';
                }

                $onClick = "vHWin=window.open('" . $GLOBALS['TSFE']->baseUrlWrap($finalTagParts['url']) .
                    "','FEopenLink','" . $JSwindowParams . "');vHWin.focus();return false;";
                $res = '<a href="' . htmlspecialchars($finalTagParts['url']) . '"' .
                    $target . ' onclick="' . htmlspecialchars($onClick) . '"' .
                    ($title ? ' title="' . $title . '"' : '') .
                    ($linkClass ? ' class="' . $linkClass . '"' : '') .
                    $finalTagParts['aTagParams'] . '>';
            } else {
                if ($GLOBALS['TSFE']->spamProtectEmailAddresses === 'ascii' && $finalTagParts['TYPE'] === 'mailto') {
                    $res = '<a href="' . $finalTagParts['url'] . '"' .
                        ($title ? ' title="' . $title . '"' : '') .
                        $finalTagParts['targetParams'] .
                        ($linkClass ? ' class="' . $linkClass . '"' : '') .
                        $finalTagParts['aTagParams'] . '>';
                } else {
                    $res = '<a href="' . htmlspecialchars($finalTagParts['url']) . '"' .
                        ($title ? ' title="' . $title . '"' : '') .
                        $finalTagParts['targetParams'] .
                        ($linkClass ? ' class="' . $linkClass . '"' : '') .
                        $finalTagParts['aTagParams'] . '>';
                }
            }

                // Call user function:
            if ($conf['userFunc']) {
                $finalTagParts['TAG'] = $res;
                $res = $this->callUserFunction($conf['userFunc'], $conf['userFunc.'], $finalTagParts);
            }

                // Hook: Call post processing function for link rendering:
            if (isset($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['typoLink_PostProc'])
                && is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['typoLink_PostProc'])) {

                $_params = array(
                    'conf' => &$conf,
                    'linktxt' => &$linktxt,
                    'finalTag' => &$res,
                    'finalTagParts' => &$finalTagParts
                );
                foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['typoLink_PostProc'] as $_funcRef) {
                    t3lib_div::callUserFunction($_funcRef, $_params, $this);
                }
            }

                // If flag "returnLastTypoLinkUrl" set, then just return the latest URL made:
            if ($conf['returnLast']) {
                switch ($conf['returnLast']) {
                    case 'url' :
                        return $this->lastTypoLinkUrl;
                    break;
                    case 'target' :
                        return $this->lastTypoLinkTarget;
                    break;
                }
            }

            $wrap = isset($conf['wrap.'])
                ? $this->stdWrap($conf['wrap'], $conf['wrap.'])
                : $conf['wrap'];
            if ($conf['ATagBeforeWrap']) {
                return $res . $this->wrap($linktxt, $wrap) . '</a>';
            } else {
                return $this->wrap($res . $linktxt . '</a>', $wrap);
            }
        } else {
            return $linktxt;
        }
    }

    /**
     * Forces a given URL to be absolute.
     *
     * @param string $url The URL to be forced to be absolute
     * @param array $configuration TypoScript configuration of typolink
     * @return string The absolute URL
     */
    protected function forceAbsoluteUrl($url, array $configuration) {
        if (!empty($url) && isset($configuration['forceAbsoluteUrl']) && $configuration['forceAbsoluteUrl']) {
            if (preg_match('#^(?:([a-z]+)(://))?([^/]*)(.*)$#', $url, $matches)) {
                $urlParts = array(
                    'scheme' => $matches[1],
                    'delimiter' => '://',
                    'host' => $matches[3],
                    'path' => $matches[4]
                );

                    // Set scheme and host if not yet part of the URL:
                if (empty($urlParts['host'])) {
                    $urlParts['scheme'] = 'http';
                    $urlParts['host'] = t3lib_div::getIndpEnv('HTTP_HOST');
                    $isUrlModified = TRUE;
                }

                    // Override scheme:
                $forceAbsoluteUrl = & $configuration['forceAbsoluteUrl.']['scheme'];
                if (!empty($forceAbsoluteUrl) && $urlParts['scheme'] !== $forceAbsoluteUrl) {
                    $urlParts['scheme'] = $forceAbsoluteUrl;
                    $isUrlModified = TRUE;
                }

                    // Recreate the absolute URL:
                if ($isUrlModified) {
                    $url = implode('', $urlParts);
                }
            }
        }

        return $url;
    }

    /**
     * Based on the input "TypoLink" TypoScript configuration this will return the generated URL
     *
     * @param   array       TypoScript properties for "typolink"
     * @return  string      The URL of the link-tag that typolink() would by itself return
     * @see typoLink()
     */
    function typoLink_URL($conf) {
        $this->typolink('|', $conf);
        return $this->lastTypoLinkUrl;
    }

    /**
     * Returns a linked string made from typoLink parameters.
     *
     * This function takes $label as a string, wraps it in a link-tag based on the $params string, which should contain data like that you would normally pass to the popular <LINK>-tag in the TSFE.
     * Optionally you can supply $urlParameters which is an array with key/value pairs that are rawurlencoded and appended to the resulting url.
     *
     * @param   string      Text string being wrapped by the link.
     * @param   string      Link parameter; eg. "123" for page id, "kasperYYYY@typo3.com" for email address, "http://...." for URL, "fileadmin/blabla.txt" for file.
     * @param   array       An array with key/value pairs representing URL parameters to set. Values NOT URL-encoded yet.
     * @param   string      Specific target set, if any. (Default is using the current)
     * @return  string      The wrapped $label-text string
     * @see getTypoLink_URL()
     */
    function getTypoLink($label, $params, $urlParameters = array(), $target = '') {
        $conf = array();
        $conf['parameter'] = $params;
        if ($target) {
            $conf['target'] = $target;
            $conf['extTarget'] = $target;
            $conf['fileTarget'] = $target;
        }
        if (is_array($urlParameters)) {
            if (count($urlParameters)) {
                $conf['additionalParams'] .= t3lib_div::implodeArrayForUrl('', $urlParameters);
            }
        } else {
            $conf['additionalParams'] .= $urlParameters;
        }
        $out = $this->typolink($label, $conf);
        return $out;
    }

    /**
     * Returns the URL of a "typolink" create from the input parameter string, url-parameters and target
     *
     * @param   string      Link parameter; eg. "123" for page id, "kasperYYYY@typo3.com" for email address, "http://...." for URL, "fileadmin/blabla.txt" for file.
     * @param   array       An array with key/value pairs representing URL parameters to set. Values NOT URL-encoded yet.
     * @param   string      Specific target set, if any. (Default is using the current)
     * @return  string      The URL
     * @see getTypoLink()
     */
    function getTypoLink_URL($params, $urlParameters = array(), $target = '') {
        $this->getTypoLink('', $params, $urlParameters, $target);
        return $this->lastTypoLinkUrl;
    }

    /**
     * Generates a typolink and returns the two link tags - start and stop - in an array
     *
     * @param   array       "typolink" TypoScript properties
     * @return  array       An array with two values in key 0+1, each value being the start and close <a>-tag of the typolink properties being inputted in $conf
     * @see typolink()
     */
    function typolinkWrap($conf) {
        $k = md5(microtime());
        return explode($k, $this->typolink($k, $conf));
    }

    /**
     * Returns the current page URL
     *
     * @param   array       Optionally you can specify additional URL parameters. An array with key/value pairs representing URL parameters to set. Values NOT URL-encoded yet.
     * @param   integer     An alternative ID to the current id ($GLOBALS['TSFE']->id)
     * @return  string      The URL
     * @see getTypoLink_URL()
     */
    function currentPageUrl($urlParameters = array(), $id = 0) {
        return $this->getTypoLink_URL($id ? $id : $GLOBALS['TSFE']->id, $urlParameters, $GLOBALS['TSFE']->sPre);
    }

    /**
     * Returns the &MP variable value for a page id.
     * The function will do its best to find a MP value that will keep the page id inside the current Mount Point rootline if any.
     *
     * @param   integer     page id
     * @param   boolean     If TRUE, the MPvalue is returned raw. Normally it is encoded as &MP=... variable
     * @return  string      MP value, prefixed with &MP= (depending on $raw)
     * @see typolink()
     */
    function getClosestMPvalueForPage($pageId, $raw = FALSE) {
            // MointPoints:
        if ($GLOBALS['TYPO3_CONF_VARS']['FE']['enable_mount_pids'] && $GLOBALS['TSFE']->MP) {

            if (!strcmp($GLOBALS['TSFE']->id, $pageId)) { // same page as current.
                $MP = $GLOBALS['TSFE']->MP;
            } else { // ... otherwise find closest meeting point:
                $tCR_rootline = $GLOBALS['TSFE']->sys_page->getRootLine($pageId, '', TRUE); // Gets rootline of linked-to page
                $inverseTmplRootline = array_reverse($GLOBALS['TSFE']->tmpl->rootLine);

                $rl_mpArray = array();
                $startMPaccu = FALSE;

                    // Traverse root line of link uid and inside of that the REAL root line of current position.
                foreach ($tCR_rootline as $tCR_data) {
                    foreach ($inverseTmplRootline as $rlKey => $invTmplRLRec) {

                            // Force accumulating when in overlay mode: Links to this page have to stay within the current branch
                        if ($invTmplRLRec['_MOUNT_OL'] && ($tCR_data['uid'] == $invTmplRLRec['uid'])) {
                            $startMPaccu = TRUE;
                        }

                            // Accumulate MP data:
                        if ($startMPaccu && $invTmplRLRec['_MP_PARAM']) {
                            $rl_mpArray[] = $invTmplRLRec['_MP_PARAM'];
                        }

                            // If two PIDs matches and this is NOT the site root, start accumulation of MP data (on the next level):
                            // (The check for site root is done so links to branches outsite the site but sharing the site roots PID
                            // is NOT detected as within the branch!)
                        if ($tCR_data['pid'] == $invTmplRLRec['pid'] && count($inverseTmplRootline) != $rlKey + 1) {
                            $startMPaccu = TRUE;
                        }
                    }
                    if ($startMPaccu)
                        break; // Good enough...
                }

                if (count($rl_mpArray)) {
                    $MP = implode(',', array_reverse($rl_mpArray));
                }
            }
        }

        return !$raw ? ($MP ? '&MP=' . rawurlencode($MP) : '') : $MP;
    }

    /**
     * Creates a href attibute for given $mailAddress.
     * The function uses spamProtectEmailAddresses and Jumpurl functionality for encoding the mailto statement.
     * If spamProtectEmailAddresses is disabled, it'll just return a string like "mailto:user@example.tld".
     *
     * @param   string      Email address
     * @param   string      Link text, default will be the email address.
     * @param   string      Initial link parameters, only used if Jumpurl functionality is enabled. Example: ?id=5&type=0
     * @return  string      Returns a numerical array with two elements: 1) $mailToUrl, string ready to be inserted into the href attribute of the <a> tag, b) $linktxt: The string between starting and ending <a> tag.
     */
    function getMailTo($mailAddress, $linktxt, $initP = '?') {
        if (!strcmp($linktxt, '')) {
            $linktxt = $mailAddress;
        }

        $mailToUrl = 'mailto:' . $mailAddress;

        if (!$GLOBALS['TSFE']->config['config']['jumpurl_enable'] || $GLOBALS['TSFE']->config['config']['jumpurl_mailto_disable']) {
            if ($GLOBALS['TSFE']->spamProtectEmailAddresses) {
                if ($GLOBALS['TSFE']->spamProtectEmailAddresses === 'ascii') {
                    $mailToUrl = $GLOBALS['TSFE']->encryptEmail($mailToUrl);
                } else {
                    $mailToUrl = "javascript:linkTo_UnCryptMailto('" . $GLOBALS['TSFE']->encryptEmail($mailToUrl) . "');";
                }
                if ($GLOBALS['TSFE']->config['config']['spamProtectEmailAddresses_atSubst']) {
                    $atLabel = trim($GLOBALS['TSFE']->config['config']['spamProtectEmailAddresses_atSubst']);
                }
                $spamProtectedMailAddress = str_replace('@', ($atLabel ? $atLabel : '(at)'), $mailAddress);

                if ($GLOBALS['TSFE']->config['config']['spamProtectEmailAddresses_lastDotSubst']) {
                    $lastDotLabel = trim($GLOBALS['TSFE']->config['config']['spamProtectEmailAddresses_lastDotSubst']);
                    $lastDotLabel = $lastDotLabel ? $lastDotLabel : '(dot)';
                    $spamProtectedMailAddress = preg_replace('/\.([^\.]+)$/', $lastDotLabel . '$1', $spamProtectedMailAddress);
                }
                $linktxt = str_ireplace($mailAddress, $spamProtectedMailAddress, $linktxt);
            }
        } else {
            $mailToUrl = $GLOBALS['TSFE']->absRefPrefix . $GLOBALS['TSFE']->config['mainScript'] .
                $initP . '&jumpurl=' . rawurlencode($mailToUrl) . $GLOBALS['TSFE']->getMethodUrlIdToken;
        }
        return array(
            $mailToUrl, $linktxt
        );
    }

    /**
     * Gets the query arguments and assembles them for URLs.
     * Arguments may be removed or set, depending on configuration.
     *
     * @param   string      Configuration
     * @param   array       Multidimensional key/value pairs that overrule incoming query arguments
     * @param   boolean     If set, key/value pairs not in the query but the overrule array will be set
     * @return  string      The URL query part (starting with a &)
     */
    public function getQueryArguments($conf, $overruleQueryArguments = array(), $forceOverruleArguments = FALSE) {
        switch ((string) $conf['method']) {
            case 'GET' :
                $currentQueryArray = t3lib_div::_GET();
            break;
            case 'POST' :
                $currentQueryArray = t3lib_div::_POST();
            break;
            case 'GET,POST' :
                $currentQueryArray = array_merge(t3lib_div::_GET(), t3lib_div::_POST());
            break;
            case 'POST,GET' :
                $currentQueryArray = array_merge(t3lib_div::_POST(), t3lib_div::_GET());
            break;
            default :
                $currentQueryArray = t3lib_div::explodeUrl2Array(t3lib_div::getIndpEnv('QUERY_STRING'), TRUE);
        }

        if ($conf['exclude']) {
            $exclude = str_replace(',', '&', $conf['exclude']);
            $exclude = t3lib_div::explodeUrl2Array($exclude, TRUE);
                // never repeat id
            $exclude['id'] = 0;
            $newQueryArray = t3lib_div::arrayDiffAssocRecursive($currentQueryArray, $exclude);
        } else {
            $newQueryArray = $currentQueryArray;
        }

        if ($forceOverruleArguments) {
            $newQueryArray = t3lib_div::array_merge_recursive_overrule($newQueryArray, $overruleQueryArguments);
        } else {
            $newQueryArray = t3lib_div::array_merge_recursive_overrule($newQueryArray, $overruleQueryArguments, TRUE);
        }

        return t3lib_div::implodeArrayForUrl('', $newQueryArray);
    }



    /***********************************************
     *
     * Miscellaneous functions, stand alone
     *
     ***********************************************/

    /**
     * Wrapping a string.
     * Implements the TypoScript "wrap" property.
     * Example: $content = "HELLO WORLD" and $wrap = "<strong> | </strong>", result: "<strong>HELLO WORLD</strong>"
     *
     * @param   string      The content to wrap
     * @param   string      The wrap value, eg. "<strong> | </strong>"
     * @param   string      The char used to split the wrapping value, default is "|"
     * @return  string      Wrapped input string
     * @see noTrimWrap()
     */
    function wrap($content, $wrap, $char = '|') {
        if ($wrap) {
            $wrapArr = explode($char, $wrap);
            return trim($wrapArr[0]) . $content . trim($wrapArr[1]);
        } else
            return $content;
    }

    /**
     * Wrapping a string, preserving whitespace in wrap value.
     * Notice that the wrap value uses part 1/2 to wrap (and not 0/1 which wrap() does)
     *
     * @param   string      The content to wrap, eg. "HELLO WORLD"
     * @param   string      The wrap value, eg. " | <strong> | </strong>"
     * @return  string      Wrapped input string, eg. " <strong> HELLO WORD </strong>"
     * @see wrap()
     */
    function noTrimWrap($content, $wrap) {
        if ($wrap) {
            $wrapArr = explode('|', $wrap);
            return $wrapArr[1] . $content . $wrapArr[2];
        } else
            return $content;
    }

    /**
     * Adds space above/below the input HTML string. It is done by adding a clear-gif and <br /> tag before and/or after the content.
     *
     * @param   string      The content to add space above/below to.
     * @param   string      A value like "10 | 20" where the first part denotes the space BEFORE and the second part denotes the space AFTER (in pixels)
     * @param   array       Configuration from TypoScript
     * @return  string      Wrapped string
     */
    function wrapSpace($content, $wrap, array $conf = NULL) {
        if (trim($wrap)) {
            $wrapArray = explode('|', $wrap);
            $wrapBefore = intval($wrapArray[0]);
            $wrapAfter = intval($wrapArray[1]);
            $useDivTag = (isset($conf['useDiv']) && $conf['useDiv']);
            if ($wrapBefore) {
                if ($useDivTag) {
                    $content = '<div class="content-spacer spacer-before" style="height:' . $wrapBefore . 'px;"></div>' . $content;
                } else {
                    $content = '<img src="' . $GLOBALS['TSFE']->absRefPrefix .
                        'clear.gif" width="1" height="' . $wrapBefore . '"' .
                    $this->getBorderAttr(' border="0"') . ' class="spacer-gif" alt="" title="" /><br />' . $content;
                }
            }
            if ($wrapAfter) {
                if ($useDivTag) {
                    $content .= '<div class="content-spacer spacer-after" style="height:' . $wrapAfter . 'px;"></div>';
                } else {
                    $content .= '<img src="' . $GLOBALS['TSFE']->absRefPrefix .
                        'clear.gif" width="1" height="' . $wrapAfter . '"' .
                    $this->getBorderAttr(' border="0"') . ' class="spacer-gif" alt="" title="" /><br />';
                }
            }
        }
        return $content;
    }

    /**
     * Calling a user function/class-method
     * Notice: For classes the instantiated object will have the internal variable, $cObj, set to be a *reference* to $this (the parent/calling object).
     *
     * @param   string      The functionname, eg "user_myfunction" or "user_myclass->main". Notice that there are rules for the names of functions/classes you can instantiate. If a function cannot be called for some reason it will be seen in the TypoScript log in the AdminPanel.
     * @param   array       The TypoScript configuration to pass the function
     * @param   string      The content string to pass the function
     * @return  string      The return content from the function call. Should probably be a string.
     * @see USER(), stdWrap(), typoLink(), _parseFunc()
     */
    function callUserFunction($funcName, $conf, $content) {
        $pre = $GLOBALS['TSFE']->TYPO3_CONF_VARS['FE']['userFuncClassPrefix'];
        if ($pre && !t3lib_div::isFirstPartOfStr(trim($funcName), $pre) && !t3lib_div::isFirstPartOfStr(trim($funcName), 'tx_')) {
            $GLOBALS['TT']->setTSlogMessage('Function "' . $funcName . '" was not prepended with "' . $pre . '"', 3);
            return $content;
        }
            // Split parts
        $parts = explode('->', $funcName);
        if (count($parts) == 2) { // Class
            // Check whether class is available and try to reload includeLibs if possible:
            if ($this->isClassAvailable($parts[0], $conf)) {
                $classObj = t3lib_div::makeInstance($parts[0]);
                if (is_object($classObj) && method_exists($classObj, $parts[1])) {
                    $classObj->cObj = $this;
                    $content = call_user_func_array(array(
                        $classObj, $parts[1]
                    ), array(
                        $content, $conf
                    ));
                } else {
                    $GLOBALS['TT']->setTSlogMessage('Method "' . $parts[1] . '" did not exist in class "' . $parts[0] . '"', 3);
                }
            } else {
                $GLOBALS['TT']->setTSlogMessage('Class "' . $parts[0] . '" did not exist', 3);
            }
        } else { // Function
            if (function_exists($funcName)) {
                $content = call_user_func($funcName, $content, $conf);
            } else {
                $GLOBALS['TT']->setTSlogMessage('Function "' . $funcName . '" did not exist', 3);
            }
        }
        return $content;
    }

    /**
     * Parses a set of text lines with "[parameters] = [values]" into an array with parameters as keys containing the value
     * If lines are empty or begins with "/" or "#" then they are ignored.
     *
     * @param   string      Text which the parameters
     * @return  array       array with the parameters as key/value pairs
     */
    function processParams($params) {
        $paramArr = array();
        $lines = t3lib_div::trimExplode(LF, $params, 1);
        foreach ($lines as $val) {
            $pair = explode('=', $val, 2);
            if (!t3lib_div::inList('#,/', substr(trim($pair[0]), 0, 1))) {
                $paramArr[trim($pair[0])] = trim($pair[1]);
            }
        }
        return $paramArr;
    }

    /**
     * Cleans up a string of keywords. Keywords at splitted by "," (comma)  ";" (semi colon) and linebreak
     *
     * @param   string      String of keywords
     * @return  string      Cleaned up string, keywords will be separated by a comma only.
     */
    function keywords($content) {
        $listArr = preg_split('/[,;' . LF . ']/', $content);
        foreach ($listArr as $k => $v) {
            $listArr[$k] = trim($v);
        }
        return implode(',', $listArr);
    }

    /**
     * Changing character case of a string, converting typically used western charset characters as well.
     *
     * @param   string      The string to change case for.
     * @param   string      The direction; either "upper" or "lower"
     * @return  string
     * @see HTMLcaseshift()
     */
    function caseshift($theValue, $case) {
        $case = strtolower($case);
        switch ($case) {
            case 'upper' :
                $theValue = $GLOBALS['TSFE']->csConvObj->conv_case($GLOBALS['TSFE']->renderCharset, $theValue, 'toUpper');
            break;
            case 'lower' :
                $theValue = $GLOBALS['TSFE']->csConvObj->conv_case($GLOBALS['TSFE']->renderCharset, $theValue, 'toLower');
            break;
        }
        return $theValue;
    }

    /**
     * Shifts the case of characters outside of HTML tags in the input string
     *
     * @param   string      The string to change case for.
     * @param   string      The direction; either "upper" or "lower"
     * @return  string
     * @see caseshift()
     */
    function HTMLcaseshift($theValue, $case) {
        $inside = 0;
        $newVal = '';
        $pointer = 0;
        $totalLen = strlen($theValue);
        do {
            if (!$inside) {
                $len = strcspn(substr($theValue, $pointer), '<');
                $newVal .= $this->caseshift(substr($theValue, $pointer, $len), $case);
                $inside = 1;
            } else {
                $len = strcspn(substr($theValue, $pointer), '>') + 1;
                $newVal .= substr($theValue, $pointer, $len);
                $inside = 0;
            }
            $pointer += $len;
        } while ($pointer < $totalLen);
        return $newVal;
    }

    /**
     * Returns the 'age' of the tstamp $seconds
     *
     * @param   integer     Seconds to return age for. Example: "70" => "1 min", "3601" => "1 hrs"
     * @param   string      $labels are the labels of the individual units. Defaults to : ' min| hrs| days| yrs'
     * @return  string      The formatted string
     */
    function calcAge($seconds, $labels) {
        if (t3lib_div::testInt($labels)) {
            $labels = ' min| hrs| days| yrs| min| hour| day| year';
        } else {
            $labels = str_replace('"', '', $labels);
        }

        $labelArr = explode('|', $labels);
        if (count($labelArr) == 4) {
            $labelArr = array_merge($labelArr, $labelArr);
        }
        $absSeconds = abs($seconds);
        $sign = ($seconds > 0 ? 1 : -1);
        if ($absSeconds < 3600) {
            $val = round($absSeconds / 60);
            $seconds = ($sign * $val) . ($val == 1 ? $labelArr[4] : $labelArr[0]);
        } elseif ($absSeconds < 24 * 3600) {
            $val = round($absSeconds / 3600);
            $seconds = ($sign * $val) . ($val == 1 ? $labelArr[5] : $labelArr[1]);
        } elseif ($absSeconds < 365 * 24 * 3600) {
            $val = round($absSeconds / (24 * 3600));
            $seconds = ($sign * $val) . ($val == 1 ? $labelArr[6] : $labelArr[2]);
        } else {
            $val = round($absSeconds / (365 * 24 * 3600));
            $seconds = ($sign * $val) . ($val == 1 ? $labelArr[7] : $labelArr[3]);
        }
        return $seconds;
    }

    /**
     * Sending a notification email using $GLOBALS['TSFE']->plainMailEncoded()
     *
     * @param   string      The message content. If blank, no email is sent.
     * @param   string      Comma list of recipient email addresses
     * @param   string      Email address of recipient of an extra mail. The same mail will be sent ONCE more; not using a CC header but sending twice.
     * @param   string      "From" email address
     * @param   string      Optional "From" name
     * @param   string      Optional "Reply-To" header email address.
     * @return  boolean     Returns TRUE if sent
     */
    function sendNotifyEmail($msg, $recipients, $cc, $email_from, $email_fromName = '', $replyTo = '') {
            // Sends order emails:
        $headers = array();
        if ($email_from) {
            $headers[] = 'From: ' . $email_fromName . ' <' . $email_from . '>';
        }
        if ($replyTo) {
            $headers[] = 'Reply-To: ' . $replyTo;
        }

        $recipients = implode(',', t3lib_div::trimExplode(',', $recipients, 1));

        $emailContent = trim($msg);
        if ($emailContent) {
            $parts = explode(LF, $emailContent, 2); // First line is subject
            $subject = trim($parts[0]);
            $plain_message = trim($parts[1]);

            if ($recipients)
                $GLOBALS['TSFE']->plainMailEncoded($recipients, $subject, $plain_message, implode(LF, $headers));
            if ($cc)
                $GLOBALS['TSFE']->plainMailEncoded($cc, $subject, $plain_message, implode(LF, $headers));
            return TRUE;
        }
    }

    /**
     * Checks if $url has a '?' in it and if not, a '?' is inserted between $url and $params, which are anyway concatenated and returned
     *
     * @param   string      Input URL
     * @param   string      URL parameters
     * @return  string
     */
    function URLqMark($url, $params) {
        if ($params && !strstr($url, '?')) {
            return $url . '?' . $params;
        } else {
            return $url . $params;
        }
    }

    /**
     * Clears TypoScript properties listed in $propList from the input TypoScript array.
     *
     * @param   array       TypoScript array of values/properties
     * @param   string      List of properties to clear both value/properties for. Eg. "myprop,another_property"
     * @return  array       The TypoScript array
     * @see gifBuilderTextBox()
     */
    function clearTSProperties($TSArr, $propList) {
        $list = explode(',', $propList);
        foreach ($list as $prop) {
            $prop = trim($prop);
            unset($TSArr[$prop]);
            unset($TSArr[$prop . '.']);
        }
        return $TSArr;
    }

    /**
     * Resolves a TypoScript reference value to the full set of properties BUT overridden with any local properties set.
     * So the reference is resolved but overlaid with local TypoScript properties of the reference value.
     *
     * @param   array       The TypoScript array
     * @param   string      The property name: If this value is a reference (eg. " < plugins.tx_something") then the reference will be retrieved and inserted at that position (into the properties only, not the value...) AND overlaid with the old properties if any.
     * @return  array       The modified TypoScript array
     * @see user_plaintext::typolist(),user_plaintext::typohead()
     */
    function mergeTSRef($confArr, $prop) {
        if (substr($confArr[$prop], 0, 1) == '<') {
            $key = trim(substr($confArr[$prop], 1));
            $cF = t3lib_div::makeInstance('t3lib_TSparser');
            // $name and $conf is loaded with the referenced values.
            $old_conf = $confArr[$prop . '.'];
            list ($name, $conf) = $cF->getVal($key, $GLOBALS['TSFE']->tmpl->setup);
            if (is_array($old_conf) && count($old_conf)) {
                $conf = $this->joinTSarrays($conf, $old_conf);
            }
            $confArr[$prop . '.'] = $conf;
        }
        return $confArr;
    }

    /**
     * Merges two TypoScript propery array, overlaing the $old_conf onto the $conf array
     *
     * @param   array       TypoScript property array, the "base"
     * @param   array       TypoScript property array, the "overlay"
     * @return  array       The resulting array
     * @see mergeTSRef(), tx_tstemplatestyler_modfunc1::joinTSarrays()
     */
    function joinTSarrays($conf, $old_conf) {
        if (is_array($old_conf)) {
            foreach ($old_conf as $key => $val) {
                if (is_array($val)) {
                    $conf[$key] = $this->joinTSarrays($conf[$key], $val);
                } else {
                    $conf[$key] = $val;
                }
            }
        }
        return $conf;
    }

    /**
     * This function creates a number of TEXT-objects in a Gifbuilder configuration in order to create a text-field like thing. Used with the script tslib/media/scripts/postit.inc
     *
     * @param   array       TypoScript properties for Gifbuilder - TEXT GIFBUILDER objects are added to this array and returned.
     * @param   array       TypoScript properties for this function
     * @param   string      The text string to write onto the GIFBUILDER file
     * @return  array       The modified $gifbuilderConf array
     * @see media/scripts/postit.inc
     */
    function gifBuilderTextBox($gifbuilderConf, $conf, $text) {
        $chars = intval($conf['chars']) ? intval($conf['chars']) : 20;
        $lineDist = intval($conf['lineDist']) ? intval($conf['lineDist']) : 20;
        $Valign = strtolower(trim($conf['Valign']));
        $tmplObjNumber = intval($conf['tmplObjNumber']);
        $maxLines = intval($conf['maxLines']);

        if ($tmplObjNumber && $gifbuilderConf[$tmplObjNumber] == 'TEXT') {
            $textArr = $this->linebreaks($text, $chars, $maxLines);
            $angle = intval($gifbuilderConf[$tmplObjNumber . '.']['angle']);
            foreach ($textArr as $c => $textChunk) {
                $index = $tmplObjNumber + 1 + ($c * 2);
                    // Workarea
                $gifbuilderConf = $this->clearTSProperties($gifbuilderConf, $index);
                $rad_angle = 2 * pi() / 360 * $angle;
                $x_d = sin($rad_angle) * $lineDist;
                $y_d = cos($rad_angle) * $lineDist;

                $diff_x_d = 0;
                $diff_y_d = 0;
                if ($Valign == 'center') {
                    $diff_x_d = $x_d * count($textArr);
                    $diff_x_d = $diff_x_d / 2;
                    $diff_y_d = $y_d * count($textArr);
                    $diff_y_d = $diff_y_d / 2;
                }


                $x_d = round($x_d * $c - $diff_x_d);
                $y_d = round($y_d * $c - $diff_y_d);

                $gifbuilderConf[$index] = 'WORKAREA';
                $gifbuilderConf[$index . '.']['set'] = $x_d . ',' . $y_d;
                    // Text
                $index++;
                $gifbuilderConf = $this->clearTSProperties($gifbuilderConf, $index);
                $gifbuilderConf[$index] = 'TEXT';
                $gifbuilderConf[$index . '.'] = $this->clearTSProperties($gifbuilderConf[$tmplObjNumber . '.'], 'text');
                $gifbuilderConf[$index . '.']['text'] = $textChunk;
            }
            $gifbuilderConf = $this->clearTSProperties($gifbuilderConf, $tmplObjNumber);
        }
        return $gifbuilderConf;
    }

    /**
     * Splits a text string into lines and returns an array with these lines but a max number of lines.
     *
     * @param   string      The string to break
     * @param   integer     Max number of characters per line.
     * @param   integer     Max number of lines in all.
     * @return  array       array with lines.
     * @access private
     * @see gifBuilderTextBox()
     */
    function linebreaks($string, $chars, $maxLines = 0) {
        $lines = explode(LF, $string);
        $lineArr = array();
        $c = 0;
        foreach ($lines as $paragraph) {
            $words = explode(' ', $paragraph);
            foreach ($words as $word) {
                if (strlen($lineArr[$c] . $word) > $chars) {
                    $c++;
                }
                if (!$maxLines || $c < $maxLines) {
                    $lineArr[$c] .= $word . ' ';
                }
            }
            $c++;
        }
        return $lineArr;
    }

    /**
     * Returns a JavaScript <script> section with some function calls to JavaScript functions from "t3lib/jsfunc.updateform.js" (which is also included by setting a reference in $GLOBALS['TSFE']->additionalHeaderData['JSincludeFormupdate'])
     * The JavaScript codes simply transfers content into form fields of a form which is probably used for editing information by frontend users. Used by fe_adminLib.inc.
     *
     * @param   array       Data array which values to load into the form fields from $formName (only field names found in $fieldList)
     * @param   string      The form name
     * @param   string      A prefix for the data array
     * @param   string      The list of fields which are loaded
     * @return  string
     * @access private
     * @see user_feAdmin::displayCreateScreen()
     */
    function getUpdateJS($dataArray, $formName, $arrPrefix, $fieldList) {
        $JSPart = '';
        $updateValues = t3lib_div::trimExplode(',', $fieldList);
        foreach ($updateValues as $fKey) {
            $value = $dataArray[$fKey];
            if (is_array($value)) {
                foreach ($value as $Nvalue) {
                    $JSPart .= "
    updateForm('" . $formName . "','" . $arrPrefix . "[" . $fKey . "][]'," . t3lib_div::quoteJSvalue($Nvalue, TRUE) . ");";
                }

            } else {
                $JSPart .= "
    updateForm('" . $formName . "','" . $arrPrefix . "[" . $fKey . "]'," . t3lib_div::quoteJSvalue($value, TRUE) . ");";
            }
        }
        $JSPart = '<script type="text/javascript">
    /*<![CDATA[*/ ' . $JSPart . '
    /*]]>*/
</script>
';
        $GLOBALS['TSFE']->additionalHeaderData['JSincludeFormupdate'] = '<script type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename($GLOBALS['TSFE']->absRefPrefix . 't3lib/jsfunc.updateform.js') . '"></script>';
        return $JSPart;
    }

    /**
     * Includes resources if the config property 'includeLibs' is set.
     *
     * @param   array       $config: TypoScript configuration
     * @return  boolean     Whether a configuration for including libs was found and processed
     */
    public function includeLibs(array $config) {
        $librariesIncluded = FALSE;

        if (isset($config['includeLibs']) && $config['includeLibs']) {
            $libraries = t3lib_div::trimExplode(',', $config['includeLibs'], TRUE);
            $GLOBALS['TSFE']->includeLibraries($libraries);
            $librariesIncluded = TRUE;
        }

        return $librariesIncluded;
    }

    /**
     * Checks whether a PHP class is available. If the check fails, the method tries to
     * determine the correct includeLibs to make the class available automatically.
     *
     * TypoScript example that can cause this:
     * | plugin.tx_myext_pi1 = USER
     * | plugin.tx_myext_pi1 {
     * |   includeLibs = EXT:myext/pi1/class.tx_myext_pi1.php
     * |   userFunc = tx_myext_pi1->main
     * | }
     * | 10 = USER
     * | 10.userFunc = tx_myext_pi1->renderHeader
     *
     * @param   string      $className: The name of the PHP class to be checked
     * @param   array       $config: TypoScript configuration (naturally of a USER or COA cObject)
     * @return  boolean     Whether the class is available
     * @link    http://bugs.typo3.org/view.php?id=9654
     * @TODO    This method was introduced in TYPO3 4.3 and can be removed if the autoload was integrated
     */
    protected function isClassAvailable($className, array $config = NULL) {
        if (class_exists($className)) {
            return TRUE;
        } elseif ($config) {
            $pluginConfiguration = & $GLOBALS['TSFE']->tmpl->setup['plugin.'][$className . '.'];
            if (isset($pluginConfiguration['includeLibs']) && $pluginConfiguration['includeLibs']) {
                $config['includeLibs'] = $pluginConfiguration['includeLibs'];
                return $this->includeLibs($config);
            }
        }
        return FALSE;
    }



    /***********************************************
     *
     * Database functions, making of queries
     *
     ***********************************************/

    /**
     * Returns an UPDATE/DELETE sql query which will "delete" the record.
     * If the $TCA config for the table tells us to NOT "physically" delete the record but rather set the "deleted" field to "1" then an UPDATE query is returned doing just that. Otherwise it truely is a DELETE query.
     *
     * @param   string      The table name, should be in $TCA
     * @param   integer     The UID of the record from $table which we are going to delete
     * @param   boolean     If set, the query is executed. IT'S HIGHLY RECOMMENDED TO USE THIS FLAG to execute the query directly!!!
     * @return  string      The query, ready to execute unless $doExec was TRUE in which case the return value is FALSE.
     * @see DBgetUpdate(), DBgetInsert(), user_feAdmin
     */
    function DBgetDelete($table, $uid, $doExec = FALSE) {
        if (intval($uid)) {
            if ($GLOBALS['TCA'][$table]['ctrl']['delete']) {
                if ($doExec) {
                    return $GLOBALS['TYPO3_DB']->exec_UPDATEquery($table, 'uid=' . intval($uid), array(
                        $GLOBALS['TCA'][$table]['ctrl']['delete'] => 1
                    ));
                } else {
                    return $GLOBALS['TYPO3_DB']->UPDATEquery($table, 'uid=' . intval($uid), array(
                        $GLOBALS['TCA'][$table]['ctrl']['delete'] => 1
                    ));
                }
            } else {
                if ($doExec) {
                    return $GLOBALS['TYPO3_DB']->exec_DELETEquery($table, 'uid=' . intval($uid));
                } else {
                    return $GLOBALS['TYPO3_DB']->DELETEquery($table, 'uid=' . intval($uid));
                }
            }
        }
    }

    /**
     * Returns an UPDATE sql query.
     * If a "tstamp" field is configured for the $table tablename in $TCA then that field is automatically updated to the current time.
     * Notice: It is YOUR responsibility to make sure the data being updated is valid according the tablefield types etc. Also no logging is performed of the update. It's just a nice general usage API function for creating a quick query.
     * NOTICE: From TYPO3 3.6.0 this function ALWAYS adds slashes to values inserted in the query.
     *
     * @param   string      The table name, should be in $TCA
     * @param   integer     The UID of the record from $table which we are going to update
     * @param   array       The data array where key/value pairs are fieldnames/values for the record to update.
     * @param   string      Comma list of fieldnames which are allowed to be updated. Only values from the data record for fields in this list will be updated!!
     * @param   boolean     If set, the query is executed. IT'S HIGHLY RECOMMENDED TO USE THIS FLAG to execute the query directly!!!
     * @return  string      The query, ready to execute unless $doExec was TRUE in which case the return value is FALSE.
     * @see DBgetInsert(), DBgetDelete(), user_feAdmin
     */
    function DBgetUpdate($table, $uid, $dataArr, $fieldList, $doExec = FALSE) {
        unset($dataArr['uid']); // uid can never be set
        $uid = intval($uid);

        if ($uid) {
            $fieldList = implode(',', t3lib_div::trimExplode(',', $fieldList, 1));
            $updateFields = array();

            foreach ($dataArr as $f => $v) {
                if (t3lib_div::inList($fieldList, $f)) {
                    $updateFields[$f] = $v;
                }
            }

            if ($GLOBALS['TCA'][$table]['ctrl']['tstamp']) {
                $updateFields[$GLOBALS['TCA'][$table]['ctrl']['tstamp']] = $GLOBALS['EXEC_TIME'];
            }

            if (count($updateFields)) {
                if ($doExec) {
                    return $GLOBALS['TYPO3_DB']->exec_UPDATEquery($table, 'uid=' . intval($uid), $updateFields);
                } else {
                    return $GLOBALS['TYPO3_DB']->UPDATEquery($table, 'uid=' . intval($uid), $updateFields);
                }
            }
        }
    }

    /**
     * Returns an INSERT sql query which automatically added "system-fields" according to $TCA
     * Automatically fields for "tstamp", "crdate", "cruser_id", "fe_cruser_id" and "fe_crgroup_id" is updated if they are configured in the "ctrl" part of $TCA.
     * The "pid" field is overridden by the input $pid value if >= 0 (zero). "uid" can never be set as a field
     * NOTICE: From TYPO3 3.6.0 this function ALWAYS adds slashes to values inserted in the query.
     *
     * @param   string      The table name, should be in $TCA
     * @param   integer     The PID value for the record to insert
     * @param   array       The data array where key/value pairs are fieldnames/values for the record to insert
     * @param   string      Comma list of fieldnames which are allowed to be inserted. Only values from the data record for fields in this list will be inserted!!
     * @param   boolean     If set, the query is executed. IT'S HIGHLY RECOMMENDED TO USE THIS FLAG to execute the query directly!!!
     * @return  string      The query, ready to execute unless $doExec was TRUE in which case the return value is FALSE.
     * @see DBgetUpdate(), DBgetDelete(), user_feAdmin
     */
    function DBgetInsert($table, $pid, $dataArr, $fieldList, $doExec = FALSE) {
        $extraList = 'pid';
        if ($GLOBALS['TCA'][$table]['ctrl']['tstamp']) {
            $field = $GLOBALS['TCA'][$table]['ctrl']['tstamp'];
            $dataArr[$field] = $GLOBALS['EXEC_TIME'];
            $extraList .= ',' . $field;
        }
        if ($GLOBALS['TCA'][$table]['ctrl']['crdate']) {
            $field = $GLOBALS['TCA'][$table]['ctrl']['crdate'];
            $dataArr[$field] = $GLOBALS['EXEC_TIME'];
            $extraList .= ',' . $field;
        }
        if ($GLOBALS['TCA'][$table]['ctrl']['cruser_id']) {
            $field = $GLOBALS['TCA'][$table]['ctrl']['cruser_id'];
            $dataArr[$field] = 0;
            $extraList .= ',' . $field;
        }
        if ($GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id']) {
            $field = $GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id'];
            $dataArr[$field] = intval($GLOBALS['TSFE']->fe_user->user['uid']);
            $extraList .= ',' . $field;
        }
        if ($GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id']) {
            $field = $GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id'];
            list ($dataArr[$field]) = explode(',', $GLOBALS['TSFE']->fe_user->user['usergroup']);
            $dataArr[$field] = intval($dataArr[$field]);
            $extraList .= ',' . $field;
        }

        unset($dataArr['uid']); // uid can never be set
        if ($pid >= 0) {
            $dataArr['pid'] = $pid;
        } // Set pid < 0 and the dataarr-pid will be used!
        $fieldList = implode(',', t3lib_div::trimExplode(',', $fieldList . ',' . $extraList, 1));

        $insertFields = array();
        foreach ($dataArr as $f => $v) {
            if (t3lib_div::inList($fieldList, $f)) {
                $insertFields[$f] = $v;
            }
        }

        if ($doExec) {
            return $GLOBALS['TYPO3_DB']->exec_INSERTquery($table, $insertFields);
        } else {
            return $GLOBALS['TYPO3_DB']->INSERTquery($table, $insertFields);
        }
    }

    /**
     * Checks if a frontend user is allowed to edit a certain record
     *
     * @param   string      The table name, found in $TCA
     * @param   array       The record data array for the record in question
     * @param   array       The array of the fe_user which is evaluated, typ. $GLOBALS['TSFE']->fe_user->user
     * @param   string      Commalist of the only fe_groups uids which may edit the record. If not set, then the usergroup field of the fe_user is used.
     * @param   boolean     True, if the fe_user may edit his own fe_user record.
     * @return  boolean
     * @see user_feAdmin
     */
    function DBmayFEUserEdit($table, $row, $feUserRow, $allowedGroups = '', $feEditSelf = 0) {
        $groupList = $allowedGroups
            ? implode(',', array_intersect(
                    t3lib_div::trimExplode(',', $feUserRow['usergroup'], 1),
                    t3lib_div::trimExplode(',', $allowedGroups, 1)
            ))
            : $feUserRow['usergroup'];
        $ok = 0;
            // points to the field that allows further editing from frontend if not set. If set the record is locked.
        if (!$GLOBALS['TCA'][$table]['ctrl']['fe_admin_lock'] || !$row[$GLOBALS['TCA'][$table]['ctrl']['fe_admin_lock']]) {
                // points to the field (integer) that holds the fe_users-id of the creator fe_user
            if ($GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id']) {
                $rowFEUser = intval($row[$GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id']]);
                if ($rowFEUser && $rowFEUser == $feUserRow['uid']) {
                    $ok = 1;
                }
            }
                // If $feEditSelf is set, fe_users may always edit them selves...
            if ($feEditSelf && $table == 'fe_users' && !strcmp($feUserRow['uid'], $row['uid'])) {
                $ok = 1;
            }
                // points to the field (integer) that holds the fe_group-id of the creator fe_user's first group
            if ($GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id']) {
                $rowFEUser = intval($row[$GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id']]);
                if ($rowFEUser) {
                    if (t3lib_div::inList($groupList, $rowFEUser)) {
                        $ok = 1;
                    }
                }
            }
        }
        return $ok;
    }

    /**
     * Returns part of a where clause for selecting records from the input table name which the user may edit.
     * Conceptually close to the function DBmayFEUserEdit(); It does the same thing but not for a single record,
     * rather for a select query selecting all records which the user HAS access to.
     *
     * @param   string      The table name
     * @param   array       The array of the fe_user which is evaluated, typ. $GLOBALS['TSFE']->fe_user->user
     * @param   string      Commalist of the only fe_groups uids which may edit the record. If not set, then the usergroup field of the fe_user is used.
     * @param   boolean     True, if the fe_user may edit his own fe_user record.
     * @return  string      The where clause part. ALWAYS returns a string. If no access at all, then " AND 1=0"
     * @see DBmayFEUserEdit(), user_feAdmin::displayEditScreen()
     */
    function DBmayFEUserEditSelect($table, $feUserRow, $allowedGroups = '', $feEditSelf = 0) {
            // Returns where-definition that selects user-editable records.
        $groupList = $allowedGroups ? implode(',', array_intersect(t3lib_div::trimExplode(',', $feUserRow['usergroup'], 1), t3lib_div::trimExplode(',', $allowedGroups, 1))) : $feUserRow['usergroup'];
        $OR_arr = array();
            // points to the field (integer) that holds the fe_users-id of the creator fe_user
        if ($GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id']) {
            $OR_arr[] = $GLOBALS['TCA'][$table]['ctrl']['fe_cruser_id'] . '=' . $feUserRow['uid'];
        }
            // points to the field (integer) that holds the fe_group-id of the creator fe_user's first group
        if ($GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id']) {
            $values = t3lib_div::intExplode(',', $groupList);
            foreach ($values as $theGroupUid) {
                if ($theGroupUid) {
                    $OR_arr[] = $GLOBALS['TCA'][$table]['ctrl']['fe_crgroup_id'] . '=' . $theGroupUid;
                }
            }
        }
            // If $feEditSelf is set, fe_users may always edit them selves...
        if ($feEditSelf && $table == 'fe_users') {
            $OR_arr[] = 'uid=' . intval($feUserRow['uid']);
        }

        $whereDef = ' AND 1=0';
        if (count($OR_arr)) {
            $whereDef = ' AND (' . implode(' OR ', $OR_arr) . ')';
            if ($GLOBALS['TCA'][$table]['ctrl']['fe_admin_lock']) {
                $whereDef .= ' AND ' . $GLOBALS['TCA'][$table]['ctrl']['fe_admin_lock'] . '=0';
            }
        }
        return $whereDef;
    }

    /**
     * Returns a part of a WHERE clause which will filter out records with start/end times or hidden/fe_groups fields
     * set to values that should de-select them according to the current time, preview settings or user login.
     * Definitely a frontend function.
     * THIS IS A VERY IMPORTANT FUNCTION: Basically you must add the output from this function for EVERY select query you create
     * for selecting records of tables in your own applications - thus they will always be filtered according to the "enablefields"
     * configured in TCA
     * Simply calls t3lib_pageSelect::enableFields() BUT will send the show_hidden flag along!
     * This means this function will work in conjunction with the preview facilities of the frontend engine/Admin Panel.
     *
     * @param   string      The table for which to get the where clause
     * @param   boolean     If set, then you want NOT to filter out hidden records. Otherwise hidden record are filtered based on the current preview settings.
     * @return  string      The part of the where clause on the form " AND [fieldname]=0 AND ...". Eg. " AND hidden=0 AND starttime < 123345567"
     * @see t3lib_pageSelect::enableFields()
     */
    function enableFields($table, $show_hidden = 0) {
        return $GLOBALS['TSFE']->sys_page->enableFields(
            $table,
            $show_hidden ? $show_hidden : ($table == 'pages' ? $GLOBALS['TSFE']->showHiddenPage : $GLOBALS['TSFE']->showHiddenRecords)
        );
    }

    /**
     * Generates a list of Page-uid's from $id. List does not include $id itself
     * (unless the id specified is negative in which case it does!)
     * The only pages WHICH PREVENTS DECENDING in a branch are
     * - deleted pages,
     * - pages in a recycler (doktype = 255) or of the Backend User Section (doktpe = 6) type
     * - pages that has the extendToSubpages set, WHERE start/endtime, hidden
     * and fe_users would hide the records.
     * Apart from that, pages with enable-fields excluding them, will also be
     * removed. HOWEVER $dontCheckEnableFields set will allow
     * enableFields-excluded pages to be included anyway - including
     * extendToSubpages sections!
     * Mount Pages are also descended but notice that these ID numbers are not
     * useful for links unless the correct MPvar is set.
     *
     * @param   integer     The id of the start page from which point in the page tree to decend. IF NEGATIVE the id itself is included in the end of the list (only if $begin is 0) AND the output does NOT contain a last comma. Recommended since it will resolve the input ID for mount pages correctly and also check if the start ID actually exists!
     * @param   integer     The number of levels to decend. If you want to decend infinitely, just set this to 100 or so. Should be at least "1" since zero will just make the function return (no decend...)
     * @param   integer     $begin is an optional integer that determines at which level in the tree to start collecting uid's. Zero means 'start right away', 1 = 'next level and out'
     * @param   boolean     See function description
     * @param   string      Additional fields to select. Syntax: ",[fieldname],[fieldname],..."
     * @param   string      Additional where clauses. Syntax: " AND [fieldname]=[value] AND ..."
     * @param   array       array of IDs from previous recursions. In order to prevent infinite loops with mount pages.
     * @param   integer     Internal: Zero for the first recursion, incremented for each recursive call.
     * @return  string      Returns the list with a comma in the end (if any pages selected and not if $id is negative and $id is added itself) - which means the input page id can comfortably be appended to the output string if you need it to.
     * @see tslib_fe::checkEnableFields(), tslib_fe::checkPagerecordForIncludeSection()
     */
    public function getTreeList($id, $depth, $begin = 0, $dontCheckEnableFields = FALSE, $addSelectFields = '', $moreWhereClauses = '', array $prevId_array = array(), $recursionLevel = 0) {

            // Init vars:
        $allFields = 'uid,hidden,starttime,endtime,fe_group,extendToSubpages,doktype,php_tree_stop,mount_pid,mount_pid_ol,t3ver_state' .
            $addSelectFields;
        $depth = intval($depth);
        $begin = intval($begin);
        $id = intval($id);
        $theList = '';
        $addId = 0;
        $requestHash = '';

        if ($id) {

                // First level, check id (second level, this is done BEFORE the recursive call)
            if (!$recursionLevel) {

                    // check tree list cache

                    // first, create the hash for this request - not sure yet whether we need all these parameters though
                $parameters = array(
                    $id,
                    $depth,
                    $begin,
                    $dontCheckEnableFields,
                    $addSelectFields,
                    $moreWhereClauses,
                    $prevId_array,
                    $GLOBALS['TSFE']->gr_list
                );
                $requestHash = md5(serialize($parameters));

                $cacheEntry = $GLOBALS['TYPO3_DB']->exec_SELECTgetSingleRow(
                    'treelist',
                    'cache_treelist',
                    'md5hash = \'' . $requestHash . '\' AND ( expires > ' . $GLOBALS['EXEC_TIME'] .
                    ' OR expires = 0 )'
                );

                if (is_array($cacheEntry)) {
                        // cache hit
                    return $cacheEntry['treelist'];
                }

                    // If Id less than zero it means we should add the real id to list:
                if ($id < 0) {
                    $addId = $id = abs($id);
                }
                    // Check start page:
                if ($GLOBALS['TSFE']->sys_page->getRawRecord('pages', $id, 'uid')) {

                        // Find mount point if any:
                    $mount_info = $GLOBALS['TSFE']->sys_page->getMountPointInfo($id);
                    if (is_array($mount_info)) {
                        $id = $mount_info['mount_pid'];
                            // In Overlay mode, use the mounted page uid as added ID!:
                        if ($addId && $mount_info['overlay']) {
                            $addId = $id;
                        }
                    }
                } else {
                    return ''; // Return blank if the start page was NOT found at all!
                }
            }

                // Add this ID to the array of IDs
            if ($begin <= 0) {
                $prevId_array[] = $id;
            }

                // Select sublevel:
            if ($depth > 0) {
                $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
                    $allFields,
                    'pages',
                    'pid = ' . intval($id) . ' AND deleted = 0 ' . $moreWhereClauses, '', 'sorting'
                );

                while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
                    $GLOBALS['TSFE']->sys_page->versionOL('pages', $row);

                    if ($row['doktype'] == t3lib_pageSelect::DOKTYPE_RECYCLER || $row['doktype'] == t3lib_pageSelect::DOKTYPE_BE_USER_SECTION || $row['t3ver_state'] > 0) {
                            // Doing this after the overlay to make sure changes
                            // in the overlay are respected.
                            // However, we do not process pages below of and
                            // including of type recycler and BE user section
                        continue;
                    }

                        // Find mount point if any:
                    $next_id = $row['uid'];
                    $mount_info = $GLOBALS['TSFE']->sys_page->getMountPointInfo($next_id, $row);

                        // Overlay mode:
                    if (is_array($mount_info) && $mount_info['overlay']) {
                        $next_id = $mount_info['mount_pid'];

                        $res2 = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
                            $allFields,
                            'pages',
                            'uid = ' . intval($next_id) . ' AND deleted = 0 ' . $moreWhereClauses,
                            '',
                            'sorting'
                        );
                        $row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res2);
                        $GLOBALS['TYPO3_DB']->sql_free_result($res2);

                        $GLOBALS['TSFE']->sys_page->versionOL('pages', $row);

                        if ($row['doktype'] == t3lib_pageSelect::DOKTYPE_RECYCLER || $row['doktype'] == t3lib_pageSelect::DOKTYPE_BE_USER_SECTION || $row['t3ver_state'] > 0) {
                                // Doing this after the overlay to make sure
                                // changes in the overlay are respected.

                                // see above
                            continue;
                        }
                    }
                        // Add record:
                    if ($dontCheckEnableFields || $GLOBALS['TSFE']->checkPagerecordForIncludeSection($row)) {
                            // Add ID to list:
                        if ($begin <= 0) {
                            if ($dontCheckEnableFields || $GLOBALS['TSFE']->checkEnableFields($row)) {
                                $theList .= $next_id . ',';
                            }
                        }
                            // Next level:
                        if ($depth > 1 && !$row['php_tree_stop']) {
                                // Normal mode:
                            if (is_array($mount_info) && !$mount_info['overlay']) {
                                $next_id = $mount_info['mount_pid'];
                            }
                                // Call recursively, if the id is not in prevID_array:
                            if (!in_array($next_id, $prevId_array)) {
                                $theList .= tslib_cObj::getTreeList(
                                    $next_id,
                                    $depth - 1,
                                    $begin - 1,
                                    $dontCheckEnableFields,
                                    $addSelectFields,
                                    $moreWhereClauses,
                                    $prevId_array,
                                    $recursionLevel + 1
                                );
                            }
                        }
                    }
                }
                $GLOBALS['TYPO3_DB']->sql_free_result($res);
            }

                // If first run, check if the ID should be returned:
            if (!$recursionLevel) {
                if ($addId) {
                    if ($begin > 0) {
                        $theList .= 0;
                    } else {
                        $theList .= $addId;
                    }
                }

                $GLOBALS['TYPO3_DB']->exec_INSERTquery(
                    'cache_treelist',
                    array(
                        'md5hash' => $requestHash,
                        'pid' => $id,
                        'treelist' => $theList,
                        'tstamp' => $GLOBALS['EXEC_TIME']
                    )
                );
            }
        }
            // Return list:
        return $theList;
    }

    /**
     * Executes a SELECT query for joining three tables according to the MM-relation standards used for tables configured in $TCA. That means MM-joins where the join table has the fields "uid_local" and "uid_foreign"
     *
     * @param   string      List of fields to select
     * @param   string      The local table
     * @param   string      The join-table; The "uid_local" field of this table will be matched with $local_table's "uid" field.
     * @param   string      Optionally: The foreign table; The "uid" field of this table will be matched with $mm_table's "uid_foreign" field. If you set this field to blank the join will be over only the $local_table and $mm_table
     * @param   string      Optional additional WHERE clauses put in the end of the query. DO NOT PUT IN GROUP BY, ORDER BY or LIMIT!
     * @param   string      Optional GROUP BY field(s), if none, supply blank string.
     * @param   string      Optional ORDER BY field(s), if none, supply blank string.
     * @param   string      Optional LIMIT value ([begin,]max), if none, supply blank string.
     * @return  pointer     SQL result pointer
     * @see mm_query_uidList()
     */
    function exec_mm_query($select, $local_table, $mm_table, $foreign_table, $whereClause = '', $groupBy = '', $orderBy = '', $limit = '') {
        return $GLOBALS['TYPO3_DB']->exec_SELECTquery(
            $select,
            $local_table . ',' . $mm_table . ($foreign_table ? ',' . $foreign_table : ''),
            $local_table . '.uid=' . $mm_table . '.uid_local' .
                ($foreign_table ? ' AND ' . $foreign_table . '.uid=' . $mm_table . '.uid_foreign' : '') .
                $whereClause, // whereClauseMightContainGroupOrderBy
            $groupBy,
            $orderBy,
            $limit
        );
    }

    /**
     * Executes a SELECT query for joining two tables according to the MM-relation standards used for tables configured in $TCA. That means MM-joins where the join table has the fields "uid_local" and "uid_foreign"
     * The two tables joined is the join table ($mm_table) and the foreign table ($foreign_table) - so the "local table" is not included but instead you can supply a list of UID integers from the local table to match in the join-table.
     *
     * @param   string      List of fields to select
     * @param   string      List of UID integers, eg. "1,2,3,456"
     * @param   string      The join-table; The "uid_local" field of this table will be matched with the list of UID numbers from $local_table_uidlist
     * @param   string      Optionally: The foreign table; The "uid" field of this table will be matched with $mm_table's "uid_foreign" field. If you set this field to blank only records from the $mm_table is returned. No join performed.
     * @param   string      Optional additional WHERE clauses put in the end of the query. DO NOT PUT IN GROUP BY, ORDER BY or LIMIT!
     * @param   string      Optional GROUP BY field(s), if none, supply blank string.
     * @param   string      Optional ORDER BY field(s), if none, supply blank string.
     * @param   string      Optional LIMIT value ([begin,]max), if none, supply blank string.
     * @return  pointer     SQL result pointer
     * @see mm_query()
     */
    function exec_mm_query_uidList($select, $local_table_uidlist, $mm_table, $foreign_table = '', $whereClause = '', $groupBy = '', $orderBy = '', $limit = '') {
        return $GLOBALS['TYPO3_DB']->exec_SELECTquery(
            $select,
            $mm_table . ($foreign_table ? ',' . $foreign_table : ''),
            $mm_table . '.uid_local IN (' . $local_table_uidlist . ')' .
                ($foreign_table ? ' AND ' . $foreign_table . '.uid=' . $mm_table . '.uid_foreign' : '') .
                $whereClause, // whereClauseMightContainGroupOrderBy
            $groupBy,
            $orderBy,
            $limit
        );
    }

    /**
     * Generates a search where clause based on the input search words (AND operation - all search words must be found in record.)
     * Example: The $sw is "content management, system" (from an input form) and the $searchFieldList is "bodytext,header" then the output will be ' AND (bodytext LIKE "%content%" OR header LIKE "%content%") AND (bodytext LIKE "%management%" OR header LIKE "%management%") AND (bodytext LIKE "%system%" OR header LIKE "%system%")'
     *
     * @param   string      The search words. These will be separated by space and comma.
     * @param   string      The fields to search in
     * @param   string      The table name you search in (recommended for DBAL compliance. Will be prepended field names as well)
     * @return  string      The WHERE clause.
     */
    function searchWhere($sw, $searchFieldList, $searchTable = '') {
        global $TYPO3_DB;

        $prefixTableName = $searchTable ? $searchTable . '.' : '';
        $where = '';
        if ($sw) {
            $searchFields = explode(',', $searchFieldList);
            $kw = preg_split('/[ ,]/', $sw);

            foreach ($kw as $val) {
                $val = trim($val);
                $where_p = array();
                if (strlen($val) >= 2) {
                    $val = $TYPO3_DB->escapeStrForLike($TYPO3_DB->quoteStr($val, $searchTable), $searchTable);
                    foreach ($searchFields as $field) {
                        $where_p[] = $prefixTableName . $field . ' LIKE \'%' . $val . '%\'';
                    }
                }
                if (count($where_p)) {
                    $where .= ' AND (' . implode(' OR ', $where_p) . ')';
                }
            }
        }
        return $where;
    }

    /**
     * Executes a SELECT query for records from $table and with conditions based on the configuration in the $conf array
     * This function is preferred over ->getQuery() if you just need to create and then execute a query.
     *
     * @param   string      The table name
     * @param   array       The TypoScript configuration properties
     * @return  mixed       A SQL result pointer
     * @see getQuery()
     */
    function exec_getQuery($table, $conf) {
        $queryParts = $this->getQuery($table, $conf, TRUE);

        return $GLOBALS['TYPO3_DB']->exec_SELECT_queryArray($queryParts);
    }

    /**
     * Creates and returns a SELECT query for records from $table and with conditions based on the configuration in the $conf array
     * Implements the "select" function in TypoScript
     *
     * @param   string      See ->exec_getQuery()
     * @param   array       See ->exec_getQuery()
     * @param   boolean     If set, the function will return the query not as a string but array with the various parts. RECOMMENDED!
     * @return  mixed       A SELECT query if $returnQueryArray is FALSE, otherwise the SELECT query in an array as parts.
     * @access private
     * @see CONTENT(), numRows()
     */
    function getQuery($table, $conf, $returnQueryArray = FALSE) {

            // Handle PDO-style named parameter markers first
        $queryMarkers = $this->getQueryMarkers($table, $conf);

            // replace the markers in the non-stdWrap properties
        foreach ($queryMarkers as $marker => $markerValue) {
            $properties = array(
                'uidInList', 'selectFields', 'where', 'max', 'begin', 'groupBy', 'orderBy', 'join', 'leftjoin', 'rightjoin'
            );
            foreach ($properties as $property) {
                if ($conf[$property]) {
                    $conf[$property] = str_replace('###' . $marker . '###', $markerValue, $conf[$property]);
                }
            }
        }

            // Construct WHERE clause:
        $conf['pidInList'] = isset($conf['pidInList.'])
            ? trim($this->stdWrap($conf['pidInList'], $conf['pidInList.']))
            : trim($conf['pidInList']);

            // Handle recursive function for the pidInList
        if (isset($conf['recursive'])) {
            $conf['recursive'] = intval($conf['recursive']);
            if ($conf['recursive'] > 0) {
                foreach (explode(',', $conf['pidInList']) as $value) {
                    if ($value === 'this') {
                        $value = $GLOBALS['TSFE']->id;
                    }
                    $pidList .= $value . ',' . $this->getTreeList($value, $conf['recursive']);
                }
                $conf['pidInList'] = trim($pidList, ',');
            }
        }

        if (!strcmp($conf['pidInList'], '')) {
            $conf['pidInList'] = 'this';
        }
        $queryParts = $this->getWhere($table, $conf, TRUE);

            // Fields:
        $queryParts['SELECT'] = $conf['selectFields'] ? $conf['selectFields'] : '*';

            // Setting LIMIT:
        if ($conf['max'] || $conf['begin']) {
            $error = 0;

            // Finding the total number of records, if used:
            if (strstr(strtolower($conf['begin'] . $conf['max']), 'total')) {
                $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('count(*)', $table, $queryParts['WHERE'], $queryParts['GROUPBY']);
                if ($error = $GLOBALS['TYPO3_DB']->sql_error()) {
                    $GLOBALS['TT']->setTSlogMessage($error);
                } else {
                    $row = $GLOBALS['TYPO3_DB']->sql_fetch_row($res);
                    $conf['max'] = str_ireplace('total', $row[0], $conf['max']);
                    $conf['begin'] = str_ireplace('total', $row[0], $conf['begin']);
                }
                $GLOBALS['TYPO3_DB']->sql_free_result($res);
            }
            if (!$error) {
                $conf['begin'] = t3lib_div::intInRange(ceil($this->calc($conf['begin'])), 0);
                $conf['max'] = t3lib_div::intInRange(ceil($this->calc($conf['max'])), 0);
                if ($conf['begin'] && !$conf['max']) {
                    $conf['max'] = 100000;
                }

                if ($conf['begin'] && $conf['max']) {
                    $queryParts['LIMIT'] = $conf['begin'] . ',' . $conf['max'];
                } elseif (!$conf['begin'] && $conf['max']) {
                    $queryParts['LIMIT'] = $conf['max'];
                }
            }
        }

        if (!$error) {

                // Setting up tablejoins:
            $joinPart = '';
            if ($conf['join']) {
                $joinPart = 'JOIN ' . trim($conf['join']);
            } elseif ($conf['leftjoin']) {
                $joinPart = 'LEFT OUTER JOIN ' . trim($conf['leftjoin']);
            } elseif ($conf['rightjoin']) {
                $joinPart = 'RIGHT OUTER JOIN ' . trim($conf['rightjoin']);
            }

                // Compile and return query:
            $queryParts['FROM'] = trim($table . ' ' . $joinPart);

                // replace the markers in the queryParts to handle stdWrap
                // enabled properties
            foreach ($queryMarkers as $marker => $markerValue) {
                foreach ($queryParts as $queryPartKey => &$queryPartValue) {
                    $queryPartValue = str_replace('###' . $marker . '###', $markerValue, $queryPartValue);
                }
            }

            $query = $GLOBALS['TYPO3_DB']->SELECTquery(
                $queryParts['SELECT'],
                $queryParts['FROM'],
                $queryParts['WHERE'],
                $queryParts['GROUPBY'],
                $queryParts['ORDERBY'],
                $queryParts['LIMIT']
            );

            return $returnQueryArray ? $queryParts : $query;
        }
    }

    /**
     * Helper function for getQuery(), creating the WHERE clause of the SELECT query
     *
     * @param   string      The table name
     * @param   array       The TypoScript configuration properties
     * @param   boolean     If set, the function will return the query not as a string but array with the various parts. RECOMMENDED!
     * @return  mixed       A WHERE clause based on the relevant parts of the TypoScript properties for a "select" function in TypoScript, see link. If $returnQueryArray is FALSE the where clause is returned as a string with WHERE, GROUP BY and ORDER BY parts, otherwise as an array with these parts.
     * @access private
     * @see getQuery()
     */
    function getWhere($table, $conf, $returnQueryArray = FALSE) {
        global $TCA;

        // Init:
        $query = '';
        $pid_uid_flag = 0;
        $queryParts = array(
            'SELECT' => '',
            'FROM' => '',
            'WHERE' => '',
            'GROUPBY' => '',
            'ORDERBY' => '',
            'LIMIT' => ''
        );

        if (trim($conf['uidInList'])) {
            $listArr = t3lib_div::intExplode(',', str_replace('this', $GLOBALS['TSFE']->contentPid, $conf['uidInList']));
            if (count($listArr) == 1) {
                $query .= ' AND ' . $table . '.uid=' . intval($listArr[0]);
            } else {
                $query .= ' AND ' . $table . '.uid IN (' . implode(',', $GLOBALS['TYPO3_DB']->cleanIntArray($listArr)) . ')';
            }
            $pid_uid_flag++;
        }
            // static_* tables are allowed to be fetched from root page
        if (substr($table, 0, 7) == 'static_') {
            $pid_uid_flag++;
        }
        if (trim($conf['pidInList'])) {
            $listArr = t3lib_div::intExplode(',', str_replace('this', $GLOBALS['TSFE']->contentPid, $conf['pidInList']));
                // removes all pages which are not visible for the user!
            $listArr = $this->checkPidArray($listArr);
            if (count($listArr)) {
                $query .= ' AND ' . $table . '.pid IN (' . implode(',', $GLOBALS['TYPO3_DB']->cleanIntArray($listArr)) . ')';
                $pid_uid_flag++;
            } else {
                $pid_uid_flag = 0; // If not uid and not pid then uid is set to 0 - which results in nothing!!
            }
        }
        if (!$pid_uid_flag) { // If not uid and not pid then uid is set to 0 - which results in nothing!!
            $query .= ' AND ' . $table . '.uid=0';
        }
        if ($where = trim($conf['where'])) {
            $query .= ' AND ' . $where;
        }

        if ($conf['languageField']) {
            if ($GLOBALS['TSFE']->sys_language_contentOL && $TCA[$table] && $TCA[$table]['ctrl']['languageField']
                && $TCA[$table]['ctrl']['transOrigPointerField']) {
                    // Sys language content is set to zero/-1 - and it is expected that whatever routine processes the output will
                    // OVERLAY the records with localized versions!
                $sys_language_content = '0,-1';
            } else {
                $sys_language_content = intval($GLOBALS['TSFE']->sys_language_content);
            }
            $query .= ' AND ' . $conf['languageField'] . ' IN (' . $sys_language_content . ')';
        }

        $andWhere = isset($conf['andWhere.'])
            ? trim($this->stdWrap($conf['andWhere'], $conf['andWhere.']))
            : trim($conf['andWhere']);
        if ($andWhere) {
            $query .= ' AND ' . $andWhere;
        }

            // enablefields
        if ($table == 'pages') {
            $query .= ' ' . $GLOBALS['TSFE']->sys_page->where_hid_del . $GLOBALS['TSFE']->sys_page->where_groupAccess;
        } else {
            $query .= $this->enableFields($table);
        }

            // MAKE WHERE:
        if ($query) {
            $queryParts['WHERE'] = trim(substr($query, 4)); // Stripping of " AND"...
            $query = 'WHERE ' . $queryParts['WHERE'];
        }

            // GROUP BY
        if (trim($conf['groupBy'])) {
            $queryParts['GROUPBY'] = isset($conf['groupBy.'])
                ? trim($this->stdWrap($conf['groupBy'], $conf['groupBy.']))
                : trim($conf['groupBy']);
        }

            // ORDER BY
        if (trim($conf['orderBy'])) {
            $queryParts['ORDERBY'] = isset($conf['orderBy.'])
                ? trim($this->stdWrap($conf['orderBy'], $conf['orderBy.']))
                : trim($conf['orderBy']);
            $query .= ' ORDER BY ' . $queryParts['ORDERBY'];
        }

            // Return result:
        return $returnQueryArray ? $queryParts : $query;
    }

    /**
     * Removes Page UID numbers from the input array which are not available due to enableFields() or the list of bad doktype numbers ($this->checkPid_badDoktypeList)
     *
     * @param   array       array of Page UID numbers for select and for which pages with enablefields and bad doktypes should be removed.
     * @return  array       Returns the array of remaining page UID numbers
     * @access private
     * @see getWhere(),checkPid()
     */
    function checkPidArray($listArr) {
        $outArr = array();
        if (is_array($listArr) && count($listArr)) {
            $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
                'uid',
                'pages',
                'uid IN (' . implode(',', $listArr) . ')' . $this->enableFields('pages') .
                    ' AND doktype NOT IN (' . $this->checkPid_badDoktypeList . ')'
            );
            if ($error = $GLOBALS['TYPO3_DB']->sql_error()) {
                $GLOBALS['TT']->setTSlogMessage($error . ': ' . $GLOBALS['TYPO3_DB']->debug_lastBuiltQuery, 3);
            } else {
                while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
                    $outArr[] = $row['uid'];
                }
            }
            $GLOBALS['TYPO3_DB']->sql_free_result($res);
        }
        return $outArr;
    }

    /**
     * Checks if a page UID is available due to enableFields() AND the list of bad doktype numbers ($this->checkPid_badDoktypeList)
     *
     * @param   integer     Page UID to test
     * @return  boolean     True if OK
     * @access private
     * @see getWhere(), checkPidArray()
     */
    function checkPid($uid) {
        $uid = intval($uid);
        if (!isset($this->checkPid_cache[$uid])) {
            $count = $GLOBALS['TYPO3_DB']->exec_SELECTcountRows(
                'uid',
                'pages',
                'uid=' . intval($uid) . $this->enableFields('pages') .
                    ' AND doktype NOT IN (' . $this->checkPid_badDoktypeList . ')'
            );
            $this->checkPid_cache[$uid] = (bool) $count;
        }
        return $this->checkPid_cache[$uid];
    }

    /**
     * Builds list of marker values for handling PDO-like parameter markers in select parts.
     * Marker values support stdWrap functionality thus allowing a way to use stdWrap functionality in various properties of 'select' AND prevents SQL-injection problems by quoting and escaping of numeric values, strings, NULL values and comma separated lists.
     *
     * @param   string $table Table to select records from
     * @param   array $conf Select part of CONTENT definition
     * @return  array List of values to replace markers with
     * @access private
     * @see getQuery()
     */
    function getQueryMarkers($table, $conf) {

            // parse markers and prepare their values
        $markerValues = array();
        if (is_array($conf['markers.'])) {
            foreach ($conf['markers.'] as $dottedMarker => $dummy) {
                $marker = rtrim($dottedMarker, '.');
                if ($dottedMarker == $marker . '.') {
                        // parse definition
                    $tempValue = isset($conf['markers.'][$dottedMarker])
                        ? $this->stdWrap($conf['markers.'][$dottedMarker]['value'], $conf['markers.'][$dottedMarker])
                        : $conf['markers.'][$dottedMarker]['value'];
                        // quote/escape if needed
                    if (is_numeric($tempValue)) {
                        if ((int) $tempValue == $tempValue) {
                                // handle integer
                            $markerValues[$marker] = intval($tempValue);
                        } else {
                                // handle float
                            $markerValues[$marker] = floatval($tempValue);
                        }
                    } elseif (is_null($tempValue)) {
                            // it represents NULL
                        $markerValues[$marker] = 'NULL';
                    } elseif ($conf['markers.'][$dottedMarker]['commaSeparatedList'] == 1) {
                            // see if it is really a comma separated list of values
                        $explodeValues = t3lib_div::trimExplode(',', $tempValue);
                        if (count($explodeValues) > 1) {
                                // handle each element of list separately
                            $tempArray = array();
                            foreach ($explodeValues as $listValue) {
                                if (is_numeric($listValue)) {
                                    if ((int) $listValue == $listValue) {
                                        $tempArray[] = intval($listValue);
                                    } else {
                                        $tempArray[] = floatval($listValue);
                                    }
                                } else {
                                        // if quoted, remove quotes before
                                        // escaping.
                                    if (preg_match('/^\'([^\']*)\'$/', $listValue, $matches)) {
                                        $listValue = $matches[1];
                                    } elseif (preg_match('/^\"([^\"]*)\"$/', $listValue, $matches)) {
                                        $listValue = $matches[1];
                                    }
                                    $tempArray[] = $GLOBALS['TYPO3_DB']->fullQuoteStr($listValue, $table);
                                }
                            }
                            $markerValues[$marker] = implode(',', $tempArray);
                        } else {
                                // handle remaining values as string
                            $markerValues[$marker] = $GLOBALS['TYPO3_DB']->fullQuoteStr($tempValue, $table);
                        }
                    } else {
                            // handle remaining values as string
                        $markerValues[$marker] = $GLOBALS['TYPO3_DB']->fullQuoteStr($tempValue, $table);
                    }
                }
            }
        }
        return $markerValues;
    }



    /***********************************************
     *
     * Frontend editing functions
     *
     ***********************************************/

    /**
     * Generates the "edit panels" which can be shown for a page or records on a page when the Admin Panel is enabled for a backend users surfing the frontend.
     * With the "edit panel" the user will see buttons with links to editing, moving, hiding, deleting the element
     * This function is used for the cObject EDITPANEL and the stdWrap property ".editPanel"
     *
     * @param   string      A content string containing the content related to the edit panel. For cObject "EDITPANEL" this is empty but not so for the stdWrap property. The edit panel is appended to this string and returned.
     * @param   array       TypoScript configuration properties for the editPanel
     * @param   string      The "table:uid" of the record being shown. If empty string then $this->currentRecord is used. For new records (set by $conf['newRecordFromTable']) it's auto-generated to "[tablename]:NEW"
     * @param   array       Alternative data array to use. Default is $this->data
     * @return  string      The input content string with the editPanel appended. This function returns only an edit panel appended to the content string if a backend user is logged in (and has the correct permissions). Otherwise the content string is directly returned.
     */
    function editPanel($content, $conf, $currentRecord = '', $dataArr = array()) {

        if ($GLOBALS['TSFE']->beUserLogin && ($GLOBALS['BE_USER']->frontendEdit instanceof t3lib_frontendedit)) {
            if (!$currentRecord) {
                $currentRecord = $this->currentRecord;
            }

            if (!count($dataArr)) {
                $dataArr = $this->data;
            }

            // Delegate rendering of the edit panel to the t3lib_frontendedit class.
            $content = $GLOBALS['BE_USER']->frontendEdit->displayEditPanel($content, $conf, $currentRecord, $dataArr);
        }

        return $content;
    }

    /**
     * Adds an edit icon to the content string. The edit icon links to alt_doc.php with proper parameters for editing the table/fields of the context.
     * This implements TYPO3 context sensitive editing facilities. Only backend users will have access (if properly configured as well).
     *
     * @param   string      The content to which the edit icons should be appended
     * @param   string      The parameters defining which table and fields to edit. Syntax is [tablename]:[fieldname],[fieldname],[fieldname],... OR [fieldname],[fieldname],[fieldname],... (basically "[tablename]:" is optional, default table is the one of the "current record" used in the function). The fieldlist is sent as "&columnsOnly=" parameter to alt_doc.php
     * @param   array       TypoScript properties for configuring the edit icons.
     * @param   string      The "table:uid" of the record being shown. If empty string then $this->currentRecord is used. For new records (set by $conf['newRecordFromTable']) it's auto-generated to "[tablename]:NEW"
     * @param   array       Alternative data array to use. Default is $this->data
     * @param   string      Additional URL parameters for the link pointing to alt_doc.php
     * @return  string      The input content string, possibly with edit icons added (not necessarily in the end but just after the last string of normal content.
     */
    function editIcons($content, $params, array $conf = array(), $currentRecord = '', $dataArr = array(), $addUrlParamStr = '') {
        if ($GLOBALS['TSFE']->beUserLogin && ($GLOBALS['BE_USER']->frontendEdit instanceof t3lib_frontendedit)) {
            if (!$currentRecord) {
                $currentRecord = $this->currentRecord;
            }

            if (!count($dataArr)) {
                $dataArr = $this->data;
            }

                // Delegate rendering of the edit panel to the t3lib_frontendedit class.
            $content = $GLOBALS['BE_USER']->frontendEdit->displayEditIcons(
                $content,
                $params,
                $conf,
                $currentRecord,
                $dataArr,
                $addUrlParamStr
            );
        }

        return $content;
    }


    /**
     * Returns TRUE if the input table/row would be hidden in the frontend (according nto the current time and simulate user group)
     *
     * @param   string      The table name
     * @param   array       The data record
     * @return  boolean
     * @access private
     * @see editPanelPreviewBorder()
     */
    function isDisabled($table, $row) {
        global $TCA;
        if (($TCA[$table]['ctrl']['enablecolumns']['disabled']
            && $row[$TCA[$table]['ctrl']['enablecolumns']['disabled']])
            || ($TCA[$table]['ctrl']['enablecolumns']['fe_group'] && $GLOBALS['TSFE']->simUserGroup
            && $row[$TCA[$table]['ctrl']['enablecolumns']['fe_group']] == $GLOBALS['TSFE']->simUserGroup)
            || ($TCA[$table]['ctrl']['enablecolumns']['starttime']
            && $row[$TCA[$table]['ctrl']['enablecolumns']['starttime']] > $GLOBALS['EXEC_TIME'])
            || ($TCA[$table]['ctrl']['enablecolumns']['endtime']
            && $row[$TCA[$table]['ctrl']['enablecolumns']['endtime']]
            && $row[$TCA[$table]['ctrl']['enablecolumns']['endtime']] < $GLOBALS['EXEC_TIME'])) {

            return TRUE;
        }
    }
}



/**
 * Rendering of framesets
 *
 * @author  Kasper Skårhøj <kasperYYYY@typo3.com>
 * @package TYPO3
 * @subpackage tslib
 */
class tslib_frameset {

    /**
     * Generates a frameset based on input configuration in a TypoScript array.
     *
     * @param   array       The TypoScript properties of the PAGE object property "frameSet.". See link.
     * @return  string      A <frameset> tag.
     * @see TSpagegen::renderContentWithHeader()
     */
    function make($setup) {
        $content = '';
        if (is_array($setup)) {
            $sKeyArray = t3lib_TStemplate::sortedKeyList($setup);
            foreach ($sKeyArray as $theKey) {
                $theValue = $setup[$theKey];
                if (intval($theKey) && $conf = $setup[$theKey . '.']) {
                    switch ($theValue) {
                        case 'FRAME' :
                            $typeNum = intval($GLOBALS['TSFE']->tmpl->setup[$conf['obj'] . '.']['typeNum']);
                            if (!$conf['src'] && !$typeNum) {
                                $typeNum = -1;
                            }
                            $content .= '<frame' . $this->frameParams($conf, $typeNum) . ' />' . LF;
                        break;
                        case 'FRAMESET' :
                            $frameset = t3lib_div::makeInstance('tslib_frameset');
                            $content .= $frameset->make($conf) . LF;
                        break;
                    }
                }
            }
            return '<frameset' . $this->framesetParams($setup) . '>' . LF . $content . '</frameset>';
        }
    }

    /**
     * Creates the attributes for a <frame> tag based on a $conf array and the type number
     *
     * @param   array       Configuration for the parameter generation for the FRAME set. See link
     * @param   integer     The typenumber to use for the link.
     * @return  string      String with attributes for the frame-tag. With a prefixed space character.
     * @access private
     * @link http://typo3.org/documentation/document-library/references/doc_core_tsref/current/view/7/9/
     * @see make(), t3lib_TStemplate::linkData()
     */
    function frameParams($setup, $typeNum) {
        $paramStr = '';
        $name = $setup['obj'];

        if ($setup['src'] || $setup['src.']) {
            $src = $setup['src'];
            if (is_array($setup['src.'])) {
                $src = $GLOBALS['TSFE']->cObj->stdWrap($src, $setup['src.']);
            }
            $paramStr .= ' src="' . htmlspecialchars($src) . '"';
        } else {
            $LD = $GLOBALS['TSFE']->tmpl->linkData(
                $GLOBALS['TSFE']->page,
                '',
                $GLOBALS['TSFE']->no_cache,
                '',
                '',
                ($setup['options'] ? '&' . $setup['options'] : '') .
                    $GLOBALS['TSFE']->cObj->getClosestMPvalueForPage($GLOBALS['TSFE']->page['uid']), intval($typeNum)
            );
            $finalURL = $LD['totalURL'];
            $paramStr .= ' src="' . htmlspecialchars($finalURL) . '"';
        }
        if ($setup['name']) {
            $paramStr .= ' name="' . $setup['name'] . '"';
        } else {
            $paramStr .= ' name="' . $name . '"';
        }
        if ($setup['params']) {
            $paramStr .= ' ' . $setup['params'];
        }
        return $paramStr;
    }

    /**
     * Creates the attributes for a <frameset> tag based on a conf array($setup)
     *
     * @param   array       The setup array(TypoScript properties)
     * @return  string      Attributes with preceeding space.
     * @access private
     * @see make()
     */
    function framesetParams($setup) {
        $paramStr = '';
        if ($setup['cols']) {
            $paramStr .= ' cols="' . $setup['cols'] . '"';
        }
        if ($setup['rows']) {
            $paramStr .= ' rows="' . $setup['rows'] . '"';
        }
        if ($setup['params']) {
            $paramStr .= ' ' . $setup['params'];
        }
        return $paramStr;
    }
}



/**
 * Rendering of tables for offset
 *
 * @see tslib_cObj::OTABLE(), tslib_cObj::stdWrap()
 * @author  Kasper Skårhøj <kasperYYYY@typo3.com>
 * @package TYPO3
 * @subpackage tslib
 */
class tslib_tableOffset {
    var $tableParams = 'border="0" cellspacing="0" cellpadding="0"';
    var $default_tableParams = 'border="0" cellspacing="0" cellpadding="0"';
    var $tdParams = ' width="99%" valign="top"';

    /**
     * Wrapping the input content string in a table which will space it out from top/left/right/bottom
     *
     * @param   string      The HTML content string
     * @param   string      List of offset parameters; x,y,r,b,w,h
     * @return  string      The HTML content string being wrapped in a <table> offsetting the content as the $offset parameters defined
     */
    function start($content, $offset) {
        $valPairs = t3lib_div::intExplode(',', $offset . ',,,,,');

        if ($valPairs[0] || $valPairs[1] || $valPairs[2] || $valPairs[3] || $valPairs[4] || $valPairs[5]) {
                // If width is defined AND there has been no change to the default table params, then extend them to a tablewidth of 1
            if ($valPairs[4] && $this->default_tableParams == $this->tableParams) {
                $this->tableParams .= ' width="1"';
            }
                // Init:
            $this->begin = LF . '<table ' . $this->tableParams . '>';
            $this->end = '</table>';
            $rows = array();
            $widthImg = '';
            $heightImg = '';
                // If width is required, set so bottom column will display for sure
            if ($valPairs[4]) {
                if (!$valPairs[3])
                    $valPairs[3] = 1;
                $widthImg = '<img src="' . $GLOBALS['TSFE']->absRefPrefix . 'clear.gif" width="' .
                    $valPairs[4] . '" height="1" alt="" title="" />';
            }
                // If height is required, set so right column will display for sure
            if ($valPairs[5]) {
                if (!$valPairs[2])
                    $valPairs[2] = 1;
                $valPairs[2] = 1;
                $heightImg = '<img src="' . $GLOBALS['TSFE']->absRefPrefix . 'clear.gif" width="1" height="' .
                    $valPairs[5] . '" alt="" title="" />';
            }

                // First row:
            if ($valPairs[1]) { // top
                $rows[1] .= '<tr>';
                $rows[1] .= '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix . 'clear.gif" width="' .
                    ($valPairs[0] ? $valPairs[0] : 1) . '" height="' . $valPairs[1] . '" alt="" title="" /></td>';
                if ($valPairs[0])
                    $rows[1] .= '<td></td>';
                if ($valPairs[2])
                    $rows[1] .= '<td></td>';
                $rows[1] .= '</tr>';
            }
                // Middle row:
            $rows[2] .= '<tr>';
            if ($valPairs[0]) {
                $rows[2] .= $valPairs[1] ? '<td></td>' : '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" width="' . $valPairs[0] . '" height="1" alt="" title="" /></td>';
            }
            $rows[2] .= '<td' . $this->tdParams . '>' . $content . '</td>';
            if ($valPairs[2]) {
                $rows[2] .= $valPairs[3] ? '<td>' . $heightImg . '</td>' : '<td><img src="' .
                    $GLOBALS['TSFE']->absRefPrefix . 'clear.gif" width="' . $valPairs[2] . '" height="' .
                    ($valPairs[5] ? $valPairs[5] : 1) . '" alt="" title="" /></td>';
            }
            $rows[2] .= '</tr>';
                // Bottom row:
            if ($valPairs[3]) { // bottom
                $rows[3] .= '<tr>';
                if ($valPairs[0])
                    $rows[3] .= '<td></td>';
                if ($valPairs[2])
                    $rows[3] .= '<td>' . $widthImg . '</td>';
                $rows[3] .= '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix . 'clear.gif" width="' .
                    ($valPairs[2] ? $valPairs[2] : ($valPairs[4] ? $valPairs[4] : 1)) . '" height="' .
                    $valPairs[3] . '" alt="" title="" /></td>';
                $rows[3] .= '</tr>';
            }
            return $this->begin . implode('', $rows) . $this->end;
        } else
            return $content;
    }
}



/**
 * Rendering of tables for content positioning
 *
 * @see tslib_cObj::CTABLE()
 * @author  Kasper Skårhøj <kasperYYYY@typo3.com>
 * @package TYPO3
 * @subpackage tslib
 */
class tslib_controlTable {
    var $offX = 0; // offset, x
    var $offY = 0; // offset, y


    var $tm = ''; // top menu
    var $lm = ''; // left menu
    var $rm = ''; // right menu
    var $bm = ''; // bottom menu
    var $content = ''; // content


    var $tmTDparams = 'valign="top"'; // top menu TDparams
    var $lmTDparams = 'valign="top"'; // left menu TDparams
    var $rmTDparams = 'valign="top"'; // right menu TDparams
    var $bmTDparams = 'valign="top"'; // bottom menu TDparams
    var $contentTDparams = 'valign="top"'; // content TDparams


    var $cMl = 1; // content margin, left
    var $cMr = 1; // content margin, right
    var $cMt = 0; // content margin, top
    var $cMb = 1; // content margin, bottom


    var $contentW = 0; // Places a little gif-spacer in the bottom of the content frame


    var $tableParams = 'border="0" cellspacing="0" cellpadding="0"';

    /**
     * Wrapping internal vars ->tm, ->lm, ->rm, ->bm and ->content in a table where each content part is stored in a cell.
     * The two arguments to this function defines some offsets and margins to use in the arrangement of the content in the table.
     *
     * @param   string      List of offset parameters; x,y
     * @param   string      List of margin parameters; left, top, right, bottom
     * @return  string      The content strings wrapped in a <table> as the parameters defined
     * @see tslib_cObj::CTABLE()
     */
    function start($offset, $cMargins) {
        $offArr = t3lib_div::intExplode(',', $offset);
        $cMargArr = t3lib_div::intExplode(',', $cMargins);

        $cols = 0;
        $rows = 0;

        if ($this->lm)
            $cols++;
        if ($this->rm)
            $cols++;
        if ($cMargArr[0])
            $cols++;
        if ($cMargArr[2])
            $cols++;
        if ($cMargArr[1] || $cMargArr[3] || $this->tm || $this->bm || $this->content || $this->contentW)
            $cols++;

        if ($cMargArr[1])
            $rows++;
        if ($cMargArr[3])
            $rows++;
        if ($this->tm)
            $rows++;
        if ($this->bm)
            $rows++;
        if ($this->content)
            $rows++;
        if ($this->contentW)
            $rows++;
        if (!$rows && $cols)
            $rows = 1; // If there are no rows in the middle but still som columns...


        if ($rows && $cols) {
            $res = LF . '<table ' . $this->tableParams . '>';
                // top offset:
            if ($offArr[1]) {
                $xoff = $offArr[0] ? 1 : 0;
                if ($cols + $xoff > 1) {
                    $colspan = ' colspan="' . ($cols + $xoff) . '"';
                }
                $res .= '<tr><td' . $colspan . '><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" width="1" height="' . $offArr[1] . '" alt="" title="" /></td></tr>';
            }
                // The rows:
            if ($rows > 1) {
                $rowspan = ' rowspan="' . ($rows) . '"';
            }
            $res .= '<tr>';
            if ($offArr[0]) {
                $res .= '<td' . $rowspan . '><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" height="1" width="' . $offArr[0] . '" alt="" title="" /></td>';
            }
            if ($this->lm) {
                $res .= '<td' . $rowspan . ' ' . $this->lmTDparams . '>' . $this->lm . '</td>';
            }
            if ($cMargArr[0]) {
                $res .= '<td' . $rowspan . '><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" height="1" width="' . $cMargArr[0] . '" alt="" title="" /></td>';
            }
                // content...


            $middle = array();
            if ($this->tm) {
                $middle[] = '<td ' . $this->tmTDparams . '>' . $this->tm . '</td>';
            }
            if ($cMargArr[1]) {
                $middle[] = '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" width="1" height="' . $cMargArr[1] . '" alt="" title="" /></td>';
            }
            if ($this->content) {
                $middle[] = '<td ' . $this->contentTDparams . '>' . $this->content . '</td>';
            }
            if ($cMargArr[3]) {
                $middle[] = '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" width="1" height="' . $cMargArr[3] . '" alt="" title="" /></td>';
            }
            if ($this->bm) {
                $middle[] = '<td ' . $this->bmTDparams . '>' . $this->bm . '</td>';
            }
            if ($this->contentW) {
                $middle[] = '<td><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" height="1" width="' . $this->contentW . '" alt="" title="" /></td>';
            }
            if (isset($middle[0])) {
                $res .= $middle[0];
            }

                // Left of content
            if ($cMargArr[2]) {
                $res .= '<td' . $rowspan . '><img src="' . $GLOBALS['TSFE']->absRefPrefix .
                    'clear.gif" height="1" width="' . $cMargArr[2] . '" alt="" title="" /></td>';
            }
            if ($this->rm) {
                $res .= '<td' . $rowspan . ' ' . $this->rmTDparams . '>' . $this->rm . '</td>';
            }
            $res .= '</tr>';

                // More than the two rows
            $mCount = count($middle);
            for ($a = 1; $a < $mCount; $a++) {
                $res .= '<tr>' . $middle[$a] . '</tr>';
            }
            $res .= '</table>';
            return $res;
        }
    }
}


if (defined('TYPO3_MODE') && isset($GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['tslib/class.tslib_content.php'])) {
    include_once($GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['tslib/class.tslib_content.php']);
}

?>