..  include:: /Includes.rst.txt
..  _columns-inline:
..  _columns-inline-introduction:

=============
IRRE / inline
=============

..  versionadded:: 13.0
    When using the `inline` type, TYPO3
    :ref:`generates the correct database fields <t3coreapi:auto-generated-db-structure>`.
    Developers do not need to define this field in an extension's
    :file:`ext_tables.sql` file.

Inline Relational Record Editing (IRRE) is a way of editing parent-child-relations in the backend view.
Instead of child records already having to exist, new child records are created
using AJAX calls (to prevent reloading the complete backend view).

The :ref:`according database field <t3coreapi:auto-generated-db-structure>`
is generated automatically.

..  note::
    Inline fields should not be used anymore to handle files.  Use the TCA
    column type :ref:`file <columns-file>` instead.

The type='inline' is a powerful element that can handle many types of relation,
including simple :code:`1:n` and nested :code:`1:n-1:n` relations, aswell as :code:`m:n`
relations with different view aspects and localization setups. When combined with
'ctrl' and 'types' properties in the TCA a huge amount of different views are possible.

The inline type was mainly designed to handle :code:`1:n` relations,
where one parent record has many children and each child has only one
parent. Children can not be transferred from one parent to another.

However, :code:`m:n` relations can be setup using intermediate tables. An :code:`m:n`
relation is where a child has many parents. In addition to the main parent-child
relation fields in the intermediate table, fields can be added to attach
additional information to the parent-child relation. One example of this is
"FAL" / resource handling in the Core. A parent record
(for instance table "tt_content") is connected via table "sys_file_reference" to
a media resource in "sys_file". A sys_file record has table "sys_file_metadata"
as a child record which holds meta information about the file (for instance a
description). This information can be overwritten for the specific file resource used in
"tt_content" by adding a new description in "sys_file_reference". There are inline
and field properties in the TCA such as "placeholder" to set this up.

..  hint::

    The inline type does not have :code:`fieldInformation`,
    :code:`fieldControl` or :code:`fieldWizard` properties like other types. This is
    due to the fact that it is a container and not an element. You can
    still add fieldInformation or fieldWizard, but they must be configured
    in the :code:`ctrl`. Please see the
    :ref:`example <inline-example-field-information>`.

..  contents:: Table of contents:
    :local:
    :depth: 1

..  toctree::
    :titlesonly:

    Examples

..  _columns-inline-properties:
..  _columns-inline-properties-type:

Properties of the TCA column type `inline`
==========================================

..  confval-menu::
    :name: inline
    :display: table
    :type:
    :Scope:

    ..  include:: _Properties/_*.rst.txt
        :show-buttons:

..  _columns-inline-workspaces:

Inline fields and workspaces
============================

..  deprecated:: 14.0
    Using a workspace aware parent table with a not workspace aware child table
    is deprecated in TYPO3 v14. An automatic TCA migration is in place to scan
    TCA columns for this scenario and to add :php:`versioningWS = true;` to
    the affected child tables.

TCA tables that are used as `inline` child table in a standard
`foreign_table  <https://docs.typo3.org/permalink/t3tca:confval-inline-properties-foreign-table>`_
relationship must be declared workspace aware if the parent table is workspace
aware. A typical scenario are inline child tables attached to the
`tt_content` table as the latter is workspace aware by default.

Example for workspace-aware parent table:

..  literalinclude:: _Snippets/_workspace_parent.php
    :caption: packages/my_extension/Configuration/TCA/tx_myextension_myparent.php

If the parent table is workspace aware, `versioningWS  <https://docs.typo3.org/permalink/t3tca:confval-ctrl-versioningws>`_
set to `true`, the child table must also be made parent aware:

..  literalinclude:: _Snippets/_workspace_child.php
    :caption: packages/my_extension/Configuration/TCA/tx_myextension_mychild.php

The same applies if an inline field is used within a
`FlexForm field <https://docs.typo3.org/permalink/t3tca:columns-flex>`_.