Lengoo Optimizely12 Connector

Overview

This solution contains OptimizelyConnector and TestSite projects. Test Site - runs the CMS Demonstration Template project from Optimizely. Connector - provides connection between Optimizely CMS and Lengoo Api services.

More details about Optimizely project you may find at: https://docs.developers.optimizely.com/content-management-system/docs/getting-started

Development environment

1. .NET 6.0
2. Visual studio 2022 / Visual studio code

Dependencies

• EpiServer.CMS
• Lengoo.net
• Lengoo.SDK

First Running

Before running the project, you have to check:

• TestSite was set as Startup project

• If the credentials was configured in TestSite project, appsettings.json file.

  Lengoo section provides next configs:

  1. environment (should have one of the values: Production or Sandbox)

  2. apiCredentials (should have credentials that was provide for Proffesional translations)

  3. apiMachineTranslationCredentials (should have credentials that was provide for Machine translations)

     "Lengoo": { "environment": "Sandbox", "apiCredentials": { "clientId": "%CLIENT_ID%", "token": "%CLIENT_SECRET%" }, "apiMachineTranslationCredentials": { "clientId": "%MT_CLIENT_ID%", "token": "%MT_CLIENT_SECRET%" } }

Project Features and Functionality

OptimizelyConnector provides functionality of 2 types of translations: Proffesional (human) and Machine translations for CMS project that are using Optimizely12.

To test how it works, you have to click on translate button on top of the page (1), and complete the translation request wizard (2).

After that your Translation job was created - you have to check if this job appears on Profesional (3) or Machine (4) Translations JobList. When the job will be tranlsated you will get an notification that status was changed (5).

In case that Import Translation results automatically checkbox was checked in translation request wizard (2) - translation result will be applied to selected languages.

In case that Translation Job status is not updated, please ensure that Lengoo Scheduled Jobs was configured in Admin panel.

Nuget Packaging

1. To release a new package version you have to use "Actions" tab on gitHub
2. In "Release Connector" menu - you have to run the workflow with new version of NugetPackage
3. After that package will be generated and uploaded - in approximatelly 10 minutes it will appears in Nuget Services