Liste der verfügbaren Tags

Tags können in bestimmte Felder eingefügt werden, um automatisch Inhalt zu generieren. Manche Tags sind nur für bestimmte Einstellungen verfügbar. Wird der Inhalt eines Tags nicht gefunden oder ist er nicht verfügbar wird an der Stelle nichts angezeigt.

1. Zahlungsempfänger / Begünstigter

Diese Tags können für E-Mail-Benachrichtigungen, im PDF-Editor sowie für Dateinahmen (Rechnung und Lieferschein) verwendet werden.

  • {beneficiary_name}: Der Name des Begünstigten.
  • {beneficiary_addition}: Der Namenszusatz des Begünstigten.
  • {beneficiary_street}: Die Adresse/Strasse des Begünstigten.
  • {beneficiary_house_nr}: Die Hausnummer des Begünstigten.
  • {beneficiary_zip}: Die Postleitzahl des Begünstigten.
  • {beneficiary_city}: Der Ort des Begünstigten.
  • {beneficiary_country}: Das Land des Begünstigten.

2. Buchung

Folgende Tags können verwendet werden, um Daten der betroffenen Buchung einzufügen. Diese sind nur für Admin- und Kunden-E-Mails (QR-Rechnung > Einstellungen > E-Mails) verfügbar.

  • {booking.id}: Die ID der Buchung.
  • {booking.bill_id}: Die ID der zugehörigen Rechnung.
  • {booking.wc_order_id}: Die ID der zugehörigen WooCommerce-Bestellung.
  • {booking.account}: Die Kontonummer des Empfängers.
  • {booking.amount}: Der Betrag der Buchung.
  • {booking.currency}: Die Währung der Buchung.
  • {booking.reference}: Die Referenznummer der Buchung/Rechnung.
  • {booking.get_formatted_time}: Zeit und Datum der Buchung.

3. Rechnung

Folgende Tags können verwendet werden, um Daten einer verknüpften Rechnungen einzufügen. Diese Tags können für E-Mail-Benachrichtigungen, im PDF-Editor sowie für Dateinahmen (Rechnung und Lieferschein) verwendet werden.

  • {id} oder {bill.id}: Die ID der Rechnung.
  • {wc_order_id} oder {bill.wc_order_id}: Die ID der zugehörigen WooCommerce-Bestellung.
  • {status} oder {bill.status}: Der Zahlungsstatus der Rechnung (unbezahlt, teilweise bezahlt, bezahlt).
  • {bill.account}: Die Kontonummer des Empfängers.
  • {amount} oder {bill.amount}: Der Rechnungsbetrag.
  • {amount_paid} oder {bill.amount_paid}: Der bereits bezahlte Betrag.
  • {currency} oder {bill.currency}: Die Währung der Rechnung.
  • {reference} oder {bill.reference}: Die Referenznummer der Rechnung.
  • {payer_first_name} oder {bill.first_name}: Der Vorname des Zahlungspflichtigen.
  • {payer_last_name} oder {bill.last_name}: Der Nachname des Zahlungspflichtigen.
  • {payer_company} oder {bill.company}: Der Firmenname des Zahlungspflichtigen.
  • {bill.get_company_and_full_name}: Firmenname, Vorname und Nachname des Zahlungspflichtigen.
  • {payer_company_or_name} oder {bill.get_company_or_else_name}: Firmenname, falls vorhanden. Andernfalls Vor- und Nachname des Zahlungspflichtigen.
  • {payer_full_name} oder {bill.get_full_name}: Vor- und Nachname des Zahlungspflichtigen.
  • {bill.get_name_and_address}: Name und Adresse des Zahlungspflichtigen getrennt durch Kommas.
  • {payer_street} oder {bill.street}: Strasse und Hausnummer des Zahlungspflichtigen.
  • {payer_zip} oder {bill.zip}: PLZ des Zahlungspflichtigen.
  • {payer_city} oder {bill.city}: Ort des Zahlungspflichtigen.
  • {payer_country} oder {bill.country}: Land des Zahlungspflichtigen.
  • {payer_email} oder {bill.email}: E-Mail-Adresse des Zahlungspflichtigen.
  • {bill.user_id}: Benutzer-ID des zugewiesenen Benutzers (falls vorhanden).
  • {time} oder {bill.get_formatted_time}: Zeit der Rechnung.
  • {date} oder {bill.get_formatted_date}: Datum der Rechnung.

4. WooCommerce-Bestellung

Es können alle WooCommerce-Funktionen oder Properties von WC_Order verwendet werden die als String, Float oder Int zurückgegeben werden. Unter anderem sind dadurch folgende Tags verfügbar. Diese Tags können für E-Mail-Benachrichtigungen, im PDF-Editor sowie für Dateinahmen (Rechnung und Lieferschein) verwendet werden.

  • {wc_order.get_id} : Die WooCommerce-Bestellungs-ID.
  • {wc_order.get_formatted_order_total} : Formatiertes Total.
  • {wc_order.get_cart_tax} : Steuer des Warenkorbs.
  • {wc_order.get_currency} : Währung als ISO-Code (z.B. CHF).
  • {wc_order.get_discount_tax} : Steuer von Vergünstigungen.
  • {wc_order.get_discount_to_display} : Formatiertes Total der Vergünstigungen.
  • {wc_order.get_discount_total} : Total der Vergünstigungen.
  • {wc_order.get_shipping_tax} : Steuer des Versands.
  • {wc_order.get_shipping_total} : Total des Versands.
  • {wc_order.get_subtotal} : Subtotal (vor Vergünstigungen aber mit Steuern).
  • {wc_order.get_subtotal_to_display} : Formatiertes Subtotal.
  • {wc_order.get_total} : Total der Bestellung.
  • {wc_order.get_total_tax} : Total der Steuern.
  • {wc_order.get_total_refunded} : Insgesamt zurückerstatteter Betrag.
  • {wc_order.get_total_tax_refunded} : Insgesamt zurückerstattete Steuern.
  • {wc_order.get_total_shipping_refunded} : Insgesamt zurückerstattete Versandgebühren.
  • {wc_order.get_formatted_billing_address} : Formatierte Rechnungsadresse.
  • {wc_order.get_formatted_billing_full_name} : Formatierter Name des Rechnungsempfängers.
  • {wc_order.get_formatted_order_total} : Formatiertes Total der Bestellung.
  • {wc_order.get_formatted_shipping_address} : Formatierte Versandadresse.
  • {wc_order.get_formatted_shipping_full_name} : Formatierter Name des Empfängers.

5. Custom Fields

Eigene Felder (custom fields) einer WooCommerce-Bestellung können hinzugefügt werden indem das Tag {custom.[field_name]} verwendet wird, wobei [field_name] mit dem Namen des Custom Fields ersetzt werden muss.

6. Eigene Filter

Das Tag {filter.[filter_name]} kann verwendet werden um mittels eigenem Code Inhalt hinzuzufügen. [filter_name] muss mit dem Namen des Filters ersetzt werden.

Bsp.: Wenn das Tag {filter.my_custom_filter} hinzugefügt wird, kann folgender Code verwendet werden (z.B. in der Datei functions.php des Themes) um dynamisch Inhalt hinzuzufügen:

function my_custom_filter_fct($empty_str, $bill){

  $wc_order = $bill->get_wc_order(); // WC_Order object.

  return 'My custom text';

}

add_filter('my_custom_filter', 'my_custom_filter_fct', 10, 2);