Projects 

Shows the select Active state, with the options All, Active and Completed, in the form of the list. Switched off, the visitor cannot choose the state, and the list shows the state Active state presets.

The option stores the inverse, settings.hideActiveState, which is why it reads "show" while the stored value hides. A template override checks {settings.hideActiveState} .

With the select hidden, the list keeps the preset state when the visitor changes the sorting or a category, and whatever state the URL of a link carries. A list of running projects can therefore offer the category filter and still show only the running ones.

The state the list shows until the visitor picks another one: All projects, the Active ones or the Completed ones. The state of a project describes which projects count as which. An empty or unknown value counts as All, and so does a list of values, which TypoScript makes of the setting as soon as it has a child. The state an element stores does not replace such a list.

Shows one select per category type in the form, as the site settings of The category filters decide. Switched off, the visitor cannot filter by category, and the list shows what Categories presets. The active filter tags of the categories are left out with the selects.

The option stores the inverse, settings.hideFilter. With the category selects hidden, the list keeps the preset categories when the visitor changes the sorting or the state. Categories in the URL of a link narrow the list further and never replace a preset category. Without preset categories, such a link filters the list as before.

Shows the two sorting selects, Sorting field and Sorting direction, in the form. Switched off, the list is sorted as Sorting says. With the sorting, the category filter and the state select all switched off, the element renders no form.

The option stores the inverse, settings.hideSorting. With the sorting selects hidden, the list keeps the sorting chosen here when the visitor changes a category or the state, and whatever sorting the URL of a link carries.

The order of the list until the visitor picks another one:

• Title A-Z, Title Z-A: by the title of the page. The cards show the project title where there is one, so a list sorted by title is out of order where the two differ.
• Last updated (latest last), Last updated (latest first): by the date in the field Last Update of the page properties, which an editor sets by hand.
• Page sorting (Result may be unexpected), Page sorting, reversed (Result may be unexpected): by the position of each page among its sibling pages. That is the order of the page tree only while all project pages share one parent page.
• Budget (low to high), Budget (high to low): by the project budget.
• Start date (oldest first), Start date (newest first): by the project start.

Only the items of the select are supported. Any other value, an empty one, a field without a direction or a list of values for example, which the form never stores but an import or a TypoScript value for a content element without the field can produce, is ignored, and the list sorts by title, A to Z. TypoScript makes a list of the setting as soon as it has a child, such as plugin.tx_academicprojects.settings.sorting.field , also next to a value of the setting itself, and the sorting an element stores does not replace such a list, so every list the TypoScript applies to then sorts by title, A to Z. Remove the child, or replace the whole setting by a single value, to get the sorting of the element back.

Categories of the group projects the list is filtered by until the visitor selects categories of their own. A project has to carry every category selected here, so two categories of the same type find only the projects that carry both. A project that carries only a subcategory of a selected category is not found. Select at most one category per category type unless that is meant.

The tree shows every category of the installation that belongs to a type of the group projects. While the category selects are shown, a selection the visitor submits replaces the categories chosen here of the category types the form offers, and the active filter tags show them as tags the visitor can remove. A category of a type the form does not offer, because The category filters leaves it out, stays. While the selects are hidden, the categories chosen here always apply.

Lists hidden project pages as well, to every visitor, whatever the preview settings of the backend user say. Only the hidden state of a page is ignored: a start or end date, an access restriction to frontend user groups and a deleted page still keep a project out of the list. Use it for a list on an access restricted page that previews projects before they go online.

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

The pages the project pages sit in. The list shows the project pages that are direct subpages of one of the chosen pages. Project pages further down the page tree are not found, so choose every page or folder that holds projects. The form offers no Recursive field for this element.

Empty, the list shows every project page of the installation, on every site. Only pages of the type Academic project are listed, whatever else lies below the chosen pages.