Hybris Connector

Translating with Hybris

The Hybris Connector extension integrates Smartling translation into your Hybris workflow via Smartling API. You will control the setup for your source and localized sites through Hybris, but send your source content to Smartling for translation. Smartling translations are then downloaded back to Hybris to populate your localized sites.

Before Installing

Before using the Connector, you will need to:

  1. Set up your localized sites in Hybris, including setting which page and product attributes are translated.
  2. Create a CMS Connector-type Smartling project with the same locales as your Hybris sites.
  3. Get your Project ID and API Key from the Smartling Dashboard at Project Settings > API.
  4. Download the Hybris Connector zip file from the Connectors page in the Smartling dashboard.

Install the Connector

  1. Download the Hybris Connector package from the Connectors page in the Smartling Dashboard.

  2. Extract the zip file into [your hybris folder]/hybris/custom

  3. Add this extension element to the localextensions.xml file in [your hybris folder]/hybris/config:

    <!-- Smartling extensions -->
    <extension name="smartling" />

  4. The Hybris Connector extension is an additional extension for the Product and CMS Cockpits. By default it works with the cockpit accelerator extensions called yacceleratorcockpits. If you have renamed your Accelerator-based Cockpit(s) you will need to add the following entry to your project.properties ([your hybris folder]/hybris/bin/platform/project.properties)or local.properties ([your hybris folder]/hybris/config/local.properties) file for each cockpit:


  5. Build the extension and start the Hybris server:
    • From the command line, navigate to [your hybris folder]/bin/platform
    • Run setantenv.sh
    • Run ant clean all
    • Run hybrisserver.sh

  6. From your browser, go to http://[your.server.host]:[server.port]/platform/update and select the following options:
    • smartlingcockpit
    • smartling

  7. Click Update.

Configure the Hybris Connector

  1. Open the Hybris Management Console.

  2. Go to Smartling > Configuration, and click Search. The search will return only one profile, named, default.

  3. Edit the default profile:
    • Set your Project ID and API Key.
    • Give the corresponding Smartling locale code for each Hybris locale (can be found at Project Settings > API.)
    • Set your Static Data URL.
    • Set a Retrieval Type:
      • Published - Only published translations will be pushed to Hybris
      • Pending - Translations at any workflow step will be pushed to Hybris
      • Pseudo - Untranslated items will be pushed to Hybris as Pseudo translations - the original strings with extra characters added.
    • Set Auto-authorize content. If ticked, any content sent to Smartling will be automatically approved for translation and sent to the default workflow for each locale.

  4. Set up Users: The ability to manage Smartling translations can be granted to select users. To give a user the ability to send content to Smartling and download translations:
    • Open the Hybris Management Console.
    • From User > Employees, search for and select a user you want to manage translations.
    • Add the user to the group: smartlingTranslationManager.

Was this article helpful?