Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
django-chunks + headerfield + variable chunknames + "inclusion tag" == django-flatblocks
Python
tag: v0.1.0

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
flatblocks
.gitignore
AUTHORS.txt
LICENSE.txt
MANIFEST.in
README.rst
ez_setup.py
setup.py

README.rst

django-flatblocks

django-flatblocks is a simple application for handling small text-blocks on websites. Think about it like django.contrib.flatpages just not for a whole page but for only parts of it, like an information text describing what you can do on a site.

Usage

Once you've created some instances of the flatblocks.models.FlatBlock model, you can load it it using the flatblock_tags templatetag-library:

{% load flatblock_tags %}

<html>
    <head>
        <!-- ... -->
    </head>
    <body>
        <div id="page">
            <div id="main">
                <!-- ... -->
            </div>
            <div id="sidebar">
                {% flatblock "page.info" %}
            </div>
        </div>
    </body>
</html>

This way you can display a text block with the name 'page.info'. If you have the name of a block in a template variable, leave out the quotes.

This tag also accepts an optional argument where you can specify the number of seconds, the that block should be cached:

{% flatblock "page.info" 3600 %}

History

Since this application targets use-cases that are basically applicable to most web-projects out there, there are tons of solutions similar to this one. In fact, this app is a fork originally from django-chunks developed by Clint Ecker.

In November 2008 Kevin Fricovsky created the original fork in order to add an additional "active"-flag to each chunk. That project was later on forked by Peter Baumgardner who removed that flag again and added a "header"-field in order to directly associate and optional title with each text block.

This fork aims now to add more features like variable chunks and also integrate some of the features developed by H. Waara and S. Cranford in the django-better-chunks fork (django.contrib.site- and i18n-support).

Something went wrong with that request. Please try again.