v1.1.2

Author: raagin

README.md

@@ -29,10 +29,14 @@ Module also working with [Grappelli Interface](https://github.com/sehmaschine/dj
 - [Special cases](#special-cases)
   - [Complex Blocks](#complex-blocks)    
   - [Blocks without data in database. Only templates](#blocks-without-data-in-database-only-templates)
+  - [Add extra context to blocks](#add-extra-context-to-blocks)
   - [Cache for reduce the number of database requests](#cache-for-reduce-the-number-of-database-requests)
 - [Settings](#settings)
 
 ## Installation
+
+Requirements: `django>=3.*`
+
 `pip install django-streamfield`
 
 ## How to use
@@ -150,6 +154,16 @@ you can get content by field cached property page.stream.render
 ...
 ```
 
+Or, if you need extra context in blocks, you may use template tag:
+```html
+{% load streamfield_tags %}
+...
+<div class="content">
+  {% stream_render page.stream request=request %}
+</div>
+...
+```
+
 
 ## Admin
 ### Custom admin class for block's models
@@ -268,6 +282,21 @@ class EmptyBlock(models.Model):
 and use `streamblocks/templates/streamblocks/emptyblock.html` for your content.
 > Note: Don't forget to register a block in STREAMBLOCKS_MODELS
 
+### Add extra context to blocks
+Supose, you need to add some data to blocks from global context.
+Instead of using render property in template `{{ page.stream.render }}`,
+you need to use template tag `stream_render` from `streamfield_tags` with keywords arguments.
+
+For example, if you have in page template `request` and `page` objects and want to use it in blocks:
+```html
+{% load streamfield_tags %}
+...
+<div class="content">
+  {% stream_render page.stream request=request page=page %}
+</div>
+...
+```
+
 ### Cache for reduce the number of database requests
 There is two ways of caching:
 - Simple cache view with django cache 

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="django-streamfield",
-    version="1.1.1",
+    version="1.1.2",
     author="Yury Lapshinov",
     author_email="y.raagin@gmail.com",
     description="StreamField for native Django Admin or with Grappelli",
@@ -15,6 +15,7 @@
     packages=setuptools.find_packages(exclude=['test_project']),
     include_package_data=True,
     zip_safe=False,
+    python_requires='>=3',
     classifiers=[
         "Programming Language :: Python :: 3",
         'License :: OSI Approved :: BSD License',

streamfield/__init__.py

@@ -1,2 +1,2 @@
 name = "streamfield"
-VERSION = '1.1.1'
+VERSION = '1.1.2'