Skip to main content

Add positioned images to PDF reports.

Project description

Odoo Community Association

Report Positioned Image

Beta License: AGPL-3 OCA/reporting-engine Translate me on Weblate Try me on Runboat

This module allows you to add positioned images (such as watermarks, logos, or stamps) to PDF reports. Images can be precisely positioned using millimeter coordinates (top, left) and you can control whether they appear on all pages or only the first page.

The module supports two types of images:

  • Company-level Images: Define images at the company level that can be included in reports by enabling the Include Company Images option

  • Report-specific Images: Configure specific images for individual reports, filtered by company context and always shown when configured

Images can be assigned to a specific company or left as shared records (without company assignment) for use across multiple companies

Table of contents

Configuration

To configure company-level images:

  1. Go to Settings / Companies

  2. Open your company record

  3. Navigate to the Report Images tab

  4. Add images with position settings:

    • Upload an image - width defaults to 50mm and height is automatically calculated to maintain the original aspect ratio

    • Top (mm): Distance from the top of the page

    • Left (mm): Distance from the left edge of the page

    • Width (mm): Width of the image (changing this auto-adjusts height)

    • Height (mm): Height of the image (changing this auto-adjusts width)

    • Respect Image Ratio: When enabled (default), changing width or height automatically adjusts the other dimension to maintain aspect ratio. Uncheck for manual control of both dimensions.

    • First Page Only: Check to show only on the first page

    • Company: Automatically set to the current company when creating from the company form. To create shared images, leave empty.

To configure report-specific images:

  1. Go to Settings / Technical / Actions / Reports

  2. Open the report you want to customize

  3. Navigate to the Report Images tab

  4. Check Include Company Images if you want to show company-level images in addition to report-specific images

  5. Add report-specific images in the list with the same position settings as above

Note: By default, images maintain their aspect ratio. When you upload an image, it’s automatically sized to 50mm width with proportional height. You can then adjust either dimension and the other will update automatically to prevent distortion.

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

Authors

  • Quartile

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

This module is part of the OCA/reporting-engine project on GitHub.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file odoo_addon_report_positioned_image-18.0.1.0.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for odoo_addon_report_positioned_image-18.0.1.0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 690dac4f72d2ea8eff6eeb5fb983857a81da8cfd7634d5ca2ae27c365e007e8e
MD5 aa449bb1630fd2d39a7a2beb39740ad7
BLAKE2b-256 249555f97997bf1f1b784839cc624e1e23e9c560a7cc2e0000ffc182ab5d9b03

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page