Platzhalter

Ein Platzhalter ist ein Wort zwischen zwei Prozentzeichen. Beim Versand wird er je Empfänger durch den passenden Wert ersetzt.

Guten Tag %abo_title% %abo_name%,

wird zu

Guten Tag Frau Reinhardt,

Platzhalter funktionieren im Betreff, in der HTML-Fassung, in der Textfassung und in einer eigenen Vorlage — überall gleich. Groß- und Kleinschreibung ist bei den Platzhaltern zum Abonnenten und zum Newsletter egal; bei den Datumsplatzhaltern nicht, dort sind %m% und %M% zwei verschiedene Dinge.

Im Editor gibt es die Schaltfläche Platzhalter einfügen. Sie öffnet eine Auswahl mit allem, was diese Installation kennt — auch mit dem, was Module beisteuern.

---

Zum Abonnenten

Platzhalter	Wird zu
%abo_title%	Anrede, also „Herr" oder „Frau" — der Wert, der im Abonnenten steht
%abo_vorname%	Vorname
%abo_name%	Nachname
%abo_email%	E-Mail-Adresse
%abo_strasse%	Straße und Hausnummer
%abo_plz%	Postleitzahl
%abo_ort%	Ort

Leere Felder bleiben leer

„Guten Tag %abo_vorname% %abo_name%," wird bei einem Abonnenten, der nur seine Adresse hinterlassen hat, zu „Guten Tag ,". Wenn Sie Namen in der Anrede benutzen wollen, machen Sie die Felder unter Formularkonfiguration zu Pflichtfeldern — oder schreiben Sie eine Anrede, die ohne Namen auskommt.

Für Bestandsadressen hilft das nicht rückwirkend. Sehen Sie in der Abonnentenliste nach, wie viele überhaupt einen Namen haben, bevor Sie sich darauf verlassen.

Abmelden und Anmeldeformular

Platzhalter	Wird zu
%deregisterurl%	Die persönliche Abmeldeadresse dieses Empfängers
%deregisterlink%	Derselbe Link, fertig als <a> mit dem Text „Newsletter abbestellen"
%deregisterformurl%	Die Adresse Ihrer Anmeldeseite
%deregisterformlink%	Derselbe Link, fertig als <a> mit dem Text „Newsletterformular"

Die ersten beiden melden mit einem Klick ab, ohne dass der Empfänger seine Adresse eintippen muss. Sie stecken schon in jeder mitgelieferten Vorlage — Sie müssen sie nicht selbst setzen.

Ohne Abonnent zeigt %deregisterurl% auf das Formular

In der Browseransicht und im Archiv gibt es keinen Empfänger. Dort werden die persönlichen Felder leer gelassen, und der Abmeldelink zeigt auf Ihre Anmeldeseite statt auf einen persönlichen Link. Sonst stünde auf einer öffentlichen Seite ein gültiger Abmeldelink einer fremden Person.

Zur Website

Platzhalter	Wird zu
%privacyurl%	Die Adresse Ihrer Datenschutzerklärung
%privacylink%	Derselbe Link, fertig als <a> mit dem Text „Datenschutzerklärung"

Beide kommen aus Einstellungen → Datenschutz im Menü von WordPress. Ist dort keine veröffentlichte Seite eingetragen, bleiben sie leer — ein Link auf nichts wäre schlimmer als gar keiner.

Zum Newsletter

Platzhalter	Wird zu
%nl_name%	Der Name des Newsletters. Steht ab Werk in der Betreffzeile
%nl_onlineurl%	Adresse der Browseransicht
%nl_onlinelink%	Fertiger Link, Text „Newsletter im Browser ansehen"
%nl_onlineurl_text%	Adresse der Textfassung im Browser
%nl_onlinelink_text%	Fertiger Link auf die Textfassung

Die alten Namen funktionieren weiter

%nl_previewurl%, %nl_previewlink%, %nl_previewurl_text% und %nl_previewlink_text% liefern dasselbe. Sie werden nur nicht mehr zum Einfügen angeboten: Der Endpunkt ist keine Vorschau, sondern die Ansicht des versendeten Newsletters, und ein Name, der etwas anderes sagt als er tut, gehört nicht in eine Auswahlliste.

