Exports aus TYPO3 Backend

Für einen Kunden habe ich Module entwickelt, in denen die dargestellten Daten als CSV exportiert werden könnne. Ursprünglich für TYPO3 8 entwickelt, wurden die Module in den letzten Jahren mehrfach aktualisiert, im Moment für TYPO3 11.

Ein Export in einem Backend-Modul kann wie folgt implementiert werden:

public function exportContactListAction(): ResponseInterface
    {
        $records = $this->recordRepository->findAll();
 
        $filename = 'records_list' . '_' . date('Y-m-d') . '.csv';
        $export = $this->createExport($records);
 
        $response = $this->responseFactory->createResponse()
            ->withHeader('Content-Type', 'application/octet-stream')
            ->withHeader('Content-Length', (string)strlen($export))
            ->withHeader('Content-Disposition', 'attachment; filename=' . PathUtility::basename($filename));
        $response->getBody()->write($export);
 
        return $response;
    }

In der Funktion createExport kann ein beliebiger Content generiert werden. Als praktisch hat sich für mich folgende Funktion erwiesen:

CsvUtility::csvValues($dataRow, ';') . "\n";

Man packt die zu exportierenden Daten in ein Array und macht ein Csv daraus.

Geschrieben in TYPO3, TYPO3 v11 | Kommentare deaktiviert für Exports aus TYPO3 Backend

Update Stress und neues Setup

Seit bestimmt zwei Jahren arbeite ich wie folgt: Docker Desktop, DDEV und WSL mit Ubuntu. Dazu nutze ich schon seit langer, langer Zeit mit PhpStorm mit ein paar nützlichen Plugins etc. Dabei liegen die Projekte in der Ubuntu Distribution und ich greife per \\wsl$\ auf sie zu. Im letzten Jahr hat PhpStorm schonmal Probleme bereitet – seit einem Update konnten auf einmal keine Projekte von WSL mehr geladen werden. Zum Glück war ich nicht die einzige mit diesem Problem und durch ein Rollback auf die vorherige Version konnte das Problem behoben werden.

Seit einem Windows Update (?) am Dienstag hatte ich nun wieder das Problem, dass PhpStorm keine Projekte aus der WSL laden wollte. Ich habe mehrmals verschiedene PhpStorm-Versionen installiert, leider immer das gleiche Ergebnis. Ein Kollege von mir schlug vor, alles (WSL, Ubuntu etc.) neu zu installieren. Gute Idee, aber dabei gingen ja die in Ubuntu abgelegten Projekte komplett verloren und mussten daher erstmal gesichert werden. In Linux ist ja das Windows-Laufwerk gemountet, der Zugriff aber ziemlich langsam, daher habe ich alle Projekte aus Ubuntu nach Windows verschoben. Das hat entsprechend den ganzen Tag gedauert. Am Ende des Tages alles neu installiert – und wieder das gleiche Ergebnis – langsamer Zugriff im Explorer und kein Zugriff aufs WSL in PhpStorm.

Dieser Kollege hat aber ein anderes Setup: bei ihm läuft DDEV direkt in Windows. Er startet ddev als nicht wie ich aus Ubuntu, sondern in PowerShell. Das hat bei mir leider nicht funktioniert. Beim Aufruf von ddev in PowerShell kamen nur Fehlermeldungen.

Auf purer Verzweiflung entschloss ich mich, ein vollständiges Backup einzuspielen. Ich nutze seit Jahren Acronis, um vollständiges Backup meiner Hauptplatte zu erstellen. Nun sollte sich zeigen, ob das funktioniert. Das Backup war von Dienstag früh, also zum Glück nicht so alt. Den ganzen Donnerstag rödelte mein armer Rechner, um das Backup einzuspielen (10 Std.?). Die Zeit habe ich zumindest sinnvoll genutzt, um eine Entwicklungsumgebung auf meinem Laptop einzurichten. Und da hat sich gezeigt, dass das folgende Setup erstaunlich gut funktioniert: Docker mit Hyper-V. Voraussetzung dafür ist, dass man Windows Professional nutzt und Virtualisierung erlaubt ist. Dann musste ich Docker nur noch neu installieren und dabei den Haken bei „WSL nutzen“ entfernen.

Das Einspielen des Backups hat sehr gut funktioniert – ein hoch auf Acronis. Das Problem war aber immer noch da – der Zugriff auf WSL war erstaunlich lahm. Nun habe ich also auf meinem Desktop-Rechner ebenfalls das genannte Setup mit Hyper-V und hoffe, dass es lange und update-sicher funktioniert.

Geschrieben in default | Kommentare deaktiviert für Update Stress und neues Setup

TYPO3 Vhs Sprachnavigation Standardsprache fehlt

Ich selbst nutze die Extension Vhs sehr selten, betreue gelegentlich Projekte, die es einsetzen und komme daher nicht drumrum, mich damit zu beschäftigen.

Folgendes Setup: eine Seite mit drei Sprachen – Deutsch [0], Englisch [1] und Polnisch [2]. Die Zahl in Klammern ist die ID der Sprache im System. Wenn ich in Deutsch bin, dann möchte ich zur Auswahl Englisch und Polnisch, auf der englischen Seite Deutsch und Polnisch und auf der polnischen eben Deutsch und Englisch.

So kann man in Flux die Sprachnavigation einsetzen:

<v:page.languageMenu layout="name" />

