- XF Compatibility
- 2.3.x
- 2.2.x
- Kurzbeschreibung
- Add SparkPost mail transport for seamless email sending with full support for bounced and unsubscribed emails via XenForo's built-in addon, including advanced click tracking and open tracking features. Setup involves configuring your SparkPost account and API key in the Email options page. Test functionality using XenForo's test system to ensure proper integration.
Fügt eine Option für den SparkPost-Sendernutzungszusatz hinzu, damit alle E-Mails über Ihr System gesendet werden.SparkPostKonto.
Dieser Addon hat Unterstützung für vollständig abgeschickte Emails und abonnementschlagteile mit der SparkPost Events-API - keine Postfach erforderlich.EinrichtungWenn Sie noch nicht getan haben, eine Sendear Dienstleister für Ihr Forum im SparkPost-Konto zu konfigurieren. Es ist empfohlen, auch ein Standard-Abbruch-Dienstleister einzustellen.
Sie werden dann einen API-Schlüssel mit den folgenden Berechtigungen erstellen:
2. Notieren Sie sich bitte, dass der Email-Versand-Klasse \SwiftSparkPost\Transport zugewiesen sein sollte - falls dies nicht der Fall ist, haben Sie das Addon möglicherweise nicht installiert oder aktiviert.
3. Es gibt auch eine zweite Testfunktion, die es Ihnen ermöglicht, auszusuchen, ob Sie transaktions- oder nicht-transaktionsbezogene E-Mails senden möchten. Gehe im Admin UI > Werkzeuge > Test SparkPost hin.
4. Aktivieren Sie das Kontrollkästchen für transaktionale E-Mails - deaktivieren Sie es für nicht-transaktionalen.
5. In allen Fällen sollten Sie die Headers der erhaltenen Emails überprüfen, um sicherzustellen, dass sie tatsächlich von SparkPost gesendet wurden und um den Vorkommen/Entfernen des List-Unsubscribe-Headers zu bestätigen.Transaktionsfreundliche vs Transaktionale EmailsTransaktionalE-Mails sind automatisierte E-Mails, die von einem System dem Kunden oder Nutzer über Informationen versendet werden, die mit deren Konto oder der Nutzung deines Sites zusammenhängen. Sie sind typischerweise spezifisch für einen einzelnen Benutzer und sind in der Regel wichtig für den fortlaufenden Gebrauch deines Sites.
Beispiele für Transaktions-E-Mails sind:
Beispiele für nicht transaktionale E-Mails sind:
Standardmäßig markiert SparkPost alle Emails, die über ihren API gesendet werden, als "nicht-transaktional". Dieser Addon ändert das Verhalten und setzt alle Forum-E-Mails als transaktional fest, mit Ausnahme von:
Sie müssen keine "Abbonierungsabbruchadresse" (außer Sie haben keinen Standardabbonierungsdomänenbereich nicht eingerichtet) oder "Abonnementabbauadresse" in Ihren E-Mail-Einstellungen konfigurieren. Sie müssen auch die "Automatisierte Emailverwaltung" oder "Automatisierte Emailverwaltung aktivieren" Optionen nicht aktivieren - SparkPost sendet keine Rückkehr- oder Abonnementabbauanfragen per E-Mail, sondern wir verwenden ihre API, um Rückkehr-/Abonnementabbauinformation zu abrufen.
Die Abonnementabbauverwaltung ist etwas komplexer als der Standard-XenForo-System - da wir zwischen transaktionalen und nicht-transaktionalen Emails unterscheiden und sie unterschiedlich behandeln.
Hinweis: Wenn wir für transaktionale Emails eine harte Rückkehr erhalten, wird das Konto des Nutzers deaktiviert, um weitere Emails zu verhindern.SperrelistenWenn SparkPost eine Hard-Bounce von einer gesendeten Email oder einen List-Unsubscribe-Anfrage erhält, fügt es diese E-Mail-Adresse auf einer Verboten-Liste hinzu, was bedeutet, dass Sie nicht mehr an diesen Nutzer schicken können. Dies ist in der Absicht, Ihre Sendepredigt zu schützen - da die Fortsetzung der Schickung an eine ungültige oder abonniertem Adresse ein Spam-Signal darstellt, das Sie möglicherweise von einigen E-Mail-Diensten gesperrt sehen könnte.
Das zu beachten ist, dass wenn ein Nutzer-Forum-Konto wegen einer Bounce-E-Mail deaktiviert wurde, es wahrscheinlich auch auf der SparkPost-Verboten-Liste hinzugetragen wurde. Wenn Sie sein Konto wieder aktivieren ohne das Email-Adresse zu ändern, können sie möglicherweise keine Emails von Ihrem Site erhalten, da Sendungen an ihn durch SparkPost blockiert sind.
Wenn Sie sicher sind, dass die Email jetzt gültig ist, entfernen Sie sie von der SparkPost-Verboten-Liste - im SparkPost-Betriebskonsole.https://app.sparkpost.com/lists/suppressionsDenken Sie nur daran, dass es zwei getrennte Listen gibt - eine für transaktionale E-Mails und eine für nicht-transaktionale E-Mails.
Dieser Addon hat Unterstützung für vollständig abgeschickte Emails und abonnementschlagteile mit der SparkPost Events-API - keine Postfach erforderlich.EinrichtungWenn Sie noch nicht getan haben, eine Sendear Dienstleister für Ihr Forum im SparkPost-Konto zu konfigurieren. Es ist empfohlen, auch ein Standard-Abbruch-Dienstleister einzustellen.
Sie werden dann einen API-Schlüssel mit den folgenden Berechtigungen erstellen:
- *]Nachrichtenevents: Nur lesenÜbertragungen: Lesen/Schreiben*Nach der aktuellen Version wird dir die Berechtigung zum Senden über das SMTP-API-Endpoint gewährt, aber dies istnichterforderlich - diese Anweisungen werden in einer zukünftigen Version entfernt.)
- *[]Click Trackingaktiviert Clicktracking auf alle Links in Emails
- Open Trackingfügt eine Tracking-Bild zu allen versand Emails hinzu, um die Öffnungen zu verfolgen
- Nachrichtenevents Batchgrößeerlaubt Ihnen die Anzahl der Ereignisse, die das System pro Batch anfordern soll. Sie sollten normalerweise diese Einstellung vom Standard nicht ändern.
- Test-Modusappend '.sink.sparkpostmail.com' zu allen Empfänger-E-Mail-Adressen, damit wir mit SparkPost ohne tatsächlich an die Empfänger zu senden Kommunikation testen können.
2. Notieren Sie sich bitte, dass der Email-Versand-Klasse \SwiftSparkPost\Transport zugewiesen sein sollte - falls dies nicht der Fall ist, haben Sie das Addon möglicherweise nicht installiert oder aktiviert.
3. Es gibt auch eine zweite Testfunktion, die es Ihnen ermöglicht, auszusuchen, ob Sie transaktions- oder nicht-transaktionsbezogene E-Mails senden möchten. Gehe im Admin UI > Werkzeuge > Test SparkPost hin.
4. Aktivieren Sie das Kontrollkästchen für transaktionale E-Mails - deaktivieren Sie es für nicht-transaktionalen.
5. In allen Fällen sollten Sie die Headers der erhaltenen Emails überprüfen, um sicherzustellen, dass sie tatsächlich von SparkPost gesendet wurden und um den Vorkommen/Entfernen des List-Unsubscribe-Headers zu bestätigen.Transaktionsfreundliche vs Transaktionale EmailsTransaktionalE-Mails sind automatisierte E-Mails, die von einem System dem Kunden oder Nutzer über Informationen versendet werden, die mit deren Konto oder der Nutzung deines Sites zusammenhängen. Sie sind typischerweise spezifisch für einen einzelnen Benutzer und sind in der Regel wichtig für den fortlaufenden Gebrauch deines Sites.
Beispiele für Transaktions-E-Mails sind:
- *kontoerstellung und Aktivierungse-Mails*vorgabepasswords und Zwei-Faktor-Autentisierung*sicherheits- und kontoanzeigeprozesse*]benachrichtigungen aus den Abonnements oder der Benutzeroptionen, die der Nutzer gewählt hat*käuferschein und Lieferbenachrichtigungen*]rechtliche und wichtige Anmeldeinformationen
Beispiele für nicht transaktionale E-Mails sind:
- Newsletter*vorratsangebote*nieuwe productupdates*e-mail designiert zur Steigerung der Nutzerbindung und Onboardeinsatz
Standardmäßig markiert SparkPost alle Emails, die über ihren API gesendet werden, als "nicht-transaktional". Dieser Addon ändert das Verhalten und setzt alle Forum-E-Mails als transaktional fest, mit Ausnahme von:
- [E-Mails gesendet über das Admin-UI - Kommunikation > E-Mail an Nutzer[Willkommensmails
- nicht-transactionale Emails haben den Header List-Unsubscribe hinzugefügt (überschreibt den Header, der von XenForo hinzugefügt wird), um eine ein-klick-Abskillung in einigen E-Mail-Anwendungen zu ermöglichen. Transactionale Emails enthalten diesen Header nicht.*]Es gibt getrennte Verzögerungslisten für transaktionale und nicht-transaktionale E-Mails. Wenn jemand die nicht-transaktionalen E-Mails abonniert, kannst du ihnen trotzdem wichtige transaktionale Emails wie Forumabonnements und Passwortwiederherstellungen senden. Allerdings wenn jemand die transaktionalen E-Mails abboniert oder sie blockiert, solltest du deren Konto deaktivieren, da du dann nicht mehr an sie über wichtiges Foruminformation schreiben kannst.
Sie müssen keine "Abbonierungsabbruchadresse" (außer Sie haben keinen Standardabbonierungsdomänenbereich nicht eingerichtet) oder "Abonnementabbauadresse" in Ihren E-Mail-Einstellungen konfigurieren. Sie müssen auch die "Automatisierte Emailverwaltung" oder "Automatisierte Emailverwaltung aktivieren" Optionen nicht aktivieren - SparkPost sendet keine Rückkehr- oder Abonnementabbauanfragen per E-Mail, sondern wir verwenden ihre API, um Rückkehr-/Abonnementabbauinformation zu abrufen.
Die Abonnementabbauverwaltung ist etwas komplexer als der Standard-XenForo-System - da wir zwischen transaktionalen und nicht-transaktionalen Emails unterscheiden und sie unterschiedlich behandeln.
Hinweis: Wenn wir für transaktionale Emails eine harte Rückkehr erhalten, wird das Konto des Nutzers deaktiviert, um weitere Emails zu verhindern.SperrelistenWenn SparkPost eine Hard-Bounce von einer gesendeten Email oder einen List-Unsubscribe-Anfrage erhält, fügt es diese E-Mail-Adresse auf einer Verboten-Liste hinzu, was bedeutet, dass Sie nicht mehr an diesen Nutzer schicken können. Dies ist in der Absicht, Ihre Sendepredigt zu schützen - da die Fortsetzung der Schickung an eine ungültige oder abonniertem Adresse ein Spam-Signal darstellt, das Sie möglicherweise von einigen E-Mail-Diensten gesperrt sehen könnte.
Das zu beachten ist, dass wenn ein Nutzer-Forum-Konto wegen einer Bounce-E-Mail deaktiviert wurde, es wahrscheinlich auch auf der SparkPost-Verboten-Liste hinzugetragen wurde. Wenn Sie sein Konto wieder aktivieren ohne das Email-Adresse zu ändern, können sie möglicherweise keine Emails von Ihrem Site erhalten, da Sendungen an ihn durch SparkPost blockiert sind.
Wenn Sie sicher sind, dass die Email jetzt gültig ist, entfernen Sie sie von der SparkPost-Verboten-Liste - im SparkPost-Betriebskonsole.https://app.sparkpost.com/lists/suppressionsDenken Sie nur daran, dass es zwei getrennte Listen gibt - eine für transaktionale E-Mails und eine für nicht-transaktionale E-Mails.