Skip to content

[!!!][TASK] Remove TCA field related search options #1266

Open
@TYPO3IncTeam

Description

@TYPO3IncTeam

ℹ️ View this commit on Github
👥 Authored by Oliver Bartsch [email protected]
✔️ Merged by Georg Ringer [email protected]

Commit message

[!!!][TASK] Remove TCA field related search options

The TCA field search configuration is removed.
This includes the following options:

  • search[case]
  • search[pidonly]
  • search[andWhere]

These options were not used in TYPO3 Core or
common extensions, offered unclear benefits,
and added unnecessary complexity to TCA
configuration.

Their removal is part of our effort to simplify
and modernize TCA.

Resolves: #106976
Releases: main
Change-Id: Ib1304bc05653a76077e7feb153e3c97886fea492
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/89885
Tested-by: core-ci [email protected]
Reviewed-by: Andreas Kienast [email protected]
Tested-by: Stefan Bürk [email protected]
Tested-by: Georg Ringer [email protected]
Reviewed-by: Georg Ringer [email protected]
Reviewed-by: Stefan Bürk [email protected]

➕ Added files

14.0/Breaking-106976-RemovalOfTCASearchFieldConfigurationOptions.rst
..  include:: /Includes.rst.txt

..  _breaking-106976-1750865819:

=====================================================================
Breaking: #106976 - Removal of TCA search field configuration options
=====================================================================

See :issue:`106976`

Description
===========

The following TCA field  level search configuration options have been **removed**:

* :php:`search.case`
* :php:`search.pidonly`
* :php:`search.andWhere`

These options were originally intended to customize backend record search
behavior, but they have proven to be of little practical value:

- They were not used in TYPO3 Core,
- They are not used in common third-party extensions,
- They had unclear behavior and inconsistent support,
- They were insufficiently documented and hard to validate.

The removal is part of an ongoing effort to simplify and streamline the TCA
configuration and reduce cognitive load for integrators.

Impact
======

Any of those option are no longer evaluated. They are automatically removed at
runtime through a TCA migration, and a deprecation log entry is generated to
highlight where adjustments are required.

Affected Installations
======================

Any installation or extension that uses any of those options in their TCA
field configuration:

.. code-block:: php

   'my_field' => [
       'config' => [
           'type' => 'input',
           'search' => [
               'case' => true,
               'pidonly' => true,
               'andWhere' => '{#CType}=\'text\'',
           ],
       ],
   ],

Migration
=========

Remove the obsolete :php:`search` options from your TCA field configurations.

..  index:: TCA, FullyScanned, ext:core

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions