Beiträge der Kategorie TYPO3 v10

Linkhandler mit Links zu Sections

Dieser Fall ist etwas speziell, aber vielleicht hilft es jemandem ja weiter. In einem Ordner liegen Datensätze vom Typ FAQ Einträge. Diese können in einem Plugin ausgewählt werden. Nun hatte die Kunden den Wunsch geäußert, aus dem Text in einem FAQ-Element auf ein anderes zu verlinkten. Ich habe den Linkhandler so konfiguriert, dass man aus einem Text mit dem Linkhandler ein FAQ-Elemeent referenzieren kann.

TCEMAIN {
    linkHandler {
        tx_faq {
            handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
            label = FAQ
            configuration {
                table = tx_faq_domain_model_faq
                pageTreeMountPoints = 3870
            }
            scanAfter = page
        }
    }
}

In der Ausgabe gehe ich davon aus, dass das FAQ Element auf der gleichen Seite eingesetzt ist. Ich brauche damit nur einen Link mit Section zu generieren:

  1. config.recordLinks.tx_faq {
  2.     forceLink = 0
  3.     typolink {
  4.         #parameter = current
  5.         parameter.data = TSFE:id
  6.         section.data = field:uid
  7.         section.wrap = faq_|
  8.         useCacheHash = 1
  9.     }
  10. }

In Zeile 4 oder 5 bin ich mir sicher, ob es etwas bewirkt. Lasse ich die Angabe parameter komplett weg, wird kein Link generiert. Daher ist diese Stelle „geraten“. Wenn jemand die richtige Konfiguration kennt, dann gerne her damit.

Generiert wird der Link dann wie folgt: <a href="#faq_140">Typoblindtext</a>

Anzahl Elemente in einer Spalte per TypoScript

In einem Projekt wurden die Elemente in der Header-Spalte immer als Slideshow ausgegeben – auch wenn nur ein Element in dieser Spalte sichtbar war. Ich habe nach einer Möglichkeit gesucht, im Template abzufragen, wie viele Elemente dargestellt werden müssen und dann statt Slideshow einfach nur das Bild auszugeben. Mit diesem TypoScript wird die Anzahl der Elemente korrekt ermittelt und kann dann an das Fluid Template übergeben werden. Es funktionert sogar mit Workspaces.

