Sponsorship is managed via the sponsorship app.
Sponsorship levels and sponsors are added via the Django admin.
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_emails, 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.
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.
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.