django-siteblocks 1.2.2__py3-none-any.whl

django_siteblocks-1.2.2.dist-info/METADATA

@@ -0,0 +1,87 @@
+Metadata-Version: 2.5
+Name: django-siteblocks
+Version: 1.2.2
+Summary: Reusable application for Django introducing URL-dependent static and dynamic data blocks
+Project-URL: Homepage, https://github.com/idlesign/django-siteblocks
+Project-URL: Documentation, https://django-siteblocks.readthedocs.io/
+Author-email: Igor Starikov <idlesign@yandex.ru>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: Django,blocks
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# django-siteblocks
+
+<https://github.com/idlesign/django-siteblocks>
+
+[![release](https://img.shields.io/pypi/v/django-siteblocks.svg)](https://pypi.python.org/pypi/django-siteblocks)
+[![lic](https://img.shields.io/pypi/l/django-siteblocks.svg)](https://pypi.python.org/pypi/django-siteblocks)
+[![coverage](https://img.shields.io/coveralls/idlesign/django-siteblocks/master.svg)](https://coveralls.io/r/idlesign/django-siteblocks)
+
+## What's that
+
+*django-siteblocks is a reusable application for Django to build blocks of static or dynamic data that could be used in templates.*
+
+It allows you to describe data that doesn't clearly belong to any application in your project in terms of static or dynamic blocks,
+that could be rendered in certain places on site pages. These blocks are addressed in templates by their aliases.
+
+The following siteblock types are supported:
+
+### Static
+
+Those are defined using Django Admin contrib and are linked to certain URLs.
+
+This allows different siteblock contents on different URLs. Just go to admin and add some blocks.
+
+### Dynamic
+
+Those are ordinary Python functions registered as siteblocks returning contents.
+
+This allows complex logic to build siteblock contents. Let's make a block with a random quote from Pratchett:
+
+```python
+from random import choice
+
+from siteblocks.siteblocksapp import register_dynamic_block
+
+
+def get_quote(**kwargs):
+    quotes = [
+        'Early to rise, early to bed, makes a man healthy, wealthy and dead.',
+        'The duke had a mind that ticked like a clock and, like a clock, it regularly went cuckoo.',
+        'Speak softly and employ a huge man with a crowbar.',
+    ]
+    return choice(quotes)
+
+register_dynamic_block('quote', get_quote)
+```
+
+## Block rendering
+
+Use `siteblocks` tag to render block contents where you need it.
+
+```html
+{% load siteblocks %}
+
+<div class="quote">
+    {% siteblock "quote" %}
+</div>
+```
+
+## Documentation
+
+<https://django-siteblocks.readthedocs.io/>

django_siteblocks-1.2.2.dist-info/RECORD

@@ -0,0 +1,21 @@
+siteblocks/__init__.py,sha256=QFqUvdnuC8ebmxSfLeY1iXn6kxj_ekIGviPOPfQQFGg,76
+siteblocks/admin.py,sha256=aaE1CHDf_hTXM6wq4qM-NIIy4tRGPG9HRXexf9iblxw,744
+siteblocks/apps.py,sha256=7s4IncuqsRvJsjPfVWP20radBQJ1qOoMxyEZMOriiH4,277
+siteblocks/models.py,sha256=PgSJWPE6Ngix2_VDImPsftwtB6aKwALE-_E5Aobdunc,1589
+siteblocks/settings.py,sha256=JBMnc2kqgmMchrp-TOhQqhTsehbRsxKMdRl6nW8I2rE,152
+siteblocks/siteblocksapp.py,sha256=b_JpSdDETSUDKKpewBv099f97qOOGAiV1X1vnj9-Lao,7597
+siteblocks/locale/en/LC_MESSAGES/django.po,sha256=21aqqDyGDRnJq5EBzerd5g0ouVuMG55lCgNNoDBPjEs,1927
+siteblocks/locale/fr/LC_MESSAGES/django.mo,sha256=orsVIt75ULgsFsw6xZMKUUGQ5cYQMpIZGk0fNV8DjHQ,1771
+siteblocks/locale/fr/LC_MESSAGES/django.po,sha256=FN5t8AjXS3Yb0uxQCHPzXR_S-faVEavREyMvymG6v90,2645
+siteblocks/locale/ru/LC_MESSAGES/django.mo,sha256=gv6Eg-xMHCFU2RAXgSautwYkX7dKIpQfb9aoPNCJIng,3015
+siteblocks/locale/ru/LC_MESSAGES/django.po,sha256=PB0CciHQjiAhAThpdtfxTjHdnP4VpM_NhsWNVqW6G1c,3533
+siteblocks/migrations/0001_initial.py,sha256=ZP1YSNFu0RCatiNEobUO2Fw93SJHWAsHpW7P8Mt7krU,1522
+siteblocks/migrations/0002_auto_20140921_1038.py,sha256=H9mN6sdeiYSHdHyyJMcOzIxbDlzvcZBrDcUoBGCWbJI,868
+siteblocks/migrations/0003_alter_block_access_guest_alter_block_access_loggedin.py,sha256=1QdRvNrx4Na-8g7CaV9whhcncWbQPBQV9ofwPTI3sjU,799
+siteblocks/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+siteblocks/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+siteblocks/templatetags/siteblocks.py,sha256=F-RBs3J-hzMDYxH8vr9fsTAEHI-LC06hCgkG66XgYKM,1691
+django_siteblocks-1.2.2.dist-info/METADATA,sha256=g7lTTyzKtzAJl3O2lrQJyr7HadzEy9XYZjB9jT-uRkQ,3080
+django_siteblocks-1.2.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+django_siteblocks-1.2.2.dist-info/licenses/LICENSE,sha256=TgZMEIuVqPzFCn8S6twEoSSGSgFF2-2oaKWrgULpEOA,1555
+django_siteblocks-1.2.2.dist-info/RECORD,,

django_siteblocks-1.2.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

django_siteblocks-1.2.2.dist-info/licenses/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2010-2026, Igor 'idle sign' Starikov
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice, 
+       this list of conditions and the following disclaimer.
+    
+    2. Redistributions in binary form must reproduce the above copyright 
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of the django-siteblocks nor the names of its
+       contributors may be used to endorse or promote products derived from 
+       this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

siteblocks/__init__.py

@@ -0,0 +1,4 @@
+VERSION = '1.2.2'
+
+
+default_app_config = 'siteblocks.apps.SiteblocksConfig'

siteblocks/admin.py

@@ -0,0 +1,31 @@
+from django.contrib import admin
+from django.utils.translation import gettext_lazy as _
+
+from .models import Block
+
+
+class BlockAdmin(admin.ModelAdmin):
+
+    list_display = ('alias', 'description', 'url', 'hidden', 'access_loggedin', 'access_guest')
+
+    search_fields = ['alias', 'url']
+
+    list_filter = ['hidden']
+
+    ordering = ['alias']
+
+    fieldsets = (
+        (_('Basic settings'), {
+            'fields': ('alias', 'url', 'contents',)
+        }),
+        (_('Access settings'), {
+            'classes': ('collapse',),
+            'fields': ('access_loggedin', 'access_guest')
+        }),
+        (_('Additional settings'), {
+            'fields': ('description', 'hidden')
+        }),
+    )
+
+
+admin.site.register(Block, BlockAdmin)

siteblocks/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class SiteblocksConfig(AppConfig):
+    """Siteblocks configuration."""
+
+    name = 'siteblocks'
+    verbose_name = _('Site Blocks')
+    default_auto_field = 'django.db.models.AutoField'

siteblocks/locale/en/LC_MESSAGES/django.po

@@ -0,0 +1,98 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-09-21 12:39+0700\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: admin.py:14
+msgid "Basic settings"
+msgstr ""
+
+#: admin.py:17
+msgid "Access settings"
+msgstr ""
+
+#: admin.py:21
+msgid "Additional settings"
+msgstr ""
+
+#: config.py:9 models.py:19
+msgid "Site Blocks"
+msgstr ""
+
+#: models.py:9
+msgid "Alias"
+msgstr ""
+
+#: models.py:9
+msgid "Short name to address this block from a template."
+msgstr ""
+
+#: models.py:10
+msgid "Description"
+msgstr ""
+
+#: models.py:10
+msgid "Short memo for this block."
+msgstr ""
+
+#: models.py:11
+msgid "URL"
+msgstr ""
+
+#: models.py:11
+msgid ""
+"Page URL this block is related to. Regular expressions supported (e.g.: \"/"
+"news.*\" &#8212; everything under \"/news\").<br />View names are supported: "
+"prepend <b>:</b> to view name <br /><b>Reserved URL alias:</b> \"*\" &#8212; "
+"every page."
+msgstr ""
+
+#: models.py:12
+msgid "Contents"
+msgstr ""
+
+#: models.py:12
+msgid "Block contents to render in a template."
+msgstr ""
+
+#: models.py:13
+msgid "Logged in only"
+msgstr ""
+
+#: models.py:13
+msgid "Check it to grant access to this block to authenticated users only."
+msgstr ""
+
+#: models.py:14
+msgid "Guests only"
+msgstr ""
+
+#: models.py:14
+msgid "Check it to grant access to this block to guests only."
+msgstr ""
+
+#: models.py:15
+msgid "Hidden"
+msgstr ""
+
+#: models.py:15
+msgid "Whether to show this block when requested."
+msgstr ""
+
+#: models.py:18
+msgid "Site Block"
+msgstr ""

siteblocks/locale/fr/LC_MESSAGES/django.po

@@ -0,0 +1,105 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+#
+# Translators:
+# PatrickHetu <patrick.hetu@gmail.com>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: django-siteblocks\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-09-21 12:39+0700\n"
+"PO-Revision-Date: 2014-09-21 05:35+0000\n"
+"Last-Translator: Igor Starikov <idlesign@yandex.ru>\n"
+"Language-Team: French (http://www.transifex.com/projects/p/django-siteblocks/"
+"language/fr/)\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+#: admin.py:14
+msgid "Basic settings"
+msgstr ""
+
+#: admin.py:17
+msgid "Access settings"
+msgstr ""
+
+#: admin.py:21
+msgid "Additional settings"
+msgstr ""
+
+#: config.py:9 models.py:19
+msgid "Site Blocks"
+msgstr "Site Blocks"
+
+#: models.py:9
+msgid "Alias"
+msgstr "Jeton"
+
+#: models.py:9
+msgid "Short name to address this block from a template."
+msgstr "Nom court du jeton à remplacer dans le gabarit."
+
+#: models.py:10
+msgid "Description"
+msgstr "Description"
+
+#: models.py:10
+msgid "Short memo for this block."
+msgstr "Description courte pour ce jeton."
+
+#: models.py:11
+msgid "URL"
+msgstr "URL"
+
+#: models.py:11
+msgid ""
+"Page URL this block is related to. Regular expressions supported (e.g.: \"/"
+"news.*\" &#8212; everything under \"/news\").<br />View names are supported: "
+"prepend <b>:</b> to view name <br /><b>Reserved URL alias:</b> \"*\" &#8212; "
+"every page."
+msgstr ""
+"URL, nom d'une vue ou expressions régulières des pages dans lesquelles le "
+"jeton sera remplacé. <br />Par exemple:<br /> \"/nouvelles.*\" &#8212; "
+"remplacera toutes les pages qui commençant par \"/nouvelles\").<br />Le nom "
+"d'une vue est aussi supporté avec le préfixe <b>:</b><br /><b>Utiliser "
+"l'astérisque </b> \"*\" &#8212; pour indiquer toutes les pages."
+
+#: models.py:12
+msgid "Contents"
+msgstr "Contenu"
+
+#: models.py:12
+msgid "Block contents to render in a template."
+msgstr "Contenu à inclure dans le gabarit."
+
+#: models.py:13
+msgid "Logged in only"
+msgstr ""
+
+#: models.py:13
+msgid "Check it to grant access to this block to authenticated users only."
+msgstr ""
+
+#: models.py:14
+msgid "Guests only"
+msgstr ""
+
+#: models.py:14
+msgid "Check it to grant access to this block to guests only."
+msgstr ""
+
+#: models.py:15
+msgid "Hidden"
+msgstr "Caché"
+
+#: models.py:15
+msgid "Whether to show this block when requested."
+msgstr "Inclure ou non ce contenu dans le gabarit."
+
+#: models.py:18
+msgid "Site Block"
+msgstr "Site Block"

siteblocks/locale/ru/LC_MESSAGES/django.po

@@ -0,0 +1,108 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+#
+# Translators:
+# Igor Starikov <idlesign@yandex.ru>, 2013-2014
+msgid ""
+msgstr ""
+"Project-Id-Version: django-siteblocks\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2014-09-21 12:39+0700\n"
+"PO-Revision-Date: 2014-09-21 05:36+0000\n"
+"Last-Translator: Igor Starikov <idlesign@yandex.ru>\n"
+"Language-Team: Russian (http://www.transifex.com/projects/p/django-"
+"siteblocks/language/ru/)\n"
+"Language: ru\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
+"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
+
+#: admin.py:14
+msgid "Basic settings"
+msgstr "Основные настройки"
+
+#: admin.py:17
+msgid "Access settings"
+msgstr "Настройки доступа"
+
+#: admin.py:21
+msgid "Additional settings"
+msgstr "Дополнительные настройки"
+
+#: config.py:9 models.py:19
+msgid "Site Blocks"
+msgstr "Блоки сайта"
+
+#: models.py:9
+msgid "Alias"
+msgstr "Псевдоним"
+
+#: models.py:9
+msgid "Short name to address this block from a template."
+msgstr "Краткое имя блока, для обращения к нему из шаблонов."
+
+#: models.py:10
+msgid "Description"
+msgstr "Описание"
+
+#: models.py:10
+msgid "Short memo for this block."
+msgstr "Произвольная заметка для блока."
+
+#: models.py:11
+msgid "URL"
+msgstr "URL"
+
+#: models.py:11
+msgid ""
+"Page URL this block is related to. Regular expressions supported (e.g.: \"/"
+"news.*\" &#8212; everything under \"/news\").<br />View names are supported: "
+"prepend <b>:</b> to view name <br /><b>Reserved URL alias:</b> \"*\" &#8212; "
+"every page."
+msgstr ""
+"URL страницы, для которой актуален блок. Поддерживаются регулярные выражения "
+"(например, \"/news.*\" &#8212; любые страницы ниже \"/news\").<br /"
+">Поддерживаются обращения к представлениям: добавьте <b>:</b> перед именем "
+"представления<br /><b>Зарезервированный псевдоним URL:</b> \"*\" &#8212; "
+"любая страница."
+
+#: models.py:12
+msgid "Contents"
+msgstr "Содержимое"
+
+#: models.py:12
+msgid "Block contents to render in a template."
+msgstr "Содержимое блока для вывода на страницах."
+
+#: models.py:13
+msgid "Logged in only"
+msgstr "Только авторизовавшиеся"
+
+#: models.py:13
+msgid "Check it to grant access to this block to authenticated users only."
+msgstr ""
+"Поставьте галочку, чтобы разрешить доступ к этому блоку только "
+"авторизовавшимся."
+
+#: models.py:14
+msgid "Guests only"
+msgstr "Только гости"
+
+#: models.py:14
+msgid "Check it to grant access to this block to guests only."
+msgstr "Поставьте галочку, чтобы разрешить доступ к этому блоку только гостям."
+
+#: models.py:15
+msgid "Hidden"
+msgstr "Скрыт"
+
+#: models.py:15
+msgid "Whether to show this block when requested."
+msgstr "Определяет, можно ли выводить этот блок."
+
+#: models.py:18
+msgid "Site Block"
+msgstr "Блок сайта"

siteblocks/migrations/0001_initial.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+from __future__ import unicode_literals
+
+from django.db import models, migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Block',
+            fields=[
+                ('id', models.AutoField(verbose_name='ID', serialize=False, auto_created=True, primary_key=True)),
+                ('alias', models.CharField(help_text='Short name to address this block from a template.', max_length=80, verbose_name='Alias', db_index=True)),
+                ('description', models.CharField(help_text='Short memo for this block.', max_length=100, null=True, verbose_name='Description', blank=True)),
+                ('url', models.CharField(help_text='Page URL this block is related to. Regular expressions supported (e.g.: "/news.*" &#8212; everything under "/news").<br />View names are supported: prepend <b>:</b> to view name <br /><b>Reserved URL alias:</b> "*" &#8212; every page.', max_length=200, verbose_name='URL')),
+                ('contents', models.TextField(help_text='Block contents to render in a template.', verbose_name='Contents')),
+                ('hidden', models.BooleanField(default=False, help_text='Whether to show this block when requested.', db_index=True, verbose_name='Hidden')),
+            ],
+            options={
+                'verbose_name': 'Site Block',
+                'verbose_name_plural': 'Site Blocks',
+            },
+            bases=(models.Model,),
+        ),
+    ]

siteblocks/migrations/0002_auto_20140921_1038.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+from __future__ import unicode_literals
+
+from django.db import models, migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('siteblocks', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='block',
+            name='access_guest',
+            field=models.BooleanField(default=False, help_text='Check it to grant access to this item to guests only.', db_index=True, verbose_name='Guests only'),
+            preserve_default=True,
+        ),
+        migrations.AddField(
+            model_name='block',
+            name='access_loggedin',
+            field=models.BooleanField(default=False, help_text='Check it to grant access to this item to authenticated users only.', db_index=True, verbose_name='Logged in only'),
+            preserve_default=True,
+        ),
+    ]

siteblocks/migrations/0003_alter_block_access_guest_alter_block_access_loggedin.py

@@ -0,0 +1,23 @@
+# Generated by Django 6.1.3 on 2026-11-09 14:56
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('siteblocks', '0002_auto_20140921_1038'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='block',
+            name='access_guest',
+            field=models.BooleanField(db_index=True, default=False, help_text='Check it to grant access to this block to guests only.', verbose_name='Guests only'),
+        ),
+        migrations.AlterField(
+            model_name='block',
+            name='access_loggedin',
+            field=models.BooleanField(db_index=True, default=False, help_text='Check it to grant access to this block to authenticated users only.', verbose_name='Logged in only'),
+        ),
+    ]

siteblocks/models.py

@@ -0,0 +1,41 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
+
+class Block(models.Model):
+
+    alias = models.CharField(
+        _('Alias'), max_length=80, help_text=_('Short name to address this block from a template.'), db_index=True)
+
+    description = models.CharField(
+        _('Description'), max_length=100, help_text=_('Short memo for this block.'), null=True, blank=True)
+
+    url = models.CharField(
+        _('URL'), max_length=200,
+        help_text=_(
+            'Page URL this block is related to. Regular expressions supported (e.g.: "/news.*" — '
+            'everything under "/news").<br />'
+            'View names are supported: prepend <b>:</b> to view name <br />'
+            '<b>Reserved URL alias:</b> "*" &#8212; every page.'))
+
+    contents = models.TextField(
+        _('Contents'), help_text=_('Block contents to render in a template.'))
+
+    access_loggedin = models.BooleanField(
+        _('Logged in only'),
+        help_text=_('Check it to grant access to this block to authenticated users only.'),
+        db_index=True, default=False)
+
+    access_guest = models.BooleanField(
+        _('Guests only'),
+        help_text=_('Check it to grant access to this block to guests only.'), db_index=True, default=False)
+
+    hidden = models.BooleanField(
+        _('Hidden'), help_text=_('Whether to show this block when requested.'), db_index=True, default=False)
+      
+    class Meta:
+        verbose_name = _('Site Block')
+        verbose_name_plural = _('Site Blocks')
+        
+    def __str__(self):
+        return self.alias

siteblocks/settings.py

@@ -0,0 +1,5 @@
+from django.conf import settings
+
+
+# Support for blocks dependent on get_language().
+I18N_SUPPORT = getattr(settings, 'SITEBLOCKS_I18N_SUPPORT', False)

siteblocks/siteblocksapp.py

@@ -0,0 +1,224 @@
+import re
+from collections import defaultdict
+from random import choice
+from typing import Callable, Dict, List
+
+from django.core.cache import cache
+from django.db.models import signals
+from django.template import Context
+from django.urls import resolve, Resolver404
+from django.utils.translation import get_language
+
+from .models import Block
+from .settings import I18N_SUPPORT
+
+if I18N_SUPPORT:
+
+    def cache_get_key(block_alias: str) -> str:
+        return f'{block_alias}:{get_language()}'
+
+else:
+    def cache_get_key(block_alias: str) -> str:
+        return block_alias
+
+
+# Contains dynamic blocks.
+_DYNAMIC_BLOCKS = defaultdict(list)
+
+
+def register_dynamic_block(alias: str, callable: Callable):
+    """Registers a callable that produces contents for a dynamic block.
+
+    Callable on call will get the following kwargs:
+
+        * `block_alias` - block alias,
+        * `block_context` - template context for block
+
+    Example::
+
+        # Put the following code somewhere where it'd be triggered as expected. E.g. in app view.py.
+
+        from random import choice
+        # Import the register function.
+        from siteblocks.siteblocksapp import register_dynamic_block
+
+
+        # The following function will be used as a block contents producer.
+        def get_quote(**kwargs):
+            quotes = [  # From Terry Pratchett's Discworld novels.
+                'Ripples of paradox spread out across the sea of causality.',
+                'Early to rise, early to bed, makes a man healthy, wealthy and dead.',
+                'Granny had nothing against fortune-telling provided it was done badly by people with no talent for it.'
+                'Take it from me, there\'s nothing more terrible than someone out to do the world a favour.',
+                'The duke had a mind that ticked like a clock and, like a clock, it regularly went cuckoo.',
+                'Most gods find it hard to walk and think at the same time.',
+                'They didn\'t have to be funny - they were father jokes',
+                'Speak softly and employ a huge man with a crowbar.',
+            ]
+            return choice(quotes)
+
+        # And we register our siteblock.
+        register_dynamic_block('quote', get_quote)
+
+    """
+    global _DYNAMIC_BLOCKS
+    _DYNAMIC_BLOCKS[alias].append(callable)
+
+
+def get_dynamic_blocks() -> Dict[str, List[Callable]]:
+    """Returns a dictionary with currently registered dynamic blocks."""
+    return _DYNAMIC_BLOCKS
+
+
+class SiteBlocks:
+
+    # siteblocks objects are stored in Django cache for a year (60 * 60 * 24 * 365 = 31536000 sec).
+    # Cache is only invalidated on block item change.
+    CACHE_TIMEOUT: str = 31536000
+    CACHE_KEY: str = 'siteblocks'
+
+    IDX_GUEST: int = 0
+    IDX_AUTH: int = 1
+
+    def __init__(self):
+        self._cache = None
+        signals.post_save.connect(self._cache_empty, sender=Block)
+        signals.post_delete.connect(self._cache_empty, sender=Block)
+
+    def _cache_init(self):
+        """Initializes local cache from Django cache."""
+        cache_ = cache.get(self.CACHE_KEY)
+        if cache_ is None:
+            cache_ = defaultdict(dict)
+        self._cache = cache_
+
+    def _cache_save(self):
+        cache.set(self.CACHE_KEY, self._cache, self.CACHE_TIMEOUT)
+
+    def _cache_get(self, key: str) -> List[Dict[str, List]]:
+        """Returns cache entry parameter value by its name."""
+        return self._cache.get(key, False)
+
+    def _cache_set(self, key: str, value: List[Dict[str, List]]):
+        """Replaces entire cache entry parameter data by its name with new data."""
+        self._cache[key] = value
+
+    def _cache_empty(self, **kwargs):
+        self._cache = None
+        cache.delete(self.CACHE_KEY)
+
+    def get_contents_static(self, block_alias: str, context: Context) -> str:
+        """Returns contents of a static block."""
+
+        if 'request' not in context:
+            # No use in further actions as we won't ever know current URL.
+            return ''
+
+        current_url = context['request'].path
+
+        # Resolve current view name to support view names as block URLs.
+        try:
+            resolver_match = resolve(current_url)
+            namespace = ''
+
+            if resolver_match.namespaces:
+                # More than one namespace, really? Hmm.
+                namespace = resolver_match.namespaces[0]
+
+            resolved_view_name = f':{namespace}:{resolver_match.url_name}'
+
+        except Resolver404:
+            resolved_view_name = None
+
+        self._cache_init()
+
+        cache_entry_name = cache_get_key(block_alias)
+        idx_guest = self.IDX_GUEST
+        idx_auth = self.IDX_AUTH
+
+        siteblocks_static = self._cache_get(cache_entry_name)
+
+        if not siteblocks_static:
+
+            blocks = Block.objects.filter(
+                alias=block_alias,
+                hidden=False
+            ).only('url', 'contents', 'access_guest', 'access_loggedin')
+
+            siteblocks_static = [defaultdict(list), defaultdict(list)]
+
+            for block in blocks:
+
+                if block.url == '*':
+                    url_re = block.url
+
+                elif block.url.startswith(':'):
+                    url_re = block.url
+                    # Normalize URL name to include namespace.
+                    if url_re.count(':') == 1:
+                        url_re = f':{url_re}'
+
+                else:
+                    url_re = re.compile(rf'{block.url}')
+
+                if block.access_guest:
+                    siteblocks_static[idx_guest][url_re].append(block.contents)
+
+                elif block.access_loggedin:
+                    siteblocks_static[idx_auth][url_re].append(block.contents)
+
+                else:
+                    siteblocks_static[idx_guest][url_re].append(block.contents)
+                    siteblocks_static[idx_auth][url_re].append(block.contents)
+
+            self._cache_set(cache_entry_name, siteblocks_static)
+
+        self._cache_save()
+
+        user = getattr(context['request'], 'user', None)
+        is_authenticated = getattr(user, 'is_authenticated', False)
+
+        lookup_area = siteblocks_static[idx_auth if is_authenticated else idx_guest]
+
+        static_block_contents = ''
+
+        if '*' in lookup_area:
+            static_block_contents = choice(lookup_area['*'])
+
+        elif resolved_view_name in lookup_area:
+            static_block_contents = choice(lookup_area[resolved_view_name])
+
+        else:
+            for url, contents in lookup_area.items():
+                if url.match(current_url):
+                    static_block_contents = choice(contents)
+                    break
+
+        return static_block_contents
+
+    def get_contents_dynamic(self, block_alias: str, context: Context) -> str:
+        """Returns contents of a dynamic block."""
+        dynamic_block = get_dynamic_blocks().get(block_alias, [])
+
+        if not dynamic_block:
+            return ''
+
+        dynamic_block = choice(dynamic_block)
+        return dynamic_block(block_alias=block_alias, block_context=context)
+
+    def get(self, block_alias: str, context: Context) -> str:
+        """Main method returning block contents (static or dynamic)."""
+        contents = []
+
+        dynamic_block_contents = self.get_contents_dynamic(block_alias, context)
+        if dynamic_block_contents:
+            contents.append(dynamic_block_contents)
+
+        static_block_contents = self.get_contents_static(block_alias, context)
+        if static_block_contents:
+            contents.append(static_block_contents)
+
+        if not contents:
+            return ''
+
+        return choice(contents)

siteblocks/templatetags/siteblocks.py

@@ -0,0 +1,60 @@
+from django import template
+from django.template.base import FilterExpression, Parser, Token
+
+from ..siteblocksapp import SiteBlocks
+
+register = template.Library()
+
+# Utility methods are implemented in SiteBlocks class
+siteblocks = SiteBlocks()
+
+
+@register.tag
+def siteblock(parser: Parser, token: Token):
+    """Two notation types are acceptable:
+
+        1. Two arguments:
+           {% siteblock "myblock" %}
+           Used to render "myblock" site block.
+           
+        2. Four arguments:
+           {% siteblock "myblock" as myvar %}
+           Used to put "myblock" site block into "myvar" template variable.
+           
+    """
+    tokens = token.split_contents()
+    tokens_num = len(tokens)
+
+    if tokens_num not in (2, 4):
+        raise template.TemplateSyntaxError(
+            f'{tokens[0]} tag requires two or four arguments. '
+            'E.g.: {%% siteblock "myblock" %%} or {%% siteblock "myblock" as myvar %%}.')
+
+    block_alias = parser.compile_filter(tokens[1])
+    as_var = None
+    tokens = tokens[2:]
+
+    if len(tokens) >= 2 and tokens[-2] == 'as':
+        as_var = tokens[-1]
+
+    return siteblockNode(block_alias, as_var)
+
+
+class siteblockNode(template.Node):
+
+    def __init__(self, block_alias, as_var=None):
+        self.block_alias = block_alias
+        self.as_var = as_var
+        
+    def render(self, context):
+        block_alias = self.block_alias
+        if isinstance(self.block_alias, FilterExpression):
+            block_alias = block_alias.resolve(context)
+
+        contents = siteblocks.get(block_alias, context)
+
+        if self.as_var is not None:
+            context[self.as_var] = contents
+            return ''
+
+        return contents