PHPackages                             xima/xima-typo3-recordlist - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. xima/xima-typo3-recordlist

ActiveLibrary

xima/xima-typo3-recordlist
==========================

This package provides an abstract class for creating TYPO3 backend modules that display a feature-rich and easy-to-customize list view of records. It also includes built-in simplified TYPO3 workspace integration.

14.0.0(3mo ago)09.8k—6.5%[3 issues](https://github.com/xima-media/xima-typo3-recordlist/issues)[1 PRs](https://github.com/xima-media/xima-typo3-recordlist/pulls)GPL-2.0-or-laterPHPPHP ^8.2CI failing

Since Sep 4Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/xima-media/xima-typo3-recordlist)[ Packagist](https://packagist.org/packages/xima/xima-typo3-recordlist)[ Docs](https://www.xima.de)[ RSS](/packages/xima-xima-typo3-recordlist/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (16)Versions (32)Used By (0)

[![Extension icon](Resources/Public/Icons/Extension.svg)](Resources/Public/Icons/Extension.svg)

TYPO3 Recordlist
================

[](#typo3-recordlist)

**Quickly create feature-rich TYPO3 backend modules for managing records**

[![TYPO3](https://camo.githubusercontent.com/1b6c390eac52f128bcf2640be62fe0e7cbbd2e99fbd02ea8d393a0ee0d71de95/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31332e3425323025374325323031342e302d6f72616e67652e737667)](https://typo3.org/)[![PHP](https://camo.githubusercontent.com/5fe05c705bf034839bda7651781e4d0a9d42f4a840478ca5e343873a0361bb89/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d626c75652e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/36be30f8feb7f55eb28b8a3026863de08ab79c957b768d8f16009c2f5cff8830/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d2d6f722d2d6c617465722d677265656e2e737667)](LICENSE)

---

This extension provides a powerful abstract controller for creating advanced record listing backend modules in TYPO3. Save development time by extending `AbstractBackendController` instead of building record lists from scratch.

[![Screenshot](Documentation/Images/Preview.png)](Documentation/Images/Preview.png)

Table of Contents
-----------------

[](#table-of-contents)

- [Why Use This Extension?](#why-use-this-extension)
- [Features](#features)
- [Requirements](#requirements)
- [Install](#install)
- [Quick Start](#quick-start)
- [Customization](#customization)
    - [Templates](#templates)
    - [Custom Template Configurations](#custom-template-configurations)
    - [Modifying Records](#modifying-records)
    - [Custom Filters](#custom-filters)
    - [Column Configuration](#column-configuration)
    - [Custom Actions](#custom-actions)
- [Documentation](#documentation)
- [Contributing](#contributing)

Why Use This Extension?
-----------------------

[](#why-use-this-extension)

Building custom backend modules for listing and managing records typically requires significant boilerplate code. This extension eliminates that overhead by providing:

- **Rapid Development**: Get a fully-functional backend module with just a few lines of code
- **Rich Features Out-of-the-Box**: Filtering, sorting, pagination, inline editing, and more
- **Multiple Table Support**: Manage related tables in a single module with automatic table switching
- **Workspace Integration**: Built-in support for TYPO3 workspaces with simplified approval workflows
- **Highly Customizable**: Override templates, modify queries, add custom columns, and extend behavior

Features
--------

[](#features)

- **List records** from any TYPO3 table
- **Filter records** by any field with customizable filters
- **Sort records** by any column
- **Configurable columns** with user-customizable visibility and order
- **Inline editing** for quick record updates
- **Multiple tables** in a single module with dropdown selection
- **Multiple templates** with per-template action control
- **Workspace integration** for content approval workflows
- **Pagination** for handling large datasets
- **View record** button linking to frontend preview
- **Row selection** with checkbox, row click, and keyboard shortcuts (Shift+Click, Ctrl/Alt+Click)
- **Batch field editing** from column headers for selected or all records

Requirements
------------

[](#requirements)

- TYPO3 13.4+ or 14.0+
- PHP 8.2+

Install
-------

[](#install)

```
composer require xima/xima-typo3-recordlist
```

Quick Start
-----------

[](#quick-start)

Get a working backend module in 3 simple steps:

### 1. Extend new controller from `AbstractBackendController`

[](#1-extend-new-controller-from-abstractbackendcontroller)

The controller implements the `BackendControllerInterface` which requires you to add the methods `getTableNames()` and `getRecordPid()`:

```