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

Beispiele für Übersetzungen

Englischer Beispiel-Satz: "Our new app is designed to simplify your daily tasks, and I’m confident it will make your work faster and more enjoyable."

Formality	Model-Type	Writing style	Ausgabe Deutsch
Default	Default	Default	Unsere neue App wurde entwickelt, um Ihre täglichen Aufgaben zu vereinfachen, und ich bin sicher, dass sie Ihre Arbeit schneller und angenehmer machen wird.
Less	Latency optimized	Casual	Unsere neue App wurde entwickelt, um deine täglichen Aufgaben zu vereinfachen, und ich bin sicher, dass sie deine Arbeit schneller und angenehmer machen wird.
Prefer less	Quality optimized	Academic	Unsere neue App soll dir die täglichen Aufgaben erleichtern, und ich bin mir sicher, dass sie deine Arbeit schneller und angenehmer machen wird.
Prefer less	Prefer quality optimized	Prefer business	Unsere neue App wurde entwickelt, um Ihre täglichen Aufgaben zu vereinfachen, und ich bin überzeugt, dass sie Ihre Arbeit beschleunigen und angenehmer gestalten wird.
More	Quality optimized	Prefer simple	Unsere neue App wurde entwickelt, um Ihre täglichen Aufgaben zu vereinfachen, und ich bin überzeugt, dass sie Ihre Arbeit beschleunigen und angenehmer gestalten wird.

Englischer Beispiel-Satz: "Even though our latest gadget has a few quirks, I believe it could completely transform the way you handle your daily routine."

Formality	Model-Type	Writing style	Ausgabe Deutsch
Default	Default	Default	Auch wenn unser neuestes Gerät ein paar Macken hat, glaube ich, dass es die Art und Weise, wie Sie Ihre tägliche Routine bewältigen, völlig verändern kann.
More	Quality optimized	Academic	Obwohl unser neuestes Gerät einige Eigenheiten aufweist, bin ich überzeugt, dass es die Art und Weise, wie Sie Ihre täglichen Aufgaben bewältigen, grundlegend verändern könnte.
Prefer less	Latency optimized	Simple	Auch wenn unser neuestes Gadget ein paar Macken hat, glaube ich, dass es die Art und Weise, wie du deinen Alltag bewältigst, völlig verändern kann.
Default	Prefer quality optimized	Business	Auch wenn unser neuestes Gerät ein paar Macken hat, glaube ich, dass es die Art und Weise, wie Sie Ihren Alltag bewältigen, völlig verändern könnte.
More	Default	Simple	Auch wenn unser neuestes Gadget ein paar Macken hat, glaube ich, dass es die Art und Weise, wie Sie Ihren Alltag bewältigen, völlig verändern könnte.