Django Scheduler

A calendar app for Django

Donate bitcoins to this project.

    BTC: 13BeXBBjM3PPtp8YvKFvgfXdqgZC19YX23

Information

Installation

npm install -g bower
pip install django-scheduler

edit your settings.py

add to INSTALLED_APPS:

'schedule',
'djangobower',

add to TEMPLATE_CONTEXT_PROCESSORS:

"django.core.context_processors.request"

Add staticfinder to STATICFILES_FINDERS:

'djangobower.finders.BowerFinder',

Specify path to components root (you need to use absolute path):

BOWER_COMPONENTS_ROOT = '/PROJECT_ROOT/components/'

Add the following required Bower dependencies for scheduler:

BOWER_INSTALLED_APPS = (
    'jquery',
    'bootstrap'
)

Last step, install bower dependencies with:

./manage.py bower install

Features

one-time and recurring events
calendar exceptions (occurrences changed or cancelled)
occurrences accessible through Event API and Period API
relations of events to generic objects
ready to use, nice user interface
view day, week, month, three months and year

Configuration

Full Calendar examples

Optional Settings

FIRST_DAY_OF_WEEK

This setting determines which day of the week your calendar begins on if your locale doesn't already set it. Default is 0, which is Sunday.

OCCURRENCE_CANCEL_REDIRECT

This setting controls the behavior of Views.get_next_url. If set, all calendar modifications will redirect here (unless there is a next set in the request.)

SHOW_CANCELLED_OCCURRENCES

This setting controls the behavior of Period.classify_occurence. If True, then occurences that have been cancelled will be displayed with a css class of canceled, otherwise they won't appear at all.

Defaults to False

CHECK_PERMISSION_FUNC

deprecated

Should be replaced with CHECK_EVENT_PERM_FUNC

CHECK_EVENT_PERM_FUNC

This setting controls the callable used to determine if a user has permission to edit an event or occurrence. The callable must take the object (event) and the user and return a boolean.

Default:

    check_edit_permission(ob, user):
        return user.is_authenticated()

If ob is None, then the function is checking for permission to add new events

CHECK_CALENDAR_PERM_FUNC

This setting controls the callable used to determine if a user has permission to add, update or delete an events in specific calendar. The callable must take the object (calendar) and the user and return a boolean.

Default:

    check_edit_permission(ob, user):
        return user.is_authenticated()

GET_EVENTS_FUNC

This setting controls the callable that gets all events for calendar display. The callable must take the request and the calendar and return a QuerySet of events. Modifying this setting allows you to pull events from multiple calendars or to filter events based on permissions

Default:

    get_events(request, calendar):
        return calendar.event_set.all()

SCHEDULER_BASE_CLASSES

This setting allows for custom base classes to be used on all models. Useful for adding fields, managers, or other elements.

Defaults to django.db.models.Model

SCHEDULER_PREVNEXT_LIMIT_SECONDS

This settings allows to set the upper and lower limit in calendars navigation. Value is in seconds.

Default (two years): 62208000

cfcastro24 / django-scheduler Goto Github PK