Migration

Once a new major of Trifid is released, the process to migrate from the previous major version will be documented here.

Migrate from 3.x to 4.x

The v4 version of Trifid is a simple breaking change with the name of the entity renderer plugin.

If you are using a custom configuration file, you will need to update the name of the entity renderer plugin.

Use @zazuko/trifid-entity-renderer instead of @zazuko/trifid-renderer-entity.

You will need to do the change in your configuration file:

 middlewares:
   # …

   entity-renderer:
-    module: "@zazuko/trifid-renderer-entity"
+    module: "@zazuko/trifid-entity-renderer"

Migrate from older versions

We do not cover the migration process from older versions, as the changes are too big and the process is not straightforward.

We recommand instead to start from scratch.

Trifid version 3 came with those major changes:

• The configuration file format has changed ; it is a lot easier to understand and to use, and supports YAML also.
• The plugin system has been reworked to be more flexible and easier to use.
• Each middleware should return an Express middleware.
• A real template engine is now available (which uses Handlebars) ; previously it was just a simple string replacement, which lead to a lot of limitations, big issues and it was hard to debug them. Code editors were not able to provide proper syntax highlighting and error checking.