Route enhancers 

Importing it into a site configuration 

Add the file to the imports of the site that shows the plugin, and limit the enhancer to the pages that carry it:

imports:
  - resource: 'EXT:academic_programs/Configuration/Routes/List.yaml'

routeEnhancers:
  AcademicPrograms:
    limitToPages: [23]

TYPO3 offers every enhancer of a site to every page unless it carries limitToPages , and the first route whose path matches wins. The uids are those of the pages in the default language, one entry covers every translation of a page.

A site that wrote its own enhancer for the plugin removes it when it imports this file. Two enhancers for one plugin compete for the same URLs.

What the URLs look like 

A list URL carries up to two arguments, in this order:

A filter alone, a sorting alone and both together each have a route of their own and resolve.

• The filter is mapped by the CategoryFilterMapper aspect of category_types, with the group programs : the title of each category in the language of the page, followed by its uid. See its documentation.

• The sorting is two segments, field and direction, the values of \FGTCLB\AcademicPrograms\Enumeration\SortingOptions :

  Sorting	English	German
  Title	title	titel
  Last updated	last-updated	zuletzt-aktualisiert
  Sorting of the page tree	sorting	sortierung
  Ascending, descending	asc, desc	aufsteigend, absteigend

A sorting value of the other language is a 404, not a second address of the same list. The filter segment is read by the uid, so it resolves under the title of any language. A path with the sorting field alone, such as /last-updated, does not resolve.

The enhancer declares no defaults, on purpose: a link that uses the default sorting generates /title/asc, not the plain page URL. The plain page URL is where the content element's preset categories and sorting apply, and the list redirects every form submission to a URL with the sorting in it so that a visitor who cleared a preset category does not get it back. A default would turn that redirect into the plain page URL again. The same holds for an enhancer a site writes for this plugin itself. A link to the list that carries no argument at all, the action URL of the plugin's own form for example, enters no route and keeps its plugin arguments in the query string.

The form of the plugin submits by POST, and the plugin answers with a redirect to the list URL, so the address bar shows the path after a submit. The program finder posts to the list as well and ends on the same path.

Another language 

The file maps English and German. A site with a further language adds localeMap items to the aspects in its own site configuration. The import appends list items, so the site's own items come after the shipped ones:

routeEnhancers:
  AcademicPrograms:
    limitToPages: [23]
    aspects:
      sorting_field:
        localeMap:
          - locale: 'fr.*'
            map:
              titre: 'title'
              mise-a-jour: 'lastUpdated'
              tri: 'sorting'
      sorting_direction:
        localeMap:
          - locale: 'fr.*'
            map:
              croissant: 'asc'
              decroissant: 'desc'

A language without localeMap items of its own uses the English keys and values. A value missing from the map of a language keeps its query argument in that language.

The page cache 

The sorting is a static route argument, so each of the six sortings is a page cache entry of its own, per page and language. A path with the filter alone is one more entry, and the page without arguments another, eight in all. The filter is a dynamic argument and adds no entry: the demand of the list is excluded from the cache hash (Important: The list demand is not part of the cache hash), so every filter of a list shares one entry and its path carries no cache hash.

The detail plugin (ProgramDetails) takes no arguments, it renders the program of the page it sits on, so there is nothing to map into a path for it.