Doc improvements for usage with djangocms-page-meta

nephila · Aug 19, 2020 · aa8f21a · aa8f21a
1 parent ee6ce05
commit aa8f21a
Show file tree

Hide file tree

Showing 4 changed files with 23 additions and 6 deletions.
diff --git a/changes/613.bugfix b/changes/613.bugfix
@@ -0,0 +1 @@
+Doc improvements for usage with djangocms-page-meta
diff --git a/djangocms_blog/templates/djangocms_blog/base.html b/djangocms_blog/templates/djangocms_blog/base.html
@@ -1,6 +1,7 @@
 {% extends CMS_TEMPLATE %}
 
-{% block meta %}
+{% if meta %}
+    {% block meta %}
     {% comment %}
     This is needed if you can't add ``{% include "meta/meta.html" %}`` in the django CMS template attached to the blog
     page.
@@ -15,10 +16,9 @@
         ...
 
     {% endcomment %}
-    {% if meta %}
         {% include "meta/meta.html" %}
-    {% endif %}
-{% endblock meta %}
+    {% endblock meta %}
+{% endif %}
 
 {% block content %}
 <div class="app app-blog">

diff --git a/docs/features/meta.rst b/docs/features/meta.rst
@@ -30,7 +30,7 @@ In order to enable its rendering you must follow two steps:
   a. The recommended way is to include in your project base templates:
 
      .. code-block:: html+django
-         :name: my_base.html
+         :name: base_a.html
 
          <html>
          <head>
@@ -42,12 +42,27 @@ In order to enable its rendering you must follow two steps:
      for the blog posts:
 
      .. code-block:: html+django
-         :name: base.html
+         :name: base_b.html
 
          <html>
          <head>
             <title>{% block title %}{% page_attribute 'title' %}{% endblock title %}</title>
             {% block meta %}{% endblock meta %}
             ...
 
+  c. If you are also using ``djangocms-page-meta`` use this bas base template to make the two packages interoperable:
+
+     .. code-block:: html+django
+         :name: base_c.html
+
+         {% load page_meta_tags %}
+         {% page_meta request.current_page as page_meta %}
+         <html>
+         <head>
+            <title>{% block title %}{% page_attribute 'title' %}{% endblock title %}</title>
+            {% block meta %}
+            {% include 'djangocms_page_meta/meta.html' with meta=page_meta %}
+            {% endblock meta %}
+            ...
+
 For complete social meta tags rendering, configure default properties (see ``BLOG_FB``, ``BLOG_TWITTER``, ``BLOG_GPLUS``/``BLOG_SCHEMAORG`` in :ref:`settings`) and apphook ones.
diff --git a/tox.ini b/tox.ini
@@ -84,6 +84,7 @@ skip_install = true
 commands =
     {envpython} -m invoke docbuild
 deps =
+    django<3.1
     invoke
     sphinx
     sphinx-rtd-theme
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Doc improvements for usage with djangocms-page-meta