Core Gantt Engine

• Native Odoo view type — ztgantt view works alongside list, kanban, and form views via standard view_mode configuration.
• Configurable field mapping — bind any model's date, name, progress, assignee, and customer fields through declarative XML attributes; no Python changes required for most integrations.
• Parent / child task hierarchy — display parent records with nested child tasks in a collapsible tree layout.
• Drag-to-create tasks — draw a new task bar directly on the timeline to open a pre-filled creation form.
• Drag-to-reschedule — reposition or resize existing task bars; dates are written back to the database automatically.
• Inline editing — double-click any bar to open the record form dialog without leaving the Gantt view.
• Zoom levels — hour, day, week, month, and year scales with a single click; week numbers are translated automatically.
• Today marker & current-time line — always know where "now" sits on the timeline.
• Full-screen mode — expand the chart to the full browser viewport.
• Group-by support — group records by any field (many2one, selection, date granularity, etc.) with nested multi-level grouping.
• Tooltip on hover — shows assignee, customer, and date range at a glance.

GA-01 — Weekend & Holiday Shading

• Automatically fetches the company's working calendar (resource.calendar) once per browser session.
• Weekend columns are shaded with a subtle diagonal-stripe pattern.
• Public holiday columns receive a slightly darker solid shade.
• CSS variables (--gantt-weekend-opacity, --gantt-holiday-opacity) allow theme overrides without editing module files.
• Graceful fallback to Mon–Fri / no holidays if the RPC call times out twice.

GA-02 — Visual Polish

• Multi-color task bars — 7-color palette cycled by project_id % 7. Colors are applied via post-render DOM manipulation so they work reliably regardless of how the zt-gantt library handles template callbacks.

  Index	Color
  0	#10b981 (green)
  1	#f59e0b (amber)
  2	#8b5cf6 (violet)
  3	#ec4899 (pink)
  4	#3b82f6 (blue)
  5	#eab308 (yellow)
  6	#14b8a6 (teal)

• Rounded task bar corners — border-radius: 4px for a modern look.

• Inline progress text — percentage and task name rendered inside bars wider than 80 px, with a text shadow for readability on all palette colours.

• Progress fill tinting — darker shade of the bar colour for the zt-gantt-task-progress fill element.

Requirements

• Odoo 19.0 (Community or Enterprise)
• The web and resource Odoo addons (both are standard; no extra dependencies)

Steps

1. Copy (or clone) the zehntech_gantt_app_base_v19 directory into your Odoo custom addons path, e.g.:

   /opt/odoo/custom-addons/zehntech_gantt_app_base_v19/
   

2. Restart the Odoo server:

   sudo systemctl restart odoo
   

3. Activate developer mode in Odoo (Settings → Activate the developer mode).

4. Open Apps, click Update Apps List, search for "Odoo Gantt App Base", and click Install.

5. After installation the ztgantt view type is available for any model. A demo project/task view is automatically registered under ZT Gantt Demo in the apps menu when demo data is enabled.

Adding a Gantt View to Your Own Model

Create an ir.ui.view record of type ztgantt in your module's XML:

<record id="my_model_gantt_view" model="ir.ui.view">
    <field name="name">my.model.ztgantt</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <ztgantt
            start_date="date_start"
            end_date="date_end"
            name="name"
            child_ids="task_ids"
            child_start_date="date_start"
            child_end_date="date_end"
            child_name="name"
            parent_id="project_id"
            allocated_hours="planned_hours"
            child_allocated_hours="planned_hours"
            child_progress="progress"
            assignee="user_id"
            customer="partner_id"
            child_assignee="user_ids"
            child_customer="partner_id"
        />
    </field>
</record>

Then add ztgantt to the view_mode of your action:

<record id="action_my_model" model="ir.actions.act_window">
    <field name="name">My Projects</field>
    <field name="res_model">my.model</field>
    <field name="view_mode">list,kanban,ztgantt</field>
</record>

Available View Attributes

Customising Colors via CSS Variables

Override in your own module's CSS (no need to edit this module):

:root {
    --gantt-weekend-opacity: 0.05;   /* default 0.08 */
    --gantt-holiday-opacity: 0.08;   /* default 0.12 */
}

19.0.1.1.0 — 2026-03-16

• GA-02 fix — Multi-color task bars now apply correctly via post-render DOM manipulation; the task_class template callback was unreliable because the zt-gantt library does not forward custom task fields to it.
• GA-02e — Added rich demo data (30 tasks across 6 projects).
• GA-03 — Professional README (this file).
• Added custom.model and custom.model.task Python models that back the bundled example Gantt view.

19.0.1.0.1 — 2025-12-01

• GA-02 — Visual polish: multi-color bars, rounded corners, diagonal weekend stripe, inline progress text.
• GA-01 — Weekend & public-holiday column shading driven by resource.calendar.
• Initial Odoo 19 release.

1.0.0 — 2025-04-12

• Initial release — Odoo Gantt App Base.