40+ Erweiterungen in TYPO3 v10 für Entwickler: Serie 5

Vendor\MyExtension\Widgets\MyFirstWidget:
    tags:
        -
        name: dashboard.widget
        identifier: widget-identifier-1
        widgetGroups: ’general’

class: Vendor\MyExtension\Widgets\MySecondWidget
    tags:
        -
        name: dashboard.widget
        identifier: widget-identifier-2
        widgetGroups: ’general, typo3’

EXT:my_extension/Configuration/Backend/DashboardWidgetGroups.php
    return [
    ’widgetGroup-exampleGroup’ => [
        ’title’ => ’LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:widget_group_name’,
    ],
];

symfony/mime // for creating mail messages
symfony/mailer // for sending emails

$email = GeneralUtility::makeInstance(MailMessage::class)
->to(new Address('kasperYYYY@typo3.org'), new Address('benni@typo3.org', 'Benni Mack'))
->subject('This is an example email')
->text('This is the plain-text variant')
->html('Hello Benni.
Enjoy a HTML-readable email. We love TYPO3.');

$email->send();

$GLOBALS['TYPO3_CONF_VARS']['MAIL']['templateRootPaths'][700] = 'EXT:my_site_extension/Resources/Private/Templates/Email';
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['layoutRootPaths'][700] = 'EXT:my_site_extension/Resources/Private/Layouts';

$email
    ->to('contact@acme.com')
    ->from(new Address('jeremy@acme.com', 'Jeremy'))
    ->subject('TYPO3 loves you - here is why')
    ->setFormat('html') // only HTML mail
    ->setTemplate('TipsAndTricks')
    ->assign('mySecretIngredient', 'Tomato and TypoScript');
GeneralUtility::makeInstance(Mailer::class)->send($email);

<f:section name="Subject"> New Login at "{typo3.sitename}"</f:section>

# Configuration/Services.yaml
Services:
    _defaults:
        autowire: true
        autoconfigure: true
        public: false
    Your\Namespace\:
        resource: ’../Classes/*’

services:
    Vendor\Example\EventListener\NullMailer:
    tags:
        - { name: event.listener, identifier: ’myListener’, event: TYPO3\CMS\Core\Mail\Event\
        AfterMailerInitializationEvent, before: ’redirects, anotherIdentifier’ }

define(’PERMISSIONS_javascript’, 0b0); // 0
define(’PERMISSIONS_PAGE_SHOW’, 0b1); // 1
define(’PERMISSIONS_PAGE_EDIT’, 0b10); // 2
define(’PERMISSIONS_PAGE_DELETE’, 0b100); // 4
define(’PERMISSIONS_PAGE_NEW’, 0b1000); // 8
define(’PERMISSIONS_CONTENT_EDIT’, 0b10000); // 16
define(’PERMISSIONS_ALL’, 0b11111); // 31

$bitSet = new \TYPO3\CMS\Core\Type\BitSet(PERMISSIONS_PAGE_SHOW | PERMISSIONS_PAGE_NEW);
$bitSet->get(PERMISSIONS_PAGE_SHOW); // true
$bitSet->get(PERMISSIONS_CONTENT_EDIT); // false

\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin()
\TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule()

\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin(
    ’ExampleBlog’, // previously: ’Vendor.ExampleBlog’
    ’pi1’,
    [
        \Vendor\Example\Controller\BlogController::class => ’list,update,delete’
    ],
    [
        \Vendor\Example\Controller\BlogController::class => ’list,update,delete’
    ]
);

use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
use ExtbaseTeam\BlogExample\Domain\Model\Comment;
class Post
{
    /**
    * @var ObjectStorage
    */
    public $comments;
}

Vendor\Example\Domain\Validator\BlogValidator
use Vendor\Example\Domain\Model\Blog;
use TYPO3\CMS\Extbase\Annotation as Extbase;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;

class BlogController extends ActionController
{
    /**
    * @Extbase\Validate(param="blog", validator="Vendor\Example\Domain\Validator\BlogValidator")
    */

    public function showAction(Blog $blog)
    {
        // ...
    }
}

require([
'TYPO3/CMS/Backend/ActionButton/ImmediateAction',
'TYPO3/CMS/Backend/ActionButton/DeferredAction',
'TYPO3/CMS/Backend/Notification'
], function(ImmediateAction, DeferredAction, Notification) {
    const immediateActionCallback = new ImmediateAction(function () { /* your action code */ });
        Notification.info(
            'Great! We are almost done here...',
            'Common default settings have been applied based on your previous input.',
            0,
        [
            {label: 'Show settings', action: immediateActionCallback}
        ]
    );
});

# Configuration/Extbase/Persistence/Classes.php:

    declare(strict_types = 1);
        return [
            \Vendor\Example\Domain\Model\Author::class => [
                ’tableName’ => ’fe_users’,
                ’properties’ => [
                ’fullname’ => [
                ’fieldName’ => ’name’
            ]
        ]
    ]
];

class MyClass
{
    /**
    * @var TYPO3\CMS\Core\Cache\Frontend\FrontendInterface
    */

