DeepL API Translation Plugin - Integration Guide &amp

Authentifizierung schützt jede Anfrage, während die setting Seite ermöglicht es Ihnen, einen einzelnen Token über languages and translations with the same policy. Verfolge die Quelle in Protokollen und make der Ressourcengleiche Pfad, um das Debugging zu vereinfachen und formatting checks.

In der Integrationsanleitung, konfigurieren Sie die Authentifizierung header, verify responses for Korrektur Notizen und Tests translations in einer Sandbox life cycle. Nachdem Sie die Genauigkeit bestätigt haben, verschärfen Sie die Zugriffsberechtigungen an jedem level und bieten Sie eine Option an delete nicht verwendete Schlüssel, um das System sauber zu halten.

Definieren Sie unterstützte languages und ordne sie dem DeepL-Format zu, wobei die formatting during translations. Verwenden Sie eine Ressource bundle, keep the page sauber, und die ursprüngliche Quelle Inhaltsstoffe für Qualitätsürprüfungen.

Workflow-Tipp: behalte ein dediziertes setting for delete von veralteten Einträgen; überwachen Sie die life Zyklus von Token und Verwendung Korrektur Anmerkungen zur Verbesserung der Ergebnisse über languages.

Wenn Sie versenden, dokumentieren Sie benutzerorientierte resources und sicherstellt, dass die Benutzeroberfläche auf allen languages. Das Plugin make es ist einfach, abzurufen, zu cachen und neu zu formatieren translations für ein reibungsloses Erlebnis auf jeder page.

DeepL API Translation Plugin: Integration Guide & Glossaries

Empfehlung: Speichern Sie Ihren API-Schlüssel sicher und aktivieren Sie die Authentifizierung beim ersten Start; konfigurieren Sie dann das Plugin in Ihrem Editor, um eine Standardsprache zu verwenden und sich in Ihren Content-Workflow einzuhaken.

Integrationsschritte helfen Ihnen, Übersetzungen mit Ihren bestehenden Prozessen abzustimmen und Verzögerungen zu vermeiden. Befolgen Sie eine klare Abfolge, um die Zeit, die für die Einrichtung aufgewendet wird, zu minimieren und die Qualität der übersetzten Seiten zu maximieren.

1. Authentifizieren Sie sich mit der deeplapi, indem Sie einen API-Schlüssel von Ihrem Konto generieren und Ihre Umgebung so konfigurieren, dass dieser sicher in Anfragen übergeben wird. Verifizieren Sie den Namen und den Umfang der Ressource, die Sie übersetzen möchten, um sicherzustellen, dass der Zugriff mit Ihren Diensten übereinstimmt.
2. Installieren Sie das Plugin in Ihrem Editor oder CMS, und bestätigen Sie anschließend, dass das Plugin in der Plugin-Liste erscheint. Öffnen Sie das Einstellungsfeld und wählen Sie eine Standardzielsprache aus, die Ihrer Zielgruppe entspricht.
3. Erstellen Sie ein Glossar, das die Terminologie über alle Übersetzungen hinweg regelt. Ein gut gestaltetes Glossar vermeidet Abweichungen zwischen übersetzten Begriffen und der ursprünglichen Formulierung und hilft Redakteuren, Konsistenz über Seiten und Auszüge hinweg zu gewährleisten.
4. Definieren Sie Nutzungsregeln, einschließlich Ratenbegrenzungen, maximale Zeichen pro Anfrage und Behandlung nicht übersetzbarer Inhalte. Legen Sie vernünftige Schwellenwerte fest, um Ausfälle während Spitzenzeiten zu verhindern.
5. Ordnen Sie Ihre Inhalt-Quellen als Ressourcen zu. Identifizieren Sie für bestehende Seiten die Spalten, die den Haupttext enthalten, und alle Auszüge, die übersetzt werden müssen; verwenden Sie eine einzelne Spalte oder ein Set von parallelen Feldern nach Bedarf.
6. Konfigurieren Sie Zielsprachen pro Projekt oder pro Seiten Gruppe. Wenn Sie in mehrere Märkte veröffentlichen, laden Sie mehrere Übersetzungssets und speichern Sie die übersetzte Ausgabe in den entsprechenden Ländereinstellungen.
7. Bereiten Sie den Inhalt für die Übersetzung vor, indem Sie Seiten öffnen und die Editoransicht auswählen. Stellen Sie sicher, dass Nicht-Text-Elemente (Bilder, Metadaten) ausgeschlossen oder als nicht übersetzbar markiert sind, um eine Überübersetzung zu vermeiden.
8. Führen Sie einen ersten Übersetzungslauf an einem Beispielauszug durch, um Ton und Stil zu kalibrieren. Vergleichen Sie die übersetzten Ergebnisse mit dem Originaltext, um Glossar Begriffe und Nutzungsregeln bei Bedarf anzupassen.
9. Fügen Sie Übersetzungen an den richtigen Stellen ein. Verwenden Sie die Optionen Ersetzen oder Anhängen des Plugins, um den ursprünglichen Inhalt intakt zu halten, während Sie übersetzten Text hinzufügen.
10. Umgang mit fehlenden Übersetzungen durch Fallback auf die Ausgangssprache, wenn eine Übersetzung nicht verfügbar ist. Einführung eines Workflows, um Lücken zur manuellen Überprüfung zu kennzeichnen oder sie für einen späteren automatisierten Durchgang in die Warteschlange zu stellen.
11. Nutzen Sie Caching für wiederholte Übersetzungen desselben Ressourcen, um Zeit und API-Nutzung zu reduzieren. Speichern Sie übersetzte Blöcke lokal und aktualisieren Sie diese nur, wenn sich der Quellinhalt ändert.
12. Überprüfen Sie im Editor ein zweites Mal, um sicherzustellen, dass Formatierung, Überschriften und Blöcke mit Ihrem Layout übereinstimmen. Bestätigen Sie, dass der übersetzte Inhalt die gleiche Bedeutung beibehält und in die Zielspaltenbreiten passt.
13. Dokumentieren Sie einen Beispiel-Workflow und halten Sie ihn in den Ressourcen Ihres Projekts bereit. Dies sorgt für eine Ausrichtung neuer Teammitglieder und beschleunigt die Einarbeitung für Redakteure und Übersetzer.

