.. _feature-ace-250-academic-projects:

==================================================================
Feature: "Show hidden records" plugin option for the project lists
==================================================================

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

A new boolean plugin option **Show hidden records**
(:typoscript:`settings.showHiddenRecords`, a toggle, off by default) was added
to the following plugins:

* **Projects** (:php:`academicprojects_projectlist`)
* **Projects (selected)** (:php:`academicprojects_projectlistsingle`)

Both plugins share the single
:file:`Configuration/FlexForms/ProjectSettings.xml` data structure.

When the option is enabled, the frontend project listing includes hidden
(disabled) records, also for visitors without a preview of hidden records. Only
the `hidden` enable column (`disabled`) is ignored. The `deleted`,
`starttime`/`endtime` and `fe_group` restrictions stay in effect.

On a translated page the listing shows the translation of a hidden record,
and follows the fallback type of the site language like for any other
record. The start and end time of the default record keep deciding for its
translation. One limit remains on TYPO3 v12 with :yaml:`fallbackType: fallback`:
a record whose translation differs from its default record in visibility is
listed twice (default visible, translation hidden) or not at all (default
hidden, translation visible). With :yaml:`fallbackType: strict`, and on
TYPO3 v13, it is listed once, with its translation.

Impact
======

Editors can now opt in per plugin instance to display hidden projects in
the frontend, for example to preview intentionally hidden records without
changing the global preview settings. The option is off by default, so
existing plugin instances keep their current behaviour.

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

All installations using the `EXT:academic_projects` extension starting
with version 2.4. No action is required for existing installations.

.. index:: Backend, Frontend, ext:academic_projects