Find file
Fetching contributors…
Cannot retrieve contributors at this time
73 lines (41 sloc) 1.72 KB

Django Events

A simple upcoming events calendar for Django.

View builds on TravisCI.

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 INSTALLED_APPS tuple in the project's settings file:


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