Skip to content

Commit 9cdb5c7

Browse files
imp
1 parent 4bfe68a commit 9cdb5c7

17 files changed

Lines changed: 1004 additions & 114 deletions

report_positioned_image/README.rst

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
=======================
2+
Report Positioned Image
3+
=======================
4+
5+
..
6+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7+
!! This file is generated by oca-gen-addon-readme !!
8+
!! changes will be overwritten. !!
9+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
10+
!! source digest: sha256:95c34a70f400e6b0cf4dffe8ff3683704930c7080a435724ec9b495387d48309
11+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
12+
13+
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
14+
:target: https://odoo-community.org/page/development-status
15+
:alt: Beta
16+
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
17+
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
18+
:alt: License: AGPL-3
19+
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Freporting--engine-lightgray.png?logo=github
20+
:target: https://github.com/OCA/reporting-engine/tree/18.0/report_positioned_image
21+
:alt: OCA/reporting-engine
22+
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
23+
:target: https://translation.odoo-community.org/projects/reporting-engine-18-0/reporting-engine-18-0-report_positioned_image
24+
:alt: Translate me on Weblate
25+
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
26+
:target: https://runboat.odoo-community.org/builds?repo=OCA/reporting-engine&target_branch=18.0
27+
:alt: Try me on Runboat
28+
29+
|badge1| |badge2| |badge3| |badge4| |badge5|
30+
31+
This module allows you to add positioned images to PDF reports generated
32+
by Odoo. You can configure images with precise positioning (top, right
33+
coordinates) and control whether they appear on all pages or only the
34+
first page.
35+
36+
The module supports two modes:
37+
38+
- **Company Images**: Use images configured at the company level for
39+
all reports
40+
- **Custom Images**: Configure specific images for individual reports
41+
42+
**Table of contents**
43+
44+
.. contents::
45+
:local:
46+
47+
Usage
48+
=====
49+
50+
To configure company-level images:
51+
52+
1. Go to **Settings > Companies**
53+
2. Open your company record
54+
3. Navigate to the **Company Images** tab
55+
4. Add images with position settings:
56+
57+
- **Top (mm)**: Distance from the top of the page
58+
- **Right (mm)**: Distance from the right edge of the page
59+
- **Width (mm)**: Width of the image
60+
- **First Page Only**: Check to show only on the first page
61+
62+
To configure report-specific images:
63+
64+
1. Go to **Settings > Technical > Actions > Reports**
65+
2. Open the report you want to customize
66+
3. Navigate to the **Report Images** tab
67+
4. Select **Report Image** mode:
68+
69+
- **Use Company Images**: Use images from the company configuration
70+
- **Custom**: Configure specific images for this report
71+
72+
5. If you selected **Custom**, add images in the list below
73+
74+
Images are positioned using CSS absolute or fixed positioning and are
75+
injected into the PDF during report generation.
76+
77+
Bug Tracker
78+
===========
79+
80+
Bugs are tracked on `GitHub Issues <https://github.com/OCA/reporting-engine/issues>`_.
81+
In case of trouble, please check there if your issue has already been reported.
82+
If you spotted it first, help us to smash it by providing a detailed and welcomed
83+
`feedback <https://github.com/OCA/reporting-engine/issues/new?body=module:%20report_positioned_image%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
84+
85+
Do not contact contributors directly about support or help with technical issues.
86+
87+
Credits
88+
=======
89+
90+
Authors
91+
-------
92+
93+
* Quartile
94+
95+
Contributors
96+
------------
97+
98+
- Quartile <<<<https://www.quartile.co>>>>
99+
100+
- Tatsuki Kanda
101+
- Aung Ko Ko Lin
102+
103+
Maintainers
104+
-----------
105+
106+
This module is maintained by the OCA.
107+
108+
.. image:: https://odoo-community.org/logo.png
109+
:alt: Odoo Community Association
110+
:target: https://odoo-community.org
111+
112+
OCA, or the Odoo Community Association, is a nonprofit organization whose
113+
mission is to support the collaborative development of Odoo features and
114+
promote its widespread use.
115+
116+
This module is part of the `OCA/reporting-engine <https://github.com/OCA/reporting-engine/tree/18.0/report_positioned_image>`_ project on GitHub.
117+
118+
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

report_positioned_image/__manifest__.py

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,16 @@
22
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
33
{
44
"name": "Report Positioned Image",
5+
"summary": "Add positioned images to PDF reports generated by Odoo.",
56
"version": "18.0.1.0.0",
67
"category": "Reporting",
7-
"author": "Quartile",
8+
"author": "Quartile, Odoo Community Association (OCA)",
9+
"website": "https://github.com/OCA/reporting-engine",
810
"license": "AGPL-3",
911
"depends": ["web"],
1012
"data": [
1113
"security/ir.model.access.csv",
14+
"views/report_positioned_image_views.xml",
1215
"views/res_company_views.xml",
1316
"views/ir_actions_report_views.xml",
1417
],
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Copyright 2026 Quartile
22
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
33

4+
from . import ir_actions_report
45
from . import report_positioned_image
56
from . import res_company
6-
from . import ir_actions_report

0 commit comments

Comments
 (0)