配置活动摘要邮件

[Discourse]

This guide explains how to configure and manage activity summary emails in Discourse, including user and admin options, customization, and troubleshooting.

Required user level: Administrator

Activity summary emails (formerly known as digest emails) are automated messages sent to forum members who haven’t visited in a specific period. These emails contain a collection of popular content since the user’s last visit, aiming to re-engage inactive members.

Understanding activity summary emails

Activity summary emails include:

1. Activity statistics to emphasize engagement levels
2. A list of popular topics
3. A selection of popular posts
4. Links to topics that are “New for you”

Here’s an example of what an activity summary email looks like:

The system sends these emails only when a member hasn’t visited the forum or received an email from the forum for a minimum period.

Configuring user options

Users can customize their activity summary email preferences:

1. Go to user preferences
2. Navigate to the “Emails” tab
3. Adjust the “Activity Summary” frequency

Available frequency options are:

• Never
• Every 30 minutes
• Every hour
• Daily
• Weekly
• Every month
• Every six months

The system won’t send activity summaries to silenced or suspended members.

Setting up admin options

Default user settings

To configure default settings for new users:

1. Go to Admin / Settings
2. Search for “digest”
3. Adjust the following settings:
   • default email digest frequency
   • default include tl0 in digests

Here’s what these settings look like in the admin panel:

Site settings

To customize activity summary emails:

1. Go to Admin / Settings
2. Search for “digest”
3. Modify the following settings as needed:
   • digest logo url
   • digest min excerpt length
   • digest topics
   • digest posts
   • digest other topics
   • suppress digest email after days
   • digest suppress categories
   • show topic featured link in digest
   • disable digest emails

Customizing email appearance

To customize the email’s appearance:

1. Go to Admin / Settings
2. Adjust the following settings:
   • email accent bg color
   • email accent fg color

For more advanced customization, refer to the guide on customizing email templates.

Adding custom content

To add custom text to activity summary emails:

1. Go to Admin / Customize / Text Content
2. Search for user_notifications.digest.custom
3. Edit the desired customization keys

Understanding the list of popular topics

Popular topics for digests are extracted from /top topics with certain rules:

• individual user permissions to view that topic
  • topics from private categories the user does not have access to will not be sent
• topic notification level
  • the topic shouldn’t be muted for that user
• user who created that topic must have trust level greater than 0
  • this default can be overridden (see below)
• topic must be created after the user was last emailed
• topic should not be from a muted category
• topic should not be closed
• topic should not be archived

Testing activity summary emails

To preview an activity summary email:

1. Go to Admin / Emails
2. Click on “Preview Summary”
3. Set the Last Seen User date
4. Enter a username to use for the summary email.
5. Choose to view on-site or send to an email address

Here’s what the preview option looks like in the admin panel:

Note that for the summary email to populate, it will need to contain at least some activity since the last seen user date, so you may need to set this date back several weeks if your site does not have a lot of activity.

Troubleshooting

A user might not receive activity summary emails if:

• They have been active on the site recently
• They have unsubscribed from activity summary emails
• A summary has been sent recently
• Their email has been bouncing
• They’re inactive, suspended, or staged
• They were created via sync_sso and have never visited the forum

Checking email sending dates

To check when an email was last sent to a user:

• Check the last_emailed_at column in the users table
• Check the digest_attempted_at column in the user_stats table

Frequestly asked questions

Is there a place to see statistics or a report of the amount of e-mails sent?

You can see the list of sent emails from your site’s Admin / Emails / Sent page. You can see the total number of emails sent per day with the Emails Sent dashboard report (found by clicking the Reports link from your admin dashboard.)

For a detailed report of emails sent per type of email, you can query the email_logs table with the Data Explorer plugin.

For self hosted sites, you can also usually see reports at your transactional mail provider, which will also include delivery status, bounces, etc.

What are the technical requirements and the costs associated with sending email to forum members?

For self hosted sites, an account with a transactional email provider like Sendgrid needed. Take a look at the email provider recommendations.

Email delivery is included with all of our hosting plans. If you go with our hosting, everything to do with sending and receiving emails on your Discourse site is configured for you.

Additional resources

• Managing Activity Summary email subscriptions
• Customizing the Discourse outer email template
• Adding custom content to summary emails

Last edited by @SaraDev 2025-06-11T20:46:13Z

Last checked by @hugh 2024-08-02T04:11:44Z

Check document

Perform check on document:

[bayardo.rivas]

我已经配置了几个类别，并且有一个组拥有这些类别的权限。我希望这些组的成员仅接收来自这些特定类别的活动（帖子/回复）的通知和电子邮件摘要/回顾。目前，用户会收到来自其他类别的活动通知。

感谢任何建议。

[Moin]

@Discourse

该系统仅在会员在最短时间内未访问论坛或未收到论坛电子邮件时发送这些电子邮件。

我认为这在 Activity Summary not sent if other emails are sent - #25 by zogstrip 中已更改

@Discourse

添加自定义内容

要在活动摘要电子邮件中添加自定义文本：

1. 转到 管理员 / 自定义 / 文本内容

此说明无助于我导航到 /admin/customize/site_texts。“文本内容”似乎既不在 URL 中，也不在管理员侧边栏中，也不在旧的管理员菜单中。

[bayardo.rivas]

我仍然不明白如何配置活动摘要电子邮件。我想按组向用户发送电子邮件。例如，我有 Category-A 和 Category-B，我在 Category-A 和 Category-B 中分别拥有 GroupA 和 GroupB 的权限。我理想的电子邮件摘要是 GroupA 中的用户仅接收 Category-A 中活动的摘要和帖子，GroupB 中的用户也是如此。

[tobiaseigen]

@bayardo.rivas

我理想中的电子邮件摘要是，GroupA 的用户仅接收 Category-A 中的活动和帖子的摘要，GroupB 的用户也是如此。

您的网站上不是这样吗？看起来与此不同吗？

[ToddZ]

@Moin

@Discourse

系统仅在会员在最短时间内未访问论坛或未收到论坛邮件时发送这些邮件。

我认为这在 Activity Summary not sent if other emails are sent - #25 by zogstrip 中已更改。

是的，这部分应该更新，因为我们已经同意，“收到通知不应算作阻止您收到活动摘要电子邮件的访问”，并且已经实施了修复程序来解决这个问题。

[tknospdr (David Muszynski)]

我只是想在这里弄清楚一些事情。
既然您必须输入一个用户才能在网站上看到摘要预览，我猜 Discourse 已经足够智能，知道如果用户没有访问某个类别的权限，就不会将该类别的帖子发送给他们，对吧？
所以，将类别添加到“摘要抑制类别”设置中的唯一原因就是，如果您永远不希望来自此类别中的任何帖子发送给任何人，对吧？