views — Swingtime Views

Functions

event_listing

views.event_listing(request[, template='swingtime/event_list.html', events=None, **extra_context])

View all events.

If events is a queryset, clone it. If None default to all Event objects.

Context parameters:

events

an iterable of Event objects

extra_context

extra variables passed to the template context

event_view

views.event_view(request, pk[, template='swingtime/event_detail.html', event_form_class=forms.EventForm, recurrence_form_class=forms.MultipleOccurrenceForm])

View an Event instance and optionally update either the event or its occurrences.

Context parameters:

event

the event keyed by pk

event_form

a form object for updating the event

recurrence_form

a form object for adding occurrences

occurrence_view

views.occurrence_view(request, event_pk, pk[, template='swingtime/occurrence_detail.html', form_class=forms.SingleOccurrenceForm])

View a specific occurrence and optionally handle any updates.

Context parameters:

occurrence

the occurrence object keyed by pk

form

a form object for updating the occurrence

add_event

views.add_event(request[, template='swingtime/add_event.html', event_form_class=forms.EventForm, recurrence_form_class=forms.MultipleOccurrenceForm])

Add a new Event instance and 1 or more associated Occurrence instancess.

Context parameters:

dtstart

a datetime.datetime object representing the GET request value if present, otherwise None

event_form

a form object for updating the event

recurrence_form

a form object for adding occurrences

_datetime_view

views._datetime_view(request template, dt[, timeslot_factory=None, items=None, params=None])

Build a time slot grid representation for the given datetime dt. See utils.create_timeslot_table documentation for items and params.

Context parameters:

day

the specified datetime value (dt)

next_day

day + 1 day

prev_day

day - 1 day

timeslots

time slot grid of (time, cells) rows

day_view

views.day_view(request, year, month, day[, template='swingtime/daily_view.html', **params])

See documentation for function``_datetime_view``.

today_view

views.today_view(request[, template='swingtime/daily_view.html', **params])

See documentation for function``_datetime_view``.

year_view

views.year_view(request, year[, template='swingtime/yearly_view.html', queryset=None])

Context parameters:

year

an integer value for the year in questin

next_year

year + 1

last_year

year - 1

by_month

a sorted list of (month, occurrences) tuples where month is a datetime.datetime object for the first day of a month and occurrences is a (potentially empty) list of values for that month. Only months which have at least 1 occurrence is represented in the list

month_view

views.month_view(request, year, month[, template='swingtime/monthly_view.html', queryset=None])

Render a tradional calendar grid view with temporal navigation variables.

Context parameters:

today

the current datetime.datetime value

calendar

a list of rows containing (day, items) cells, where day is the day of the month integer and items is a (potentially empty) list of occurrence for the day

this_month

a datetime.datetime representing the first day of the month

next_month

this_month + 1 month

last_month

this_month - 1 month