Overview

The Countdown Timer Widget is a powerful tool for adding real-time, self-updating timers to your Odoo form views. It is designed to be highly flexible, visually appealing, and accurate, providing immediate visual feedback on time-sensitive data. It works seamlessly with multiple data types and remains accurate even when the browser tab is inactive.

Key Features

• Multiple Field Types: Works out-of-the-box with datetime, date, integer, and float fields.
• High Accuracy: The timer logic is based on a fixed target timestamp, ensuring it always shows the correct time, even after a browser tab has been backgrounded.
• Extensive Customization: Almost every visual aspect can be controlled directly from the XML view using the options attribute.
• Advanced Behavior Control: Dictate whether the timer stops at zero or crosses over into negative values, and set limits on how far it can go.
• Smart Visual Cues: An elegant glowing animation automatically highlights timers nearing their deadline, and a helpful tooltip provides extra detail on hover.
• Responsive Display: The widget intelligently hides itself if the source field is empty, keeping your UI clean.

Installation

1. Place the eis_countdown_timer module into your Odoo addons path.
2. Navigate to the "Apps" menu in Odoo.
3. Click on "Update Apps List".
4. Search for "Countdown Timer Widget" and click "Install".

Usage

To use the widget, simply add widget="expertpktimer" to a supported field in your form view XML definition.

Basic Usage:

<field name="your_datetime_field" widget="expertpktimer"/>

Customization via Options

All customization is handled through the options attribute on the field tag.

<field name="your_field" widget="expertpktimer" options="{'option_name': 'value', ...}"/>

Here is a complete list of available options:

Examples

Example 1: A simple SLA Timer

This timer will be center-aligned and will stop at 00:00:00 without going negative.

<field name="sla_deadline" widget="expertpktimer"
       options="{'alignment': 'center', 'inverseColors': True}"/>

Example 2: A Project Deadline Timer

This timer will be right-aligned, use custom colors and a "fire" icon for the negative state, will cross over to negative, but will stop counting after it has been negative for more than 48 hours.

<field name="project_deadline" widget="expertpktimer"
       options="{
           'alignment': 'right',
           'positiveColor': '#008784',
           'negativeColor': '#d9534f',
           'timerSize': '1.2em',
           'inverseColors': True,
           'negativeIcon': '🔥',
           'allowCrossover': True,
           'negativeThresholdHours': 48
       }"/>

Visual Features

"Nearing End" Animation

When a positive timer has less than 60 seconds remaining, it will automatically get a subtle, glowing pulse animation to draw the user's attention. This works best with the inverseColors: True option.

Tooltip

Hovering your mouse over the timer will display a tooltip showing the original, unformatted value of the field. * For datetime fields, it shows the full date and time (e.g., "August 4, 2025 at 10:00:00 AM"). * For integer fields, it shows the original value (e.g., "Original Value: 8 hours").

Support

For any questions, support, or customization requests, please contact Expert IT Solutions.