content_tab_switcher.md

description
Tabs switcher allows separating the default field types in the content type from the field types that enhance the content with new functionalities.

Tab switcher in content edit page

Tabs switcher allows separating the default field types in the content type from the field types that enhance the content with new functionalities. The best example of such field types are SEO or Taxonomy, as these aren't typical field types but a field types that handle functionalities for the whole content object.

The following example shows how to add a Meta tab with automatically assigned Taxonomy field type.

Add Meta tab

Before you start adding the Meta tab, make sure the content type you want to edit has [Taxonomy Entry Assignment field type]([[= user_doc =]]/taxonomy/#assign-tag-to-content-from-taxonomy-tree).

Next, provide the semantic configuration under the ibexa.system.<scope>.admin_ui_forms configuration key:

ibexa:
    system:
        admin_group:
            admin_ui_forms:
                content_edit:
                    fieldtypes:
                        ibexa_taxonomy_entry_assignment:
                            meta: true

ibexa_taxonomy_entry_assignment - identifier for the field type

meta - when set to true, puts the declared field type in the Meta tab

Configure field groups for Meta tab

The default configuration makes the ibexa_taxonomy_entry_assignment field always visible in the Meta tab in the content form. With this new feature, you can indicate what field types, previously set in the back office content type, are shown in the Meta tab section in the content form. You can automatically move all field types from Metadata group to the Meta tab in the content form.

To do it, use the following configuration:

ibexa:
    system:
        admin_group:
            admin_ui_forms:
                content_edit:
                    meta_field_groups_list:
                       - metadata

To disable the feature:

ibexa:
    system:
        admin_group:
            admin_ui_forms:
                content_edit:
                    meta_field_groups_list: []

The meta_field_groups_list configuration can be overriden.

Add custom tab

First, create an event listener in the src/EventListener/TextAnchorMenuTabListener.php:

[[= include_file('code_samples/back_office/content_type/src/EventListener/TextAnchorMenuTabListener.php') =]]

A new custom tab is defined in the line 28, the line 31 defines items for the second level.

For new tabs it's also required to render its section in the content editing form. To do it, register the UI Component:

[[= include_file('code_samples/back_office/content_type/config/custom_services.yaml') =]]

Finally, create the templates/themes/admin/content_type/edit/custom_tab.html.twig file:

[[= include_file('code_samples/back_office/content_type/templates/themes/admin/content_type/edit/custom_tab.html.twig') =]]