    private $cache;
    public function __construct()
    {
        $cacheManager = GeneralUtility::makeInstance(CacheManager::class);
        $this->cache = $cacheManager->getCache(’my_cache’);
    }
}

class MyClass
{
    /**
    * @var TYPO3\CMS\Core\Cache\Frontend\FrontendInterface
    */

    private $cache;
    public function __construct(FrontendInterface $cache)
    {
        $this->cache = $cache;
    }
}

services:
    cache.my_cache:
    class: TYPO3\CMS\Core\Cache\Frontend\FrontendInterface
    factory: [’@TYPO3\CMS\Core\Cache\CacheManager’, ’getCache’]
    arguments: [’my_cache’]
MyClass:
    arguments:
    $cache: ’@cache.my_cache’

// PSR-17 consists of six factory interfaces:
\Psr\Http\Message\RequestFactoryInterface
\Psr\Http\Message\ResponseFactoryInterface
\Psr\Http\Message\ServerRequestFactoryInterface
\Psr\Http\Message\StreamFactoryInterface
\Psr\Http\Message\UploadedFileFactoryInterface
\Psr\Http\Message\UriFactoryInterface

// PSR-18 consists of a client interface and three exception interfaces:
\Psr\Http\Client\ClientInterface
\Psr\Http\Client\ClientExceptionInterface
\Psr\Http\Client\NetworkExceptionInterface
\Psr\Http\Client\RequestExceptionInterface

// ext_localconf.php
$GLOBALS[’TYPO3_CONF_VARS’][’SYS’][’fal’][’processors’][’ExampleImageProcessor’] = [
    ’className’ => \Vendor\MyExtension\Resource\Processing\ExampleImageProcessor::class,
    ’before’ => ’LocalImageProcessor’,
];

imports:
    - { resource: "EXT:my_extension/Configuration/FooBar/Example.yaml" }
another:
    option: true

imports:
    - { resource: "subfolder/AnotherExample.yaml" }
    - { resource: "../path/to/configuration/AnotherExample.yaml" }
another:
    option: true

<f:widget.autocomplete for="name" objects="{posts}" searchProperty="author" storeSession="false" />

TYPO3\CMS\Core\Imaging\Event\ModifyIconForResourcePropertiesEvent
TYPO3\CMS\Core\DataHandling\Event\IsTableExcludedFromReferenceIndexEvent
TYPO3\CMS\Core\DataHandling\Event\AppendLinkHandlerElementsEvent
TYPO3\CMS\Core\Configuration\Event\AfterTcaCompilationEvent
TYPO3\CMS\Core\Database\Event\AlterTableDefinitionStatementsEvent
TYPO3\CMS\Core\Tree\Event\ModifyTreeDataEvent
TYPO3\CMS\Backend\Backend\Event\SystemInformationToolbarCollectorEvent

TYPO3\CMS\Core\Configuration\Loader\PageTsConfigLoader
TYPO3\CMS\Core\Configuration\Parser\PageTsConfigParser

// Fetch all available PageTS of a page/rootline:
$loader = GeneralUtility::makeInstance(PageTsConfigLoader::class);
$tsConfigString = $loader->load($rootLine);

// Parse the string and apply conditions:
$parser = GeneralUtility::makeInstance(
PageTsConfigParser::class, $typoScriptParser, $hashCache
);
$pagesTSconfig = $parser->parse($tsConfigString, $conditionMatcher);

$GLOBALS[’TYPO3_CONF_VARS’][’SYS’][’systemLog’]
$GLOBALS[’TYPO3_CONF_VARS’][’SYS’][’systemLogLevel’]

use TYPO3\CMS\Core\Pagination\ArrayPaginator;

$items = [’apple’, ’banana’, ’strawberry’, ’raspberry’, ’ananas’];
$currentPageNumber = 3;
$itemsPerPage = 2;

$paginator = new ArrayPaginator($itemsToBePaginated, $currentPageNumber, $itemsPerPage);
$paginator->getNumberOfPages(); // returns 3
$paginator->getCurrentPageNumber(); // returns 3
$paginator->getKeyOfFirstPaginatedItem(); // returns 5
$paginator->getKeyOfLastPaginatedItem(); // returns 5

<code class="language-markup"><be:link.editRecord uid="42" table="tt_content" fields="bodytext" returnUrl="foo/bar">
    Edit record
</be:link.editRecord>

<f:asset.css identifier="identifier123" href="EXT:my_ext/Resources/Public/Css/foo.css" />
<f:asset.css identifier="identifier123">
    .foo { color: black; }
</f:asset.css>

<f:asset.script identifier="identifier123" src="EXT:my_ext/Resources/Public/JavaScript/foo.js" />
<f:asset.script identifier="identifier123">
    alert('hello world');
</f:asset.script>

GeneralUtility::makeInstance(AssetCollector::class)
->addJavaScript('my_ext_foo', 'EXT:my_ext/Resources/Public/JavaScript/foo.js', ['data-foo' => 'bar']])

TYPO3\CMS\Frontend\Event\ModifyHrefLangTagsEvent

