skip to navigation
skip to content

connector-events 0.1.0

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


.. 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
<https:"" en="" 1.6="" ref="" contrib="" gis="" model-api="" #pointfield="">`_
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
<https:"" en="" 1.6="" ref="" settings="" #time-zone="">`_ 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 <http:"" docs="" ical="" uid.html="">`_
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
<http:"" docs="" ical="" prodid.html="">`_ for more information about
this field.


0.1.0 (2014-09-01)

* First release on PyPI.  
File Type Py Version Uploaded on Size
connector-events-0.1.0.tar.gz (md5) Source 2014-08-04 11KB
  • Downloads (All Versions):
  • 4 downloads in the last day
  • 23 downloads in the last week
  • 105 downloads in the last month