====== Contact Form 7 ====== [[plugins:start|← Plugins]] **Contact Form 7** wird in TheCruiserBlog zur Bereitstellung und Verarbeitung des Kontaktformulars eingesetzt. Das Plugin stellt das Formular bereit, verarbeitet die eingegebenen Daten und erzeugt die daraus resultierende E-Mail-Nachricht. ===== Aktueller Stand ===== ^ Version ^ Status ^ Einsatz ^ | 6.1.7 | aktiv | Kontaktformular von TheCruiserBlog | ===== Zweck ===== Contact Form 7 bildet die technische Grundlage für das Kontaktformular von TheCruiserBlog. Das Plugin übernimmt insbesondere: * Bereitstellung des Kontaktformulars * Definition und Validierung der Formularfelder * Verarbeitung der eingegebenen Formulardaten * Erzeugung der E-Mail-Nachricht * Ausgabe von Status-, Bestätigungs- und Fehlermeldungen * Einbindung des Formulars in WordPress * Anbindung an den eingesetzten Spam-Schutz ===== Vorhandene Formulare ===== Aktuell wird in Contact Form 7 ein Formular verwaltet: ^ Formular ^ Verwendung ^ | **Kontaktformular** | allgemeine Kontaktaufnahme über TheCruiserBlog | Das Formular wird über den von Contact Form 7 bereitgestellten Shortcode in die entsprechende WordPress-Seite eingebunden. Die interne Formular-ID wird im TheCruiserWiki nicht dokumentiert, da sie installationsspezifisch ist. ===== Kontaktformular ===== Das Kontaktformular enthält aktuell folgende Felder: ^ Feld ^ Typ ^ Pflichtfeld ^ | Dein Name | Text | ja | | Deine E-Mail-Adresse | E-Mail | ja | | Betreff | Text | ja | | Deine Nachricht | Textbereich | nein | Zum Absenden des Formulars wird die Schaltfläche **Senden** verwendet. Für Name und E-Mail-Adresse werden die von Contact Form 7 unterstützten Autocomplete-Angaben verwendet. ===== E-Mail-Konfiguration ===== Nach erfolgreicher Verarbeitung erzeugt Contact Form 7 eine E-Mail-Nachricht. Die aktuelle Konfiguration lautet: ^ Einstellung ^ Konfiguration ^ | Empfänger | WordPress-Administratoradresse über ''[_site_admin_email]'' | | Absender | ''[_site_title] '' | | Betreff | Seitentitel und vom Besucher eingegebener Betreff | | Reply-To | vom Besucher eingegebene E-Mail-Adresse | | HTML-E-Mail | aktiviert | | Dateianhänge | keine | | zusätzliche E-Mail / Autoresponder | deaktiviert | Durch die Verwendung der Besucheradresse als ''Reply-To'' kann auf eine eingegangene Nachricht direkt an den Absender geantwortet werden. Die Absenderadresse von TheCruiserBlog lautet: kontakt@thecruiserblog.rowake.net ===== Nachrichteninhalt ===== Die erzeugte E-Mail enthält die wesentlichen Angaben aus dem Kontaktformular: * Name des Absenders * E-Mail-Adresse des Absenders * Betreff * Nachrichtentext Zusätzlich enthält die Nachricht einen Hinweis darauf, dass sie über das Kontaktformular der Website versendet wurde. ===== Status- und Fehlermeldungen ===== Contact Form 7 stellt für verschiedene Situationen entsprechende Rückmeldungen bereit. Dazu gehören unter anderem: * erfolgreicher Versand * Fehler beim Nachrichtenversand * fehlerhafte oder fehlende Formulareingaben * als Spam erkannte Eingaben * nicht akzeptierte Bedingungen * ungültige Feldlängen oder Eingabeformate Für das aktuelle Kontaktformular werden die vorhandenen deutschsprachigen Meldungen verwendet. Eigene zusätzliche Meldungslogik ist derzeit nicht eingerichtet. ===== Zusätzliche Einstellungen ===== Für das Kontaktformular sind derzeit keine zusätzlichen Contact-Form-7-Einstellungen hinterlegt. ===== Spam-Schutz ===== Das Kontaktformular verwendet mehrere Mechanismen zum Schutz vor automatisiertem Spam. Aktiv eingebunden sind: * **Akismet** * **Google reCAPTCHA v3** Beide Integrationen sind innerhalb von Contact Form 7 aktiv. Akismet übernimmt die serverseitige Bewertung möglicher Spam-Inhalte. reCAPTCHA v3 ergänzt den Schutz vor automatisierten Formularübermittlungen. Die für reCAPTCHA verwendeten Website- und geheimen Schlüssel werden aus Sicherheitsgründen nicht im TheCruiserWiki dokumentiert. ===== Zusammenspiel mit Akismet ===== Das auf TheCruiserBlog eingesetzte Plugin **Akismet Anti-spam: Spam Protection** ist mit Contact Form 7 kompatibel und aktiv. Akismet ergänzt damit den Spam-Schutz des Kontaktformulars. Die allgemeine Akismet-Konfiguration wird auf der eigenen Plugin-Seite dokumentiert: [[plugins:akismet:start|Akismet Anti-spam: Spam Protection]] ===== Zusammenspiel mit Flamingo ===== **Flamingo** ergänzt Contact Form 7 um die Speicherung eingegangener Formulardaten innerhalb von WordPress. Über das Kontaktformular eingegangene Nachrichten werden im Flamingo-Nachrichteneingang archiviert. Flamingo führt außerdem ein Adressbuch der über Contact Form 7 erfassten Kontakte. Dadurch bleibt eine über das Kontaktformular eingegangene Nachricht zusätzlich zur versendeten E-Mail innerhalb der WordPress-Administration nachvollziehbar. Die weitere Konfiguration von Flamingo wird auf der eigenen Plugin-Seite dokumentiert. ===== E-Mail-Versand ===== Contact Form 7 erzeugt die aus dem Kontaktformular resultierende E-Mail-Nachricht. Der technische Versand der von WordPress erzeugten E-Mails wird unabhängig davon über die für TheCruiserBlog eingerichtete Mail-Konfiguration abgewickelt. Hierfür wird **WP Mail SMTP** eingesetzt. Damit ergibt sich grundsätzlich folgende Aufgabenverteilung: ^ Komponente ^ Aufgabe ^ | **Contact Form 7** | Formular, Verarbeitung und Erzeugung der Nachricht | | **Akismet** | zusätzlicher Spam-Schutz | | **reCAPTCHA v3** | Schutz vor automatisierten Formularübermittlungen | | **Flamingo** | Speicherung eingegangener Nachrichten und Kontakte | | **WP Mail SMTP** | technischer Versand der erzeugten E-Mail | ===== Administration ===== Die Formulare werden im WordPress-Backend unter **Formulare → Kontaktformulare** verwaltet. Die externen Integrationen von Contact Form 7 befinden sich unter **Formulare → Integration** Die gespeicherten Formulardaten können über Flamingo eingesehen werden. ===== Sicherheit ===== Zugangsschlüssel und andere vertrauliche Konfigurationsdaten werden nicht im TheCruiserWiki dokumentiert. Dies betrifft insbesondere: * reCAPTCHA Website-Schlüssel * reCAPTCHA Geheimschlüssel * Zugangsdaten der Mail-Konfiguration Bei Screenshots für Dokumentationszwecke ist darauf zu achten, solche Informationen nicht sichtbar zu veröffentlichen. ===== Dokumentationsprinzip ===== Diese Seite dokumentiert ausschließlich den konkreten Einsatz von **Contact Form 7** innerhalb von TheCruiserBlog. Eine allgemeine Dokumentation sämtlicher Funktionen von Contact Form 7 ist nicht Bestandteil des TheCruiserWiki. Dokumentiert werden insbesondere: * eingesetzte Version * tatsächlich verwendete Formulare * Formularfelder * E-Mail-Konfiguration * Spam-Schutz * Zusammenspiel mit anderen eingesetzten Plugins * für den Betrieb relevante Besonderheiten [[#contact_form_7|↑]]