Upgrade 

Changes for integrators 

1. Include the TypoScript only once

   The static template Glossary 2 works again and imports the TypoScript of the site set. Use either the site set jweiland/glossary2 or the static template, not both. See Include the TypoScript of glossary2.

2. Check the storage PID

   The setting glossary2.storagePid is of type string now and accepts a comma-separated list of folders. See Site settings and TypoScript constants.

3. Update the database schema

   The file ext_tables.sql was removed. The database schema is created by TYPO3 from the TCA now. Run the database compare in Admin Tools > Maintenance > Analyze Database Structure: column images changes from VARCHAR to INT UNSIGNED, column l10n_source is added and the columns path_segment and description are changed.

4. Run the upgrade wizards

   Execute the upgrade wizards in Admin Tools > Upgrade > Upgrade Wizard or with vendor/bin/typo3 upgrade:run:

   glossaryPluginUpdate

   Migrates plugins from list_type to the content element (CType) glossary2_glossary. Afterwards check the field explicit_allowdeny of your backend user groups and restrictions of backend layouts (for example content_defender) for the new CType glossary2_glossary.

   glossary2UpdateOldFlexFormFields

   Migrates old FlexForm settings. The wizard now also finds plugins which were already migrated to CType.

   glossary2UpdateSlug

   Creates missing URL slugs of glossary records.

5. Check the backend

   The preview of the plugin in the page module works on all pages, also without the site set, as the preview is registered in the global Configuration/page.tsconfig. The hidden toggle of glossary records is no longer inverted. The tabs for language, access and notes of the plugin are provided by TYPO3 Core and the field l10n_parent is a select field now.

6. Check the A-Z navigation

   Umlauts and other multibyte first letters are linked correctly on all database systems including MariaDB. A title starting with an umlaut no longer adds a link to a second letter (for example "Ä" no longer adds a link to "e").

   Glossary::getSanitizedFirstLetterOfTitle() returns only the first character of the sanitized letter now ("ä" becomes "a" instead of "ae"). This changes the letter argument of links from the detail view back to the list view. Check your templates and route enhancers, if you rely on the old value.

7. Migrate the old TypoScript constants

   The constant names used before version 7.0.1 work again as a fallback for installations using the static template. The glossary2.* constants and the site settings take precedence. See Upgrade to version 7.0.1.

8. Check the items per page

   A value of itemsPerPage below 1 shows one item per page instead of throwing an exception. A missing value falls back to 10.

Changes for developers 

• ControllerActionEventInterface::getRequest() and PostProcessFluidVariablesEvent use TYPO3CMSExtbaseMvcRequestInterface instead of TYPO3CMSExtbaseMvcRequest. Only third-party implementations of ControllerActionEventInterface have to adapt the return type.
• New method PostProcessFirstLettersEvent::setFirstLetters() to modify the first letters of the A-Z navigation. See Extend the glossary function.
• GlossaryService accepts queries and query results of any model. The public API uses generic types instead of the glossary2 model.
• Pass the current request as third argument to GlossaryService::buildGlossary(). It is needed by f:link.action to build the A-Z links.
• The event listeners of glossary2 are registered with the PHP attribute #[AsEventListener]. Validation and lazy loading use the PHP attributes #[Validate] and #[Lazy] instead of annotations.
• GlossaryController uses constructor injection instead of inject*() methods. Adapt XClasses of the controller.
• The non-existing action listWithoutGlossar was removed from the plugin configuration.
• The Composer package requires typo3/cms-extbase, typo3/cms-fluid and typo3/cms-frontend explicitly. The requirement of ext-pdo was dropped.
• The CI tests PHP 8.2 to 8.5 and runs PHPStan on level 6.