Wer ein eigenes Layout liegen hat, muss nichts ändern.

Datum und Uhrzeit

Die Platzhalter folgen strftime. Sie zeigen den Zeitpunkt des Versands in der Zeitzone Ihrer Website.

%d%	Tag, zweistellig	%A%	Wochentag, ausgeschrieben
%e%	Tag, ohne führende Null	%a%	Wochentag, abgekürzt
%m%	Monat, zweistellig	%B%	Monat, ausgeschrieben
%Y%	Jahr, vierstellig	%b% · %h%	Monat, abgekürzt
%y%	Jahr, zweistellig	%j%	Tag im Jahr
%H%	Stunde, 24er-Zählung	%V%	Kalenderwoche
%I%	Stunde, 12er-Zählung	%p%	AM / PM
%M%	Minute	%S%	Sekunde
%x%	Datum, wie es das Land schreibt	%X%	Uhrzeit, wie es das Land schreibt
%T%	HH:MM:SS	%R%	HH:MM
%Z%	Kürzel der Zeitzone	%C%	Jahrhundert

Die Vorgabe für den Namen eines neuen Newsletters benutzt sie: Newsletter %b% %Y% ergibt „Newsletter Sep. 2026".

Hier gilt Groß- und Kleinschreibung

%m% ist der Monat, %M% die Minute. %y% ist zweistellig, %Y% vierstellig. Das ist die einzige Gruppe, in der das eine Rolle spielt.

---

Aus Modulen

Abonnentenvariablen

Nur in den Editionen Pro und Enterprise

Jedes eigene Feld, das Sie unter Abonnentenvariablen anlegen, bekommt einen Platzhalter %uf_<Nummer>%. Die Nummer steht in der Feldliste; in der Auswahl im Editor steht der Name, den Sie vergeben haben.

Platzhalterregel

Das Modul Platzhalterregel erlaubt eigene Platzhalter, deren Wert von einer Bedingung abhängt — „wenn PLZ mit 9 beginnt, dann diesen Text, sonst jenen". Der Name ist frei wählbar.

Eigener Code

Wer einen eigenen Platzhalter aus einem Snippet heraus setzen will:

$GLOBALS['wpng_arReplace']['/%unser_slogan%/i'] = 'Aus der Quelle, nicht aus der Leitung.';

Der Schlüssel ist ein regulärer Ausdruck, der Wert der Ersatztext. Gesetzt wird er, bevor der Versand läuft — etwa an init.

---

Wenn ein Platzhalter stehenbleibt

Das Plugin prüft es für Sie. Beim Öffnen eines noch nicht versendeten Newsletters, beim Testversand und beim Planen läuft die Ersetzung einmal probeweise; was danach noch als %name% dasteht, wird gemeldet:

Dieser Newsletter enthält Platzhalter, die niemand auflöst: %abo_vname%. Sie stehen so, wie sie dort stehen, beim Empfänger im Text.

Zwei Ursachen kommen in Frage:

1. Ein Tippfehler. Es heißt %abo_vorname%, nicht %abo_vname%.
2. Das Modul läuft nicht, das den Platzhalter mitbringt. Häufig nach einem Wechsel auf die kostenlose Fassung, oder wenn jemand ein Modul abgeschaltet hat.

Die Meldung verschwindet von selbst, sobald die Ursache behoben ist.

Was die Prüfung nicht meldet

Prozentzeichen, die keine Platzhalter sind, bleiben unbehelligt: „100 % Baumwolle", „50 % Rabatt" und die Prozentkodierung in Adressen (%C3%A4 für „ä"). Zwischen den Prozentzeichen müssen Buchstaben, Ziffern oder Unterstriche stehen, und zwei Hexziffern gelten nicht.

Auf einer Installation ohne einen einzigen Abonnenten prüft sie gar nicht — dort ließe sich %abo_vorname% von einem verwaisten Platzhalter nicht unterscheiden.