Extension:OooRender

**MediaWiki extensions manual**
OooRender Release status: beta

Implementation	Media
Description	Converts documents to HTML with OpenOffice.org
Author(s)	Tom Edwards^talk
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
Parameters $wgOooRenderOooPath $wgOooRenderAllowMacros $wgOooRenderTimeout
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.

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.