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.