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
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.