Skip to main content

ODT/ODS templating transforms for Plone

Project description

redomino.appytransforms

It registers a new portal transforms that let you dynamically generate odt or ods files for a given template.

This product is based on http://appyframework.org/pod.html

Since it aims to generate native LibreOffice/OpenOffice formats, it is not necessary running libre office in server mode.

This plugin is meant for developers, it could be used for generating dynamic odt/ods files, write a custom PloneFormGen adapter, etc.

Usage

Example:

>>> from zope.component import getUtility
>>> from Products.PortalTransforms.interfaces import IPortalTransformsTool
>>> file_contents = open('your odt file with variables').read()     # see redomino/appytransforms/tests/input.odt
>>> portal_transforms = getUtility(IPortalTransformsTool)
>>> converter = portal_transforms.convertTo(target_mimetype='application/vnd.oasis.opendocument.text.transformed',
>>>                                        orig=file_contents,
>>>                                        mimetype='application/vnd.oasis.opendocument.text',
>>>                                        mapper=dict(plone_version='4.3.2-sunny-day-beta'),
>>>                                       )
>>> transformed_odt_contents = converter.getData()

appy.pod’s tips and limitations

Tips and appy.pod’s limitations.

Odt files:

  • use the “Edit” -> “Changes” -> “Record” in order to display vars

  • conditional text fields seems to be not supported (as far as I can see), use comments with do text if expr instead

  • libreoffice does not support comments on single words (see http://ask.libreoffice.org/en/question/5256/comments-in-writer/), so it seems that you’ll have to the only way to

  • repeating list items, it does not works as expected

Ods files:

  • don’t use the “Edit” -> “Changes” -> “Record” on ods files!

  • repeat rows adding a comment on the first cell with “do row for person in persons” and put dynamic content putting into the cell value =”person[‘age’]”

  • if you want to pass a single variable and displaying it into a single cell use the followind syntax into the cell value =”variable_name” (not as a comment)

appy’s documentation is awful: if you are in trouble trying to get working ODT/ODS templates check out the tests doc https://github.com/redomino/redomino.appytransforms/tree/master/redomino/appytransforms/tests

Tests

Test status:

https://secure.travis-ci.org/redomino/redomino.appytransforms.png

How to launch tests:

$ ./bin/test -m redomino.appytransforms

Authors

Changelog

0.1 (2014-02-24)

  • First release [davidemoro]

Project details


Release history Release notifications | RSS feed

This version

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

redomino.appytransforms-0.1.zip (70.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page