====== structodt Plugin ======

---- plugin ----
description: Allows to generate odt files based on template file, filled with struct data.
author     : Szymon Olewniczak 
email      : it@rid.pl 
type       : syntax
lastupdate : 2023-08-29
compatible : Jack Jackrum
depends    : struct
conflicts  : 
similar    : 
tags       : !experimental, data, database, sqlite, odt

downloadurl: https://github.com/gkrid/dokuwiki-plugin-structodt/zipball/master
bugtracker : https://github.com/gkrid/dokuwiki-plugin-structodt/issues
sourcerepo : https://github.com/gkrid/dokuwiki-plugin-structodt/

screenshot_img : 
----

This plugin allows you to generate odt files based on template file, filled with struct data. 

===== Installation =====

:!: This plugin requires the [[struct]] plugin which has to be installed first.

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

===== Usage =====

The code below:
<code>
---- struct odt ---
schema: sample_schema
cols: *
template: ::template.odt
----
</code>

Will result with something similar to: 

{{https://image.ibb.co/c43vc7/structodt1.png}}

Each document icon in the table links to odt file which can be downloaded. All of them are build from odt template defined by template parameter. Other parameters behaves like in [[plugin:struct:aggregation|struct table]]. Template file is odt file upload by Media Manager.

==== Templates ====
Templates are normal odt files. Following strings will be replaced:
  * @@struct_field_name@@ - struct field
  * @@struct_field_mulit[0]@@, @@struct_field_mulit[1]@@, ... - first, second, ... value of multi field
  * @@%pageid%@@ etc. like in [[plugin:struct:aggregation#special_columns]] 

Entire string in odt file must be in one format.