TYPO3 v14: Extending the Records Module with Visual View Modes

Anyone working with extensive TYPO3 installations knows the situation: The Records module displays records as a table – functional, but lacking clarity when dealing with hundreds of news articles or products. The Records List Types extension provides a solution: Three additional view modes featuring thumbnails and drag & drop make daily work noticeably more efficient.

Table of Contents  

Why a New List View?  

The standard list module in TYPO3 is solid but limited to one form of presentation. For image-heavy content such as news, products, or galleries, visual orientation is missing. The extension enhances the module with grid, compact, and teaser views – editors can choose for themselves what best suits their workflow.

View Modes  

mod.web_list.gridView.table.tx_news_domain_model_news {
    titleField = title
    descriptionField = teaser
    imageField = fal_media
    preview = 1
}

Features at a Glance  

Installation  

# Installation via Composer
composer require webconsulting/records-list-types

# Activate extension
./vendor/bin/typo3 extension:activate records_list_types

After activation, the view mode buttons will appear in the header of the Records module.

Configuration via TSconfig  

Defining Fields per Table  

You can granularly control via TSconfig which fields appear in the grid or teaser view:

mod.web_list.gridView.table.tx_news_domain_model_news {
    titleField = title
    descriptionField = teaser
    imageField = fal_media
    preview = 1
}

Setting the Default View  

mod.web_list.viewMode.default = grid

Developing Custom View Types  

The extension is deliberately designed to be extensible. A custom view consists of three components:

<?php
namespace Vendor\Extension\EventListener;

use Webconsulting\RecordsListTypes\Event\RegisterViewModesEvent;

final class CustomViewModeListener
{
    public function __invoke(RegisterViewModesEvent $event): void
    {
        $event->addViewMode(
            identifier: 'kanban',
            label: 'Kanban Board',
            icon: 'actions-view-tiles',
            template: 'EXT:my_extension/Resources/Private/Templates/Kanban.html'
        );
    }
}

Architecture Overview  

Security  

The extension follows the TYPO3 Security Guidelines:

• Input Validation: User inputs are validated and sanitised
• SQL Injection Prevention: TYPO3's QueryBuilder with parameterised queries
• CSRF Protection: AJAX endpoints utilise TYPO3's token handling
• Access Control: Compliance with backend user permissions

Documentation & Resources  

Summary  

Records List Types makes the TYPO3 backend more flexible. Three view modes, drag & drop, and persistent user preferences improve everyday editorial work – without any configuration effort after installation.

What you get:

• Three pre-configured view modes: grid, compact, teaser
• Drag & drop sorting in the grid view
• Extensible with custom view types (PSR-14 / TSconfig)
• Persistent user preferences and dark mode