Basic Usage TYPO3 v14 

Translate Page with or without contents elements 

deepltranslate-core respects the new translation workflow and shares the same wizard provided by TYPO3 v14, which means that translating a page and optional directly the contents are started using the generic translation dropdown.

1. Generic translation dropdown to create translation

   

2. Select content elements to translate

   

3. Select Translate localization mode

   

   Note

   DeepL based translation is only available for Translate localization mode and will not be available if Copy localization mode is selected here.

4. Select Translate with DeepL localization handler

   

5. Review and confirm selected localization options

   

6. Localization is in progress

   

7. Localization completed successfully

   

Translate Content Elements 

Once the extension is installed and the API key provided, we are ready to start translating content elements. When translating a content element, there are four additional options besides the normal translate and copy.

• DeepL Translate (auto detect).
• DeepL Translate.

1. Start translate of missing records for language

   

2. Select source language

   

3. Select content elements to translate

   

4. Select Translate localization mode

   

5. Select Translate with DeepL localization handler

   

6. Review and confirm selected localization options

   

7. Localization is in progress

   

8. Localization completed successfully

   

Translate Record 

In list view, you are able to translate single elements by clicking the DeepL translate button for the language you want.

1. Start localization for a record with Localize to in the Records Module

   

Translate inline records 

Inline records are records edited inside another record, for example the items of a card group or an accordion. Their translation belongs to the translation of the record they are part of, so they are translated together with it.

When an inline record is added in the default language after the record it belongs to has already been translated, open the translated record. The new inline record is listed there as not yet localized, with a DeepL icon in its controls. Its tooltip says Translate with DeepL.

1. Click the DeepL icon Translate with DeepL in the controls of the inline record.

   

2. The localization wizard of TYPO3 opens for the inline record. Keep the mode Translate and click Next.

3. Manual Translation is preselected as handler. Select Translate with DeepL instead and click Next.

   

4. Check the summary and click Localize.
5. When the wizard reports Localization completed, click Finish. The edit form of the translated record opens again and shows the translated inline record. If the form has unsaved changes, TYPO3 asks whether to save or discard them first.

In TYPO3 v13 the icon asks for confirmation and translates the inline record directly, see Basic Usage TYPO3 v13.

The icon is only shown when

• the inline field shows records which are not translated yet, an integrator setting (ask your integrator if new inline records do not appear in the translated record),
• DeepL is configured for the language of the translated record, and you are allowed to translate with DeepL and to edit the inline records,
• the localize button of TYPO3 is shown for the inline record, and
• the inline record is stored with a reference to the record it belongs to, which is the usual configuration. Inline fields that store a list of records do not get the icon, and neither do files (images, media).