Configuration

From the Magento Admin Panel, choose System -> Configuration and find Contentor API in the left hand menu. The settings are divided into three segments.

Config options

The first configuration page consists of 5 parts described below and you only have to configure this once so take your time to get things going.

API Token

The API token is a required value that is used to authenticate and identify the company sending content requests via the extension. There are two types of tokens, one for testing the integration and one for production use.

The testing token should be used when setting up the extension as it will allow you to send content requests without generating real orders. When using the test token content requests will be fulfilled within a minute using test data, which is identified by field values starting with TEST.

The production token be used when setup and configuration is complete and you want to start sending real orders.

For more information about tokens see the article about authentication tokens.

API Automation Settings

Import status controls if the extension should change product status to enabled when the content request is fulfilled via the API, if this options is set to disable the product status will not change.

Autoexport will automatically send content for localization if the product has the attribute contentor_localize_me set to true. This can be used to control localization from a third-party system such as a PIM backend.

Generate url key controls if the extension should generate a new url key if the product name is localized.

API Source Language

Source language used for content requests being sent. The value picked here is used as a default value and can be changed when sending content. The source language should indicate the language that the content being sent for localization is written in. The article about content requests contains more details about how language is used by Contentor.

API Target Store Views

The Target store views are the store views that sent content requests are fulfilled for. You should choose one or more store views here and the extension will send one request per target with the locale setting for the store view as the target language. When received, the text will also be saved on the store view level for the product, category or CMS Page.

API Included Fields

This is where you build the request and choose what information Contentor has at hand when working with your content. Here you should include all fields that should be localized but also fields that provide context about the product, category or CMS Page.

If your products or categories are published in some store and available online, it is recommended to provide an URL to the page as a context field. Doing so allows Contentor to access the page, seeing the entire context and product image while working on your localization.

For a localizable field the only kind of attributes that can be sent are text and textarea fields. For products the Image gallery type is also supported and will send all image labels for the images.

Products

Categories

CMS Pages

Context and hints

You can choose an attribute to be attached as context, like a product or category url. But sometimes it can really help to be able to send additional context. Perhaps specific for the items sent right now.

In the settings you can enter default texts added to products, categories and CMS pages. This default value is carried over when sending content but can be changed before sending.

Versioning options

If something has been sent for localization and later the original source is updated, the extension can try to send an update request instead of a full content request.

Use the global activation setting to activate versioning in the extension. Then choose sections where to use versioning when previous content is sent.