Contact Form 7 in WordPress übersetzen - Formular-Tags, Nachrichten, E-Mail-Vorlagen

Vor dem Start

Installieren und aktivieren Sie diese Plugins:

Contact Form 7.
WPML und WPML String-Übersetzung.
WPML Multilingual for CF7 (das Add-on, das diese Seite behandelt).

Erstellen Sie das Formular in Contact Form 7 in der Ausgangssprache Ihrer Website (jeden Form-Tag, die Vorlagen „E-Mail“ und „E-Mail (2)“, jeden Eintrag auf der Registerkarte „Meldungen“ und alle „Zusätzlichen Einstellungen“), bevor Sie das Formular zur Übersetzung senden. Sie können das Formular später bearbeiten und erneut zur Übersetzung senden, falls sich etwas ändert.

Alles automatisch übersetzen übernimmt das für Sie

Wenn auf Ihrer Website Alles automatisch übersetzen aktiviert ist, müssen Sie das Formular nicht manuell zur Übersetzung senden. WPML erfasst neue und aktualisierte Formulare zusammen mit Ihren restlichen Inhalten und übersetzt sie im Hintergrund. Der unten stehende Schritt zum Einfügen in die Seite gilt weiterhin, aber der Schritt Formular zur Übersetzung senden erfolgt automatisch. Der Rest dieser Seite beschreibt den manuellen Weg für Websites mit Einiges übersetzen: Sie wählen, was übersetzt wird (oder für Formulare, die Sie vor der automatischen Warteschlange übersetzen möchten).

Das Formular zur Übersetzung senden

Öffnen Sie WPML > Übersetzungen > Dashboard.
Klappen Sie den Abschnitt Kontaktformulare auf.
Markieren Sie das Formular, das Sie übersetzen möchten.
Wählen Sie eine Übersetzungsmethode: PTC (empfohlen), Ihren Übersetzer oder Selbst übersetzen.
Klicken Sie auf Übersetzen.

Die Formularvorlage, E-Mail und E-Mail (2) sowie die Registerkarte „Meldungen“ werden alle in denselben Übersetzungsauftrag aufgenommen. Übersetzer sehen sie als beschriftete Zeilen im erweiterten Übersetzungs-Editor.

Das Formular in Ihre übersetzten Seiten einfügen

In eine Seite oder einen Beitrag wird Contact Form 7 über den Shortcode [contact-form-7] eingebunden, den der Admin-Bildschirm Kontakt normalerweise als [contact-form-7 id="123" title="My Form"] erzeugt. Die Regel für das mehrsprachige Einfügen:

Verwenden Sie denselben Shortcode auf jeder Sprachversion der Seite. Erstellen Sie nicht für jede Sprache ein separates Formular.

Der Ablauf:

Erstellen Sie das Formular einmal in Ihrer Ausgangssprache.
Senden Sie das Formular zur Übersetzung (oder lassen Sie es von Alles automatisch übersetzen erfassen).
Fügen Sie den Shortcode auf der Seite in der Ausgangssprache ein.
Übersetzen Sie die Seite über WPML > Übersetzungen > Dashboard auf dieselbe Weise, wie Sie jede andere Seite übersetzen würden. Der Shortcode bleibt auf der übersetzten Seite erhalten.
Wenn ein Besucher die übersetzte Seite öffnet, stellt WPML Multilingual for CF7 das Formular automatisch in der Sprache des Besuchers bereit – derselbe Shortcode, übersetzter Inhalt.

Sie benötigen keine unterschiedliche Formular-ID pro Sprache. Die Übersetzung ist mit dem Ausgangsformular verknüpft; das Glue-Plugin löst beim Rendern basierend auf der Sprache der Seite die Version in der richtigen Sprache auf.

Sowohl ID-basierte als auch titelbasierte Shortcodes funktionieren. [contact-form-7 id="123" title="Contact form 1"] funktioniert ohne zusätzliche Konfiguration mehrsprachig. [contact-form-7 title="Contact form 1"] (nur Titel, keine ID) wird ebenfalls in der richtigen Sprache aufgelöst. Die Auflösung nur nach Titel wurde in Version 1.1.0 (Juni 2021) eingeführt. Beide Formen sind sicher.