countHeaderElements = CONTENT
countHeaderElements {
    table = tt_content
    select {
        selectFields = count(uid) AS count
        pidInList = this
        where = {#colPos}=1
        andWhere = (deleted = 0 AND hidden = 0)
    }
 
    renderObj = COA
    renderObj {
        10 = TEXT
        10 {
            data = field:count
        }
    }
}

TCA für Typen überschreiben

Trotz der vielen Anleitungen, ist es jedesmal ein Try and Error das TCA für einen bestimmten Typ zu überschreiben. In diesem Fall sollte für das Element ‚video‘ die Auswahl der Dateitypen eingeschränkt werden.

Um ein Feld für alle Typen zu überschreiben, packt man folgenden Block in my_ext/Configuration/TCA/Overrides/tt_content.php

$GLOBALS['TCA']['tt_content']['columns']['header']['label'] = 'Foobar';

Was überschrieben werden kann, findet man im Backend über das Modul Configuration raus, in dem man sich das TCA anzeigen lässt.

Will man nun etwas für einen bestimmten Typen überschreiben, dann setzt man statt ['columns'] folgendes ein: ['types']['video']['columnsOverrides'].

$GLOBALS['TCA']['tt_content']['types']['introtext']['columnsOverrides']['header']['label'] = 'Foobar';

Bei den Felden mit Kindelementen wird es etwas komplizierter – das ist für alle Typen:

$GLOBALS['TCA']['tt_content']['columns']['assets']['config']['overrideChildTca']['columns']['uid_local']['config']['appearance']['elementBrowserAllowed'] = 'youtube,vimeo';
$GLOBALS['TCA']['tt_content']['columns']['assets']['config']['filter'][0]['parameters']['allowedFileExtensions'] = 'youtube,vimeo';

Nach dem gleichen Prinzip wie beim Header kann diese Konfiguration nur für einen bestimmten Inhaltstyp vorgenommen werden:

$GLOBALS['TCA']['tt_content']['types']['video']['columnsOverrides']['assets']['config']['filter'][0]['parameters']['allowedFileExtensions'] = 'youtube,vimeo';
$GLOBALS['TCA']['tt_content']['types']['video']['columnsOverrides']['assets']['config']['overrideChildTca']['columns']['uid_local']['config']['appearance']['elementBrowserAllowed'] = 'youtube,vimeo';

Event Listener mit Dependancy Injection

Um die News-Ausgabe mit weiteren Daten anzureichern, stellt News Events bereit, auf die reagiert werden kann. Das Event wird dabei in Configuration/Services.yaml registiert. In meinem Fall brauche ich in dem EventListener den Zugriff auf ein Repository. ObjectManager->get gilt seit TYPO3 10 als veraltet, injectXXX-Funktionen werden nicht ausgeführt. Was nun? Ein Fall für Dependancy Injection!

Der Basis Event-Listener sieht so aus und wird (in meinem Fall) in Classes/Event abgelegt:

<?php
use GeorgRinger\News\Event\NewsDateMenuActionEvent;
class EventListener
{
    /**
     * @var \MyNamespace\MyExtension\Domain\Repository\FooRepository
     */
    protected $fooRepository;
 
    /**
     * @param \MyNamespace\MyExtension\Domain\Repository\FooRepository $fooRepository
     */
    public function __construct(\MyNamespace\MyExtension\Domain\Repository\FooRepository $fooRepository)
    {
        $this->fooRepository = $fooRepository;
    }
 
    public function enrichWithAdditionalData(NewsDateMenuActionEvent $event): void
    {
 
    }
}

In Configuration/Services.yaml wird der Event-Listener registriert. Gleichzeitig wird definiert, welchen Typ die Variable $fooRepository beim Erstellen des Listeners haben muss. Wichtig sind dabei die letzten zwei Zeilen: dabei wird die Klasse FooRepository als public definiert, damit sie per Depencancy Injection in einem Listener instanziiert werden kann.

services:
  _defaults:
    autowire: true
    autoconfigure: true

  MyNamespace\MyExtension\Event\EventListener:
    arguments:
      $fooRepository: '@MyNamespace\MyExtension\Domain\Repository\FooRepository'
    tags:
      - name: event.listener
        identifier: 'news-event-listener'
        method: 'enrichWithAdditionalData'
        event: GeorgRinger\News\Event\NewsDateMenuActionEvent

  MyNamespace\MyExtension\Domain\Repository\FooRepository:
    public: true

Doku hier: https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/DependencyInjection/Index.html

Mask – IRRE Inhaltselemente ausgeben

Beim Erstellen von Mask Inhaltslementen kann man als Typ „Inhalte“ wählen. In der Anleitung fehlt die Angabe, wie man diese Inhaltselemente im Frontend ausgegeben bekommt. Dabei ist es so einfach:

<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
      xmlns:mask="http://typo3.org/ns/MASK/Mask/ViewHelpers"
      data-namespace-typo3-fluid="true">
 
<f:if condition="{data.tx_mask_irre_contents}">
    <f:for each="{data.tx_mask_irre_contents}" as="content">
        <mask:content uid="{content.uid}" />
    </f:for>
</f:if>

TYPO3 Extension Settings im Scheduler Task auslesen

Ich brauche die Settings eines Plugins im Scheduler. Es gibt zwar zahlreiche Snippets und Hinweise, wie es gehen soll, die alle nicht funktioniert haben. Dieses Snippet ist getestet unter TYPO3 10.

Da man sich im Backend befindet, müssen die Settings von plugin nach module kopiert werden:

module.tx_myextension < plugin.tx_myextension

Meine Extension heißt beispielhaft my_extension und ich habe im TypoScript die Konfiguration für alle Plugins gesetzt.

Im Scheduler-Task kann man auf die Settings dann wie folgt zugreifen. Zu beachten dabei die Schreibweise des Extensionnames, es ist CamelCase.

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Extbase\Configuration\ConfigurationManager;
 
$configurationManager = GeneralUtility::makeInstance(ConfigurationManager::class);
$configuration = $configurationManager->getConfiguration(
    ConfigurationManager::CONFIGURATION_TYPE_SETTINGS,
    'MyExtension'
);

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für TYPO3 Extension Settings im Scheduler Task auslesen

TCA für Image Manipulation (crop) in eigener Extension

Es gibt ein paar Beispiele im Netz, wie man Bild-Manipuation für tt_content aktiviert und Crop-Varianten (cropVariants) definiert. Ich habe kein Beispiel gefunden, wie man in seiner eigenen Extension direkt einem Bild-Feld Crop-Eigenschaften mitgeben kann. Nach langer Suche und viel rumprobieren ist das mein Ergebnis, das funktioniert.

'stage_image' => [
    'exclude' => true,
    'label' => 'LABEL',
    'config' => \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::getFileFieldTCAConfig(
        'stage_image',
        [
            'appearance' => [
                'createNewRelationLinkTitle' => 'LLL:EXT:frontend/Resources/Private/Language/locallang_ttc.xlf:images.addFileReference'
            ],
            'overrideChildTca' => [
                'types' => [
                    '0' => [
                        'showitem' => '
                        --palette--;;imageoverlayPalette,
                        --palette--;;filePalette'
                    ],
                    \TYPO3\CMS\Core\Resource\File::FILETYPE_IMAGE => [
                        'showitem' => '
                        --palette--;;imageoverlayPalette,
                        --palette--;;filePalette'
                    ],
                ],
                'columns' => [
                    'crop' => [
                        'config' => [
                            'cropVariants' => [
                                'default' => [
                                    'title' => 'Desktop',
                                    'allowedAspectRatios' => [
                                        'default' => [
                                            'title' => 'Rechteckig 22:9',
                                            'value' => 2.4
                                        ],
                                    ],
                                ],
                            ],
                        ],
                    ],
                ],
            ],
            'foreign_match_fields' => [
                'fieldname' => 'stage_image',
                'tablenames' => 'xxx',
                'table_local' => 'sys_file',
            ],
            'maxitems' => 1,
        ],
        $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']
    ),
],

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für TCA für Image Manipulation (crop) in eigener Extension

TYPO3 – Domain Property als Boolean validieren

Ich habe lange gesucht und kein Beispiel gefunden, daher hoffe ich, dass ich damit jemandem die Sucherei und das Quellcode-Lesen ersparen kann.

Möchte man eine Property als Boolean validieren, dann lautet die Annotation wie folgt:

use TYPO3\CMS\Extbase\Annotation as Extbase;
 
/**
 * @var boolean
 * @Extbase\Validate(validator="Boolean", options={"is": "1"})
 * @Extbase\ORM\Transient
 */
protected $privacy;

Die Begründung ist, dass für die Abwärtskompabitilität nicht per Default validiert werden kann. Denn alle Properties vom Typ Boolean werden damit validiert.