Extension.php

Go to the documentation of this file.

<?php
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Extensionmanager\Domain\Model;
 
use ‪TYPO3\CMS\Core\Core\Environment;
use ‪TYPO3\CMS\Core\Utility\MathUtility;
use ‪TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use ‪TYPO3\CMS\Extbase\Object\ObjectManager;
use ‪TYPO3\CMS\Extensionmanager\Utility\ExtensionModelUtility;
 
class ‪Extension extends ‪AbstractEntity
{
    const ‪DISTRIBUTION_CATEGORY = 10;
 
    protected static ‪$defaultCategories = [
        0 => 'be',
        1 => 'module',
        2 => 'fe',
        3 => 'plugin',
        4 => 'misc',
        5 => 'services',
        6 => 'templates',
        8 => 'doc',
        9 => 'example',
        self::DISTRIBUTION_CATEGORY => 'distribution'
    ];
 
    protected static ‪$defaultStates = [
        0 => 'alpha',
        1 => 'beta',
        2 => 'stable',
        3 => 'experimental',
        4 => 'test',
        5 => 'obsolete',
        6 => 'excludeFromUpdates',
        7 => 'deprecated',
        999 => 'n/a'
    ];
 
    protected ‪$objectManager;
 
    protected ‪$extensionKey = '';
 
    protected ‪$version = '';
 
    protected ‪$integerVersion = 0;
 
    protected ‪$title = '';
 
    protected ‪$description = '';
 
    protected ‪$state = 0;
 
    protected ‪$category = 0;
 
    protected ‪$lastUpdated;
 
    protected ‪$updateComment = '';
 
    protected ‪$authorName = '';
 
    protected ‪$authorEmail = '';
 
    protected ‪$currentVersion = false;
 
    protected ‪$md5hash = '';
 
    protected ‪$reviewState;
 
    protected ‪$alldownloadcounter;
 
    protected ‪$serializedDependencies = '';
 
    protected ‪$dependencies;
 
    protected ‪$documentationLink = '';
 
    protected ‪$position = 0;
 
    public function ‪injectObjectManager(‪ObjectManager ‪$objectManager)
    {
        $this->objectManager = ‪$objectManager;
    }
 
    public function ‪setAuthorEmail(‪$authorEmail)
    {
        $this->authorEmail = ‪$authorEmail;
    }
 
    public function ‪getAuthorEmail()
    {
        return ‪$this->authorEmail;
    }
 
    public function ‪setAuthorName(‪$authorName)
    {
        $this->authorName = ‪$authorName;
    }
 
    public function ‪getAuthorName()
    {
        return ‪$this->authorName;
    }
 
    public function ‪setCategory(‪$category)
    {
        $this->category = ‪$category;
    }
 
    public function ‪getCategory()
    {
        return ‪$this->category;
    }
 
    public function ‪getCategoryString()
    {
        $categoryString = '';
        if (isset(self::$defaultCategories[$this->‪getCategory()])) {
            $categoryString = self::$defaultCategories[$this->‪getCategory()];
        }
        return $categoryString;
    }
 
    public function ‪getCategoryIndexFromStringOrNumber(‪$category)
    {
        $categoryIndex = 4;
        if (‪MathUtility::canBeInterpretedAsInteger(‪$category)) {
            $categoryIndex = (int)‪$category;
            if ($categoryIndex < 0 || $categoryIndex > 10) {
                $categoryIndex = 4;
            }
        } elseif (is_string(‪$category)) {
            $categoryIndex = array_search(‪$category, self::$defaultCategories);
            if ($categoryIndex === false) {
                $categoryIndex = 4;
            }
        }
        return $categoryIndex;
    }
 
    public function ‪setDescription(‪$description)
    {
        $this->description = ‪$description;
    }
 
    public function ‪getDescription()
    {
        return ‪$this->description;
    }
 
    public function ‪setExtensionKey(‪$extensionKey)
    {
        $this->extensionKey = ‪$extensionKey;
    }
 
    public function ‪getExtensionKey()
    {
        return ‪$this->extensionKey;
    }
 
    public function ‪setLastUpdated(\DateTime ‪$lastUpdated)
    {
        $this->lastUpdated = ‪$lastUpdated;
    }
 
    public function ‪getLastUpdated()
    {
        return ‪$this->lastUpdated;
    }
 
    public function ‪setState(‪$state)
    {
        $this->state = ‪$state;
    }
 
    public function ‪getState()
    {
        return ‪$this->state;
    }
 
    public function ‪getStateString()
    {
        $stateString = '';
        if (isset(self::$defaultStates[$this->‪getState()])) {
            $stateString = self::$defaultStates[$this->‪getState()];
        }
        return $stateString;
    }
 
