Calendar Widget

The calendar widget integration is done via cone.calendar.browser.CalendarTile which is registered by name calendar.

The overall calendar configuration is done via model properties.

from cone.app.model import BaseNode
from cone.app.model import Properties

class MyCalendar(BaseNode):

    @property
    def properties(self):
        props = Properties()
        props.default_content_tile = 'calendar'
        props.calendar_header = {
            'left': 'month,agendaWeek,agendaDay',
            'center': 'title',
            'right': 'today prev,next'
        }
        return props

For a full list of available calendar options read cone.calendar.browser.CalendarTile documentation.

A calendar rendered on several kinds of nodes can say what it shows. Set calendar_title on a CalendarTile subclass, it is rendered as card header above the calendar. None by default, no header then.

from cone.calendar.browser import CalendarTile
from cone.tile import tile

@tile(
    name='calendar',
    path='cone.calendar.browser:calendar.pt',
    interface=IMyCalendar,
    permission='view')
class MyCalendarTile(CalendarTile):

    @property
    def calendar_title(self):
        return f'Calendar: {self.model.metadata.title}'

Calendar Events

In order to display events in the calendar, one or more event data sources must be provided.

Concrete event data implementation must derive from cone.calendar.browser.CalendarEvents and provide events function.

The default event data source is expected as JSON view registered by name calendar_events for a dedictaed model context.

from cone.calendar.browser import CalendarEvents
from datetime import datetime
from pyramid.view import view_config
import uuid

@view_config(
    name='calendar_events',
    context=MyCalendar,
    accept='application/json',
    renderer='json',
    permission='view')
class MyEvents(CalendarEvents):

    def events(self, start, end):
        events = [{
            'id': uuid.uuid4(),
            'title': 'Title',
            'start': datetime(2020, 4, 29, 17, 40),
            'end': datetime(2020, 4, 29, 18, 0),
        }]
        return events

For a full list of available event options read cone.calendar.browser.CalendarEvents documentation.

Multiple event data sources are defined via model properties.

class MyCalendar(BaseNode):

    @property
    def properties(self):
        props = Properties()
        props.calendar_sources = [{
            'events': 'event_data_1',
            'color': 'green'
        }, {
            'events': 'event_data_2',
            'color': 'red'
        }]
        return props

For a full list of available event source options read cone.calendar.browser.CalendarTile documentation.

Locales

The calendar locale can be set via calendar_locale on model properties.

class MyCalendar(BaseNode):

    @property
    def properties(self):
        props = Properties()
        props.calendar_locale = 'de'
        return props

Default calendar locale is en. The desired locales must be delivered to the browser in order to work correctly. Locales to deliver are defined in the application ini config as comma separated list of locale names.

cone.calendar.locales = de,fr

For a complete list of available locales see browser/static/fullcalendar/locales folder of this package.

2.0.0 (2026-10-24)

• Add optional CalendarTile.calendar_title, rendered as card header above the calendar. For a calendar shown on several kinds of nodes, where what it shows depends on the node. None by default, the markup is unchanged then. [rnix]

• Modernise the code ruff flags as outdated: class X(object). Remove unused import. Behaviour unchanged. super(Class, self) is kept, see cone.app. [rnix]

• Add qa.ruff domain to Makefile and pin the ruff rule selection in pyproject.toml, make check runs ruff check. [rnix]

• Bootstrap 5 Styles.

1.1.1 (2026-04-28)

• Fix span tag receiving icon class in calendar contextmenu. [lenadax]

1.1.0 (2026-02-03)

• Refactor package layout to use pyproject.toml and implicit namespace packages. [rnix]

• Setup Makefile. [lenadax]

• Run tests with pytest. [lenadax]

1.0a1 (2023-05-15)

• Use webresource for resource registration. [rnix]

0.4 (2025-10-25)

• Pin upper versions of dependencies. [rnix]

0.3 (2022-10-06)

• Modernize JavaScript. [rnix]

0.2 (2020-07-09)

• Add show_contextmenu to CalendarTile. Defaults to False. [rnix]

• Also check for action length when handling actions dropdown in JS. [rnix]

0.1 (2020-05-30)

• Initial. [rnix, thet]