Addon 2x SparkPost Mail Transport for XF 2.3 - Thêm phương thức SparkPost để gửi mail cho XenForo 2.3 3.0.2

[LCB]

hêm tùy chọn vận chuyển thư SparkPost để gửi tất cả thư qua tài khoản SparkPost của bạn .

Đây là phiên bản tương thích với XF v2.3 của SparkPost Mail Transport cho XF 2.2 và đã được viết lại hoàn toàn để hỗ trợ Symfony Mail được sử dụng trong XF v2.3. Tiện ích bổ sung này có hỗ trợ xử lý email bị trả lại và email đã hủy đăng ký đầy đủ bằng API SparkPost Events - không yêu cầu hộp thư.

Khả năng tương thích

Phiên bản 3.x của tiện ích bổ sung này sẽ chỉ hoạt động trên XenForo 2.3.x - không cố cài đặt nó trên phiên bản cũ hơn.

Bạn có thể nâng cấp giữa các phiên bản addon sau khi đã nâng cấp phiên bản diễn đàn của mình.

Thiết lập

Nếu bạn chưa thực hiện, bạn sẽ cần cấu hình tên miền gửi cho diễn đàn của mình trong tài khoản SparkPost. Chúng tôi rất khuyến khích bạn cũng thiết lập tên miền trả lại mặc định.

Sau đó, bạn sẽ cần tạo khóa API với các quyền sau:

• Sự kiện Tìm kiếm: Chỉ đọc
• Truyền: Đọc/Ghi

Sau khi có khóa API, hãy thay đổi phương thức vận chuyển Email trong trang Tùy chọn Email thành "SparkPost" và dán khóa API vào hộp được cung cấp.

Cấu hình

Theo ảnh chụp màn hình ở trên - bạn có thể cấu hình một số tùy chọn vận chuyển khi cấu hình SparkPost.

• Click Tracking bật tính năng theo dõi nhấp chuột trên tất cả các liên kết trong email đã gửi
• Mở theo dõi thêm hình ảnh theo dõi vào tất cả các email được gửi để theo dõi lượt mở
• Chế độ kiểm tra sẽ thêm '.sink.sparkpostmail.com' vào tất cả địa chỉ email của người nhận để chúng tôi có thể kiểm tra giao tiếp với SparkPost mà không cần thực sự gửi bất kỳ email nào cho người nhận.

Lưu ý rằng bạn nên thiết lập một miền theo dõi tùy chỉnh trước khi bật theo dõi nhấp hoặc mở.

Có một trang cấu hình bổ sung dưới tiêu đề tùy chọn SparkPost Mail:

• Message Events Batch Size cho phép bạn cấu hình số lượng sự kiện mà hệ thống sẽ cố gắng truy xuất trong mỗi đợt. Nhìn chung, bạn không cần phải điều chỉnh điều này từ mặc định.

Kiểm tra

Bạn có thể kiểm tra chức năng của tiện ích bổ sung bằng hệ thống kiểm tra email XenForo tích hợp - hãy vào giao diện người dùng quản trị > Công cụ > Kiểm tra email gửi đi

Lưu ý lớp vận chuyển email phải là \Hampel\Symfony\Mailer\SparkPost\Transport\SparkPostApiTransport - nếu không phải thì bạn chưa cài đặt hoặc kích hoạt tiện ích bổ sung đúng cách. Ngoài ra

còn có một tiện ích kiểm tra thứ hai cho phép bạn chỉ định gửi email giao dịch hay không giao dịch. Vào giao diện người dùng quản trị > Công cụ > Kiểm tra SparkPost

Bật hộp kiểm để gửi email giao dịch - tắt để gửi email không giao dịch.

Trong mọi trường hợp, bạn nên kiểm tra tiêu đề của email bạn nhận được để xác minh rằng email đó thực sự được gửi qua SparkPost và để xác thực sự có/không có tiêu đề List-Unsubscribe (tiêu đề phải có đối với email không giao dịch và không có đối với email giao dịch).

Email giao dịch so với email không giao dịch

Email giao dịch là email tự động do hệ thống gửi để giao tiếp với khách hàng hoặc người dùng trang web về thông tin liên quan đến tài khoản hoặc cách họ sử dụng trang web của bạn. Chúng thường dành riêng cho một người dùng và thường quan trọng đối với người dùng để tiếp tục sử dụng trang web của bạn.

Ví dụ về email giao dịch là:

• email tạo và kích hoạt tài khoản
• đặt lại mật khẩu và xác thực hai yếu tố
• cảnh báo về bảo mật và tài khoản
• thông báo phát sinh từ các tùy chọn đăng ký hoặc cảnh báo mà người dùng đã chọn
• biên lai mua hàng và thông báo vận chuyển
• thông báo pháp lý và quan trọng của trang web

