| 1 |
# Shortcodes und Platzhalter |
| 2 |
|
| 3 |
## Shortcodes für Bestätigungs- und Fehlerseite |
| 4 |
|
| 5 |
### `[doi_confirmation_status]` |
| 6 |
|
| 7 |
Zeigt, was mit dem Link geschehen ist, den der Besucher gerade angeklickt hat. Jeder Text lässt sich über ein Attribut ersetzen: |
| 8 |
|
| 9 |
| Attribut | Wann es greift | Standardtext | |
| 10 |
|---|---|---| |
| 11 |
| `confirmed` | Link bestätigt die Adresse | Danke! Deine E-Mail-Adresse ist bestätigt. | |
| 12 |
| `already_confirmed` | Link wurde schon verwendet | Dein Opt-In wurde bereits bestätigt. | |
| 13 |
| `expired` | Frist abgelaufen | Dieser Bestätigungslink ist abgelaufen. Bitte sende das Formular erneut ab. | |
| 14 |
| `not_found` | Link unbekannt oder verändert | Dieser Bestätigungslink ist ungültig. | |
| 15 |
| `none` | Seite ohne Link aufgerufen | leer, es erscheint nichts | |
| 16 |
|
| 17 |
Beispiel: `[doi_confirmation_status confirmed="Willkommen an Bord!"]` |
| 18 |
|
| 19 |
Steht der Shortcode nicht auf der Seite, bekommt ein abgelaufener, bereits verwendeter oder ungültiger Link trotzdem eine kurze Meldung vor dem Seiteninhalt. |
| 20 |
|
| 21 |
 |
| 22 |
|
| 23 |
### `[doi_field name="…" default="…"]` |
| 24 |
|
| 25 |
Gibt einen Wert aus dem bestätigten Formular aus, zum Beispiel `[doi_field name="your-name" default="Hallo"]`. Der Wert erscheint nur in dem Aufruf, der die Anmeldung bestätigt hat. Sonst, oder wenn das Feld leer ist, steht der Wert von `default`. |
| 26 |
|
| 27 |
### `[doi_if status="…"]…[/doi_if]` |
| 28 |
|
| 29 |
Zeigt den eingeschlossenen Inhalt nur, wenn das Ergebnis des Links zu `status` passt. Mehrere Werte werden mit Komma getrennt: `confirmed`, `already_confirmed`, `expired`, `not_found`, `none`. |
| 30 |
|
| 31 |
Beispiel: `[doi_if status="expired"]Der Link ist abgelaufen. Eine neue Anmeldung ist jederzeit möglich.[/doi_if]` |
| 32 |
|
| 33 |
 |
| 34 |
|
| 35 |
### `[doi_error_message default="…"]` |
| 36 |
|
| 37 |
Für die **Fehler-Weiterleitungsseite**. Erklärt anhand des Parameters `doi_error` in der Adresse, warum eine Anmeldung abgelehnt wurde. Ohne diesen Parameter erscheint nichts. Bei unbekanntem Code steht der Wert von `default`. |
| 38 |
|
| 39 |
| Code | Meldung | |
| 40 |
|---|---| |
| 41 |
| `rate_limit_ip` | Zu viele Anmeldungen von derselben Verbindung in kurzer Zeit. | |
| 42 |
| `rate_limit_email` | Diese Adresse wurde mehrfach in kurzer Zeit angemeldet. | |
| 43 |
| `recipient_invalid` | Diese E-Mail-Adresse kann keine Post empfangen. | |
| 44 |
| `no_recipient` | Es wurde keine gültige E-Mail-Adresse eingegeben. | |
| 45 |
| `unique_email_duplicate` | Diese E-Mail-Adresse ist bereits angemeldet. | |
| 46 |
| `consent_not_given` | Zustimmung zum Einwilligungstext fehlt. | |
| 47 |
| `save_failed` | Die Anmeldung konnte nicht gespeichert werden. | |
| 48 |
| `submission_cancelled` | Die Anmeldung konnte nicht abgeschlossen werden. | |
| 49 |
|
| 50 |
Die Meldungen gelten in der Sprache der Website; sie lassen sich über den Filter `f12_doi_error_messages` anpassen. Die Texte in der Tabelle sind sinngemäß gekürzt. |
| 51 |
|
| 52 |
## Platzhalter in der Bestätigungsmail |
| 53 |
|
| 54 |
Platzhalter stehen in eckigen Klammern im Nachrichtentext und werden beim Versand ersetzt. Unter **Platzhalter anzeigen** im Reiter **E-Mail** listet das Plugin die Standardplatzhalter. |
| 55 |
|
| 56 |
### Systemplatzhalter |
| 57 |
|
| 58 |
| Platzhalter | Inhalt | |
| 59 |
|---|---| |
| 60 |
| `[doubleoptinlink]` | persönlicher Bestätigungslink, in jeder Mail Pflicht | |
| 61 |
| `[doubleoptoutlink]` | Abmeldelink; die Abmeldeseite stellt das Opt-Out-Addon bereit | |
| 62 |
| `[doubleoptin_form_date]` | Datum der Anmeldung im Datumsformat der Website | |
| 63 |
| `[doubleoptin_form_time]` | Uhrzeit im Zeitformat der Website | |
| 64 |
| `[doubleoptin_form_url]` | Adresse der Seite, auf der das Formular abgeschickt wurde | |
| 65 |
| `[doubleoptin_form_subject]` | Betreff des Formulars | |
| 66 |
| `[doubleoptin_form_email]` | Administrator-Adresse der Website | |
| 67 |
| `[doubleoptin_privacy_url]` | Adresse der Datenschutzerklärung (**Einstellungen → Datenschutzerklärungs-Seite**, sonst die WordPress-Datenschutzseite) | |
| 68 |
|
| 69 |
### Formularfelder |
| 70 |
|
| 71 |
Diese Platzhalter werden aus den Feldern des Formulars gefüllt. Das Plugin erkennt Felder anhand üblicher Namen wie `your-email` oder `first-name`. Abweichende Namen ordnest du im Reiter **Zuordnung** zu. Ohne Treffer bleibt der Platzhalter leer. |
| 72 |
|
| 73 |
`[doi_email]`, `[doi_name]`, `[doi_first_name]`, `[doi_last_name]`, `[doi_phone]`, `[doi_company]`, `[doi_subject]`, `[doi_message]`, `[doi_address]`, `[doi_city]`, `[doi_zip]`, `[doi_country]` |
| 74 |
|
