browse_links.php

Go to the documentation of this file.

<?php
/***************************************************************
*  Copyright notice
*
*  (c) 1999-2008 Kasper Skaarhoj (kasperYYYY@typo3.com)
*  All rights reserved
*
*  This script is part of the TYPO3 project. The TYPO3 project is
*  free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  The GNU General Public License can be found at
*  http://www.gnu.org/copyleft/gpl.html.
*  A copy is found in the textfile GPL.txt and important notices to the license
*  from the author is found in LICENSE.txt distributed with these scripts.
*
*
*  This script is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
/**
 * Displays the page/file tree for browsing database records or files.
 * Used from TCEFORMS an other elements
 * In other words: This is the ELEMENT BROWSER!
 *
 * $Id: browse_links.php 4433 2008-11-07 04:13:12Z flyguide $
 * Revised for TYPO3 3.6 November/2003 by Kasper Skaarhoj
 * XHTML compliant
 *
 * @author  Kasper Skaarhoj <kasperYYYY@typo3.com>
 */
/**
 * [CLASS/FUNCTION INDEX of SCRIPT]
 *
 *
 *
 *   78: class SC_browse_links
 *   99:     function init ()
 *  120:     function main()
 *  174:     function printContent()
 *
 * TOTAL FUNCTIONS: 3
 * (This index is automatically created/updated by the extension "extdeveval")
 *
 */
$BACK_PATH='';
require ('init.php');
require ('template.php');
$LANG->includeLLFile('EXT:lang/locallang_browse_links.xml');

require_once (PATH_typo3.'/class.browse_links.php');













/**
 * Script class for the Element Browser window.
 *
 * @author  Kasper Skaarhoj <kasperYYYY@typo3.com>
 * @package TYPO3
 * @subpackage core
 */
class SC_browse_links {


    /**
     * The mode determines the main kind of output from the element browser.
     * There are these options for values: rte, db, file, filedrag, wizard.
     * "rte" will show the link selector for the Rich Text Editor (see main_rte())
     * "db" will allow you to browse for pages or records in the page tree (for TCEforms, see main_db())
     * "file"/"filedrag" will allow you to browse for files or folders in the folder mounts (for TCEforms, main_file())
     * "wizard" will allow you to browse for links (like "rte") which are passed back to TCEforms (see main_rte(1))
     *
     * @see main()
     */
    var $mode;

    /**
     * holds Instance of main browse_links class
     * needed fo intercommunication between various classes that need access to variables via $GLOBALS['SOBE']
     * Not the most nice solution but introduced since we don't have another general way to return class-instances or registry for now
     *
     * @var browse_links
     */
    var $browser;

    /**
     * document template object
     *
     * @var template
     */
    var $doc;

    /**
     * not really needed but for backwards compatibility ...
     *
     * @return  void
     */
    function init ()    {

            // Find "mode"
        $this->mode = t3lib_div::_GP('mode');
        if (!$this->mode)   {
            $this->mode = 'rte';
        }

            // Creating backend template object:
            // this might not be needed but some classes refer to $GLOBALS['SOBE']->doc, so ...
        $this->doc = t3lib_div::makeInstance('template');
        $this->doc->backPath = $GLOBALS['BACK_PATH'];
    }


    /**
     * Main function, detecting the current mode of the element browser and branching out to internal methods.
     *
     * @return  void
     */
    function main() {

        $this->content = '';

            // look for alternativ mountpoints
        switch((string)$this->mode) {
            case 'rte':
            case 'db':
            case 'wizard':
                    // Setting alternative browsing mounts (ONLY local to browse_links.php this script so they stay "read-only")
                $altMountPoints = trim($GLOBALS['BE_USER']->getTSConfigVal('options.pageTree.altElementBrowserMountPoints'));
                if ($altMountPoints) {
                    $GLOBALS['BE_USER']->groupData['webmounts'] = implode(',', array_unique(t3lib_div::intExplode(',', $altMountPoints)));
                    $GLOBALS['WEBMOUNTS'] = $GLOBALS['BE_USER']->returnWebmounts();
                }
            case 'file':
            case 'filedrag':
            case 'folder':
                    // Setting additional read-only browsing file mounts
                $altMountPoints = trim($GLOBALS['BE_USER']->getTSConfigVal('options.folderTree.altElementBrowserMountPoints'));
                if ($altMountPoints) {
                    $altMountPoints = t3lib_div::trimExplode(',', $altMountPoints);
                    foreach($altMountPoints as $filePathRelativeToFileadmindir) {
                        $GLOBALS['BE_USER']->addFileMount('', $filePathRelativeToFileadmindir, $filePathRelativeToFileadmindir, 1, 'readonly');
                    }
                    $GLOBALS['FILEMOUNTS'] = $GLOBALS['BE_USER']->returnFilemounts();
                }
                break;
        }


            // render type by user func
        $browserRendered = false;
        if (is_array ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['typo3/browse_links.php']['browserRendering'])) {
            foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['typo3/browse_links.php']['browserRendering'] as $classRef) {
                $browserRenderObj = t3lib_div::getUserObj($classRef);
                if (is_object($browserRenderObj) && method_exists($browserRenderObj, 'isValid') && method_exists($browserRenderObj, 'render')) {
                    if ($browserRenderObj->isValid($this->mode, $this)) {
                        $this->content.= $browserRenderObj->render($this->mode, $this);
                        $browserRendered = true;
                        break;
                    }
                }
            }
        }

            // if type was not rendered use default rendering functions
        if(!$browserRendered) {
            $this->browser = t3lib_div::makeInstance('browse_links');
            $this->browser->init();
            $modData = $GLOBALS['BE_USER']->getModuleData('browse_links.php', 'ses');
            list($modData, $store) = $this->browser->processSessionData($modData);
            $GLOBALS['BE_USER']->pushModuleData('browse_links.php', $modData);

                // Output the correct content according to $this->mode
            switch((string)$this->mode) {
                case 'rte':
                    $this->content = $this->browser->main_rte();
                break;
                case 'db':
                    $this->content = $this->browser->main_db();
                break;
                case 'file':
                case 'filedrag':
                    $this->content = $this->browser->main_file();
                break;
                case 'folder':
                    $this->content = $this->browser->main_folder();
                break;
                case 'wizard':
                    $this->content = $this->browser->main_rte(1);
                break;
            }
        }
    }

    /**
     * Print module content
     *
     * @return  void
     */
    function printContent() {
        echo $this->content;
    }


}



if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['typo3/browse_links.php'])  {
    include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['typo3/browse_links.php']);
}



// Make instance:
$SOBE = t3lib_div::makeInstance('SC_browse_links');
$SOBE->init();
$SOBE->main();
$SOBE->printContent();

?>

---