Glossare helfen, die Terminologie über Dienste und Plugins hinweg konsistent zu halten. Verwenden Sie ein zentrales Glossar als eine einzige Quelle der Wahrheit und beziehen Sie sich während jedes Übersetzungsprozesses darauf, um die Qualität sicherzustellen.

Glossary

• Glossar – eine kuratierte Liste von Begriffen mit bevorzugten Übersetzungen und Nutzungshinweisen.
• deeplapi – die API-Schnittstelle für Übersetzungen, Authentifizierung und Ressourcenanfragen.
• usage – rules for how translations are requested, batched, and cached.
• authentication – the process of proving identity to access the API, typically via an API key.
• name – identifier for a project, resource, or glossary entry.
• resource – any content item to translate, such as a page, post, or excerpt.
• plugins – modular extensions that add translation capabilities to editors or CMS systems.
• than – used to compare options or results (e.g., faster than manual edits).
• time – measurement of how long translation tasks take and how caching reduces it.
• target – the destination language for a translation job.
• editor – the text editor or CMS interface used to author and review content.
• appears – indicates where translated text shows up in the document.
• same – indicates identical or equivalent meaning across languages when glossaries align.
• need – identifies essential steps, such as authentication, glossary setup, and testing.
• insert – the action of placing translated text into the content structure.
• open – access to pages, excerpts, or resources to translate.
• pages – discrete content units such as articles or posts to be translated.
• existing – content already in your system that can be translated in batches.
• using – describes how the plugin operates within your workflow.
• temp – temporary translation drafts used for quick review before final publish.
• life – the ongoing lifecycle of a translation project from draft to publish.
• excerpt – a short extract of text used for testing or previews of translations.
• column – a data field that holds textual content in structured content models.
• services – translation-related features provided by the API and related plugins.
• translations – the output produced by the API for each source text segment.
• missing – translations or glossary terms that are not yet available and require attention.
• translate – the action to convert text from one language to another.
• example – concrete instances showing how to configure and run translation tasks.
• translated – text that has been converted into the target language and reviewed.

By following this guide, you align your workflow with reliable API usage, maintain a consistent voice via the glossary, and reduce time spent on manual corrections. The result is faster publishing cycles and clearer communication across languages. Use the same approach for new projects, and your team will see translated content that matches your brand’s tone and structure.

Install, Activate, and Connect Your DeepL API

