====== ODT2DW Plugin ======

---- plugin ----
description: Create a DokuWiki page by importing an odt file
author     : garlik
email      : garlik.crx@gmail.com
type       : action
lastupdate : 2016-02-04
compatible : Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus
depends    :
conflicts  :
similar    :
tags       : create, odt, import

downloadurl: https://github.com/garlik-gag/dokuwiki-plugin-odt2dw/zipball/master
bugtracker : https://github.com/garlik-gag/dokuwiki-plugin-odt2dw/issues
sourcerepo : https://github.com/garlik-gag/dokuwiki-plugin-odt2dw/
donationurl:
----

**Firstly, I apologize for english mistake.** The [[fr:plugin:odt2dw|french page]] should be more understandable.

===== Installation =====

This plugin use the php xsltProcessor class. Be sure php-xml library or php5-xsl library is installed before using the plugin.

Anyway, an error message occur if something goes wrong.

:!: **External requirements:** This plugin requires the following additional components that must be installed separately:
  * php xsltProcessor (ex : php-xml, php5-xsl)


Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.


===== How to =====

This plugin display a form in 4 cases :
  * use action odt2dw (''?do=odt2dw'') anywhere
  * if allowed use action show (''?do=show'') on a new page (allowed by default)
  * if allowed use action edit (''?do=edit'') on a new page (allowed by default)
  * use any allowed action on a new page
Have a look to the configuration section for more information

You must choose an odt file and submit.

Then, the file is parsed, the result is stored (replacing the existing page) and the wiki displays the result with the set action. 

===== Configuration and Settings =====

Configuring it by using the [[plugin:config|config plugin]].

You can set some parameter like the debug level, which action will display the upload form, ...

===== Development =====

This version is a beta, some format won't be translate in DokuWiki like wrong made headline.

Please, report your issues with sample as possible.

Odtfiles are zipfiles contain a file name content.xml.
If you know xml, xsl and xslt, you can improve the parser.

=== Change Log ===

Look at github: [[https://github.com/garlik-gag/dokuwiki-plugin-odt2dw/blob/master/README|README]]

=== Known Bugs and Issues ===

Look at github: [[https://github.com/garlik-gag/dokuwiki-plugin-odt2dw/issues?sort=created&state=open|issues]]

===== FAQ =====

Nothing yet

Hello,\\
I'm using your uploader with *.odt files from Word 2013 the files contain images important for the page. But its usally only showing the first image the others are displayed as "%%{{ObjectReplacements/Object 1}}%%" so I'm wondering if someone could help with this problem because im not sure why this happens.

===== Discussion =====

== Great! == 
Thanks. Especially for correct images import . - Max 2014/03/04 14:14

== Works nice even on new version 2016-06-26 "Elenor of Tsort" ==
I use this plugin for several years and works very well without any major problems, even through upgrades of the wiki. - brozkeff 2016/09/08 13:56

== Critical Error==
I wonder if i do something wrong but alltime i try to upload a odt file made with  libreoffice i get the error
Kritischer Fehler: ZipArchive-Objekt konnte nicht initialisiert werden
is this because i am do something wrong or a bug by the plugin?

  * Solution: You need to have Zip module in PHP. On Debian with PHP7.0 install it with sudo apt install php7.0-zip  or if you have different version of PHP change the package name appropriately. Restart webserver afterwards. --Martin Malec