Django-blog-lotus

--------------------------

A minor release with many things for *Category tree* and some API improvements, there
is no incompatible changes with v0.9.0.

* Updated french translations in PO;
* Updated every Category queryset to use the right ordering for flat or tree listing,
this should fix issue where some nodes could be missing in tree listing;
* Improved ``Category.get_nested_tree()`` to add a "branch mode" where only nodes from
a tree branch will be unfolded;
* Changed ``Category.get_nested_tree()`` which accept new arguments ``current`` and
``branch``;
* Improved template tag ``get_category_tree_html`` which includes last changes from
``Category.get_nested_tree()``;
* Improved Article sitemap class to set another priority value when article is pinned
or featured;
* Added new options in Article sitemap setting ``pinned_priority`` and
``featured_priority`` to define different value for pinned or feature articles;
* Added a new validation on Article and Category forms to avoid to make an
original object as a translation of another original object. An original can not be
a translation;
* Added ``translations`` field to Category and Article API detail endpoint;
* Added ``children`` field to Category API detail endpoint;
* Added a new text field for all image fields from Article and Category images:

* ``Article.cover_alt_text``;
* ``Article.image_alt_text``;
* ``Category.cover_alt_text``;

* Added serializers for Album and AlbumItem models and use them correctly in Article
serializer so the Article detail endpoint now provide the possible related album
and its items;
* Added new setting ``LOTUS_API_ALLOW_DETAIL_LANGUAGE_SAFE`` with default value to
``True``. Previously the detail endpoints filtered on current client language, meaning
with ``en`` language trying to get a french object leaded to a 404 response. This is
not the case anymore and now you can get detail from objects with different language
without to change your header ``Accept-Language``. The old behavior is still available
when you disable this setting. In any way, the listing endpoints still always filter
on language to return results;

--------------------------

A major release with new feature *Category tree*, see
`Migration to 0.9.0 <https://django-blog-lotus.readthedocs.io/en/latest/migrations.html#from-0-8-1-to-0-9-0>`_
to know about migrating your project.

**This will be the last version to support Django<4.1.**

* Dropped support for Python 3.8;
* Added new feature 'Category tree':

* Added django-treebeard to requirements and applied usage in Category model;
* Adapted Category form to manage the treebeard fields;
* Added some validation in Category admin form for constraints about language and
parenting to ensure tree is not corrupted;
* Added a new admin view to list a tree of categories, this is currently in beta and
will need some more work in UI/UX before to be ready to override the admin changelist;
* Added new template tag ``get_category_tree_html`` to display a tree of all categories
for current language;
* Added new setting ``LOTUS_CATEGORY_SHORT_CRUMBS`` to disable category ancestors
listing in breadcrumb;
* Added new setting ``LOTUS_CATEGORY_TREE_TAG_TEMPLATE`` to define a custom default
template for template tag ``get_category_tree_html``;

* Added new extra requirements section ``sandbox`` dedicated to sandbox only third party
application. It is currently not installed from the Makefile task ``install``;
* Added requirement ``drf-redesign`` to sandbox extra requirements;
* Updated Category serializers and its tests to include 'parent' field;
* Fixed syntax error in some help text from ``lotus_demo`` command, close 78;
* Fixed invalid documentation configuration referencing another repository, close 77;
* Fixed Article item fragment template that was still displaying the categories part
even if it does not have any relatded category, close 73;
* Added Diskette configuration in contrib
* Added ``lotus.contrib.disk.DISKETTE_DEFINITIONS`` list to use with
`diskette <https://diskette.readthedocs.io/en/latest/>`_ to
include default configuration to manage dumps for Lotus data;
* Configured and enabled Diskette usage in sandbox;
* Added minimal requirement versions to help Pip resolving;
* Updated script to freeze local dependencies;
* Updated Makefile for minor enhancements;

--------------------------

A minor release with new feature *Sitemaps*, see
`Migration to 0.8.1 <https://django-blog-lotus.readthedocs.io/en/latest/migrations.html#from-0-8-0-to-0-8-1>`_
to know about migrating your project.

* Added a ``modified`` field on Category, Album and AlbumItem models. This was required
to have accurate update datetime in future ``sitemap.xml``;
* Added Sitemap classes for Article, Author, Category and Tag objects with test
coverage and documentation;

--------------------------

A major release with new feature *Article album*, see
`Migration to 0.8.0 <https://django-blog-lotus.readthedocs.io/en/latest/migrations.html#from-0-7-0-to-0-8-0>`_
to know about migrating your project.

* Added new feature "Article album":

* Album holds items which can have a uploaded media;
* Article can select an Album to display in its detail view;
* This features comes with new models, factories, setting, template tag and tests;
* Updated ``lotus_demo`` command to create some albums to use in articles;
* API does not implement it yet and it will come in the next version;

* Improved quality task to include check-django;
* Adopted some django-ckeditor settings in sandbox for a better usecase with image
embedded in ckeditor contents;
* Added new meta tag in ``base.html`` to define canonical URL for every pages, this
needs to enable a new middleware in your Django settings to work. See migration
document for details;
* Pinned django-taggit to ``<5.0.0`` since the 5.x version drops support of Django 4.0
that we want to keep for Lotus 0.8.x version;
* Fixed task ``check-migration`` so it returns migration code instead of just signal
error when there is pending migration. This is required since Django 4.0 the Django
command ``makemigration`` has some behavior changes;
* Enabled CSS Grid from Bootstrap settings in sandbox frontend (since Grid is used to
display Album);
* Added API overview documentation;
* Added new stylesheet used in Lotus model admins to improve CKEditor width, this
configurable from settings;

--------------------------

A major release without almost no breaking changes, see
`Migration to 0.7.0 <https://django-blog-lotus.readthedocs.io/en/latest/migrations.html#from-0-6-1-to-0-7-0>`_
to know about migrating your project.

* Added API with Django REST framework (DRF):

* API is in beta stage for now, some improvements may come later;
* API is optional depending DRF is installed or not;
* API is read only, at least for now;
* Article, Author and Category have their own entrypoint;
* Listing and details use different serializers to avoid too large responses;
* Publication criteria and language filtering is properly implemented alike in HTML
frontend;

* Added new template tag ``article_get_related`` that is able to properly filter
related article queryset and use it in article detail template;
* Added new template tag ``get_categories`` to list all categories available in current
language;
* Added new template tag ``get_categories_html`` which do the same as
``get_categories`` but is rendered to HTML fragment from a template;
* Added filter on Category into Article admin list;
* Moved documentation to Furo theme;
* Restructured documentation and improved some parts;
* Fixed warnings about deprecated ``django.utils.timezone.utc`` in favor of
``datetime.timezone.utc``;
* Fixed warnings about Factoryboy deprecation with post generators and auto save using
``skip_postgeneration_save`` on every factory;

--------------------------

A minor version only to update ``.readthedocs.yml`` file to follow service deprecations
changes.