=== Docxpresso ===
Tags: Word, Libre Office, Open Office, copy and paste, insert, content, document, html, css, comment popovers, sortable tables, v1.3
Requires at least: 3.5
Tested up to: 4.4.2
Stable tag: trunk
Contributors: No-nonsense Labs
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

"Copy and Paste" from MS Word, Libre Office or Open Office.

== Description ==

If you are used to write all your documents using a Office Suite 
Word Processor like the ones available in
MS Office, Libre Office or Open Office **Docxpresso** is the WordPress plugin
you are looking for!

> This plugin will allow you to publish content that has been generated with your
> favourite Office Suite (MS, libre or Open Office) preserving all of its structure,
> design and format:

> * Nicely formatted text
> * Headings
> * Tables (sortable)
> * Links and bookmarks
> * Nested lists with sophisticated numberings
> * Images
> * Textboxes
> * Footnotes and endnotes
> * Headers and Footers
> * Tables of contents (TOCs)
> * Comments

Moreover you may also create your own forms, create sortable tables or even export your **charts**.

This plugin is a spin-off of our [Docxpresso API](http://www.docxpresso.com "Generate dynamically all your documents online")
library designed to generate all kind of dynamical documents on your web server (PDF, Word, ODT, RTF).

= How to use it =

1. Create a standard document with the content that you want to insert in your Post or Page using your favourite Word Processor (MS Word, Libre Office or Open Office).
2. IMPORTANT: Save your document in **.odt** format. In MS Word choose OpenDocument (*.odt) in your **Save As** dialogue (in Libre or Open Office is the default format).
3. Create or edit a Post or Page in your WordPress interface.
4. Click the **Docxpresso** button located over the text editor.
5. A standard WordPress media window will open. You may upload a new document with the required contents or use a previously uploaded document.
6. After choosing a file click on the **Insert** button.
7. A [docxpresso] shortcode will be included within your text editor.     
8. You may then add or not any additional content to your post but do not try to modify by hand the contents of the Docxpresso shortcode unless you really know what you are doing.
9. You may insert as many documents as you wish in a single Post or Page.

You may also check this video tutorial where yo will find a detailed example of all the above:

http://www.youtube.com/watch?v=wu_pi8FOrUs

In case you want to make any of your tables sortable you also should:

1. Declare the first row of your table as a header row within your Office document
2. insert a "@" symbol as the first character in every column that you wish to be sortable
3. If you want to sort columns by numbers that do not follow the en-US standard, i.e. 3,576.45, you should modify accordingly the "locale" parameter in the config.ini in the root directory of your plugin

== Installation ==

= From your WordPress dashboard =

1. Visit 'Plugins > Add New'.
2. Search for **Docxpresso**.
3. Activate Docxpresso from your Plugins page.

= From WordPress.org =

1. Download Docxpresso.
2. Upload the 'docxpresso' directory to your '/wp-content/plugins/' directory.
3. Activate Docxpresso from your Plugins page.

== Frequently Asked Questions ==

= May I use this plugin in any website, commercial or not? =
Yes, there are no limits to that regard.
= May I ask for support? =
Yes, you may write in the forum or leave a message in [Docxpresso](http://www.docxpresso.com "Generate dynamically all your documents online") but beware that support
is not (always) offered for free.


== Screenshots ==

1. **Docxpresso button** - just clicking on it you will be able to upload or choose a document from the media popup window. A shortcode will
be inserted into your text editor with all the required data.
2. **Sample post** - this is just a sample result of a document with charts and formatted text.

== Changelog ==

= 1.3 =

* Parsing of document comments as popovers
* Sortable tables
* Numbered headings and paragraphs
* Superscripts and subscripts
* Miscellaneous improvements in the rendering engine
* Correction of minor bugs

= 1.2 =

* Improvements in chart rendering

= 1.1 =

* Improvements in selector specificity to avoid conflicts among styles
* New added default styles

= 1.0.1 =

* Minor improvements in the documentation

= 1.0 =

* Initial version

== Licensing ==

This work is licensed under GPLv2 or later.

This plugin comes bundled with the D3 and C3 JavaScript libraries for chart rendering and the webui-popover library for comment rendering. D3 (http://d3js.org) is
distributed under the BSD license and C3 (http://c3js.org/) and webui-popover (https://github.com/sandywalker/webui-popover) are distributed under 
the MIT license .