Die Ausnahme – wenn Sie wirklich unterschiedliche Formulare pro Sprache wünschen. Wenn Sie strukturell unterschiedliche Formulare pro Sprache benötigen (unterschiedliche Form-Tags, unterschiedliche E-Mail-Vorlagen, unterschiedliche Inhalte auf der Registerkarte „Meldungen“), erstellen Sie separate Formulare in Contact Form 7 und fügen Sie den jeweiligen Shortcode in die entsprechende Sprachversion der Seite ein, indem Sie den WordPress-Editor für diese Übersetzung verwenden. Das ist die einzige Situation, in der Shortcodes zwischen den Sprachen abweichen.

Page-Builder-Falle

Wenn Ihre Seite mit Divi, Elementor oder einem anderen Page-Builder erstellt wurde, dessen Textmodul den Shortcode umschließt, übersteht der Shortcode die Übersetzung möglicherweise nicht immer sauber. Wenn die übersetzte Seite das Formular in der Ausgangssprache anzeigt, öffnen Sie die übersetzte Seite im Page-Builder und fügen Sie den Shortcode [contact-form-7] dort erneut ein. Der native WordPress-Block-Editor und der klassische Editor haben dieses Problem nicht.

Form-Tag-Beschriftungen und für Besucher sichtbare Strings

Die für Besucher sichtbaren Inhalte jedes Form-Tags werden übersetzt: Beschriftungen (der Text außerhalb des in Klammern stehenden Tags), Schaltflächenbeschriftungen (der Wert in [submit "Send"]), Platzhalter, die über die Option placeholder festgelegt wurden, und die Optionswerte innerhalb der Tags [checkbox], [radio] und [select].

Der Typ und der Name des Form-Tags werden nicht übersetzt. Sie sind Bezeichner. Die Werte des Form-Tags (die für den Besucher sichtbaren Auswahlmöglichkeiten) werden übersetzt. Beispiel:

[select your-country "China" "India" "San Marino"]

In der französischen Übersetzung wird "China" zu "Chine", während your-country (der Name des Form-Tags) und select (der Typ) identisch bleiben. Die Ersetzung von Mail-Tags funktioniert weiterhin, da die Übersetzung die Position jedes Wertes beibehält.

Durch senkrechte Striche getrennte Werte – Beschriftung übersetzen, Wert stabil halten

Die Pipe-Syntax (senkrechter Strich) ermöglicht es Ihnen, die für den Besucher sichtbare Beschriftung vom Wert zu entkoppeln, der in der E-Mail gesendet wird:

[select your-country
  "Chinese|CN"
  "Indian|IN"
  "Sammarinese|SM"]

Wenn Sie dieses Formular übersetzen, werden nur die Beschriftungen (Chinese, Indian, Sammarinese) übersetzt. Die Werte (CN, IN, SM) bleiben kanonisch. Ein französischer Besucher sieht Chinois, Indien, Saint-Marinais; der E-Mail-Text und jeder Backend-Handler erhalten weiterhin CN, IN, SM. Verwenden Sie die Pipe-Syntax überall dort, wo der übermittelte Wert sprachübergreifend stabil bleiben muss: CRM-Zuordnungen, Zahlungs-SKUs, geografische Codes.

Bestätigungs- und Quiz-Tags

Das Kontrollkästchen Bestätigung enthält den Zustimmungstext und normalerweise einen oder mehrere eingebettete Links zu den Seiten für Datenschutz und Nutzungsbedingungen. Übersetzen Sie den Text als einzelne Zeile im Übersetzungsauftrag; bearbeiten Sie für die Linkziele die übersetzte Zeile so, dass sie auf die jeweiligen sprachspezifischen Seiten für Datenschutz und Nutzungsbedingungen verweist.

Bei Quiz-Tags werden sowohl die Frage als auch die Antwort übersetzt. Verwenden Sie die Pipe-Syntax für Quiz-Antworten, damit die Logik für akzeptierte Antworten sprachübergreifend vorhersehbar bleibt:

[quiz captcha
  "1+1=?|2"
  "2+3=?|5"]

Die Registerkarte „Meldungen“