    public function ‪getDefaultState(‪$state = null)
    {
        $defaultState = '';
        if (‪$state === null) {
            $defaultState = ‪self::$defaultStates;
        } else {
            if (is_string(‪$state)) {
                $stateIndex = array_search(strtolower(‪$state), self::$defaultStates);
                if ($stateIndex === false) {
                    // default state
                    $stateIndex = 999;
                }
                $defaultState = $stateIndex;
            } else {
                if (is_int(‪$state) && ‪$state >= 0) {
                    if (array_key_exists(‪$state, self::$defaultStates)) {
                        $stateTitle = self::$defaultStates[‪$state];
                    } else {
                        // default state
                        $stateTitle = 'n/a';
                    }
                    $defaultState = $stateTitle;
                }
            }
        }
        return $defaultState;
    }
 
    public function ‪setTitle(‪$title)
    {
        $this->title = ‪$title;
    }
 
    public function ‪getTitle()
    {
        return ‪$this->title;
    }
 
    public function ‪setUpdateComment(‪$updateComment)
    {
        $this->updateComment = ‪$updateComment;
    }
 
    public function ‪getUpdateComment()
    {
        return ‪$this->updateComment;
    }
 
    public function ‪setVersion(‪$version)
    {
        $this->version = ‪$version;
    }
 
    public function ‪getVersion()
    {
        return ‪$this->version;
    }
 
    public function ‪setCurrentVersion(‪$currentVersion)
    {
        $this->currentVersion = ‪$currentVersion;
    }
 
    public function ‪getCurrentVersion()
    {
        return ‪$this->currentVersion;
    }
 
    public function ‪setMd5hash(‪$md5hash)
    {
        $this->md5hash = ‪$md5hash;
    }
 
    public function ‪getMd5hash()
    {
        return ‪$this->md5hash;
    }
 
    public static function ‪returnInstallPaths()
    {
        $installPaths = [
            'System' => ‪Environment::getFrameworkBasePath() . '/',
            'Global' => ‪Environment::getBackendPath() . '/ext/',
            'Local' => ‪Environment::getExtensionsPath() . '/'
        ];
        return $installPaths;
    }
 
    public static function ‪returnAllowedInstallPaths()
    {
        $installPaths = ‪self::returnInstallPaths();
        if (empty(‪$GLOBALS['TYPO3_CONF_VARS']['EXT']['allowGlobalInstall'])) {
            unset($installPaths['Global']);
        }
        if (empty(‪$GLOBALS['TYPO3_CONF_VARS']['EXT']['allowLocalInstall'])) {
            unset($installPaths['Local']);
        }
        return $installPaths;
    }
 
    public static function ‪returnAllowedInstallTypes()
    {
        $installPaths = ‪self::returnAllowedInstallPaths();
        return array_keys($installPaths);
    }
 
    public function ‪setSerializedDependencies(‪$dependencies)
    {
        $this->serializedDependencies = ‪$dependencies;
    }
 
    public function ‪getSerializedDependencies()
    {
        return ‪$this->serializedDependencies;
    }
 
    public function ‪setDependencies(‪$dependencies)
    {
        $this->dependencies = ‪$dependencies;
    }
 
    public function ‪getDependencies()
    {
        if (!is_object($this->dependencies)) {
            $extensionModelUtility = $this->objectManager->get(ExtensionModelUtility::class);
            $this->‪setDependencies($extensionModelUtility->convertDependenciesToObjects($this->getSerializedDependencies()));
        }
        return ‪$this->dependencies;
    }
 
    public function ‪addDependency(‪Dependency $dependency)
    {
        $this->dependencies->attach($dependency);
    }
 
    public function ‪setIntegerVersion(‪$integerVersion)
    {
        $this->integerVersion = ‪$integerVersion;
    }
 
    public function ‪getIntegerVersion()
    {
        return ‪$this->integerVersion;
    }
 
    public function ‪setReviewState(‪$reviewState)
    {
        $this->reviewState = ‪$reviewState;
    }
 
    public function ‪getReviewState()
    {
        return ‪$this->reviewState;
    }
 
    public function ‪setPosition(‪$position)
    {
        $this->position = ‪$position;
    }
 
    public function ‪getPosition()
    {
        return ‪$this->position;
    }
 
    public function ‪setAlldownloadcounter(‪$alldownloadcounter)
    {
        $this->alldownloadcounter = ‪$alldownloadcounter;
    }
 
    public function ‪getAlldownloadcounter()
    {
        return ‪$this->alldownloadcounter;
    }
 
    public function ‪getDocumentationLink(): string
    {
        return ‪$this->documentationLink;
    }
 
    public function ‪setDocumentationLink(string ‪$documentationLink): void
    {
        $this->documentationLink = ‪$documentationLink;
    }
}