Feincms3

~~~~~~~~~~~~~~~~~~~~

- Fixed one use of removed API.
- Fixed a bug where the move form "Save" button wasn't shown with Django
2.1.
- Made overriding the ``Regions`` type used in
``TemplatePluginRenderer`` less verbose.
- Modified the documentation to produce several pages. Completed the
guide for building your own CMS and added a section about customizing
rendering using ``Regions`` subclasses.

~~~~~~~~~~~~~~~~~~~~

- Switched the preferred quote to ``"`` and started using `black
<https://pypi.org/project/black/>`_ to automatically format Python
code.

Switched to a new library for recursive common table expressions
----------------------------------------------------------------

django-tree-queries_ supports more database engines, which means that
the PostgreSQL_-only days of feincms3 are gone.

Incompatible differences are few:

- The attributes on page objects are named ``tree_depth`` and ``tree_path``
now instead of ``depth`` and ``cte_path``. If you're using ``WHERE``
clauses on your querysets change ``depth`` to ``__tree.tree_depth``
(or only ``tree_depth``). Properties for backward compatibility have
been added to the ``AbstractPage`` class, but of course those cannot
be used in database queries.
- django-tree-queries_ uses the correct definition of node depth where
root nodes have a depth of ``0``, not ``1``.
- django-tree-queries_ does not add the CTE by default to all queries,
instead, users are expected to call ``.with_tree_fields()`` themselves
if they want to use the CTE attributes. For the time being, the
``AbstractPageManager`` always returns querysets with tree fields.

~~~~~~~~~~~~~~~~~~~~

- Fixed a problem in ``MoveForm`` where invalid move targets would crash
because of missing form fields to attach the error to instead of
showing the underlying problem.
- Made it possible to override the list of apps processed in
``apps_urlconf``.
- Converted the apps middleware into a function, now named
``apps_middleware``. The old name ``AppsMiddleware`` will stay
available for some undefined time.
- Made the path clash check less expensive by running less SQL queries.
- Made page saving a bit less expensive by only saving descendants when
``is_active`` or ``path`` changed.

~~~~~~~~~~~~~~~~~~~~

- Added a template tag for ``reverse_app``.
- **(At least a bit) BACKWARDS INCOMPATIBLE** Switched the preferred
image field from django-versatileimagefield_ to django-imagefield_.
The transition should mostly require replacing ``versatileimagefield``
with ``imagefield`` in your settings etc., adding the appropriate
``IMAGEFIELD_FORMATS`` setting and running ``./manage.py
process_imagefields`` once. Switch from ``feincms3[all]`` to
``feincms3[versatileimagefield]`` to stay with
django-versatileimagefield_ for the moment.

~~~~~~~~~~~~~~~~~~~~

- Changed ``render_list`` and ``render_detail`` to return
``TemplateResponse`` instances instead of pre-rendered instances to
increase the shortcuts' flexibility.
- Factored the JSON fetching from ``oembed_html`` into a new
``oembed_json`` helper.
- Added Django 2.0 to the Travis CI build (nothing had to be changed,
0.19 was already compatible)
- Changed the ``TemplatePluginRenderer`` to also work when used
standalone, not from inside a template.
- Dropped compatibility with Django versions older than 1.11.
- Changed ``AppsMixin.clean_fields`` to use ``_default_manager`` instead
of ``_base_manager`` to search for already existing app instances.
- Changed the page move view to suppress the "Save and add another"
button with great force.

~~~~~~~~~~~~~~~~~~~~

The diff for this release is big, but there are almost no changes in
functionality.

- Minor documentation edits, added a form builder example app to the
documentation.
- Made ``reverse_fallback`` catch ``NoReverseMatch`` exceptions only,
and fixed a related test which didn't reverse anything at all.
- Switch to tox_ for building docs, code style checking and local test
running.
- Made the ``forms.Media`` CSS a list, not a set.