puzzler 2.0.0-beta2

Puzzler 2.0.0-beta2 simplifies Wikipedia content setup and improves image selection, attribution and alternative text.

Contributors

Nick Hope. Hook modernisation builds on the Project Update Bot proposal.

Upgrade notes

• Run Drupal database updates after upgrading, then rebuild caches.
• The new Puzzler Wikipedia content field keeps each article, its images and their ALT text together. It supports multiple articles and multiple images per article.
• Existing plain-text fields, image-choice widgets, formatters and token names remain available. Conversion is optional and is not automatic. When converting, copy the values and update the relevant Views or entity displays; verify the output before deleting original fields.
• Review the new image licensing and caption settings. Public-domain and CC0 images can be displayed without creator metadata. Their captions remain enabled by default, with an option to hide the whole caption, including source and rights information. Unavailable-content messages and image attribution links opening in a new tab are enabled by default; these choices can be changed globally or per formatter.
• Drupal 10.3+, 11 and 12 remain supported. Images continue to be served from Wikimedia; downloading them into Drupal's local files is not included.

Changelog

#2994188: Puzzler 2.0.0-beta2 improvements (MR !3).

Changes since 2.0.0-beta1 (compare):

• Add the repeatable Wikipedia content field, including multiple images and an “Images and introduction” output that keeps each article’s images with its introduction, plus a per-article “Show introduction” checkbox. Existing entries keep their introductions enabled after the database update.
• Improve image licensing and attribution handling, including public-domain and CC0 images without creator metadata and cached Commons file-page metadata when needed.
• Add global and formatter controls for image reuse, optional public-domain and CC0 captions, and new-tab attribution links.
• Add image checks, previews, source ALT text, editable ALT text and recovery of previous custom ALT text during editing.
• Accept Wikipedia article URLs as well as titles, including mobile URLs; identify the Wikipedia language from the URL, and handle encoded Wikimedia file titles, spaces and underscores.
• Clarify image-loading controls, find images on non-English Wikipedias, and allow a selected image to be shown while its foreign-language introduction is hidden.
• Explain API failures, including replication lag, missing content and image-policy restrictions with specific notices and file-page links where available.
• Improve form grouping and formatter help.
• Modernise hooks while retaining compatibility wrappers, and extend tests and CI coverage.

Validation

Release CI checks passed, including PHPUnit and PHPStan on Drupal 10.6.18, Drupal 11.4.8 and the Drupal 12 development branch, plus coding standards and spelling checks.

AI assistance: OpenAI Codex assisted with implementation, testing and documentation.