Create a DeepL API key in your account, then paste it into the plugin's authentication field in the metabox. This gives immediate translations access and keeps resources synced. The title region shows a status icon to confirm the connection.

Open the plugin settings, navigate to the DeepL API section, and click Connect. The panel opens with a clear authentication status and a checkbox you can use to reuse the same key across environments, preserving a consistent life cycle for your translations.

First, run a quick test: translate a sample sentence via the deeplapi route and check the result. If the response is missing or the authentication fails, fixes are simple: re-enter the key, delete the old token, and save again. No import of files is required for testing.

Adding glossaries helps maintain terminology across projects. You can import glossaries or add terms directly in the glossary section, then map them to your target languages. When you add glossaries, you’ll see a glossary list with a source (источник) and notes; the formalité setting and the first niveau rating improve results over time. The icon next to the glossary tab lets you access deeplapi tools quickly.

If you need help, review the resources page for practical guidance. Use the metabox to manage authentication, and keep delete and add actions straightforward. For life with ongoing content, avoid unnecessary imports and rely on built-in glossaries and deeplapi features to stay productive, all without affecting other posts.

Add the Translate Button to the WordPress Edit Post Page

First, install the DeepL API Translation Plugin: Integration Guide &. Activate it in Plugins. The plugin name is DeepL API Translation Plugin. Open the WordPress admin, go to Plugins > Installed Plugins, and click Activate. In Authentication, paste your API key and set en_us as the default source language. Save changes, then open any post and view the Edit Post Page–the Translate Button opens a translation pane in the editor window to translate selected text or the current block.

Integrationsschritte

The button can open on the top toolbar of the editor and is available for classic and block editors. If you see an issue with authentication, re-check your API key and ensure the plugin version matches your WordPress version. Always check the authentication status after updates. In the pane, choose the target language, make a selection, and click Translate. Translating is immediate, and you can insert results back into the page with a single click. You have a free trial window to test translating on a sample page first, and you can check resources in the help center if you need more guidance.

Fine-tuning and tips

Use the formality control to select formal or informal tone. The selection supports multiple languages, so you can translate between en_us and other languages. The window layout stays responsive, and the pane remains accessible even on longer posts. If you update the plugin, review the changes to see new functions and any authentication changes. Always browse the docs to confirm how to customize the button name, and check the version to ensure compatibility with your editor. The feature helps teams work faster on translating pages, posts, and custom post types.

Create and Manage Glossaries for Consistent Translations

Create a centralized glossary in the deepl API Translation Plugin by loading terms from your memoq base and importing them to the server. In the metabox, tag each entry with its target language, pair it with the english source term, and add a short context. This setup ensures translations return the same result for identical source phrases and keeps a formal style across projects.

Use the pane on the right to review the selection of terms; open a term card to adjust the correction notes, add synonyms, and set the preferred translation. If a term is missing a variant, add an ajout to the glossary and update the entry.

Steps to build a glossary

Export your term base from memoq as CSV or XLIFF, then import it into the deepl plugin. In the metabox, map each entry to a target language and define a concise context to guide translators. Open the glossary panel, review each item, and mark corrections to align with your style guide. The server will store the glossary and return consistent translations for repeated phrases, reducing post-edit work and time spent on fixes.

After the import, run a quick check by translating a sample sentence and confirming that the term appears as expected. If you detect a missing term, add it to the glossary and re-import. This workflow keeps translations reliable and reduces the need for ad hoc corrections.

Best practices for glossary maintenance

Keep the english source up to date and attach usage notes in the metabox to guide translators. Schedule regular reviews, for example monthly, and use the selection pane to audit entries by language. Start with the free version to test the process, then scale the glossary as needed. Regular updates preserve consistency and help translations stay aligned with your terminology across projects.

Leverage deepl alongside memoq for iterative improvement; when corrections accumulate, the server returns the refined terms quickly and supports a cleaner life cycle for translations. Always verify results after updates and open the result pane to confirm the changes took effect.

Translate Directly from the WordPress Admin to Save Time

Enable the Translate metabox on the page editor, set the source language to english, and press the import button to pull translations directly into the page. The output appears inline so you can review and insert translated blocks without leaving the editor, saving minutes per post.

