Settings

All django-timepiece settings are optional. Default values are given in timepiece.defaults and can be overriden in your project’s settings.

TIMEPIECE_EXTRA_NAV

Default:{}

This is an optional setting that is used to add extra navigation items to the global navigation bar displayed at the top of each django-timepiece page. The setting uses Twitter Bootstrap’s dropdown navigation. The setting can be declared as follows:

TIMEPIECE_EXTRA_NAV = {
    'Dropdown Text': [
        ('named_url_1', 'Dropdown Item #1',),
        ('named_url_2', 'Dropdown Item #2',),
    ], ...
}

For example, the following would add a “Paste Bin” dropdown menu with the two links “Make a Paste” and “View my Pastes” as menu items in that dropdown.

TIMEPIECE_EXTRA_NAV = {
    'Paste Bin': [
        ('create_paste_view', 'Make a Paste',),
        ('user_paste_view', 'View my Pastes',),
    ],
}

You can add as many menu items as you wish and are only limited by the space available in the navigation bar. Any navigation item that you add will appear following the django-timepiece related navigation items.

Note: To take advantage of this feature, you must have the context processor timepiece.context_processors.extra_nav listed in Django’s TEMPLATE_CONTEXT_PROCESSORS setting.

TIMEPIECE_DEFAULT_LOCATION_SLUG

Default:None

This setting allows you to set an initial Location to associate with an entry in the Clock In form. The user can override the default choice by selecting another Location when clocking in.

If TIMEPIECE_DEFAULT_LOCATION_SLUG is not given, then then no initial value is used.

TIMEPIECE_PAID_LEAVE_PROJECTS

Default:{}

This setting allows you to specify projects which people can clock in to that are not business-related. These projects will not be included in the total number of ‘worked’ hours. For example:

TIMEPIECE_PAID_LEAVE_PROJECTS = {
    'sick': 1,
    'vacation': 2,
}

where each key is an arbitrary slug for the project and each value is the primary key of the associated project.