redturtle.importer.volto 1.0.0

Features

There is a new adapter for redturtle.importer.base for content-types with volto.blocks enabled behavior that converts rich text from html (TinyMce) to json (DraftJs/blocks).

HTML to DraftJs converter

For content-types with blocks enabled, we need to convert old-style HTML text to a DraftJs compatible data structure.

The best library to do this, is the officiale one that is only available for Javascript.

For that reason, to convert HTML we need to connect to an external tool: https://github.com/RedTurtle/draftjs-converter

This is a nodejs rest api that accept some html and returns its DraftJs converted version.

To use this api, we need to set an environment variable with its address in our buildout:

environment-vars +=
    ...
    DRAFTJS_CONVERTER_URL http://localhost:3000/html_converter

Blocks conversions

Every piece of a RichText value should be converted into a Volto block element.

Some pieces can be converted into a specific block (for example tables, images, embed items). Other standard html elements are converted into a text block that contains a DraftJs data structure.

We made some assumption when converting text into blocks.

Types conversion

If a content-type have volto.blocks behavior enabled and a text field, that field will be converted in blocks.

Collection content-types will be converted into a Document with a listing block with its criteria filters.

Folders with a default view will be converted into a Document content-type with these rules for its blocks:

• If default view is a Collection content-type, we create a listing block with its criteria filters.

• If default view is a Document or News Item, we convert its text into blocks.

• If the folder doesn’t have a default item as view, we create a listing block that shows first level contents.

Installation

Install redturtle.importer.volto by adding it to your buildout:

[buildout]

...

eggs =
    redturtle.importer.volto

and then running bin/buildout

You don’t have to install it. In this way, after the data migration, you can remove it from the buildout and everything is clean.

Credits

This product has been developed with some help from

Contributors

• RedTurtle Technology, sviluppoplone@redturtle.it

Changelog

1.0.0 (2020-12-18)

• Initial release. [cekk]