Improve django-app-enabler support (#661)

Add django-app-enabler documentation Improve addon config
nephila · Dec 21, 2020 · 4647c47 · 4647c47
1 parent 3c42a1e
commit 4647c47
Show file tree

Hide file tree

Showing 4 changed files with 35 additions and 1 deletion.
diff --git 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
@@ -0,0 +1 @@
+Improve django-app-enabler support
diff --git 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
@@ -15,10 +15,31 @@ django CMS docs:
 - `django CMS user guide <http://docs.django-cms.org/en/latest/user/index.html>`_
 - `django CMS videos <https://www.youtube.com/channel/UCafBqF_OeeGDgQVte5eCiJg>`_
 
+
+**************************
+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