[18.0][FEAT] attachment_preview: add Office format preview via LibreOffice

Extends attachment_preview to support DOCX, XLSX, PPTX, DOC, XLS, PPT,
and ODG in addition to the existing PDF + ODF format support.

New endpoint: GET /attachment_preview/office_to_pdf
  Accepts ?model=<model>&field=<field>&id=<id>&filename=<name>
  Converts the binary field content to PDF using LibreOffice headless,
  then streams the PDF to ViewerJS for in-browser rendering.
  Returns HTTP 503 gracefully if LibreOffice is not installed.

Changes:
- controllers/main.py: new HTTP controller with LibreOffice conversion
- utils.esm.js: OFFICE_EXTENSIONS added to canPreview(); getUrl() routes
  Office files to the conversion endpoint
- binary_field.esm.js: passes filename for correct extension detection
- tests: controller unit tests covering success, FileNotFoundError,
  TimeoutExpired, and non-zero exit code paths

Closes #603

Author: dnplkndll

attachment_preview/README.rst

@@ -1,7 +1,3 @@
-.. image:: https://odoo-community.org/readme-banner-image
-   :target: https://odoo-community.org/get-involved?utm_source=readme
-   :alt: Odoo Community Association
-
 ===================
 Preview attachments
 ===================
@@ -17,7 +13,7 @@ Preview attachments
 .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
     :target: https://odoo-community.org/page/development-status
     :alt: Beta
-.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
     :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
     :alt: License: AGPL-3
 .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github

attachment_preview/__init__.py

@@ -1,4 +1,4 @@
 # Copyright 2014 Therp BV (<http://therp.nl>)
 # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
 
-from . import models
+from . import controllers, models

attachment_preview/controllers/__init__.py

@@ -0,0 +1,4 @@
+# Copyright 2026 Ledoweb
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from . import main

attachment_preview/controllers/main.py

@@ -0,0 +1,109 @@
+# Copyright 2026 Ledoweb
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+"""
+LibreOffice-based conversion endpoint for Office document preview.
+
+Converts DOCX, XLSX, PPTX (and legacy DOC/XLS/PPT) to PDF for in-browser
+viewing via the ViewerJS widget. LibreOffice headless must be installed;
+if it is absent the endpoint returns HTTP 503.
+"""
+
+import base64
+import os
+import subprocess
+import tempfile
+
+from odoo import http
+from odoo.http import request
+
+# Extensions handled by LibreOffice conversion
+OFFICE_EXTENSIONS = frozenset(
+    {"docx", "xlsx", "pptx", "doc", "xls", "ppt", "odt", "ods", "odp", "odg"}
+)
+
+
+class AttachmentPreviewOfficeController(http.Controller):
+    @http.route(
+        "/attachment_preview/office_to_pdf",
+        type="http",
+        auth="user",
+        methods=["GET"],
+    )
+    def office_to_pdf(self, model, field, id, filename="file", **kwargs):
+        """Convert a binary field's Office document to PDF for preview.
+
+        Query params:
+            model   – Odoo model name (e.g. 'dms.file')
+            field   – binary field name (e.g. 'content')
+            id      – record id (integer)
+            filename – original filename (used to derive extension)
+        """
+        try:
+            record_id = int(id)
+        except (TypeError, ValueError):
+            return request.make_response("Bad request", status=400)
+
+        record = request.env[model].browse(record_id)
+        record.check_access_rights("read")
+        record.check_access_rule("read")
+
+        raw = getattr(record, field, None)
+        if not raw:
+            return request.make_response("No content", status=404)
+
+        content = base64.b64decode(raw)
+        ext = os.path.splitext(filename)[-1].lstrip(".").lower() or "bin"
+
+        if ext not in OFFICE_EXTENSIONS:
+            return request.make_response(
+                "Extension not supported for conversion", status=415
+            )
+
+        pdf_bytes = self._libreoffice_to_pdf(content, ext)
+        if pdf_bytes is None:
+            return request.make_response(
+                "LibreOffice not available — cannot convert document", status=503
+            )
+
+        return request.make_response(
+            pdf_bytes,
+            headers=[
+                ("Content-Type", "application/pdf"),
+                (
+                    "Content-Disposition",
+                    f'inline; filename="{os.path.splitext(filename)[0]}.pdf"',
+                ),
+                ("Cache-Control", "private, max-age=3600"),
+            ],
+        )
+
+    @staticmethod
+    def _libreoffice_to_pdf(content, ext):
+        """Run LibreOffice headless conversion. Returns PDF bytes or None."""
+        try:
+            with tempfile.TemporaryDirectory() as tmpdir:
+                src = os.path.join(tmpdir, f"source.{ext}")
+                with open(src, "wb") as fh:
+                    fh.write(content)
+                result = subprocess.run(
+                    [
+                        "libreoffice",
+                        "--headless",
+                        "--convert-to",
+                        "pdf",
+                        "--outdir",
+                        tmpdir,
+                        src,
+                    ],
+                    timeout=30,
+                    capture_output=True,
+                )
+                if result.returncode != 0:
+                    return None
+                pdf_path = os.path.join(tmpdir, "source.pdf")
+                if not os.path.exists(pdf_path):
+                    return None
+                with open(pdf_path, "rb") as fh:
+                    return fh.read()
+        except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
+            return None

