TheCruiserWiki

Bitte bearbeite dieses Dokument nur, wenn du es verbessern kannst. Nach dem Bearbeiten den [Speichern]-Knopf drücken. Siehe syntax zur Wiki-Syntax. Zum Testen bitte erst im Spielplatz üben.

<WRAP tcw-page-header>
<WRAP tcw-page-header-main>
<WRAP tcw-page-title>
====== Contact Form 7 ======
</WRAP>

<WRAP tcw-page-back>
[[plugins:start|← Plugins]]
</WRAP>
</WRAP>

**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:

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:

Durch die Verwendung der Besucheradresse als ''Reply-To'' kann auf eine eingegangene Nachricht direkt an den Absender geantwortet werden.

Die Absenderadresse von TheCruiserBlog lautet:

<code>
kontakt@thecruiserblog.rowake.net
</code>

===== 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:

===== 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

<WRAP tcw-to-top>
[[#contact_form_7|↑]]
</WRAP>

Zusammenfassung