SpriteManager.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Backend\Sprite;

use TYPO3\CMS\Core\Utility\GeneralUtility;

class SpriteManager {

    static public $tempPath = 'typo3temp/sprites/';

    static protected $isInitialized = FALSE;

    static public function initialize() {
        if (!static::isInitialized()) {
            $cacheIdentifier = static::getCacheIdentifier();
            $codeCache = GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager')->getCache('cache_core');
            if ($codeCache->has($cacheIdentifier)) {
                $codeCache->requireOnce($cacheIdentifier);
            } else {
                static::buildSpriteDataAndCreateCacheEntry();
            }
            self::$isInitialized = TRUE;
        }
    }

    static public function isInitialized() {
        return self::$isInitialized;
    }

    static protected function buildSpriteDataAndCreateCacheEntry() {
        $handlerClass = $GLOBALS['TYPO3_CONF_VARS']['BE']['spriteIconGenerator_handler'];
        $handler = GeneralUtility::makeInstance($handlerClass);
        // Throw exception if handler class does not implement required interface
        if (!$handler instanceof \TYPO3\CMS\Backend\Sprite\SpriteIconGeneratorInterface) {
            throw new \RuntimeException('Class ' . $handlerClass . ' in $TYPO3_CONF_VARS[BE][spriteIconGenerator_handler] ' . ' does not implement TYPO3\\CMS\\Backend\\Sprite\\SpriteIconGeneratorInterface', 1294586333);
        }
        // Create temp directory if missing
        if (!is_dir((PATH_site . self::$tempPath))) {
            GeneralUtility::mkdir(PATH_site . self::$tempPath);
        }
        // Generate CSS and TCA files, build icon set register
        $handler->generate();
        // Get all icons registered from skins, merge with core icon list
        $availableSkinIcons = (array) $GLOBALS['TBE_STYLES']['spriteIconApi']['coreSpriteImageNames'];
        foreach ($GLOBALS['TBE_STYLES']['skins'] as $skinData) {
            $availableSkinIcons = array_merge($availableSkinIcons, (array) $skinData['availableSpriteIcons']);
        }
        // Merge icon names provided by the skin, with
        // registered "complete sprites" and the handler class
        $iconNames = array_merge($availableSkinIcons, (array) $GLOBALS['TBE_STYLES']['spritemanager']['spriteIconsAvailable'], $handler->getAvailableIconNames());
        $GLOBALS['TBE_STYLES']['spriteIconApi']['iconsAvailable'] = $iconNames;

        $cacheFileContent = '$GLOBALS[\'TBE_STYLES\'][\'spriteIconApi\'][\'iconsAvailable\'] = ';
        $cacheFileContent .= var_export($iconNames, TRUE) . ';';
        GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager')->getCache('cache_core')->set(static::getCacheIdentifier(), $cacheFileContent);
    }

    static protected function getCacheIdentifier() {
        return 'sprites_' . sha1((TYPO3_version . PATH_site . 'spriteManagement'));
    }

    static public function addIconSprite(array $icons, $styleSheetFile = '') {
        $GLOBALS['TBE_STYLES']['spritemanager']['spriteIconsAvailable'] = array_merge((array) $GLOBALS['TBE_STYLES']['spritemanager']['spriteIconsAvailable'], $icons);
        if ($styleSheetFile !== '') {
            $GLOBALS['TBE_STYLES']['spritemanager']['cssFiles'][] = $styleSheetFile;
        }
    }

    static public function addSingleIcons(array $icons, $extKey = '') {
        foreach ($icons as $iconName => $iconFile) {
            $GLOBALS['TBE_STYLES']['spritemanager']['singleIcons']['extensions-' . $extKey . '-' . $iconName] = $iconFile;
        }
    }

    static public function addTcaTypeIcon($table, $type, $iconFile) {
        $GLOBALS['TBE_STYLES']['spritemanager']['singleIcons']['tcarecords-' . $table . '-' . $type] = $iconFile;
        if (is_array($GLOBALS['TCA'][$table]['ctrl']['typeicon_classes'])) {
            $GLOBALS['TCA'][$table]['ctrl']['typeicon_classes'][$type] = 'tcarecords-' . $table . '-' . $type;
        }
    }

}