Glossare in einer dedizierten Einstellung verwalten, um die Terminologie über alle Übersetzungen hinweg zu sperren, und die Formalitätssteuerung verwenden, um die Markenstimme anzupassen. Dieser Ansatz wahrt die Qualität und beschleunigt gleichzeitig die Einführung Ihrer Website, wobei weiterhin klare, genaue Ergebnisse geliefert werden.

Öffnen Sie das Symbol im Metabox, um Abschnitte wie Überschriften, Listen und Bildunterschriften zu übersetzen, und klicken Sie dann auf Einfügen, um die übersetzten Inhalte dort zu platzieren, wo Sie sie benötigen. Sie können währenddessen zwischen Übersetzen und Bearbeiten wechseln und dabei die Kontrolle über jeden Absatz und jeden Satz behalten.

Für Teams und Entwickler übernimmt der Server die schwere Arbeit, während Sie die Übersicht über Änderungen direkt auf der Beitragseite behalten. Wenn Sie mehrsprachige Unterstützung benötigen, verwenden Sie ajout-Tags in Glossaren, um die Terminologie schnell zu erweitern, und exportieren oder führen Übersetzungen später erneut aus, ohne die Arbeit wiederholen zu müssen.

Step	Action	Notes
1	Öffnen Sie den Seiteneditor	Zeige das Metabox an, setze die Quelle auf Englisch, klicke auf die Import-Schaltfläche
2	Review output	Übersetzungen erscheinen inline; passen Sie Glossare und Formalität bei Bedarf an.
3	Füge übersetzte Blöcke ein	Verwenden Sie die Einfögen-Option, um übersetzten Inhalt in die Seite einzufügen
4	Feinabstimmen und speichern	Überprüfen Sie die Seitenansicht und nehmen Sie vor der Veröffentlichung Anpassungen vor.
5	Glossare aktualisieren	Die Hinzufügung neuer Begriffe gewährleistet Konsistenz über alle Übersetzungen hinweg

API-Nutzung in Echtzeit überwachen und Nutzungsbenachrichtigungen einrichten

Aktivieren Sie einen Echtzeit-Nutzungsmonitor und legen Sie abgestufte Warnmeldungen fest, um Ressourcen zu schützen und Teams zu informieren. Verfolgen Sie die Nutzung nach Fenster, Schlüssel und Plugin; ordnen Sie Aktivitäten einer Ebene zu und senden Sie Warnmeldungen, bevor das Limit erreicht ist. Verwenden Sie pro Endpunkt Dashboards, um Anomalien zu erkennen, und behalten Sie eine Standardansicht bei, die die aktuelle Nutzung, den Trend und fehlende Ereignisse anzeigt. Dadurch können Sie die benötigten Daten über mehrere Seiten hinweg einsehen, ohne manuelle Überprüfungen durchführen zu müssen. Es gibt eine Einstellung, um den Warnungstyp auszuwählen und abzubrechen, wenn sich die Bedingungen ändern, um sicherzustellen, dass die Warnung nur angezeigt wird, wenn eine echte Änderung vorliegt.

Komponenten für Echtzeitüberwachung

• Fensterbasierte Aggregation: wähle 1, 5 oder 15 Minuten; die Fenstergröße glättet Spitzen und ermöglicht rechtzeitige Warnungen.
• Aufschlüsselung pro Schlüssel und pro Endpunkt: Attributaufrufe des API-Schlüssels und des spezifischen Endpunkts oder Plugins; eine Ergänzung in der Benutzeroberfläche einfügen, um neue Quellen widerzuspiegeln.
• Plugin- und Gutenberg-Bewusstsein: Verfolgen Sie die Nutzung durch Plugins, einschließlich Gutenberg-Blöcke über die API, um die gleichen Muster über Komponenten hinweg zu erkennen.
• Metriken zur Anzeige: Nutzung, Anfragen, Latenz und Fehlerrate; Anzeige eines Titels für jede Metrik und Bezeichnung des Levels (niedrig/mittel/hoch).
• Fehlende Ereignisse und Heartbeat-Prüfungen: Erkennen von Lücken im Stream und Auslösen einer separaten Warnung, falls das Fenster fehlende Daten anzeigt (источник).
• UI-Hinweise: Farbkodierte Anzeigen und Trendpfeile einfügen; sicherstellen, dass die Standardansicht ohne übermäßige Formalität zugänglich ist; einfache Formulierungen verwenden.

Warnungen, Automatisierung und Aktionen

