# Lionbridge connector

This connector integrates the translation service of the agency, which consumes the translation files directly. Files are automatically sent and imported into Sitefinity CMS.

To setup this connector, you need to have a Lionbridge account. When you create the account, the agency will provide you with the required parameters.

To configure the connector, perform the following:

1. From [NuGet.org repository](https://www.nuget.org/), download and install the `Telerik.Sitefinity.Translations.Lionbridge` NuGet package.
2. Build your project.
3. Click *Administration* » *Settings* » *Advanced* » *Translations* » *Connectors*.
4. Click *Create new*.
5. In *Name*, enter `Lionbridge`.
6. In *Title*, enter `Export to Lionbridge`.\
   This is the title that appears in the UI, you can enter any title that is convenient for you.
7. In *ConnectorType*, enter `Telerik.Sitefinity.Translations.Lionbridge.LionbridgeTranslationConnector`.
8. In *Supported languages*, enter the languages that you want the connector to work with and for which you have an account.\
   For example, if you enter `en-us -> fr-fr; en-us -> es-es`, it means you have account for translation service for US English to French and Spanish.
9. Select *Strip HTML tags*, if you want to remove all HTML tags and send for translation text only.

   > success **EXAMPLE**: If you have the following paragraph that you want to send for translation:\
   > `<p>This is just a test paragraph with a <a href="#">link</a>,`\
   > `a <strong>strong</strong> tag and nothing else.</p>`
   >
   > * If you have the checkbox selected, which is the default behavior, the following will be sent:
   >   ```XML
   >   <source>
   >        <g id="g001">
   >          <mrk mtype="x-html">This is just a test paragraph with a </mrk>
   >          <mrk mtype="x-html">link</mrk>
   >          <mrk mtype="x-html">, a </mrk>
   >          <mrk mtype="x-html">strong</mrk>
   >          <mrk mtype="x-html"> tag and nothing else.</mrk>
   >        </g>
   >   </source>
   >   ```
   > * If you have the checkbox deselected, the following will be sent:
   >   ```XML
   >   <source>
   >        <g id="g001">
   >          <mrk mtype="x-html">&lt;p&gt;This is just a test paragraph with a &lt;a href="#"&gt;link&lt;/a&gt;, a &lt;strong&gt;strong&lt;/strong&gt; tag and nothing else.&lt;/p&gt;</mrk>
   >        </g>
   >   </source>
   >   ```
10. Save your changes.\
    The connector appears under *Connectors*.
11. Click *Parameters* and create the parameters with the following keys, the values for which will be provided by the translation agency:
    * `ClientId`
    * `ClientSecret`
    * `ProviderId`
12. Click *Parameters* and create a new parameter with *Key* `acknowledgeEveryMessage` and *Value* `false`\
    The default value of this parameter is `true`. It means that different users, who work with different translation projects with the same connector credentials, can have access to each other's projects and potentially cause conflicts.\
    For example, one user can approve the translation of another user in a different project.

    If this use case is applicable to your scenario, you should create this parameter, set its value to `false`, and save your changes.
13. Save your changes.