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