Selected Projects 

Icon of the Selected Projects content element
CType

academicprojects_projectlistsingle

Plugin

AcademicProjects, plugin ProjectListSingle, action ProjectController::listAction()

Set

fgtclb/academic-projects-project-list-single, included in fgtclb/academic-projects

Templates

Templates/Project/List.html, with the partials below Partials/Project/, see Templates

The Selected Projects element shows project pages an editor picks one by one, with the cards and the form of the Projects element. The form works under the Content Security Policy of TYPO3 as described there, see Content Security Policy. It is the element for a short list of projects that share no parent page: the projects of a research group on its page, the projects a news article or a person page refers to, or a hand picked selection on a landing page.

The number of projects found above three project cards in a row, without a form

Three projects picked by hand, sorted by title.

Both elements are served by the same plugin action, with the same templates and the same options. They differ in one field: here Selected projects to display names the project pages themselves, not the pages they sit in. A selection made in the default language finds the translations of the projects on a translated page.

Settings 

The tab Configuration holds the options of the Projects element, and below them the field that picks the projects. The options work as they do there, so they are only listed here with what differs for a selection.

Show active state options
Type
checkbox
Default
on

Shows the select Active state in the form, as Show active state options describes. For a short selection it is usually switched off.

Active state
Type
select
Default
All

Leaves out the picked projects that are not in this state, see Active state. A list of picked projects usually keeps All: with Active, a picked project disappears from the page once its end date has passed, without an editor noticing.

Show filter options
Type
checkbox
Default
on

Shows the category selects in the form, see Show filter options. The selects enable the categories the picked projects carry, and offer the others disabled or leave them out, as the site settings of The category filters say.

Show sorting options
Type
checkbox
Default
on

Shows the two sorting selects in the form, see Show sorting options.

Sorting
Type
select
Default
Title A-Z

The order of the picked projects, with the values of Sorting. The order in which the editor picked the projects is not kept: the list is always sorted by this field. Page sorting sorts by the position of each page in the page tree, which says little for projects of different parent pages.

Categories
Type
category tree
Default
empty

Leaves out the picked projects that do not carry every category selected here, see Categories. For a selection made by hand it is rarely needed.

Show hidden records
Type
checkbox
Default
off

Lists a picked project page that is hidden as well, see Show hidden records. Without it, a picked project that is hidden later disappears from the list.

Show active state badge
Type
checkbox
Default
off

Shows on every card whether the project is active or completed, see The state on the project cards.

Selected projects to display
Type
page
Default
empty

The project pages to show. A page of another page type is not shown, whatever the editor picks. The field offers up to 50 pages.

Empty, the element is not limited to a selection: it shows every project page of the installation, on every site, like a Projects element without pages. Pick at least one project.