Platzhalter¶
An vielen Stellen im Shop können Sie Platzhalter verwenden, z. B. im Betreff und in den Zusatztexten der Mails (siehe E-Mail-Konfiguration), im Betreff von Zahlungen, in Rechnungs- und Lieferscheintexten oder in PDF-Dokumenten der Module. Beim Erzeugen der Mail oder des Dokuments ersetzt der Shop den Platzhalter durch den passenden Wert.
Einige Grundregeln:
- Platzhalter stehen zwischen zwei Prozentzeichen, z. B.
%order_onr%. Groß- und Kleinschreibung spielt bei den meisten Platzhaltern keine Rolle. Bei den Datumsplatzhaltern (%d%ist etwas anderes als%D%), bei%rand%,%product_index%und bei den Modulplatzhaltern%ov_…%,%pv_…%und%at_…%müssen Sie sie genau einhalten. - Welche Platzhalter an einer Stelle zur Verfügung stehen, hängt vom Zusammenhang ab: Bestellplatzhalter gibt es nur, wenn es um eine Bestellung geht, Produktplatzhalter nur, wenn ein Produkt zugeordnet ist.
- Platzhalter, für die es keinen Wert gibt, entfernt der Shop aus dem Text.
Seiten-URLs¶
Die Seiten legen Sie unter wpShopGermany → Konfiguration → Einstellungen → Seitenkonfiguration fest (siehe Seitenkonfiguration).
| Platzhalter | Wert |
|---|---|
%warenkorb_url% |
Warenkorbseite |
%warenkorb_more_url% |
„Weiter shoppen“-Seite |
%kundendaten_url% |
Seite mit der Eingabe der Kundendaten (Checkout) |
%versandkosten_url% |
Seite mit den Versandkosten |
%agb_url% |
AGB-Seite |
%datenschutz_url% |
Datenschutzseite |
%widerruf_url% |
Seite mit der Widerrufsbelehrung |
%impressum_url% |
Impressum |
%anfrageliste_url% |
Seite der Anfrageliste (benötigt das Modul Anfrageprodukte) |
%profil_url% |
Profilseite des Kunden (Modul Kundenverwaltung) |
%bestellungen_url% |
Seite mit den Bestellungen des angemeldeten Kunden (Modul Kundenverwaltung) |
%logout_url% |
Adresse, die den angemeldeten Kunden abmeldet (Modul Kundenverwaltung) |
%passwortvergessen_url% |
Seite „Passwort vergessen“ (Modul Kundenverwaltung) |
%abo_url% |
Aboübersicht des Kunden (Modul Aboprodukte) |
%widerrufsformular_url% |
hochgeladenes Widerrufsformular (siehe Widerruf) |
%widerrufformular_pdf_url% |
wie %widerrufsformular_url%, aber nur gesetzt, wenn die Datei tatsächlich vorhanden ist |
Datum und Zufallszahl¶
Die Datumsplatzhalter beziehen sich auf das aktuelle Datum und entsprechen den Formatangaben von PHP strftime. Namen von Wochentagen und Monaten richten sich nach der Sprache der Installation.
| Platzhalter | Wert | Beispiel am 31.12.2026 |
|---|---|---|
%a% |
abgekürzter Wochentag | Do |
%A% |
Wochentag | Donnerstag |
%b% |
abgekürzter Monatsname | Dez |
%B% |
Monatsname | Dezember |
%d% |
Tag des Monats, zweistellig | 31 |
%e% |
Tag des Monats ohne führende Null | 31 |
%m% |
Monat, zweistellig | 12 |
%y% |
Jahr, zweistellig | 26 |
%Y% |
Jahr, vierstellig | 2026 |
%y1% / %Y1% |
nächstes Jahr, zwei- bzw. vierstellig | 27 / 2027 |
%H% / %M% / %S% |
Stunde / Minute / Sekunde | |
%j% |
Tag im Jahr (001–366) | 365 |
%V% |
Kalenderwoche nach ISO 8601 | 53 |
Außerdem stehen %c%, %C%, %D%, %g%, %G%, %h%, %I%, %n%, %p%, %r%, %R%, %t%, %T%, %u%, %U%, %w%, %W%, %x%, %X% und %Z% mit der Bedeutung aus dem PHP-Handbuch zu strftime zur Verfügung.
%rand% liefert eine Zufallszahl zwischen 0 und 1000.
Shopinfo¶
Die Werte stammen aus wpShopGermany → Konfiguration → Einstellungen → Shopinfo (siehe Shopinfo).
| Platzhalter | Wert |
|---|---|
%shopinfo_name% (auch %shopdata_name%) |
Name des Shops / der Firma |
%shopinfo_owner% |
Inhaber |
%shopinfo_street% |
Straße |
%shopinfo_zip% |
Postleitzahl |
%shopinfo_city% |
Ort |
%shopinfo_country% |
Land aus den Shopdaten (ohne Angabe das Standardland der Länderverwaltung) |
%shopinfo_tel% |
Telefonnummer |
%shopinfo_fax% |
Faxnummer |
%shopinfo_email% |
E-Mail-Adresse |
%shopinfo_taxnr% |
Steuernummer |
%shopinfo_ustidnr% |
USt-IdNr. |
%shopinfo_bankname% |
Name der Bank |
%shopinfo_accountowner% |
Kontoinhaber |
%shopinfo_iban% |
IBAN |
%shopinfo_qriban% |
QR-IBAN (Schweiz) |
%shopinfo_bic% |
BIC |
%shopinfo_besr% |
BESR-ID (Schweiz) |
Für eine zweite Adresse gibt es %shopinfo_2_street%, %shopinfo_2_zip%, %shopinfo_2_city%, %shopinfo_2_country%, %shopinfo_2_tel%, %shopinfo_2_fax% und %shopinfo_2_email%, für die Angaben zur Niederlassung in der EU %shopinfo_eu_name%, %shopinfo_eu_street%, %shopinfo_eu_zip%, %shopinfo_eu_city%, %shopdata_eu_country%, %shopinfo_eu_tel%, %shopinfo_eu_fax% und %shopinfo_eu_email%.
Bestellung¶
Jede Spalte der Bestelltabelle steht als %order_<Spaltenname>% zur Verfügung. Die wichtigsten:
| Platzhalter | Wert |
|---|---|
%order_id% |
interne ID der Bestellung |
%order_onr% |
Bestellnummer |
%order_cdate% |
Bestelldatum (TT.MM.JJJJ) |
%order_cdate_format_de% |
Bestelldatum und Uhrzeit im Format TT.MM.JJJJ \| HH:MM |
%order_k_id% |
interne ID des Kunden |
%order_status% |
Status-ID (siehe Eigene Texte in die Statusmeldungen integrieren) |
%order_comment% |
Kommentar des Kunden |
%order_admincomment% |
interner Kommentar |
%order_price_gesamt_brutto% / %order_price_gesamt_netto% |
Warenwert brutto / netto |
%order_topay_brutto% / %order_topay_netto% |
Zahlbetrag brutto / netto |
%order_topay_brutto_formated% |
Zahlbetrag brutto, formatiert mit Währung |
%order_price_shipping_brutto% / %order_price_payment_brutto% |
Versandkosten / Kosten der Zahlungsart, brutto (entsprechend …_netto) |
%order_price_rabatt_brutto% / %order_price_gs_brutto% |
Rabatt / Gutscheinwert, brutto (entsprechend …_netto) |
%order_shipping_key% / %order_payment_key% |
gewählte Versand- bzw. Zahlungsart (interner Schlüssel) |
%order_gs_code% |
eingelöster Gutscheincode |
%order_payed_date% |
Zahlungsdatum |
%order_transaction% |
Transaktionsnummer des Zahlungsanbieters |
%order_language% |
Sprache der Bestellung |
%order_ip% / %order_useragent% |
IP-Adresse / Browserkennung beim Bestellen |
%order_done_url% |
Adresse der Bestellabschlussseite dieser Bestellung |
Rechnungsanschrift:
%order_invoice_title%, %order_invoice_vname%, %order_invoice_name%, %order_invoice_firma%, %order_invoice_strasse%, %order_invoice_nr%, %order_invoice_plz%, %order_invoice_ort%, %order_invoice_land%
Lieferanschrift:
%order_shipping_title%, %order_shipping_vname%, %order_shipping_name%, %order_shipping_firma%, %order_shipping_strasse%, %order_shipping_nr%, %order_shipping_plz%, %order_shipping_ort%, %order_shipping_land%
Module ergänzen die Bestelltabelle um eigene Spalten, die ebenfalls als Platzhalter verfügbar sind, z. B. %order_weight% (Modul Produktgewicht), %order_wpsg_mod_packagetracking_code% (Modul Paketverfolgung) oder %order_mod_autodebit_iban% (Modul Bankeinzug).
Bestellvariablen¶
Werte aus dem Modul Bestellvariablen: %ov_{ID der Bestellvariable}%
Kunde¶
Jede Spalte der Kundentabelle und der Kundenanschrift steht als %kunde_<Spaltenname>% zur Verfügung:
| Platzhalter | Wert |
|---|---|
%kunde_id% |
interne ID des Kunden |
%kunde_knr% |
Kundennummer |
%kunde_anrede% |
Anrede als Text (z. B. „Frau“) |
%kunde_title% |
Anrede als Index |
%kunde_vname% / %kunde_name% |
Vorname / Name |
%kunde_firma% |
Firma |
%kunde_strasse% / %kunde_nr% |
Straße / Hausnummer |
%kunde_plz% / %kunde_ort% |
Postleitzahl / Ort |
%kunde_land% |
Land (ID) |
%kunde_email% |
E-Mail-Adresse |
%kunde_tel% / %kunde_fax% |
Telefon / Fax |
%kunde_geb% |
Geburtsdatum |
%kunde_ustidnr% |
USt-IdNr. |
%kunde_email_einvoice% / %kunde_leitweg_id% |
E-Mail und Leitweg-ID für E-Rechnungen |
%kunde_comment% |
Kommentar zum Kunden |
%kunde_paypal_payer_id% |
PayPal-Kennung |
%kunde_budget% |
Budget (Modul Kundenbudget) |
%kunde_group_id% |
Kundengruppe (Modul Kundengruppen) |
Kundenvariablen¶
Eigene Kundenfelder (siehe Kundendaten, Bereich „Weitere Kundendaten“): %kv_{INDEX}%. Den Index lesen Sie in der Verwaltung der Kundendaten ab.
Produkt¶
Wo ein Produkt zugeordnet ist (z. B. in PDF-Dokumenten des Moduls DownloadPlus oder bei Gutscheinprodukten), steht jede Spalte der Produkttabelle als %product_<Spaltenname>% zur Verfügung, z. B. %product_name%, %product_detailname%, %product_anr% (Artikelnummer) oder %product_preis%. Dazu kommen %product_url% (Adresse der Produktseite) und %product_index% (Position in der Bestellung).
Produktattribute¶
Werte aus dem Modul Produktattribute: %at_{ID des Produktattributes}%
Produktvariablen¶
Werte aus dem Modul Produktvariablen: %pv_{ID der Variable}%. Die ID steht in der Verwaltung der Produktvariablen. Produktvariablen gibt es nur, wenn Produkt und Bestellung zugeordnet sind (z. B. bei generierten Gutschein-PDFs).
Produktvarianten¶
Werte aus dem Modul Produktvarianten für das bestellte Produkt:
| Platzhalter | Wert |
|---|---|
%productvariants_{var_id}_value% |
Name der gewählten Variation |
%productvariants_{var_id}_artnr% |
Artikelnummer der gewählten Variation |
%productvariants_{var_id}_price% |
Preis der gewählten Variation |
%productvariants_key% |
alle gewählten Variationen, mit / getrennt |
%productvariants_akey% |
Artikelnummern aller gewählten Variationen, mit / getrennt |
Warenkorb¶
| Platzhalter | Wert |
|---|---|
%basket_txt% |
Aufstellung der Bestellung als Text (für Textmails) |
%basket_html% |
Aufstellung der Bestellung als HTML (für HTML-Mails) |
Angemeldeter Backend-Benutzer¶
Nur bei Aktionen im Backend (z. B. wenn Sie dort eine Mail auslösen) stehen die Daten des angemeldeten WordPress-Benutzers zur Verfügung:
| Platzhalter | Wert |
|---|---|
%user_username% |
Benutzername |
%user_email% |
E-Mail-Adresse |
%user_firstname% |
Vorname |
%user_lastname% |
Nachname |
%display_name% |
öffentlicher Name |
Einzelne Module bieten zusätzlich eigene Platzhalter an; diese sind auf den jeweiligen Modulseiten beschrieben. Die Platzhalter von wpNewsletterGermany stehen im Handbuch von wpNewsletterGermany.