Die Registerkarte Meldungen von Contact Form 7 enthält ~16 bearbeitbare Validierungs-Strings – diejenigen, die Besucher beim Senden und bei Fehlern sehen. Jeder davon wird im selben Auftrag übersetzt:

Thank you for your message. It has been sent.
One or more fields have an error. Please check and try again.
There was an error trying to send your message. Please try again later.
This field is required.
This e-mail address is invalid.
The telephone number is invalid.
The URL is invalid.
The number is smaller than the minimum allowed.
The number is larger than the maximum allowed.
The date format is incorrect.
The file is too big.
The file is not supported.
The Acceptance checkbox is required.
The answer to the quiz is incorrect.
(sowie die restlichen Standardmeldungen, die CF7 mitliefert).

Wenn auf Ihrer Registerkarte „Meldungen“ Mail-Tags verwendet werden, um Eingaben einzusetzen (Thanks [your-name], your message has been sent!), wird der Mail-Tag auch nach der Übersetzung korrekt aufgelöst.

E-Mail und E-Mail (2)

Die beiden Vorlagen für ausgehende E-Mails von Contact Form 7, E-Mail (Admin-Benachrichtigung) und E-Mail (2) (optionale Antwort oder Autoresponder an den Besucher), werden unabhängig voneinander übersetzt. An, Von, Betreff, Zusätzliche Kopfzeilen, Nachrichtentext und die Beschreibungen der Dateianhänge befinden sich alle im Übersetzungsauftrag. Mail-Tags innerhalb der übersetzten Texte ([your-name], [your-message], [your-email]) werden korrekt aufgelöst.

Bei E-Mail (2) kommt es vor allem auf die Übersetzung des für den Besucher sichtbaren Autoresponder-Textes an. Das ist die Nachricht, die im Posteingang des Besuchers landet. Senden Sie eine Testübermittlung von einer übersetzten Seite und vergewissern Sie sich, dass der Autoresponder in der Sprache des Besuchers ankommt.

Übermittlungsintegrationen

Contact Form 7 verfügt über eine kleine, aber wichtige Auswahl an Integrationen. Jede davon behält die Sprache des Besuchers bei, wenn die Übersetzung konfiguriert ist:

Flamingo. Das Add-on zur Übermittlungsverwaltung des Autors von Contact Form 7. Übermittlungen landen in Kontakt > Eingehende Nachrichten, wobei der übersetzte Betreff und Text intakt bleiben.
Constant Contact. Die offizielle E-Mail-Marketing-Integration von CF7. Die Eingaben der Besucher gelangen in deren Sprache in Ihre Constant-Contact-Listen.
Stripe. Die [stripe]-Form-Tag-Felder von Contact Form 7 und der Text der Empfangsbestätigung erscheinen beide im Übersetzungsauftrag.
Akismet. Spam-Schutz-Meldungen werden über die WPML String-Übersetzung übersetzt (nicht über den Formular-Übersetzungsauftrag).
reCAPTCHA. Die für den Besucher sichtbare Fehlermeldung wird über die WPML String-Übersetzung übersetzt.

Häufige Fallstricke

Bestätigung mit eingebettetem Link verweist auf die Datenschutzseite der falschen Sprache. Bearbeiten Sie die Übersetzung der Bestätigung im erweiterten Übersetzungs-Editor und legen Sie sprachspezifische Linkziele fest.
Nicht übereinstimmender Shortcode-Hash bei CF7 6.0+. Behoben in WPML Multilingual for CF7 1.3.2 (Nov. 2024). Führen Sie ein Upgrade durch, wenn dieses Problem bei Ihnen auftritt.
Die Übersetzungen der Registerkarte „Meldungen“ werden nicht angezeigt. Vergewissern Sie sich, dass die WPML String-Übersetzung aktiv ist und dass das Formular nach der Bearbeitung der Registerkarte „Meldungen“ erneut zur Übersetzung gesendet wurde.
Mail-Tags innerhalb von Übersetzungen werden zu leeren Strings aufgelöst. Überprüfen Sie, ob der Name des Form-Tags im Mail-Tag (z. B. [your-name]) mit einem Form-Tag im Formular übereinstimmt. Die Übersetzung unterbricht niemals die Auflösung von Mail-Tags, das Umbenennen eines Form-Tags nach der Übersetzung jedoch schon.