TYPO3 Logo
TYPO3 Core Changelog
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

TYPO3 Core Changelog

  • ChangeLog v14
    • 14.0 Changes
    • 14.x Changes by type
  • ChangeLog v13
    • 13.4.x Changes
    • 13.4 Changes
    • 13.3 Changes
    • 13.2 Changes
    • 13.1 Changes
    • 13.0 Changes
    • 13.x Changes by type
  • ChangeLog v12
    • 12.4.x Changes
    • 12.4 Changes
    • 12.3 Changes
    • 12.2 Changes
    • 12.1 Changes
    • 12.0 Changes
    • 12.x Changes by type
  • ChangeLog v11
    • 11.5.x Changes
    • 11.5 Changes
    • 11.4 Changes
    • 11.3 Changes
    • 11.2 Changes
    • 11.1 Changes
    • 11.0 Changes
    • 11.x Changes by type
  • ChangeLog v10
    • 10.4.x Changes
    • 10.4 Changes
    • 10.3 Changes
    • 10.2 Changes
    • 10.1 Changes
    • 10.0 Changes
    • 10.x Changes by type
  • ChangeLog v9
    • 9.5.x Changes
    • 9.5 Changes
    • 9.4 Changes
    • 9.3 Changes
    • 9.2 Changes
    • 9.1 Changes
    • 9.0 Changes
    • 9.x Changes by type
  • ChangeLog v8
    • 8.7.x Changes
    • 8.7 Changes
    • 8.6 Changes
    • 8.5 Changes
    • 8.4 Changes
    • 8.3 Changes
    • 8.2 Changes
    • 8.1 Changes
    • 8.0 Changes
    • 8.x Changes by type
  • ChangeLog v7
    • 7.6.x Changes
    • 7.6 Changes
    • 7.5 Changes
    • 7.4 Changes
    • 7.3 Changes
    • 7.2 Changes
    • 7.1 Changes
    • 7.0 Changes
    • 7.x Changes by type
  • Documenting Changes
  • Sitemap
  1. TYPO3 Core Changelog
  2. ChangeLog v12
  3. 12.1 Changes
  4. Feature: #99033 - Add table filter for backend search
Give feedback Edit on GitHub

Feature: #99033 - Add table filter for backend search

See forge#99033

Description

The TYPO3 backend search (aka "Live Search") is using the \TYPO3\CMS\Backend\Search\LiveSearch\DatabaseRecordProvider to search for records in database tables, having searchFields configured in TCA.

In some individual cases, it may not be desired to search in a certain table. Therefore, the new event \TYPO3\CMS\Backend\Search\Event\BeforeSearchInDatabaseRecordProviderEvent has been introduced, which allows to exclude / ignore such tables by adding them to a deny list. Additionally, the new PSR-14 event can be used to further limit the search result on certain page IDs or to modify the search query altogether.

The event features the following methods:

  • getSearchPageIds(): Returns the page ids to search in
  • setSearchPageIds(): Allows to define page ids to search in
  • getSearchDemand(): Returns the SearchDemand, used by the live search
  • setSearchDemand(): Allows to set a custom SearchDemand object
  • ignoreTable(): Allows to ignore / exclude a table from the lookup
  • setIgnoredTables(): Allows to overwrite the ignored tables
  • isTableIgnored(): Returns whether a specific table is ignored
  • getIgnoredTables(): Returns all tables to be ignored from the lookup

Registration of the event in your extension's Services.yaml:

MyVendor\MyPackage\EventListener\BeforeSearchInDatabaseRecordProviderEventListener:
  tags:
    - name: event.listener
      identifier: 'my-package/before-search-in-database-record-provider-event-listener'
Copied!

The corresponding event listener class:

use TYPO3\CMS\Backend\Search\Event\BeforeSearchInDatabaseRecordProviderEvent;

final class ModifyEditFileFormDataEventListener
{
    public function __invoke(BeforeSearchInDatabaseRecordProviderEvent $event): void
    {
        $event->ignoreTable('my_custom_table');
    }
}
Copied!

Impact

It is now possible to ignore specific tables from the backend search using the new PSR-14 event BeforeSearchInDatabaseRecordProviderEvent. The event also allows to adjust the page IDs to search in as well as to modify the corresponding SearchDemand object.

  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: Jul 04, 2025 09:57

© since 1997 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy