<h1 class="title">MuK Converter</h1> <p>Technical module to provide some utility features and libraries that can be used in other applications. This module has no direct effect on the running system.</p> <a name="requirements"></a> <h2>Requirements</h2> <p>The requirements are only to be fulfilled if the module is not used with the IAP service.</p> <a name="unoconv"></a> <h3>unoconv</h3> <p>Universal Office Converter (unoconv) is a command line tool to convert any document format that LibreOffice can import to any document format that LibreOffice can export. It makes use of the LibreOffice's UNO bindings for non-interactive conversion of documents.</p> <p>To install unoconv please follow the instructions (<a class="reference external" href="https://github.com/dagwieers/unoconv">here</a>).</p> <p>Make sure that unoconv can be executed from the console and the conversion is done correctly.</p> <p>To set an individual path for the LibreOffice installation, the config variable <code>uno_path</code> can be set accordingly in the Odoo config.</p> <p>Under Windows you should rename the <code>unoconv</code> file to <code>unoconv.py</code> and set the corresponding path for the <code>uno_path</code> variable. Since it does not work reliably with the environment variable <code>UNO_PATH</code>.</p> <a name="installation"></a> <h2>Installation</h2> <p>To install this module, you need to:</p> <p>Download the module and add it to your Odoo addons folder. Afterward, log on to your Odoo server and go to the Apps menu. Trigger the debug mode and update the list by clicking on the &quot;Update Apps List&quot; link. Now install the module by clicking on the install button.</p> <p>Another way to install this module is via the package management for Python (<a class="reference external" href="https://pypi.org/project/pip/">PyPI</a>).</p> <p>To install our modules using the package manager make sure <a class="reference external" href="https://pypi.org/project/odoo-autodiscover/">odoo-autodiscover</a> is installed correctly. Then open a console and install the module by entering the following command:</p> <p><code>pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple &lt;module&gt;</code></p> <p>The module name consists of the Odoo version and the module name, where underscores are replaced by a dash.</p> <p><strong>Module:</strong></p> <p><code>odoo&lt;version&gt;-addon-&lt;module_name&gt;</code></p> <p><strong>Example:</strong></p> <p><code>sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo11-addon-muk-utils</code></p> <p>Once the installation has been successfully completed, the app is already in the correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the debug mode and update the list by clicking on the &quot;Update Apps List&quot; link. Now install the module by clicking on the install button.</p> <p>The biggest advantage of this variant is that you can now also update the app using the &quot;pip&quot; command. To do this, enter the following command in your console:</p> <p><code>pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple &lt;module&gt;</code></p> <p>When the process is finished, restart your server and update the application in Odoo. The steps are the same as for the installation only the button has changed from &quot;Install&quot; to &quot;Upgrade&quot;.</p> <p>You can also view available Apps directly in our <a class="reference external" href="https://nexus.mukit.at/#browse/browse:odoo">repository</a> and find a more detailed installation guide on our <a class="reference external" href="https://mukit.at/page/open-source">website</a>.</p> <p>For modules licensed under OPL-1, you will receive access data when you purchase the module. If the modules were not purchased directly from <a class="reference external" href="https://www.mukit.at/">MuK IT</a> please contact our support (<a class="reference external" href="mailto:support&#64;mukit.at">support&#64;mukit.at</a>) with a confirmation of purchase to receive the corresponding access data.</p> <a name="upgrade"></a> <h2>Upgrade</h2> <p>To upgrade this module, you need to:</p> <p>Download the module and add it to your Odoo addons folder. Restart the server and log on to your Odoo server. Select the Apps menu and upgrade the module by clicking on the upgrade button.</p> <p>If you installed the module using the &quot;pip&quot; command, you can also update the module in the same way. Just type the following command into the console:</p> <p><code>pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple &lt;module&gt;</code></p> <p>When the process is finished, restart your server and update the application in Odoo, just like you would normally.</p> <a name="configuration"></a> <h2>Configuration</h2> <p>The converter uses a store to avoid the repeated conversion of the same file. To avoid unnecessary memory consumption, Odoo's AutoVaccum Cron Job empties the store accordingly. The system parameter <code>muk_converter.max_store</code> can be used to set the maximum number of elements that can be in the store after cleaning. By default, this value is set to 20.</p> <a name="usage"></a> <h2>Usage</h2> <p>This module has no direct visible effect on the system. It provides functions to convert data from one file format to another.</p> <a name="credits"></a> <h2>Credits</h2> <a name="contributors"></a> <h3>Contributors</h3> <ul class="simple"> <li>Mathias Markl &lt;<a class="reference external" href="mailto:mathias.markl&#64;mukit.at">mathias.markl&#64;mukit.at</a>&gt;</li> </ul> <a name="images"></a> <h3>Images</h3> <p>Some pictures are based on or inspired by the icon set of Font Awesome:</p> <ul class="simple"> <li><a class="reference external" href="https://fontawesome.com">Font Awesome</a></li> </ul> <a name="author-maintainer"></a> <h3>Author &amp; Maintainer</h3> <p>This module is maintained by the <a class="reference external" href="https://www.mukit.at/">MuK IT GmbH</a>.</p> <p>MuK IT is an Austrian company specialized in customizing and extending Odoo. We develop custom solutions for your individual needs to help you focus on your strength and expertise to grow your business.</p> <p>If you want to get in touch please contact us via mail (<a class="reference external" href="mailto:sale&#64;mukit.at">sale&#64;mukit.at</a>) or visit our website (<a class="reference external" href="https://mukit.at">https://mukit.at</a>).</p>