TYPO3\CMS\RteCKEditor\Form\Element\Event\AfterGetExternalPluginsEvent
TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforeGetExternalPluginsEvent
TYPO3\CMS\RteCKEditor\Form\Element\Event\AfterPrepareConfigurationForEditorEvent
TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforePrepareConfigurationForEditorEvent

// EXT:my_extension/Configuration/Services.yaml
services:
    Vendor\MyExtension\EventListener\RteConfigEnhancer:
    tags:
    - name: event.listener
        identifier: 'ext-myextension/rteConfigEnhancer'
        method: 'beforeGetExternalPlugins'
        event: TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforeGetExternalPluginsEvent
    - name: event.listener
        identifier: 'ext-myextension/rteConfigEnhancer'
        method: 'beforePrepareConfiguration'
        event:
TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforePrepareConfigurationForEditorEvent

// EXT:my_extension/Classes/EventListener/RteConfigEnhancer.php
namespace Vendor\MyExtension\EventListener;

use TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforeGetExternalPluginsEvent;
use TYPO3\CMS\RteCKEditor\Form\Element\Event\BeforePrepareConfigurationForEditorEvent;

class RteConfigEnhancer
{
    public function beforePrepareConfiguration(BeforePrepareConfigurationForEditorEvent $event): void
    {
        $data = $event->getData();
        // @todo make useful decisions on fetched data
        $configuration = $event->getConfiguration();
        $configuration['extraPlugins'][] = 'example_plugin';
        $event->setConfiguration($configuration);
    }
}

require(['TYPO3/CMS/Core/Ajax/AjaxRequest'], function (AjaxRequest) {
const request = new AjaxRequest('https://httpbin.org/json');
    request.get().then(
        async function (response) {
            const data = await response.resolve();
            console.log(data);
        }, function (error) {
            console.error('Request failed because of error: ' + error.status + ' ' + error.statusText);
        }
    );
});

Modal.confirm(’Header’, ’Some content’, Severity.error, [
    {
        text: ’Based on trigger()’,
        trigger: function () {
            console.log(’Vintage!’);
        }
    },
    {
        text: ’Based on action()’,
        action: new DeferredAction(() => {
            return new AjaxRequest(’/any/endpoint’).post({});
        })
    }
]);

require(['TYPO3/CMS/Core/Event/RegularEvent'], function (RegularEvent) {
    new RegularEvent('click', function (e) {
        // Do something
    }).bindTo(document.querySelector('#my-element'));
});

class MyClass
{
    public $myProperty = 'foo';
}

$property = GeneralUtility::makeInstance(\TYPO3\CMS\Extbase\Reflection\ReflectionService::class)
    ->getClassSchema(MyClass::class)
    ->getProperty('myProperty');

$defaultValue = $property->getDefaultValue(); // "foo"

$GLOBALS['TCA']['pages']['columns']['field_name']['config']['fieldControl']['linkPopup'] = [
    'renderType' => 'linkPopup',
];

EXT:my_extension/Configuration/TCA/Overrides/pages.php
    'ctrl' => [
        'typeicon_classes' => [
        '123' => "your-icon",
        '123-contentFromPid' => "your-icon-contentFromPid",
        '123-root' => "your-icon-root",
        '123-hideinmenu' => "your-icon-hideinmenu",
    ],
]

TYPO3:
    CMS:
        Form:
            prototypes:
                standard:
                    formElementsDefinition:
                        ContentElement:
                            formEditor:
                                editors:
                                    # ...
                                    300:
                                    identifier: contentElement
                                    # ...
                                    browsableType: tt_content
                                    iconIdentifier: mimetypes-x-content-text
                                    propertyPath: properties.contentElementUid
                                    # ...

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['felogin']['password_changed'][] = \Your\Namespace\Hooks\MyBeautifulHook::class . '->passwordChanged';

public function passwordChanged(array &$params)
{
    if($params['newPasswordUnencrypted']==='password'){
        $params['passwordValid']=FALSE;
        $params['passwordInvalidMessage']='Do not use password as password';
    }
}

imports:
    -
    resource: 'Env_%env("foo")%.yaml'

$queryBuilder-$gt;set($fieldName, $fieldValue, true, \PDO::PARAM_INT);

// typo3conf/AdditionalConfiguration.php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][\TYPO3\CMS\Core\Locking\FileLockStrategy::class]['priority'] = 10;
// The directory specified here must exist und must be a subdirectory of `Environment::getProjectPath()`
$GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][\TYPO3\CMS\Core\Locking\FileLockStrategy::class]['lockFileDir'] = 'mylockdir';  

// Your Class
public static function getPriority()
{
    return $GLOBALS['TYPO3_CONF_VARS']['SYS']['locking']['strategies'][self::class]['priority']
    ?? self::DEFAULT_PRIORITY;
}

./typo3/sysext/core/bin/typo3 scheduler:run --task 1 --task 2

#LocalConfiguration.php
$GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash'] = [
    'excludedParameters' => [
        'utm_source',
        'utm_medium',
        '^utm_', // making previous two obsolete
    ],
    'excludedParametersIfEmpty' => [
        '^tx_my_plugin[aspects]',
        'tx_my_plugin[filter]',
    ],
];