1. Definieren Sie Schwellenwerte: 80% für Warnung und 95% für kritisch; passen Sie diese an den Plan und die Ressourcen an und wenden Sie sie pro Schlüssel und Endpunkt an; verwenden Sie bei Bedarf Werte, die höher als die Basisquote sind.
2. Alertkanäle und -aktionen: E-Mail, Webhooks und Chat-Benachrichtigungen aktivieren; eine Stornierungsaktion für vorübergehende Spitzen und einen Reset einfügen, wenn die Nutzung sinkt; der Alerttitel sollte die betroffene Ressource klar widerspiegeln.
3. Automatisierte Antworten: Wenn ein kritischer Alarm ausgelöst wird, werden nicht unbedingt notwendige Plugins reduziert oder angehalten; es wird eine kurze Verzögerung eingefügt, um Laständerungen auszugleichen und die Servicequalität zu erhalten.
4. Beispiel: Für einen Plan mit 1.000.000 Anfragen/Monat, setzen Sie 800.000 (80%) als Warnung und 900.000 (90%) als kritisch; lösen Sie einen Webhook aus, um nicht-kritische Änderungen anzuhalten und ein Paar von Fakten an den Ops-Kanal zu senden; stellen Sie sicher, dass die Nachricht das Fenster und das Ressourcenpaar enthält.
5. Lokalisierung und Provenienz: Verwenden Sie in der französischen Benutzeroberfläche den Begriff „ajout“ für eine neue Ressource und zeigen Sie die Quelle (источник) der Daten neben jeder Warnung an, um den Ursprung zu verdeutlichen.

DeepL MT Plugin Einstellungen: Ausgabe anpassen und Zugriff auf erweiterte Optionen erhalten

Aktivieren Sie die Einstellung "Formaler Ausgabemodus" für en_us im MT-Plugin und richten Sie die Formatierungsspalte aus, um einen einheitlichen Ton über das gesamte Projekt sicherzustellen. Dieser einzelne Schritt sorgt dafür, dass Übersetzungen in jedem Editorfenster konsistent sind und bestehende Terminologie verwendet wird, wenn Sie Inhalte zu MemoQ-Projekten hinzufügen.

Stimmen Sie die Ausgabe mit drei Reglern ab: Typ, Formalität und Gebiete. Setzen Sie den Typ auf formal für rechtliche oder regulatorische Texte oder auf neutral für interne Notizen. Verwenden Sie niveau als Referenzpegel, streben Sie nach sehr klaren Sätzen und wählen Sie eine Gebietskarten, die die Lesbarkeit über en_us und andere Gebiete hinweg gut hält, wobei die Konsistenz verbessert wird. Dies verbessert die Konsistenz und liefert vorhersehbarere Ergebnisse als lose Anpassungen.

Sie können das Metabox im Editor öffnen, um auf erweiterte Optionen zuzugreifen, ohne Ihre Arbeitsfläche zu verlassen. Verwenden Sie den Auswahlabereich, um ein Segment auszuwählen, und sehen Sie dann sehr schnell in dem Fenster temporäre Variationen, bevor Sie zur Bearbeitung zurückkehren. Wenn Sie die Auswahl rückgängig machen müssen, drücken Sie Abbrechen, um zur vorherigen Einstellung zurückzukehren.

In diesem Workflow hilft das Hinzufügen einer kleinen Beispieldatei, die Ausgabe mit vorhandenen Übersetzungen zu vergleichen und bei Unterschieden zum Original zurückzukehren. Verwenden Sie dieselbe Metabox, um mehrere Varianten anzuwenden und diese als Voreinstellungen für zukünftige Jobs zu speichern.

Für Teams, die memoq verwenden, synchronisieren Sie Styleguides, indem Sie dieselben Formatierungsregeln aktivieren und ein gemeinsames Spaltenlayout in den DeepL-Ergebnissen verwenden. Der Reiter "Erweitert" ermöglicht es Ihnen, eine spezifische Einstellung zu erstellen, die eine konsistente Tonart über verschiedene Regionen, Lebenskontexte und Editor-Workflows hinweg gewährleistet. Verwenden Sie eine benutzerdefinierte memoq-Notiz im Metabox, um zu erklären, warum eine bestimmte Anpassung vorgenommen wurde und wie sie die Ausgabe konsistenter macht.