XWiki Platform - Office - Macro

Version 40.5 by Vincent Massol on 2022/08/08 00:11

cogView office attachments (doc, ppt, xls, odt, odp, ods etc.) inside wiki pages without downloading or
TypeJAR
Category
Developed by

XWiki Development Team

Active Installs9
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1
Bundled With

XWiki Standard

Compatibility

XWiki >= 2.5 Milestone 2

Installable with the Extension Manager

Description

Displays an office file (e.g. presentation, spreadsheet or word document) within the content of a wiki page. It uses the Office Importer Application to convert the office file to HTML before displaying it.

presentation.png

Usage

From WYSIWYG Editor

When inserting or editing the macro call from the WYSIWYG editor there's a picker to help you select or upload the office file to view.

From Wiki Syntax

{{office reference="file.doc" filterStyles="false"/}}
{{office reference="attach:file.doc" filterStyles="false"/}}
{{office reference="url:http://host.com/some/external/file.doc" filterStyles="false"/}}
{{office attachment="file.doc" filterStyles="false"/}}

Parameters definition

NameOptionalAllowed valuesDefault valueDescription
attachmentnoa valid attachment reference The name of the attachment to display. Deprecated since 5.4.6 and 6.2.2, use reference instead.
referencenoa valid resource reference or a valid attachment reference Since 5.4.6 and 6.2.2 The reference of the attachment to display. The supported resources are URLs (url:) and attachments (attach:). If no reference type or an unknown reference type is provided it's parsed as attachment reference.
filterStylesyestrue/falsetrueWhether to filter out all non-essential styles from the parsed content

Examples

Displays an office attachment defined as an attachment in another page:

{{office attachment="[email protected]" filterStyles="false"/}}

Configuration

XWiki 10.11.9+ You can provide a custom configuration of the office filters (documented in OpenOffice wiki) by editing document-formats.js and copying it to WEB-INF/classes

 The following only apply up until version 10.11.9 after which the jodconverter was updated to version 4.2.4 and such customization on document-formats no longer work as before.

The office macro uses the office server to convert presentation slides into images. By default these images are not very large. If you want to configure the image dimensions and other stuff you'll have to copy document-formats.js from the jodconverter jar to WEB-INF/classes and edit it. For instance, if you want the slide images to have 1024px width you have to change this line:

"PRESENTATION": {"FilterName": "impress_html_Export"},

with

"PRESENTATION": {"FilterName": "impress_html_Export", "FilterData": {"Width": 1024}},

You can also control the compression level / quality of the generated images:

"PRESENTATION": {"FilterName": "impress_html_Export", "FilterData": {"Quality": 90, "Width": 1024}},

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.


The OpenOffice Server needs to be configured and started in order for this macro to work. See the prerequisites for the Office Importer Application for instructions.

Dependencies

Dependencies for this extension (org.xwiki.platform:xwiki-platform-office-macro 14.6):

Tags: office
    

Get Connected