Skip to main content

Simple (rich) content blocks for use on front end templates. With admin tool.

Project description

=====
django-richcontentblocks
=====

Very simple CMS-like content blocks for use in a django project.

Features:

1. Admin interface for creating/managing content blocks (including a rich text editor)

2. Template tag for retrieving/displaying content block in a django project template. Django cache is leveraged, when possible, in loading content block.

Inspiration and more full featured version: django-tinycontent_

Installation
------------
Run: ``pip install django-richcontentblocks``

Quick start
-----------
1. Follow configuration instructions for ckeditor_ (skip this step if ckeditor is already configured).

2. Run migrations::

manage.py migrate

3. Add "richcontent" to your INSTALLED_APPS setting like this::

INSTALLED_APPS = (
...
'richcontentblocks',
)

You should now have an admin tool with the ability to create rich content blocks.

Usage in template
------------------
An example of loading a rich content block, with a key value of ``my-block`` in a template::

{% load rich_content_block_tags %}
<div>
the content block will be in next div
</div>
<div>
{% rich_content_block 'my-block' %}
</div>

The first time a content block loads, it will be placed in cache. Subsequent loads of the content block will use the cached item.

If an invalid content block key is used to when attempting to load a content object, an error message is displayed.


.. _ckeditor: https://github.com/django-ckeditor/django-ckeditor
.. _django-tinycontent: https://github.com/dominicrodger/django-tinycontent

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-richcontentblocks-0.4.4.tar.gz (4.3 kB view details)

Uploaded Source

File details

Details for the file django-richcontentblocks-0.4.4.tar.gz.

File metadata

File hashes

Hashes for django-richcontentblocks-0.4.4.tar.gz
Algorithm Hash digest
SHA256 d5ef604f73f47d85b93db6b92ad8a6087c51eea7235e7a5a61d5f0e15f82f641
MD5 73ad5333f22106f4ed9649f8f709d818
BLAKE2b-256 a679de146bccdb8ae11d7fb0f4167b74be3bbc59dc5807febfe9a71ebce1b583

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page