Email không giao dịch (còn được gọi là Email thương mại) thường được gửi đến một nhóm người dùng theo nhóm (mặc dù chúng cũng có thể được cá nhân hóa), chứa tài liệu quảng cáo hoặc tiếp thị. Thông thường chỉ những người dùng đã chọn nhận tài liệu như vậy từ bạn mới nhận được chúng.

Ví dụ về email không giao dịch là:

• bản tin
• chào bán
• cập nhật sản phẩm mới
• email được thiết kế để tăng sự tương tác và hướng dẫn sử dụng của người dùng, v.v.

Trang web SparkPost có nhiều thông tin hơn về email Giao dịch so với email Thương mại.

Theo mặc định, SparkPost đánh dấu tất cả các email được gửi qua API của họ là "không giao dịch". Tiện ích bổ sung này thay đổi hành vi đó và đặt tất cả các email diễn đàn thành giao dịch ngoại trừ:

• Email được gửi qua giao diện người dùng quản trị - Giao tiếp > Người dùng email
• Email chào mừng

Có hai điểm khác biệt đáng kể giữa email giao dịch và email không giao dịch được gửi qua SparkPost:

1. email không giao dịch có tiêu đề List-Unsubscribe được thêm vào (ghi đè tiêu đề được XenForo thêm vào) cho các yêu cầu hủy đăng ký bằng một cú nhấp chuột trong một số ứng dụng email. Email giao dịch không chứa tiêu đề này.
2. có danh sách ngăn chặn riêng cho email giao dịch và không giao dịch. Nếu ai đó hủy đăng ký nhận email không giao dịch, bạn vẫn có thể gửi cho họ các email giao dịch quan trọng như đăng ký diễn đàn và đặt lại mật khẩu. Tuy nhiên, nếu ai đó hủy đăng ký hoặc chặn bạn khỏi email giao dịch, bạn nên vô hiệu hóa tài khoản của họ, vì bạn sẽ không thể gửi email cho họ về thông tin diễn đàn quan trọng nữa.

Xem bên dưới để biết thêm thông tin về danh sách ngăn chặn.

Xử lý trả lại và hủy đăng ký Xử

lý trả lại và hủy đăng ký tự động trong tiện ích bổ sung sẽ kiểm tra tất cả các cuộc gọi trả lại cứng và mềm tiêu chuẩn có thể nhận được do gửi email. Những tin nhắn trả lại này được SparkPost chặn và sau đó chúng tôi có thể thực hiện truy vấn để xác định hành động cần thực hiện sau đó.

Bạn KHÔNG cần phải cấu hình "Địa chỉ email trả lại" (trừ khi bạn không thiết lập tên miền trả lại mặc định) hoặc "Địa chỉ email hủy đăng ký" trong tùy chọn email của mình. Bạn cũng không cần phải bật tùy chọn "Trình xử lý email tự động" hoặc "Bật trình xử lý email tự động" - SparkPost không chuyển tiếp email trả lại hoặc thông báo hủy đăng ký qua email - chúng tôi truy vấn API của họ để xác định thông tin trả lại/hủy đăng ký.

Xử lý hủy đăng ký phức tạp hơn một chút so với hệ thống XenForo tiêu chuẩn - vì chúng tôi phân biệt giữa email giao dịch và không giao dịch và xử lý chúng theo cách khác nhau.

Lưu ý rằng nếu chúng tôi nhận được email trả lại cứng đối với email giao dịch - tài khoản người dùng sẽ bị vô hiệu hóa để ngăn không cho các email tiếp theo được gửi đi.

Danh sách ngăn chặn

Khi SparkPost nhận được email trả lại cứng từ email đã gửi hoặc yêu cầu Hủy đăng ký danh sách, SparkPost sẽ đưa địa chỉ email đó vào danh sách ngăn chặn, nghĩa là bạn không thể gửi email cho người dùng đó nữa. Điều này được áp dụng để bảo vệ uy tín gửi email của bạn - vì việc tiếp tục gửi email đến địa chỉ không hợp lệ hoặc không đăng ký là dấu hiệu thư rác có thể khiến bạn bị một số nhà cung cấp dịch vụ email chặn.

Điều cần lưu ý là nếu tài khoản diễn đàn của người dùng bị vô hiệu hóa do email trả lại, thì rất có thể họ cũng sẽ được thêm vào danh sách ngăn chặn của SparkPost. Nếu bạn kích hoạt lại tài khoản của họ mà không thay đổi địa chỉ email, thì họ có thể không nhận được bất kỳ email nào từ trang web của bạn vì việc gửi email cho họ đã bị SparkPost chặn.

Nếu bạn chắc chắn rằng email hiện hợp lệ, bạn có thể xóa họ khỏi danh sách ngăn chặn của SparkPost - trong bảng điều khiển quản trị SparkPost - https://app.sparkpost.com/lists/suppressions .

Chỉ cần nhớ rằng có hai danh sách riêng biệt - một danh sách dành cho email giao dịch và một danh sách dành cho email không giao dịch.