Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
86 lines (48 sloc) 1.92 KB

Django Events

A simple upcoming events calendar for Django.

Installation from Source

$ git clone git://
$ cd django-events
$ python install

Installation via PIP Requirements File

Include in the PIP requirements file the following lines:

-e git://

And then install as normal (IE:)

$ pip install -r path/to/requirements/file.txt

Setup the Project For the Application

Add to the project's settings file tuple of INSTALLED_APPS:


If you're using South, initiate the events application.

$ python schemamigration events --auto

Sync the database to finish installing sorl-thumbnail and events if you aren't using South.

$ python syncdb

If you're using South, migrate the events application to finish installing it.

$ python migrate events

In the project's file add:

url(r'^events/', include('events.urls')),

A list of upcoming events can now be linked to:

<a href="{% url 'events' %}">Events</a>

The RSS feed of upcoming events can now be referred to in the <head> of your HTML templates:

<link rel="feed alternate" type="application/rss+xml" title="Events" href="{% url 'events_feed' %}" />

Configure the Templates

By default the templates contain only the bare necessities. To override the default templates, create a directory called events in your templates directory and copy the templates from the project into that directory in order to make adjustments to them. If you're using Virtualenv, cd to the root of the django project and execute the following command:

cp -r $VIRTUAL_ENV/src/django-events/events/templates/events templates/events
Jump to Line
Something went wrong with that request. Please try again.