README

TESSA Connector for Akeneo 5.0

With this Connector Bundle you seamlessly connect Akeneo with the Digital Asset Management solution "TESSA" (https://www.tessa-dam.com). This provides you with a professional and fully integrated DAM solution for Akeneo to centrally store, manage and use all additional files for your products (e.g. images, videos, documents, etc.) in all channels.

More informationen is available at our website.

Requirements

IMPORTANT! Ensure, that your Akeneo API ist working. Tessa needs an API connection to your Akeneo. In some cases Apache is configured wrong, see https://api.akeneo.com/documentation/troubleshooting.html#apache-strip-the-authentication-header.

Installation

1. Install the bundle with composer

composer require eikona-media/akeneo5-0-tessa-connector

1. Then add the following lines at the end of your config/routes/routes.yml :

tessa_media:
    resource: "@EikonaTessaConnectorBundle/Resources/config/routing.yml"

1. Enable the bundle in the config/bundles.php file:

return [
    // ...
    Eikona\Tessa\ConnectorBundle\EikonaTessaConnectorBundle::class => ['all' => true],
];

1. EE Only: Enable the Enterprise bundle in the config/bundles.php file:

return [
    // ...
    Eikona\Tessa\EEConnectorBundle\EikonaTessaEEConnectorBundle::class => ['all' => true],
];

1. Run the following commands in your project root:

php bin/console cache:clear --env=prod --no-warmup
php bin/console cache:warmup --env=prod
php bin/console pim:installer:dump-require-paths --env=prod
php bin/console pim:installer:assets --env=prod
yarn run webpack
yarn run less
yarn run update-extensions

1. Update your database schema

php bin/console doctrine:schema:update --dump-sql # Show changes
php bin/console doctrine:schema:update --force # Update database schema

1. Configure the Tessa Connector in your Akeneo System Settings.

2. (Optionally) Create a cronjob to synchronize data with TESSA in the background

This is only necessary if you use the option "Sync in background" in the system settings

php bin/console eikona_media:tessa:notification_queue:execute --env=prod

Recommended to run every 5 minutes (*/5 * * * *). If the command is started twice at the same time, the second command exists with a notice.

How to use with reference entities

1. Add the following lines at the end of your config/routes/routes.yml :

tessa_api_reference_data:
  resource: "@EikonaTessaReferenceDataAttributeBundle/Resources/config/routing.yml"

1. Enable the ReferenceDataAttributeBundle in the config/bundles.php file:

return [
    // ...
    Eikona\Tessa\ConnectorBundle\EikonaTessaConnectorBundle::class => ['all' => true], // Already registered
    Eikona\Tessa\ReferenceDataAttributeBundle\EikonaTessaReferenceDataAttributeBundle::class => ['all' => true], // New
];

1. Select TESSA in the type dropdown when you add a new reference entity attribute