initial documentation of sponsorship app

This commit is contained in:
James Tauber 2012-02-05 18:18:30 -05:00
parent a2c6810460
commit 3d6a69466b
2 changed files with 85 additions and 2 deletions

View file

@ -10,11 +10,12 @@ We are in the process of cleaning things up and making them more generic.
The project homepage is http://pinax.github.com/symposion/
Contents:
Apps:
.. toctree::
:maxdepth: 2
sponsorship
Indices and tables

View file

@ -0,0 +1,82 @@
Sponsorship App
===============
Sponsorship is managed via the ``sponsorship`` app.
Sponsorship levels and sponsors are added via the Django admin.
Models
------
Each sponsor level has a ``name`` (e.g. "Gold", "Silver") and an ``order``
field which is an integer that is used to sort levels (lowest first). Each
level also has a ``description`` which is not currently exposed anywhere
but can be used for private annotation.
Each sponsor has a ``name``, ``external_url`` (i.e. link to the sponsor's
website), ``contact_name`` and ``contact_email``, ``logo``, and ``level``.
A sponsor may also have a private ``annotation`` that can be used by
organizers to take notes about the sponsor.
A sponsor will not appear on the site until the ``active`` flag is set true.
Template Snippets
-----------------
The easiest way to include sponsor logos, grouped by level, is to either::
{% include "sponsorship/_vertical_by_level.html" %}
or::
{% include "sponsorship/_horizontal_by_level.html" %}
You can get a wall of sponsors (without level designation) with::
{% include "sponsorship/_wall.html" %}
You can always tweak these templates or use them as the basis for your own.
This is often all you'll need to do to display sponsors on your site.
If you want to display a specific sponsor logo you can use::
{% include "sponsorship/_sponsor_link.html" with sponsor=sponsor %}
or::
{% include "sponsorship/_sponsor_link.html" with sponsor=sponsor dimensions="100x100" %}
if you want different dimensions than the default 150 x 150.
Template Tags
-------------
If you want to retrieve the sponsors and traverse them yourself, you can use
the provided template tags::
{% load sponsorship_tags %}
{% sponsors as all_sponsors %}
or::
{% load sponsorship_tags %}
{% sponsors "Gold" as gold_sponsors %}
if you want to just get a specific level.
You can get the levels with::
{% load sponsorship_tags %}
{% sponsor_levels as levels %}
and you can always iterate over those levels, calling ``level.sponsors`` to
get the sponsors at that level.