Skip to main content

Events app primarily for the 'connector' events & community aggregator

Project description


.. image::

.. image::

.. image::

Connector events is a Django application for tracking events. It has
the typical list and detail views you expect and an iCal feed for
easily sharing event data.

It was designed as a component for a 'connector' project, tracking
events for a community from multiple sources. However it can also be
used on it's own.

.. Documentation
.. -------------

.. The full documentation is at


Install connector-events::

pip install connector-events

Then add events to your project's `INSTALLED_APPS`::


And into your URL configuration::

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


You can store and display information about events, including start and end
times, descriptions written in Markdown, and location. Locations can be stored
in both plain form, e.g.

100 Main St, Richmond, VA, USA

and in basic geocoded format. The *current* format for storing geographic
location uses two separate decimal database fields for latitude and longitude
respectively. This is suboptimal compared to using a `single point field
but does not entail any special database requirements.

The feed is available via the URL `/ical/`, relative to the root URL where you
have configured the event URLs.


Three settings are worth calling out.


This is a `default Django setting
<>`_ that
you should pay attention to, as the ics feed makes uses of this.


This is a string that will be formatted with a keyword argument named `pk`. It
used to provide a default `UID` value for an event if none is otherwise
provided (e.g. through a calendar import, which is beyond the scope of this
application itself).

The default value is::


A replacement might be::


The `iCalendar specification <>`_
requires that this be a *globally unique* identifier which is why it's a good
idea to use your site name/domain in conjunction with the event primary key
(unique on your site).


This is a string that identifies the product generating the iCalendar feed. It
populates the `PRODID` field in the feed.

The default is::


See the `iCalendar specification
<>`_ for more information about
this field.


0.1.0 (2014-09-01)

* First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for connector-events, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size connector-events-0.1.0.tar.gz (12.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page