calendar_week_days

A weekly recurring event needs to know which days it falls on, and the natural control for that is seven toggles rather than a multi-select. Odoo models it as seven boolean fields, one per day, and the base framework provides a widget that draws them.

This is that widget with a calendar template. The behavior is the same seven toggles; the difference is how they are laid out on the calendar event form.

It also defines its own change handler, which writes the inverted value of the day directly to the record.

Recurrence rules are the part of scheduling people get wrong most often, usually by picking a pattern that does not survive holidays or month boundaries. A clear weekday picker at least makes the weekly case unambiguous.

For anything more complex than weekly, the thing to check is what your team actually means by monthly. The same word covers the fourth Tuesday and the twenty-eighth, and those diverge quickly.

Placing it

<widget name="calendar_week_days"/>

No attributes. The seven fields are requested by the widget.

What a toggle does

record.update({ [day]: !currentValue })

A direct write of the inverted value.

The base widget instead

<widget name="week_days"/>

Same seven toggles with the framework's own template.

There is almost nothing here, and that is the point. The class extends the base weekday widget, names a calendar template and overrides one method.

That method takes the day being toggled, reads its current value from the widget's data and writes the inverse back to the record. No local state is kept, so what is displayed is always what is on the record.

The descriptor reuses the base widget's field dependencies rather than restating them, which means the seven day fields are requested identically. If the base list ever changes, this widget follows automatically.

Everything about the layout, the day labels and their order lives in the template rather than in this file.

Odoo 20 is expected at Odoo Experience in Brussels, 24 to 26 September 2026. The development branch is unstable and this may still change; we re-verify this page after the release.

Byte-identical. The file on the development branch matches Odoo 19 exactly, including the reused field dependencies.