attachment_preview/readme/newsfragments/603.feature

@@ -0,0 +1,3 @@
+Add Office format preview (DOCX, XLSX, PPTX, DOC, XLS, PPT, ODG) via
+LibreOffice headless conversion. Returns HTTP 503 gracefully when
+LibreOffice is not installed.

attachment_preview/static/description/index.html

@@ -3,7 +3,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils: https://docutils.sourceforge.io/" />
-<title>README.rst</title>
+<title>Preview attachments</title>
 <style type="text/css">
 
 /*
@@ -360,21 +360,16 @@
 </style>
 </head>
 <body>
-<div class="document">
+<div class="document" id="preview-attachments">
+<h1 class="title">Preview attachments</h1>
 
-
-<a class="reference external image-reference" href="https://odoo-community.org/get-involved?utm_source=readme">
-<img alt="Odoo Community Association" src="https://odoo-community.org/readme-banner-image" />
-</a>
-<div class="section" id="preview-attachments">
-<h1>Preview attachments</h1>
 <!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !! This file is generated by oca-gen-addon-readme !!
 !! changes will be overwritten.                   !!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !! source digest: sha256:badc7aad1a4bee3f65173d08f56b91d13166d0c26644edf8475aa249016995e1
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
-<p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/license-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/knowledge/tree/18.0/attachment_preview"><img alt="OCA/knowledge" src="https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/knowledge-18-0/knowledge-18-0-attachment_preview"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/knowledge&amp;target_branch=18.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
+<p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/knowledge/tree/18.0/attachment_preview"><img alt="OCA/knowledge" src="https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/knowledge-18-0/knowledge-18-0-attachment_preview"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/knowledge&amp;target_branch=18.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
 <p>This addon allows to preview attachments supported by
 <a class="reference external" href="http://viewerjs.org">http://viewerjs.org</a>.</p>
 <p>Currently, that’s most Libreoffice files and PDFs.</p>
@@ -394,13 +389,13 @@ <h1>Preview attachments</h1>
 </ul>
 </div>
 <div class="section" id="installation">
-<h2><a class="toc-backref" href="#toc-entry-1">Installation</a></h2>
+<h1><a class="toc-backref" href="#toc-entry-1">Installation</a></h1>
 <p>For filetype recognition, you’ll get the best results by installing
 <tt class="docutils literal"><span class="pre">python-magic</span></tt>:</p>
 <p>sudo apt-get install python-magic</p>
 </div>
 <div class="section" id="usage">
-<h2><a class="toc-backref" href="#toc-entry-2">Usage</a></h2>
+<h1><a class="toc-backref" href="#toc-entry-2">Usage</a></h1>
 <p>The module adds a little print preview icon right of download links for
 attachments or binary fields. When a preview is opened from the
 attachments menu it’s shown next to the form view. From this screen you
@@ -410,31 +405,31 @@ <h2><a class="toc-backref" href="#toc-entry-2">Usage</a></h2>
 <p><img alt="Screenshot navigator" src="https://raw.githubusercontent.com/attachment_preview/static/description/screenshot-paginator.png" /></p>
 </div>
 <div class="section" id="bug-tracker">
-<h2><a class="toc-backref" href="#toc-entry-3">Bug Tracker</a></h2>
+<h1><a class="toc-backref" href="#toc-entry-3">Bug Tracker</a></h1>
 <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/knowledge/issues">GitHub Issues</a>.
 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
 <a class="reference external" href="https://github.com/OCA/knowledge/issues/new?body=module:%20attachment_preview%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
 <p>Do not contact contributors directly about support or help with technical issues.</p>
 </div>
 <div class="section" id="credits">
-<h2><a class="toc-backref" href="#toc-entry-4">Credits</a></h2>
+<h1><a class="toc-backref" href="#toc-entry-4">Credits</a></h1>
 <div class="section" id="authors">
-<h3><a class="toc-backref" href="#toc-entry-5">Authors</a></h3>
+<h2><a class="toc-backref" href="#toc-entry-5">Authors</a></h2>
 <ul class="simple">
 <li>Therp BV</li>
 <li>Onestein</li>
 </ul>
 </div>
 <div class="section" id="contributors">
-<h3><a class="toc-backref" href="#toc-entry-6">Contributors</a></h3>
+<h2><a class="toc-backref" href="#toc-entry-6">Contributors</a></h2>
 <ul class="simple">
 <li>Holger Brunn &lt;<a class="reference external" href="mailto:mail&#64;hunki-enterprises.com">mail&#64;hunki-enterprises.com</a>&gt;</li>
 <li>Dennis Sluijk &lt;<a class="reference external" href="mailto:d.sluijk&#64;onestein.nl">d.sluijk&#64;onestein.nl</a>&gt;</li>
 </ul>
 </div>
 <div class="section" id="maintainers">
-<h3><a class="toc-backref" href="#toc-entry-7">Maintainers</a></h3>
+<h2><a class="toc-backref" href="#toc-entry-7">Maintainers</a></h2>
 <p>This module is maintained by the OCA.</p>
 <a class="reference external image-reference" href="https://odoo-community.org">
 <img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
@@ -447,6 +442,5 @@ <h3><a class="toc-backref" href="#toc-entry-7">Maintainers</a></h3>
 </div>
 </div>
 </div>
-</div>
 </body>
 </html>

attachment_preview/static/src/js/utils.esm.js

@@ -1,47 +1,121 @@
 import {Component} from "@odoo/owl";
 
+// Extensions rendered natively by ViewerJS (PDF + ODF formats)
+const VIEWERJS_EXTENSIONS = [
+    "odt",
+    "odp",
+    "ods",
+    "fodt",
+    "pdf",
+    "ott",
+    "fodp",
+    "otp",
+    "fods",
+    "ots",
+];
+
+// Extensions converted to PDF server-side via LibreOffice (if installed).
+// These use the /attachment_preview/office_to_pdf endpoint.
+const OFFICE_EXTENSIONS = ["docx", "xlsx", "pptx", "doc", "xls", "ppt", "odg"];
+
 export function canPreview(extension) {
-    const supported_extensions = [
-        "odt",
-        "odp",
-        "ods",
-        "fodt",
-        "pdf",
-        "ott",
-        "fodp",
-        "otp",
-        "fods",
-        "ots",
-    ];
-    return supported_extensions.includes(extension);
+    return (
+        VIEWERJS_EXTENSIONS.includes(extension) || OFFICE_EXTENSIONS.includes(extension)
+    );
+}
+
+export function isOfficeExtension(extension) {
+    return OFFICE_EXTENSIONS.includes(extension);
 }
 
 export function getUrl(
     attachment_id,
     attachment_url,
     attachment_extension,
-    attachment_title
+    attachment_title,
+    attachment_filename
 ) {
+
+    var origin = window.location.origin || "";
+
+    // Office formats: route through LibreOffice → PDF conversion endpoint
+    if (isOfficeExtension(attachment_extension)) {
+        var conversionUrl = "";
+        if (attachment_url) {
+            // Derive model/field/id from the binary field URL
+            // e.g. /web/content?model=dms.file&field=content&id=42
+            try {
+
+                var parsed = new URL(origin + attachment_url);
+                var model = parsed.searchParams.get("model");
+                var field = parsed.searchParams.get("field");
+                var id = parsed.searchParams.get("id");
+                if (model && field && id) {
+                    conversionUrl =
+                        origin +
+                        "/attachment_preview/office_to_pdf" +
+                        "?model=" +
+                        encodeURIComponent(model) +
+                        "&field=" +
+                        encodeURIComponent(field) +
+                        "&id=" +
+                        encodeURIComponent(id) +
+                        "&filename=" +
+                        encodeURIComponent(
+                            attachment_filename || "file." + attachment_extension
+                        );
+                }
+            } catch {
+                // URL parsing failed — fall through to attachment_id path
+            }
+        }
+        if (!conversionUrl && attachment_id) {
+            conversionUrl =
+                origin +
+                "/attachment_preview/office_to_pdf" +
+                "?model=ir.attachment&field=datas&id=" +
+                attachment_id +
+                "&filename=" +
+                encodeURIComponent(
+                    attachment_filename || "file." + attachment_extension
+                );
+        }
+        if (conversionUrl) {
+            // Tell ViewerJS the converted output is PDF
+            return (
+                origin +
+                "/attachment_preview/static/lib/ViewerJS/index.html" +
+                "?type=pdf" +
+                "&title=" +
+                encodeURIComponent(attachment_title) +
+                "&zoom=automatic" +
+                "#" +
+                conversionUrl.replace(origin, "")
+            );
+        }
+    }
+
+    // Native ViewerJS path (PDF + ODF)
     var url = "";
     if (attachment_url) {
         if (attachment_url.slice(0, 21) === "/web/static/lib/pdfjs") {
-            url = (window.location.origin || "") + attachment_url;
+            url = origin + attachment_url;
         } else {
             url =
-                (window.location.origin || "") +
+                origin +
                 "/attachment_preview/static/lib/ViewerJS/index.html" +
                 "?type=" +
                 encodeURIComponent(attachment_extension) +
                 "&title=" +
                 encodeURIComponent(attachment_title) +
                 "&zoom=automatic" +
                 "#" +
-                attachment_url.replace(window.location.origin, "");
+                attachment_url.replace(origin, "");
         }
         return url;
     }
     url =
-        (window.location.origin || "") +
+        origin +
         "/attachment_preview/static/lib/ViewerJS/index.html" +
         "?type=" +
         encodeURIComponent(attachment_extension) +
@@ -62,7 +136,8 @@ export function showPreview(
     attachment_extension,
     attachment_title,
     split_screen,
-    attachment_info_list
+    attachment_info_list,
+    attachment_filename
 ) {
     if (split_screen && attachment_info_list) {
         Component.env.bus.trigger("open_attachment_preview", {
@@ -75,7 +150,8 @@ export function showPreview(
                 attachment_id,
                 attachment_url,
                 attachment_extension,
-                attachment_title
+                attachment_title,
+                attachment_filename
             )
         );
     }