Configuration

You need to define a view with the tag <timeline> as base element. These are the possible attributes for the tag:

Optionally you can declare a custom template, which will be used to render the timeline items. You have to name the template ‘timeline-item’. These are the variables available in template rendering:

• record: to access the fields values selected in the timeline definition.
• field_utils: used to format and parse values (see available functions in web.field_utils).

You also need to declare the view in an action window of the involved model.

See web_timeline/demo/ir_cron_view.xml for a very basic timeline view example added onto cron tasks.

More evolved example, from project_timeline:

<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <record id="view_task_timeline" model="ir.ui.view">
        <field name="model">project.task</field>
        <field name="type">timeline</field>
        <field name="arch" type="xml">
            <timeline date_start="date_assign"
                      date_stop="date_end"
                      string="Tasks"
                      default_group_by="project_id"
                      event_open_popup="true"
                      colors="white: user_ids == []; #2ecb71: kanban_state == 'done'; #ec7063: kanban_state == 'blocked'"
                      dependency_arrow="depend_on_ids"
            >
                <field name="user_ids" />
                <field name="planned_hours" />
                <templates>
                    <t t-name="timeline-item">
                        <div class="o_project_timeline_item">
                            <t t-foreach="record.user_ids" t-as="user">
                                <img
                                    t-if="record.user_ids"
                                    t-attf-src="/web/image/res.users/#{user}/image_128/16x16"
                                    t-att-title="record.user"
                                    width="16"
                                    height="16"
                                    class="mr8"
                                    alt="User"
                                />
                            </t>
                            <span name="display_name">
                                <t t-esc="record.display_name" />
                            </span>
                            <small
                                name="planned_hours"
                                class="text-info ml4"
                                t-if="record.planned_hours"
                            >
                                <t
                                    t-esc="field_utils.format.float_time(record.planned_hours)"
                                />
                            </small>
                        </div>
                    </t>
                </templates>
            </timeline>
        </field>
    </record>

    <record id="project.action_view_task" model="ir.actions.act_window">
        <field
            name="view_mode"
        >kanban,tree,form,calendar,timeline,pivot,graph,activity</field>
    </record>
</odoo>

Usage

For accessing the timeline view, you have to click on the button with the clock icon in the view switcher. The first time you access to it, the timeline window is zoomed to fit all the current elements, the same as when you perform a search, filter or group by operation.

You can use the mouse scroll to zoom in or out in the timeline, and click on any free area and drag for panning the view in that direction.

The records of your model will be shown as rectangles whose widths are the duration of the event according our definition. You can select them clicking on this rectangle. You can also use Ctrl or Shift keys for adding discrete or range selections. Selected records are hightlighted with a different color (but the difference will be more noticeable depending on the background color). Once selected, you can drag and move the selected records across the timeline.

When a record is selected, a red cross button appears on the upper left corner that allows to remove that record. This doesn’t work for multiple records although they were selected.

Records are grouped in different blocks depending on the group by criteria selected (if none is specified, then the default group by is applied). Dragging a record from one block to another change the corresponding field to the value that represents the block. You can also click on the group name to edit the involved record directly.

Double-click on the record to edit it. Double-click in open area to create a new record with the group and start date linked to the area you clicked in. By holding the Ctrl key and dragging left to right, you can create a new record with the dragged start and end date.

Known issues / Roadmap

• Implement a more efficient way of refreshing timeline after a record update;
• Make attrs attribute work;
• When grouping by m2m and dragging for changing the time or the group, the changes on the group will not be set, because it could make disappear the records not related with the changes that we want to make. When the item is showed in all groups change the value according the group of the dragged item.
• When an item label does not fit in its date-range box: ✅ the label correctly overflows the box; ✅ clicking anywhere on the label allows moving the box; ❌ double-clicking the label outside of the box does not open that item.
• Take into account action window’s context to overwrite the default group_by.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

This module is part of the OCA/web project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.