.. _important-1789660802:

====================================================
Important: The page module shows the page categories
====================================================

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

A project page (page type 30) carries its categories in the page properties,
where an editor has to open a form to see them. The page module shows them now
as well, in a table above the content grid: one row per category type of the
:yaml:`projects` group, that is competence field, cooperation, funding partner
and department, with the categories assigned to that page.

A type the page carries no category of is listed with a `Not set` note, and a
category that is assigned and switched off is listed with the hidden overlay.

The extension has shipped such a table since its first release, as the partial
:file:`Resources/Private/Backend/Partials/PageLayout/Doktype30.html`, registered
for the backend templates in page TSconfig. No template of EXT:backend
renders a :file:`PageLayout/Doktype*` partial, in no version of TYPO3, so the
table was never shown.

A second defect hid behind the first: the partial translated
:xml:`sys_category.academic_projects.{type}`, a key that exists in no XLF
file of this extension, so every type label would have been empty even if
something had rendered it.

The partial and the registration are removed. The summary is rendered by
EXT:category_types now, which this extension already depends on, and
asked for by an event listener on
:php:`\TYPO3\CMS\Backend\Controller\Event\ModifyPageLayoutContentEvent`.

Impact
======

*   The page module of a project page shows the categories of that page.
    No other page type is affected: the page module of a standard page
    renders exactly what it rendered before.

*   The type labels are the titles the category types are registered with in
    :file:`Configuration/CategoryTypes.yaml`, so a type an installation adds to
    the :yaml:`projects` group is labelled too.

*   The override key changed. An installation that registered

    ..  code-block:: typoscript

        templates.typo3/cms-backend.academic-projects = my-vendor/my-site:Resources/Private/Backend

    to replace :file:`PageLayout/Doktype30.html` was overriding a file that
    had never been rendered, so it saw no summary either.
    It registers

    ..  code-block:: typoscript

        templates.fgtclb/category-types.my-site = my-vendor/my-site:Resources/Private/Backend

    instead now, and puts its markup in
    :file:`Resources/Private/Backend/Templates/PageCategorySummary.html`.

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

Every installation using this extension sees the summary after the update,
that is the point of the change. Only an installation that overrode the removed
partial has anything to do, and what it had was not in effect.

References
==========

*   TYPO3 v10.3 changelog `Feature: #90348 - Fluid-based replacement for
    PageLayoutView
    <https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/10.3/Feature-90348-NewFluid-basedReplacementForPageLayoutView.html>`__,
    which lists the templates and partials the page module ships, and the one
    per-record naming convention it defines.

*   TYPO3 v12.0 changelog `Breaking: #96812 - No Frontend TypoScript based
    template overrides in the backend
    <https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.0/Breaking-96812-NoFrontendTypoScriptBasedTemplateOverridesInTheBackend.html>`__,
    which explains why the :typoscript:`module.tx_backend.view` registration
    stopped existing and what replaced it.

*   The chapter :guilabel:`For Developers` of EXT:category_types,
    section :guilabel:`The page module category summary`, describes the
    template, its variables and the override key.

.. index:: Backend, TSConfig, Fluid, NotScanned, ext:academic_projects