Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A mezzanine flavored fork of django-flatblocks. The goal of this project is to be able to easily create custom blocks of HTML in the template, and can be editable via admin.
Python
branch: master

Merge pull request #18 from alan-hicks/master

Fix django.core.exceptions.AppRegistryNotReady in defaults.py
latest commit 21ca551166
Renyi Khor authored

README.md

Overview

A mezzanine flavored fork of django-flatblocks. The goal of this project is to be able to easily create custom blocks of text/HTML in the template, and can be editable via admin.

Features

  1. Raw Text Block, Rich Text Block, Image Block
  2. Multisite support (via Mezzanine's Slugged).
  3. Frontend inline editing.
  4. Categories for easier block management.
  5. Optional MPTT support for categories.

Requirements

Required - Mezzanine CMS

Optional - Django MPTT

Installation

  1. Add mezzanine_blocks to your virtualenv or clone the repository :
    pip install git+git://github.com/renyi/mezzanine-blocks.git
  1. Add "mezzanine_blocks" to INSTALLED_APPS:
    INSTALLED_APPS = (
        "...",
        "mezzanine_blocks",
    )
  1. Add blocks menu item to admin menu (Optional):
    ADMIN_MENU_ORDER = (
        ("Content", (
                "pages.Page",
                "mezzanine_blocks.Block",
                "mezzanine_blocks.RichBlock",
                "mezzanine_blocks.ImageBlock",
                "blog.BlogPost",
                "blog.BlogCategory",
                "generic.ThreadedComment",
                ("Media Library", "fb_browse"),
            )
        ),
    )
  1. Run python manage.py createdb or python manage.py syncdb && python manage.py migrate.

Usage

  1. Include block_tags in the template:

    {% load ... block_tags %}

  2. Insert block anywhere in the template:

    {% flatblock "My Awesome Block" %}

    {% richflatblock "My Awesome HTML Block" %}

    {% imageflatblock "My Image Block" %}

  3. You should see the blocks in the admin.

Options

Options are similar to django-flatblocks.

{% flatblock {block} %}
{% flatblock {block} {timeout} %}
{% flatblock {block} using {tpl_name} %}
{% flatblock {block} {timeout} using {tpl_name} %}

{% richflatblock {block} %}
{% richflatblock {block} {timeout} %}
{% richflatblock {block} using {tpl_name} %}
{% richflatblock {block} {timeout} using {tpl_name} %}

{% imageflatblock {block} %}
{% imageflatblock {block} {timeout} %}
{% imageflatblock {block} using {tpl_name} %}
{% imageflatblock {block} {timeout} using {tpl_name} %}

Installation

Version 0.9

- Bumped version to 0.9.
- Added Image Block.
- Added Categories for easier block management (Optional MPTT).
- Added frontend inline editing tags to templates.
- Bugfix: Problem with slug when block title has whitespace.
- Cache key prefix now editable in defaults.py.

Version 0.1

- Initial Release
- RawText block, and RichText block.
- Multisite support.
Something went wrong with that request. Please try again.