Skip to content
[DEPRECATED] brainstorm idea voting app
Python HTML
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
brainstorm bump for 0.2.1
CHANGELOG
LICENSE
MANIFEST.in bump for 0.2.1
README.rst updates
setup.py updates

README.rst

django-brainstorm

Django app for creating a site with multiple areas to brainstorm ideas.

Source: http://github.com/jamesturk/django-brainstorm/

Requirements

  • python >= 2.4
  • django >= 1.0

Usage

  1. Add 'brainstorm' to your INSTALLED_APPS setting.

  2. Add a reference to brainstorm.urls somewhere in your urls.py:

    (r'^', include('brainstorm.urls')),  # something that looks like this
    
  3. Login to the django admin and create a subsite.

A subsite has a slug, name, description, theme, and a number of other options. The important two are theme and slug, slug dictates where the subsite will live and theme specifies the name of a theme template (see Creating Themes for details)

Creating Themes

A theme is represented by a single django template, currently kept at templates/themes/themename.html

Required Elements

The theme must include a content block that will be filled by the page, the theme should also include "idea_form.html" if you wish to use the generic idea submission form.

Example dynamic content block:

<!-- content -->
<div>
    <h2 id="secondLogo"><a href="http://mysite.com/subsite/">{{subsite.name}}</a></h2>
    <div id="featureBox">
        <p>project description</p>
    </div>

    <div id="ltColumn">
    {% block content %}
    {% endblock %}
    </div>

    <div id="rtColumn">
    <h3>Submit New Idea</h3>
        {% include "idea_form.html" %}
    </div>
    <div class="clear"></div>
</div>

Styling the Theme

Obviously the styling/design of the static portions of the theme is entirely within the hands of the designer. There are however a few dynamic sections which typically will need some form of styling.

index

The 'content' block of the index contains two divs: 'div#ideas' and 'div#pagination'.

'div#ideas' contains an list where each li is a pair of div.btnVote and div.voteContent. When a div.btnVote has been voted up it will have the additional class 'voted' to allow for additional styling.

'div.btnVote' contains the link 'a.vote_link' for voting and 'div.votes_counted' for displaying the current vote total.

'div.voteContent' contains an <h3> with the idea title, a div.commentMeta with the idea's submitter/date, and a <p> with the description.

idea

The content block of the idea page contains two divs: 'div#idea' and 'div#comments'.

'div#idea' contains a single pair of 'div.btnVote' and 'div.voteContent' (see index for description of these elements)

'div#comments' contains an <h3> with the number of comments, then an ordered list where each <li> has the following elements:

  • div.commentMeta which contains span.commentMetaAuthor and span.commentMetaDate
  • div.commentContent which contains a <p> with the comment itself

(TODO: comment form)

Something went wrong with that request. Please try again.