From 4647c4782155f52c826ec89d052fb754484d8326 Mon Sep 17 00:00:00 2001 From: Iacopo Spalletti Date: Mon, 21 Dec 2020 11:59:00 +0100 Subject: [PATCH] Improve django-app-enabler support (#661) Add django-app-enabler documentation Improve addon config --- README.rst | 2 ++ changes/660.feature | 1 + djangocms_blog/addon.json | 8 +++++++- docs/installation.rst | 25 +++++++++++++++++++++++++ 4 files changed, 35 insertions(+), 1 deletion(-) create mode 100644 changes/660.feature diff --git a/README.rst b/README.rst index 98bf8562..14b1d5a8 100644 --- a/README.rst +++ b/README.rst @@ -31,6 +31,7 @@ Features See `features documentation`_ for all the features details +* Support for `django-app-enabler`_ autoconfiguration. * Placeholder content editing * Frontend editing using django CMS frontend editor * Multilingual support using django-parler @@ -58,6 +59,7 @@ See DjangoPackages for an updated list https://www.djangopackages.com/packages/p .. _installation documentation: http://djangocms-blog.readthedocs.io/en/latest/installation.html .. _permalinks: http://djangocms-blog.readthedocs.io/en/latest/features/permalinks.html .. _cmsplugin-filer migration documentation: http://djangocms-blog.readthedocs.io/en/latest/cmsplugin_filer.html +.. _django-app-enabler: https://github.com/nephila/django-app-enabler .. |Gitter| image:: https://img.shields.io/badge/GITTER-join%20chat-brightgreen.svg?style=flat-square diff --git a/changes/660.feature b/changes/660.feature new file mode 100644 index 00000000..bba9771f --- /dev/null +++ b/changes/660.feature @@ -0,0 +1 @@ +Improve django-app-enabler support diff --git a/djangocms_blog/addon.json b/djangocms_blog/addon.json index ba961f6e..684c5525 100644 --- a/djangocms_blog/addon.json +++ b/djangocms_blog/addon.json @@ -16,7 +16,13 @@ "META_USE_SITES": true, "META_USE_OG_PROPERTIES": true, "META_USE_TWITTER_PROPERTIES": true, - "META_USE_SCHEMAORG_PROPERTIES": true + "META_USE_SCHEMAORG_PROPERTIES": true, + "THUMBNAIL_PROCESSORS": [ + "easy_thumbnails.processors.colorspace", + "easy_thumbnails.processors.autocrop", + "filer.thumbnail_processors.scale_and_crop_with_subject_location", + "easy_thumbnails.processors.filters" + ] }, "urls": [ ["", "djangocms_blog.taggit_urls"] diff --git a/docs/installation.rst b/docs/installation.rst index 800065b9..34b4c724 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -15,10 +15,31 @@ django CMS docs: - `django CMS user guide `_ - `django CMS videos `_ + +************************** +django-app-enabler support +************************** + +`django-app-enabler`_ is supported. + +You can either + +* Installation & configuration: ``python -mapp_enabler install djangocms-blog`` +* Autoconfiguration: ``python -mapp_enabler enable djangocms_blog`` + +You can further customise the blog configuration, you can start by checking: + +- :ref:`modify_templates` +- :ref:`haystack` +- :ref:`attach` +- :ref:`external_applications` + ********************* Installation steps ********************* +.. note:: The steps in this section are applied automatically by ``django-app-enabler``, if you use it. + * Install djangocms-blog: .. code-block:: python @@ -98,6 +119,8 @@ Installation steps * Add the blog application (see :ref:`attach` below). +.. _modify_templates: + *********************** Modify templates *********************** @@ -131,6 +154,7 @@ Alternative you can override then ``djangocms_blog/base.html`` and extend a diff {% endblock my_block %} ... +.. _haystack: *********************** Enable haystack support @@ -235,3 +259,4 @@ action if a ``BlogConfig`` instance is found. .. _django cms frontend editor: http://docs.django-cms.org/en/latest/user/reference/page_admin.html .. _tutorial: http://docs.django-cms.org/en/latest/user/tutorial/structure-content-modes.html +.. _django-app-enabler: https://github.com/nephila/django-app-enabler