Konfiguration

Übersicht

Das Bundle kann in der Twocream Bundle Übersicht konfiguriert werden. Diese ist über eine neue Schaltfläche mit Twocream-Logo in der Pimcore-Seitenleiste erreichbar, dort kann dann das Bundle ausgewählt werden um dessen Konfiguration zu öffnen.

Konfiguration	Beschreibung
API-Key (apiKey)	Der DeepL API (Pro) API Key WICHTIG: Ist nicht mit einem DeepL Pro Account möglich!
Deepl-Languages (languages)	Alle Pimcore Sprachen, die mit DeepL kompatibel sind und im DeepL Kontext zur Verfügung stehen sollen
Maximum retries for HTTP fails (max_retries)	Die Anzahl, wie oft versucht werden soll, eine Übersetzung an der DeepL API anzufragen bevor abgebrochen wird Default: 5
Connection Timeout (in s) (timeout)	Anzahl der Sekunden, wie lange ein Aufruf an die API dauern darf Default: 10
API-URL (autodetect by API-Key) (server_url)	Wird durch den API-Key automatisch ermittelt. Kann jedoch bei Bedarf hier überschrieben werden.
Proxy URL (optional) (proxy)	Wird benötigt, wenn DeepL über einen Proxy angesprochen wird (optinal)
Split Sentences (split_sentences)	Gibt an, wie der Input-Text in Sätze aufgeteilt werden soll. - ON: Text werden bei Bedarf in Sätze aufgeteilt. - OFF: Texte werden bei nicht in Sätze aufgeteilt. - NO NEW LINES: Texte werden in Sätze aufgeteilt und nur durch Interpunktion getrennt, nicht durch Umbrüche. Default: ON
Preserve Formatting (preserve_formatting)	Stellt ein, ob die Formatierung behalten werden oder diese automatisch korrigiert werden soll. Default: NO
Formality (formality)	Gibt die Formalität an, mit der übersetzt werden soll. Optionen: - Less: Informelle Sprache - More: Formelle, politisch angemessene Sprache - Default: Normale Sprache - Prefer Less: Informell nutzen, wenn verfügbar - Prefer More: Formell nutzen, wenn verfügbar Default: Default
Model-Type (model_type)	Gibt an, ob beim Übersetzen der Fokus auf Geschwindigkeit oder Qualität liegen soll. Optionen: - Quality optimized: Qualitativ hochwertige Übersetzungen (Längere Dauer) - Prefer quality optimized: Qualitativ hochwertige Übersetzungen (Längere Dauer; Fallback auf Standard, wenn für Sprache nicht vorhanden) - Latency optimized: Schnelle Übersetzung, nicht besonders Qualitativ (Übersetzung nicht genau) - Default: Standardmäßig wird das "Latency optimized" Modell genutzt Default: Default
Writing style (writing_style)	Gibt den Schreibstil für übersetzte Texte an. Optionen: - Default: Neutraler, natürlicher Schreibstil ohne besondere Präferenz - Academic: Formeller, wissenschaftlicher Schreibstil - Business: Professioneller, geschäftlicher Schreibstil - Casual: Umgangssprachlicher, freundlicher Schreibstil - Simple: Einfacher Schreibstil mit kurzen Sätzen und leicht verständlichen Wörtern - Prefer academic: Formeller, wissenschaftlicher Schreibstil (Fallback auf Standard, wenn für Sprache nicht vorhanden) - Prefer business: Professioneller, geschäftlicher Schreibstil (Fallback auf Standard, wenn für Sprache nicht vorhanden) - Prefer casual: Umgangssprachlicher, freundlicher Schreibstil (Fallback auf Standard, wenn für Sprache nicht vorhanden) - Prefer simple: Einfacher Schreibstil mit kurzen Sätzen und leicht verständlichen Wörtern (Fallback auf Standard, wenn für Sprache nicht vorhanden) Default: Default
Cache TTL (s) (translation_cache_ttl)	Gibt die Cache Zeit an, in Sekunden
Show Backend Menu (showBackendMenu)	Zeigt das DeepL Bundle Menu im Pimcore Backend Seitenmenü an.
Translation threshold (%) (thresholdLimitInPercentage)	Der prozentuale Wert ab dem Nutzer / Rollen darüber informiert werden, dass das Limit für die Übersetzung zu X-Prozent erreicht ist.
Threshold informed users (thresholdLimitUsers)	Nutzer, welche bei dem Überschreiten des "Translation threshold (%)" informiert werden. Die Benachrichtigung erfolgt mittels Pimcore Notifications.
Threshold informed roles (thresholdLimitRoles)	Gruppen, welche bei dem Überschreiten des "Translation threshold (%)" informiert werden. Die Benachrichtigung erfolgt mittels Pimcore Notifications. ACHTUNG: Ist ein ausgewählter Nutzer ebenfalls in einer Gruppe, erhält er die Nachricht zwei mal! Es empfiehlt sich Nutzer oder Rollen für die Benachrichtigung auszuwählen.
Context - <Sprache> (context)	Für jede konfigurierte Sprache kann ein Kontext mitgegeben werden, der bei der Übersetzung berücksichtigt werden soll.

Requirements Check

Beispiel	Check	Beschreibung
	DeepL Bundle API URLs	Ermöglicht einen Testabruf der Glossare
	DeepL API Usage