Wenn man die Auswahl der Sprachen einschränken möchte, dann kann man einen weiteren Parameter mitgeben und darin eine kommaseparierte Liste mit Sprachen.

<v:page.languageMenu layout="name" languages="0,1,2" />

Meiner Logik nach sollte die Sprachauswahl bleiben, wie sie ist. Stattdessen verschwindet die Standardsprache aus der Navigation. Warum das?
In vhs/Classes/ViewHelpers/Page/LanguageMenuViewHelper.php Zeile 292ff.

$limitLanguages = static::arrayFromArrayOrTraversableOrCSVStatic($this->arguments['languages'] ?? []);
$limitLanguages = array_filter($limitLanguages);

Da wird der Wert aus dem Argument mit array_filter verarbeitet. Wird array_filter kein Callback übergeben, dann entfernt es alle leeren Elemente aus dem Array gem. der Definition von empty. Und empty sieht 0 auch als leer an. Damit wird aus der Liste 0,1,2 die 0 entfernt.

Und dann ist da ja noch das Problem mit dem ausblenden der aktiven Sprache. Da wäre ein Parameter sinnvoll gewesen. Die Lösung, um immer die nicht aktiven Sprachen anzuzeigen ist somit ein manuelles Rendering der Sprachnavigation, ohne die Sprachliste einzuschränken, ist somit diese:

<v:page.languageMenu as="languageMenu" flagImageType="png" layout="name">
    <ul>
        <f:for each="{languageMenu}" as="language">
            <f:if condition="{language.current} != 1">
                <li>
                    <a href="{language.url}">{language.label}</a>
                </li>
            </f:if>
        </f:for>
    </ul>
</v:page.languageMenu>

Tags: , ,

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für TYPO3 Vhs Sprachnavigation Standardsprache fehlt

ddev Tipps

Ok, wahrscheinlich ist der Titel „ddev Tipps“ etwas zu hoch gegriffen. Seit einiger Zeit nutze ich ddev (auf Windows mit WSL2) als lokale Entwicklungsumgebung. Meine Anfängliche Skepsis verschwand schnell und nun möchte ich es nicht mehr missen. Ich kann innerhalb von wenigen Minuten jede bestehende Website lokal installieren, wenn man mir Git-Zugangsdaten, einen Datenbank-Dump und fileadmin-Inhalte gibt. Wobei das letztere nicht unbedingt benötigt wird, filefill hilft zur Not auch. PHP Version Umstellen, TYPO3 Updates – alles kein Problem.

Auf dem TYPO3 Camp Rhein-Ruhr habe ich mir einen Vortrag von Wolfgang Wagner angehört zum Thema ddev. Da ich ja schon länger damit arbeite, war mir das meiste schon bekannt, aber ein paar Tipps habe ich mitgenommen.

Mit ddev launch kann man ja das Frontend der Seite aufrufen. Meistens brauche ich direkt das Backend – und das geht mit ddev launch /typo3.

Da ich phpMyAdmin nicht besonders mag und stattdessen HeidiSQL nutze, um auf die Datenbank zuzugreifen, brauche ich den dba-Container nicht, da er unnötig Speicherplatz verbraucht. Man kann in der .ddev/config.yaml in omit_containers in jedem Projekt angeben, dass dieser Container ausgelassen werden soll. Da ich diesen Container nie brauche, kann man man das auch global in ~/.ddev/global_config.yaml konfigurieren.

omit_containers: [dba]

Noch so ein kleiner Tipp: Wenn man mal Mist gebaut hat und die Projektnamen durcheinander gebracht hat, dann finden sich alle ddev-Projekte in dieser Datei ~/.ddev/global_config.yaml. Da kann man dann ein Projekt einfach löschen, falls nötig.

Wie oben beschrieben, greife ich mit HeidiSQL auf meine ddev Datenbanken zu. Dazu definiere ich in ddev einen festen DB Port (host_db_port: "22156"), lege die Verbindung in Heidi einmal an und kann sie immer wieder einfach starten.

Falls mal nur ein Teil der Datenbank aktualisiert werden soll, dann nicht ddev import-db verwenden. Dabei wird die Datenbank gelöscht und neu geschrieben. Falls man nun einen Teil der Daten bekommen hat, dann das hier verwenden. Das Password ist ‚db‘

ddev ssh
mysql -u db -p db < file.sql

Geschrieben in TYPO3 | Kommentare deaktiviert für ddev Tipps

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>

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für Linkhandler mit Links zu Sections

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
        }
    }
}

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für Anzahl Elemente in einer Spalte per TypoScript

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';

Tags:

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für TCA für Typen überschreiben

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

Zugriffsrechte in Tortoise Git ignorieren

Bei einem Projekt wurden die Zugriffsrechte der Dateien angepasst. Daraufhin wurden in Tortoise Git alle Dateien als bearbeitet aufgelistet. Allerding ist dabei die Anzahl Zeilen die dazugekommen bzw. entfernt wurden jeweils 0. Die Lösung ist einfach: (Forum-Eintrag siehe hier: https://superuser.com/questions/138669/why-is-tortoise-git-changing-my-file-permissions)

$ git config core.filemode false

Geschrieben in default | Kommentare deaktiviert für Zugriffsrechte in Tortoise Git ignorieren

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>

Geschrieben in TYPO3, TYPO3 v10 | Kommentare deaktiviert für Mask – IRRE Inhaltselemente ausgeben