Lazy-Loaded Bokeh Libraries

Loads Bokeh JS/CSS only when the widget is present, reducing backend payload and speeding up navigation.

Configurable Widget Options

Control min height, placeholder text, and optional usage logging via options on the field definition.

Demo Model & Menu

Ship with ready-to-use demo views so teams can paste a payload and validate results in minutes.

Optional Usage Logging

Track widget renders per record to understand adoption and flag payload issues proactively.

Embedded Bokeh Viewer

Render interactive Bokeh maps, charts, and dashboards without leaving the form view. The widget handles HTML payloads and scripts automatically.

Zero-Trust Sanitization

Only approved DIV and SCRIPT tags are allowed. Dangerous attributes, inline styles, and suspicious script calls are stripped before render.

JSON Payload Friendly

Drop in the JSON output from bokeh.embed or compressed dictionaries. The widget normalizes content and handles script injection automatically.

Auto Template Bootstrap

The QWeb template creates a ready-to-use canvas with loading states, helpful messaging, and accessible ARIA attributes.

Developer Diagnostics

Console logging helpers surface payload issues instantly, making it easy to debug malformed JSON or blocked scripts in development.

Performance Optimized

Lazy rendering keeps the form snappy. Scripts execute only when clean, preventing slowdowns and blocking loops.

Responsive & Accessible

Works flawlessly in split view, full-screen, and mobile layouts with ARIA roles for assistive technologies.

Multi-Map Friendly

Supports geo, scatter, heatmap, and network visuals generated from Bokeh or GeoJSON pipelines.

AI Map Intelligence

Integrates with oe_ai_job_base to score payload health, track adoption, and surface enhancement ideas automatically.

Installation & Setup

1. Install the module: Go to Apps -> Search for "oe_bokeh_map" -> Click Install.
2. Grant access: Give technical users the ability to edit forms that host Bokeh payload fields.
3. Load libraries: Ensure the included Bokeh assets are enabled in Settings -> Technical -> User Interface -> Assets.

Basic Usage

1. Prepare a field: Add a Text or Html field on the desired model and apply the widget="bokeh_map" attribute.
2. Paste payloads: Drop the Bokeh HTML or JSON export into the field and save the record.
3. Review rendering: Reload the form to see the visualization and check the console for any sanitization warnings.
4. Leverage diagnostics: Use the AI health report or browser logs to fine-tune future payloads.

Tips & Best Practices

• Store Bokeh payloads in server-side models, not attachments, for easier auditing.
• Keep JSON payloads under 500 KB for smooth form rendering.
• Enable developer mode to quickly inspect console warnings during setup.
• Combine with oe_ai_job_base to schedule automated payload health checks.

Important Notes

Depends on Odoo web and oe_ai_job_base modules. Bokeh libraries v0.13.0 are bundled; upgrade carefully to maintain compatibility.

Q: Which Odoo versions are supported?

A: Odoo 12.0 Community and Enterprise. The module depends on web and oe_ai_job_base to deliver assets and AI telemetry.

Q: How do I enable the AI health reports?

A: Install oe_ai_job_base (already bundled in our suite) and call ai_module_health_check from the AI Control Center to review asset readiness.

Q: Can I customize how the widget renders?

A: Absolutely. Extend the JavaScript module, override the QWeb template, or inherit the CSS file to match your branding while keeping the sanitization layer intact.

Why Choose Odoo Engineering