Open main menu

Extension:OooRender

MediaWiki extensions manual
OOjs UI icon advanced.svg
OooRender
Release status: beta
OooRender.png
Implementation Media
Description Converts documents to HTML with OpenOffice.org
Author(s) Tom Edwardstalk
Latest version 0.1 (2012-06-18)
MediaWiki 1.19
PHP 5.3
License GPL
Download http://steamreview.org/external/ooorender/OooRender-0.1.zip
$wgOooRenderOooPath
$wgOooRenderAllowMacros
$wgOooRenderTimeout
Translate the OooRender extension if it is available at translatewiki.net
Check usage and version matrix.

OooRender uses a server installation of OpenOffice.org to convert uploaded documents, presentations, and spreadsheets to HTML/images. It supports Microsoft Office and OpenDocument files.

The extension also handles the display of each file, and includes a lightweight JavaScript slideshow viewer.

Contents

Beta issuesEdit

  • Tested on Windows only.
  • Potential OpenOffice.org security issues when converting documents submitted by malicious users. Be warned.
  • No UI to shut the OpenOffice.org process down manually.

UsageEdit

Files are automatically converted. To insert them, use the standard embed markup:

[[File:MyDoc.docx|option=value]]

Options are:

width=
height=
Dimensions in pixels.
stretch
Forces a document to cover 100% of the page width. No effect on spreadsheets (already default to 100%) or presentations (locked to 640px).
icon
Displays an icon instead of the document. This happens automatically at small dimensions.
align=left/right
Floats the embed box
caption=
Changes the header text.

Download instructionsEdit

Download the latest release from http://steamreview.org/external/ooorender/.

InstallationEdit

To install this extension, add the following to LocalSettings.php :

$wgOooRenderOooPath = "my_path";
require_once("$IP/extensions/OooRender/OooRender.php");

To see detailed extension logs:

$wgDebugLogGroups = array(
  'OooRender'     => 'my_path',
);

Configuration parametersEdit

$wgOooRenderOooPath
Required. Path to an installation of OpenOffice.Org which includes Python.
$wgOooRenderAllowMacros
Enable macro-enabled formats (including the MS Office binary format) to be converted.
$wgOooRenderTimeout
How many seconds to wait for OpenOffice.Org to start. Default is 3.