wLanguages::translateCorrespondantDocumentsToTranslateWithDeepL
Übernimmt die Struktur in die korrespondierenden Sprachdateien und übersetzt die Texte automatisch mit DeepL (falls Weblication Modul und DeepL-Api lizenziert sind)
(ab CMS-Version 014.006.000.000) - deepL-Schnittstelle in Weblication Lizenz erforderlich!
Funktionsaufruf
String translateCorrespondantDocumentsToTranslateWithDeepL(String path, Array options)
Parameter
- path
- Pfad der aktuellen Datei
- options
- Optionen
- translateIf [referenceChanged|referenceChangedAndCurrentNotChanged|never]
- Definiert, in welchem Fall bereits bestehende Texte erneut übersetzt werden sollen.
- projectsOnly [Array]
- Falls nur bestimmte Projekte übersetzt werden sollen
- release [true|false]
- Definiert, ob die übersetzte Datei gleich veröffentlicht werden soll
- addStatusToTranslateIfNotExistsBefore [|true]
- Falls ein Element noch nicht existiert, wird der Status "Zu Übersetzen" (toBeTranslated) ergänzt
- elementTypesToMarkToBeTranslatedIfNotExistsBefore
- Elementtypen (kommagetrennt), die zum Übersetzen markiert werden sollen, wenn diese Elemente zuvor nicht in der Seite waren, z.B. headline.text,text.wysiwyg
- elementTypesToSetOfflineIfNotExistsBefore
- Elementtypen (kommagetrennt), die offline gesetzt werden sollen, wenn diese Elemente zuvor nicht in der Seite waren, z.B. headline.text,text.wysiwyg
- adaptPathProject [true|false]
- Definiert, ob die Projektpfade angepasst werden sollen
- sourceLang
- Ursprungssprache
- glossary_id
- Glossary ID
- deeplKey
- Lizenzschlüssel
Beispiel: Übernimmt die Struktur in die korrespondierenden Sprachdateien ... (über ein Projekt- bzw. Verzeichnisereignis)
Quelltext
<?php
//Übernimmt die Struktur in die korrespondierenden Sprachdateien und übersetzt die Texte automatisch mit DeepL (falls Weblication Modul und DeepL-Api lizenziert sind)
if(wLanguages::isTranslatable($eventData['filePath'])){
$options = array();
$options['deeplKey'] = wVariables::getValue('deepl_key', wProject::getPathGlobal($eventData['projectPath']));
$options['translateIf'] = 'referenceChanged'; // [referenceChanged|referenceChangedAndCurrentNotChanged] Der Text wird neu übersetzt, wenn er sich in der Ursprungsdatei ändert oder nur wenn er sich in der Ursprungsdatei ändert und in der aktuellen Sprachdatei nicht geändert hat.
$options['release'] = true; // Falls die Datei auch gleich veröffentlicht werden soll.
$options['adaptPathProject'] = true; // Falls der Projektpfad angepasst werden soll (ab CMS-Version 016.003.099.000)
wLanguages::translateCorrespondantDocumentsToTranslateWithDeepL($eventData['filePath'], $options);
}
?>
Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.