v0.21.0.rst 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. v0.21.0 release notes
  2. =====================
  3. New features
  4. ------------
  5. * Upgraded to Wagtail 2.13
  6. * Added new ``<head>`` and ``<body>`` tracking script settings. See
  7. :doc:`/how_to/add_tracking_scripts`.
  8. * Added new ``wagtailcrx.fields.MonospaceField`` for rendering text area fields
  9. in the Wagtail admin with monospace input and spell-checking disabled. This is
  10. used by the new tracking settings and is useful for implementing code-oriented
  11. fields.
  12. * Improve developer tooling in new CodeRed CMS sites by providing pre-configured
  13. ``.gitattribute`` and ``.editorconfig`` files.
  14. * SEO features have been refactored into separate package ``wagtail-seo``. There
  15. should be no noticeable changes to your models, except for the addition of new
  16. properties which can be easily overridden and customized. See
  17. `wagtail-seo customization docs <https://docs.coderedcorp.com/wagtail-seo/customizing/index.html>`_.
  18. Upgrade considerations
  19. ----------------------
  20. * Existing projects will need to add ``wagtailseo,`` to ``INSTALLED_APPS``
  21. (usually in ``settings/base.py``).
  22. * **AMP support has been removed**. This means that your site will no longer
  23. serve automatically generated AMP pages after upgrading. If you had previously
  24. implemented custom AMP templates, or rely heavily on AMP pages, you may need
  25. to implement this functionality yourself. For any site what is not a large
  26. news publisher, we recommend removing AMP from your site, as it is no longer
  27. worth the maintenance burden. `See reasoning for this change
  28. <https://github.com/coderedcorp/wagtail-seo/issues/21>`_.
  29. * ``wagtailcrx_tags.convert_to_amp`` has been removed.
  30. * ``wagtailcrx.utils.convert_to_amp()`` has been removed.
  31. * You should remove any ``amp_template`` attributes from your models, as they
  32. are no longer used.
  33. * ``wagtailcrx/pages/base.html`` template has been modified. If you implement or
  34. extend your own ``base.html``, the following changes are notable:
  35. * template blocks: ``html_seo_base``, ``html_seo_extra``, ``og_seo_base``,
  36. ``og_seo_extra``, ``twitter_seo_base``, ``twitter_seo_extra`` have been
  37. replaced with ``{% include "wagtailseo/meta.html" %}``
  38. * template blocks: ``struct_seo_base``, ``struct_seo_extra`` have been
  39. replaced with ``{% include "wagtailseo/struct_data.html" %}``
  40. * Properties and templates associated with SEO functionality have changed:
  41. * ``CoderedArticlePage.get_author_name`` -> ``CoderedArticlePage.seo_author``
  42. * ``CoderedArticlePage.get_pub_date`` -> ``CoderedArticlePage.seo_published_at``
  43. * ``CoderedArticlePage.get_description`` -> ``CoderedArticlePage.seo_description``
  44. * ``wagtailcrx_tags.og_image`` -> ``page.seo_image_url``
  45. * ``wagtailcrx_tags.structured_data_datetime`` has been removed.
  46. * Some built-in blocks used in the Wagtail admin have been replaced:
  47. * ``wagtailcrx.blocks.MultiSelectBlock`` -> ``wagtail.core.blocks.MultipleChoiceBlock``
  48. * ``wagtailcrx.blocks.OpenHoursValue`` -> ``wagtailseo.blocks.OpenHoursValue``
  49. * ``wagtailcrx.blocks.OpenHoursBlock`` -> ``wagtailseo.blocks.OpenHoursBlock``
  50. * ``wagtailcrx.blocks.StructuredDataActionBlock`` -> ``wagtailseo.blocks.StructuredDataActionBlock``
  51. * CodeRed CMS now sets ``default_auto_field = 'django.db.models.AutoField'`` for
  52. its own concrete models. If you had previously manually specified a different
  53. ``DEFAULT_AUTO_FIELD`` Django setting, you may need to create a migration.
  54. * You may need to find/replace
  55. ``wagtailcrx.blocks.base_blocks.MultiSelectBlock`` with
  56. ``wagtail.core.blocks.MultipleChoiceBlock`` in any old migrations so that they
  57. may continue working.
  58. * Follow `Wagtail 2.12 upgrade considerations <https://docs.wagtail.io/en/stable/releases/2.12.html#upgrade-considerations>`_
  59. and `Wagtail 2.13 upgrade considerations <https://docs.wagtail.io/en/stable/releases/2.13.html#upgrade-considerations>`_.
  60. * You may need to run ``python manage.py makemigrations website`` and
  61. ``python manage.py migrate`` after upgrading.
  62. Supported software
  63. ------------------
  64. * Python 3.6, 3.7, 3.8, 3.9
  65. * Django 2.2, 3.0, 3.1, 3.2
  66. Thank you!
  67. ----------
  68. Thanks to everyone who contributed to `0.21.0 on GitHub <https://github.com/coderedcorp/wagtailcrx/milestone/31?closed=1>`_.