跳转到主要内容

Trac插件,允许通过电子邮件通知wiki页面上的更改

项目描述

Trac WikiNotification是一个插件,允许用户(即使是匿名用户,只要设置了电子邮件)选择他们希望在更改时通过电子邮件通知的wiki页面。

注意:更新wiki页面的用户不会收到其自身更改的通知。

启用插件

就像这样简单:

[components]
wikinotification.* = enabled

smtp_enabled必须在通知配置部分中启用。

可用配置选项

以下是在 trac.ini 中可用的选项,您可以在 wiki-notification 下包含它们。您也可以通过网页管理界面进行配置。

配置设置

默认值

说明

redirect_time

5(秒)

默认的重定向时间,用于监视/取消监视维基页面。此值也可以针对每个用户进行定义,即用户可以自己配置此值。

smtp_always_bcc

以逗号分隔的电子邮件地址列表,始终发送通知到这些地址,地址不会公开显示(Bcc:)。

smtp_always_cc

以逗号分隔的电子邮件地址列表,始终发送通知到这些地址,地址可以被所有收件人看到(Cc:)。

from_email

trac.wiki@localhost

用于通知电子邮件的发送者地址。

from_name

用于通知电子邮件的发送者名称。默认为项目名称。

use_public_cc

收件人可以看到其他Cc收件人的电子邮件地址。如果禁用此选项(默认值),收件人将被放在Bcc中。

attach_diff

将更改差异作为附件发送,而不是在电子邮件文本主体中发送。

subject_template

$prefix $pagename $action

用于获取通知主题的Genshi文本模板片段。

banned_addresses

以逗号分隔的电子邮件地址列表,永远不向这些地址发送通知。

如果您想覆盖这些设置,则可以像以下示例那样包含它

[wiki-notification]
redirect_time = 5
smtp_always_bcc = someone@somedomain, another.one@somedomain
smtp_always_cc = someone.else@somedomain
from_email = trac.wiki@localhost
from_name = Custom Name
use_public_cc = false
attach_diff = true
subject_template = Foo $prefix $pagename $action
banned_addresses = banned.user1@somedomain, banned.user2@somedomain

下载和安装

运行以下命令安装此插件

> sudo pip install TracWikiNotification

附加说明(来自用户输入)

  • pip 是在命令行(在Linux上)中运行的,而不是在Python内部。

  • 安装Trac的任何插件后,您需要重新启动Apache才能看到它(不是所有对 trac.ini 的更改都需要重启,但添加插件需要)。

  • 请确保将新插件添加到 trac.ini

    [components]
    wikinotification.* = enabled
  • 还应注意的是,维基通知的 trac.ini 配置应如下所示

    [wiki-notification]
    smtp_always_cc = someone@somedomain
    from_email = trac.wiki@localhost
  • 另请注意:用户永远不会收到自己维基修改的通知(这在测试插件时有点棘手 :))

  • 请注意,较旧版本的插件可能设置了类似于 subject_template = $prefix $page.name $action 的 subject_template 配置值。这将导致‘UndefinedError: “page” not defined’错误。请使用 $pagename 代替 $page.name

调整/自定义通知电子邮件模板

如果您愿意,可以调整发送给用户的通知电子邮件模板。

wiki_notification_email_template.txt 文件复制到您的Trac环境 templates/ 子目录,并根据需要调整它。

请确保您已阅读 Genshi文本模板 文档,以防止破坏该模板中的任何逻辑。

项目详细信息


下载文件

下载您平台对应的文件。如果您不确定选择哪个,请了解更多关于安装包的信息

源分发

TracWikiNotification-0.4.3.tar.gz (14.2 kB 查看哈希值)

上传时间

构建分发

TracWikiNotification-0.4.3-py2-none-any.whl (22.0 kB 查看哈希值)

上传时间 Python 2

由以下支持