| Technical Name |
web_widget_preview_image
|
| License | OPL-1 |
We are excited to introduce our Enhanced Image Viewer for Odoo - a much-needed improvement to the default image viewing experience. Odoo's standard image field lacks essential features for effective image management, forcing users to download images just to view them in full size or perform basic actions like zooming or rotating. Our solution solves this by adding a comprehensive, interactive image viewer directly within Odoo.
With our Enhanced Image Viewer, users can click on any image field to open a full-featured viewer with all the tools needed to work with images efficiently. No more switching between Odoo and external image viewers - everything you need is available right in the interface.
- ✅ One-Click Image Preview - Open full-size images directly in Odoo
- ✅ Zoom Controls - Enlarge images up to full screen size with easy zoom
- ✅ Drag & Move - Pan around large images with intuitive drag functionality
- ✅ Rotate Functionality - Rotate images 90° increments for better viewing
- ✅ Download Option - Save high-resolution images with a single click
- ✅ Print Support - Print images directly from the viewer
- ✅ Share Feature - Share images via browser's native share functionality
- ✅ Reset View - Quickly return to original image position and size
- ✅ Fit to Screen - Automatically adjust image to fit your display
- ✅ High-Resolution Support - Load full-size images (1920px) for avatar/image fields
-
Community
-
Enterprise
(On-premises) -
Odoo.sh
-
Online
Community
Who Can Use It?
👨💼 All Odoo Users - Anyone working with images in Odoo will benefit from this tool.
👩💼 Administrators - Manage product images, employee avatars, and document attachments.
💇 Sales Teams - View product images in full resolution when working with customers.
👩🎨 Marketing Teams - Preview and manage marketing materials and product imagery.
👥💼 HR Teams - View employee profile pictures and document attachments easily.
Why Choose Our Image Viewer?
⚡ Seamless Integration - Works with Odoo's native image fields without modifications.
🚀 Easy to Use - Intuitive interface with familiar controls for all users.
🎯 Productivity Boost - Eliminates the need to download images to view them properly.
💡 Community First - 100% free, no hidden charges - forever.
📱 Mobile Friendly - Touch support for drag, zoom, and rotate on mobile devices.
Our Enhanced Image Viewer seamlessly integrates with Odoo's native ImageField component, adding powerful functionality without disrupting the existing workflow. When users click on any image field in Odoo, a modal viewer opens with a comprehensive set of tools to manage and interact with the image.
The viewer automatically loads high-resolution versions of images (1920px) for avatar and image fields that normally display only thumbnails (128px). This ensures users always see the best quality version of the image without extra steps.
We've designed this tool with user experience as the top priority - all controls are intuitive, responsive, and work on both desktop and mobile devices. The viewer supports touch gestures for drag and zoom on mobile, making it accessible from any device.
Drag & Move
Rotate Image
Download Image
Print Image
Share Image
Reset View
Fit to Screen
High Res Support
Touch Support
Seamless Integration
Technical Implementation & Compatibility
Our Enhanced Image Viewer is built as a modular patch to Odoo's native ImageField component, ensuring maximum compatibility and minimal impact on the system. The implementation uses Odoo's official web framework and follows best practices for Odoo module development.
| Odoo Web Framework | Built using Odoo's official @web module and patch system for safe integration. |
|---|---|
| Event Listener Management | Single global listener with guard clauses to prevent duplicate event handling and memory leaks. |
| High-Resolution Image Loading | Automatically detects and loads 1920px versions of avatar/image fields (replacing 128px thumbnails). |
| Responsive Design | Works seamlessly on both desktop and mobile devices with touch support. |
| Drag & Drop Implementation | Smooth drag functionality with proper mouse/touch event handling and state management. |
| Rotation Support | 90° incremental rotation with transform preservation during dragging. |
| Clean DOM Management | Proper cleanup of all created elements to prevent memory leaks and DOM clutter. |
| Button Factory Pattern | Reusable createButton function for consistent button styling and event handling. |
| Keyboard & Touch Support | Supports both mouse and touch events for all interactions. |
| Share Functionality | Uses browser's native share API with fallback for unsupported browsers. |
| Print Functionality | Opens dedicated print window with optimized image display. |
| Download Optimization | Generates unique filenames with proper cleanup of object URLs. |
| CSS Transitions | Smooth animations for zoom and transform operations with minimal performance impact. |
| Event Propagation Control | Proper use of stopPropagation and preventDefault to avoid conflicts with Odoo's native events. |
| Memory Management | Global state variables properly initialized and reset to prevent memory leaks. |
| Z-Index Management | Proper stacking order with z-index values compatible with Odoo's modal system (10049/10050). |
This image viewer module is completely free, and works with all standard Odoo image fields. If you need customizations such as additional image editing features, integration with specific modules, or enterprise-grade functionality, we offer a paid service to develop tailored solutions for your business needs.
Note: This module works with standard Odoo image fields. For custom image fields or special requirements, please contact our team for a tailored solution.
Mobile Optimization
Already Available
Full touch support with pinch zoom, swipe pan, and optimized button layout for mobile devices.
Ready to use! 👍
Changelog
Stay up to date with the latest features and improvements
- â Basic image preview functionality
- â Zoom and pan controls
- â Image rotation (90° increments)
- â Download and print options
- â Share functionality with browser native API
- â Mobile touch support
- â High-resolution image loading
- â Clean DOM management and memory optimization
-
Configuration
-
Odoo Hosting
-
Customisation
-
Functional Training
-
Technical Training
Configuration
-
Support & Maintenance
-
Dedicated Developer
-
Implementation
-
Odoo Migration
-
API Integration
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.