72 — Email-Templates

Aktualisiert am 1. Juni 2026

72 — Email-Templates

PartnerDesk liefert eine Reihe von vordefinierten Email-Templates für die wichtigsten Lifecycle-Momente. Jedes Template ist mehrsprachig, individualisierbar und nutzt Tenant-Branding.

Liste der System-Templates

Auth-bezogen

Template Wann
partner_welcome Erfolgreiche Aktivierung des Partner-Accounts
partner_invite Admin lädt Partner per Mail ein
partner_password_reset Partner fordert Passwort-Reset an
admin_password_reset Tenant-Admin fordert Passwort-Reset an
partner_tenant_lookup „Sie haben mehrere Programme — hier alle Logins" (siehe …/166-v2-followups.md)

Auszahlungs-bezogen

Template Wann
payout_notification Payout wurde approved und steht zur Auszahlung
payout_paid Payout wurde tatsächlich bezahlt
payout_cancelled Payout wurde storniert

Notification-bezogen (Tenant-konfigurierbar)

Diese werden durch das Notification-System (siehe 70) ausgelöst und nutzen ein universelles notification.html.twig-Layout:

  • transaction.approved — neue Provision verfügbar.
  • commission.earned — Provision verdient.
  • partner.activated — willkommen.

Lifecycle-bezogen

  • tenant_welcome — neuer Tenant nach Signup.
  • subscription_trial_ending — 3 Tage vor Trial-Ende.
  • subscription_past_due — Abbuchung fehlgeschlagen.
  • subscription_canceled — Subscription gekündigt.
  • lead_referral_reward — Reward freigeschaltet (siehe 63).
  • referral_milestone — Empfehlungs-Meilenstein.

Newsletter-spezifisch

  • partner_newsletter_approved — Tenant hat den Partner-Newsletter freigegeben.
  • partner_newsletter_rejected — Tenant hat ihn abgelehnt (mit Begründung).

Anpassbar oder nicht?

Template Wer kann anpassen
Notification-Templates Tenant-Admin frei via Block-Editor
System-Auth-Templates Übersetzungen für language=en möglich, Inhalt fest
Lifecycle-Mails (Trial/Cancel) Inhalt fest, Branding (Logo, Color) automatisch

Aufbau der Templates

Alle Mails nutzen ein gemeinsames Layout _layout.html.twig:

  • Header: Tenant-Logo + 4-px Akzentstreifen in Brand-Color.
  • Card: 12-px Border-Radius mit Shadow für moderneres Look.
  • Content-Bereich: Template-spezifisch.
  • Footer: 3-Mode (siehe 71).

Mehrsprachigkeit

Alle Templates sind in DE und EN verfügbar. Die Sprache wird automatisch aus Partner.language gewählt — der Partner sieht die Mail in seiner präferierten Sprache.

Plus pro Tenant überschreibbarer Default via Tenant.defaultLocale.

Platzhalter

Templates können Platzhalter nutzen:

Platzhalter Inhalt
{partner.firstName} Vorname
{tenant.name} Tenant-Name
{tenant.companyName} Firmenname aus Legal-Settings
{payout.payoutNumber} Gutschriftnummer
{payout.grossAmount} Brutto-Betrag
{transaction.commissionAmount} Provisionsbetrag
{referral.threshold} Empfehlungs-Schwelle

Werden vor Versand automatisch ersetzt.

Email-Open + Click-Tracking

PartnerDesk trackt für jede Newsletter-Mail (siehe 177 — geplant):

  • Open über 1×1-Pixel-Beacon.
  • Click über Redirect-URL.

Stats sichtbar in der Notification-Detail-View (siehe 70).

Test-Send

In jedem Editor gibt es einen „Test an mich"-Button — sendet die Mail mit Sample-Platzhaltern an die Login-Email des Admins. Verifikation vor Massenversand.

DKIM/SPF/DMARC

Damit Mails zuverlässig zugestellt werden, sind diese DNS-Records nötig. Siehe 71.

Verwandte Kapitel


Technische Tiefen-Doku: ../042-email-password-reset.md, ../158-unified-notifications.md, ../119-i18n-coverage-bundle.md, ../170-mail-3-mode-footer.md