Install
Works with Drupal: ^9.4 || ^10Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
This is the first release of Metatag 2 for Drupal 9+.
There are a good number of changes from v8.x-1.x, and a number of update scripts have been provided to adjust sites so they can be compatible. Please make sure to test this update on a non-production copy of all sites to ensure everything still works correctly after the update.
Sites that have custom integrations with the Metatag module will need to review the API changes and adjust their integrations as necessary. Likewise, maintainers of contributed projects that integrate with it may need to update their modules to ensure compatibility.
A sincere thank you to everyone who collaborated on this release.
Please make sure to read the release notes for 2.0.0-rc1 and 2.0.0-rc2 for further details.
Notes on updating from 8.x-1.x releases
- Remember to always update a module on a copy of the site before deploying changes to the production environment, to avoid surprises.
- When updating from Metatag v1 releases it is important to note that some files have been removed and others added, so it is important to rebuild the site's caches to avoid errors being logged.
- There are a number of update scripts that will run, they should work without any problems but please open a bug report if any of them fail.
- If the site gives warnings about not being able to find MetatagServiceProvider.php after updating, make sure to rebuild the site's caches. If that doesn't fix it, try restarting the PHP opcache, or web server if needed; sometimes the opcache can refuse to rebuild the class cache without some harder poking.
- Sites that also use Schema.org Metatag will need to update to its new v3 releases at the same time, e.g.:
composer require drupal/metatag:^2 drupal/schema_metatag:^3
- This release requires PHP 8.0, so local infrastructure (ddev, etc), web servers and the composer.json file will need to be updated accordingly.
Change notices
- Metatag normalizers removed in favor of computed field
- All Metatag custom class methods now include return types
- Certain Twitter Card meta tags deprecated in Metatag v8.x-1.23, removed in v2.0.0
- TypedData plugin removed in Metatag 2.0.0
- Metatag's tags tests are rewritten in 2.0.0
- LinkSizesBase::sizes() replaced with with iconSizes()
- Metatag uses plugin attributes to generate output to simplify output logic
Contributors (3)
jwilson3, DamienMcKenna, pvbergen
Changelog
Issues: 10 issues resolved.
Changes since 2.0.0-rc2:
Bug
- #3367071 by pvbergen, DamienMcKenna: Custom separator also used for string concatenation.
Task
- #3370353 by jwilson3, DamienMcKenna: Fix spelling of "processsed".
- #3367318 by DamienMcKenna: Update post-update scripts per #3367290.
- #3364554 by DamienMcKenna: Fix metatag_post_update_v2_02_remove_entity_values() to work on revisions.
- #3364475 by DamienMcKenna: Update scripts to convert JSON data on revision tables.