邀请其他用户（已注册或未注册）参与plone中的某个上下文。
项目描述
ftw.participation
使用 ftw.participation，用户可以邀请其他用户参与Plone安装的某个区域（例如工作区）。
具有特权的用户可以通过访问邀请视图并输入其他人员的电子邮件地址来邀请另一个人。该人员将收到一封包含到Plone安装的链接的电子邮件，其中他/她可以使用现有用户登录或创建一个新的用户。在邀请视图中，他/她现在可以接受或拒绝邀请。当邀请被接受时，用户将获得在邀请上下文中配置的权限。
邀请存储在Plone站点根的注释中的特殊容器中。
每个邀请都有自己的唯一ID，该ID用于发送给被邀请人的URL中。当通过此链接访问Plone站点时，邀请被分配给用户的会话。这就是为什么即使他/她可能以另一个用户ID登录，他/她也可以接受邀请。
激活
首先，您需要导入通用设置配置文件，该配置文件添加了一些操作、浏览器层和其他内容。
要在一个文件夹内容对象上激活参与，给它接口 ftw.participation.interfaces.IParticipationSupport，该接口启用了该上下文的参与。这在此上下文中添加了一个新的操作“管理参与者”，您可以邀请其他人。
被邀请的人将收到一封包含到平台链接的电子邮件，其中包含邀请ID。在注册/登录后，用户菜单中出现了一个新的操作“我的邀请”，用户可以在其中接受或拒绝邀请。
使用配额
提供接口 ftw.participation.interfaces.IParticipationQuotaSupport 将在模式中添加一个“最大参与者数量”字段，该字段定义可以邀请多少其他用户。
当设置了配额后，用户只能邀请这么多用户到这个上下文中。邀请表单中有一个验证器，确保不会超过配额。
当将配额设置为 5 时，只能邀请 4 个其他用户，因为第一个参与者是所有者，这通常已经存在。多次邀请同一用户也会多次计算，但邀请者可以在“我的邀请”视图中撤回邀请。
自定义电子邮件消息
如果有人被邀请到一个上下文，他会收到一封电子邮件通知。如果此人接受或拒绝邀请，邀请者也会通过电子邮件收到通知。这些电子邮件是包含 HTML 部分和平文回退部分的复合邮件。
可以通过覆盖翻译或通过在 ftw.participation.browser 中自定义邮件模板来自定义这些消息。
安装
只需将 ftw.participation 添加到您的 buildout 配置中的 eggs 中。
[instance]
eggs +=
ftw.participation
安装通用的设置配置文件。
事件
ftw.participation.events.IInvitationCreatedEvent：创建了一个邀请。
ftw.participation.events.IInvitationAcceptedEvent：接受了一个邀请。
ftw.participation.events.IInvitationRejectedEvent：拒绝了一个邀请。
ftw.participation.events.IInvitationRetractedEvent：撤回了一个邀请。
ftw.participation.events.IRolesChangedEvent：参与者的角色已更改。
ftw.participation.events.ILocalRoleRemoved：删除了一个本地角色。
链接
版权
本软件包的版权属于 4teamwork。
ftw.participation 是在 GNU 通用公共许可证，版本 2 下授权的。
变更日志
1.6.0 (2020-02-10)
为挂起的邀请添加提醒按钮。[2e12]
使用 unittest 而不是 unittest2。[busykoala]
1.5.3 (2017-06-24)
修复接受时出现的 AttributeError "get_target" 问题。[jone]
1.5.2 (2017-04-06)
修复了一个问题，即无法邀请一个用户 ID 不等于其登录名的现有用户。[elioschmutz]
1.5.1 (2017-03-02)
如果已安装“Products.PloneHotfix20160830”，则防止在更改参与者角色时崩溃。[mbaechtold]
如果安装了“ftw.activity” 1.x，则防止崩溃。[mbaechtold]
1.5.0 (2016-12-20)
改进 ftw.lawgiver 对翻译的角色的支持。[jone]
1.4.1 (2016-12-09)
修复活动渲染器中的 Unicode 错误。[jone]
1.4.0 (2016-11-30)
添加 ftw.activity 对参与事件的支持。[jone]
添加事件。[jone]
放弃对 Plone 4.1 和 4.2 的支持。[jone]
1.3.8 (2016-11-11)
更改 InvitationAccepted 文本的德语翻译。[raphael-s]
检查我们实际上在会话中是否有针对 id 的邀请。[tschanzt]
1.3.7 (2014-12-11)
修复 invite_participants 视图的条件。只有当两个选项（邀请电子邮件/成员）都禁用时才抛出 NotFound。[mathias.leimgruber]
1.3.6 (2014-12-08)
错误修正：将 email_from 作为字符串传递，而不是作为 email.header 实例。这修复了使用 Exchange 发送电子邮件的问题。[mathias.leimgruber]
如果禁用了内部用户和电子邮件邀请，则不显示邀请链接。[mathias.leimgruber]
1.3.5 (2014-09-15)
更新翻译。
1.3.4 (2014-08-07)
参与者：修复只读用户的表格布局。[jone]
参与者：隐藏没有角色的用户。这可能会发生在继承所有者时，因为继承的所有者角色已被删除。[jone]
1.3.3 (2014-08-07)
修复翻译中的某些语法错误。[tschanzt]
不要仅从地址编码名称。[tschanzt]
1.3.2 (2014-06-02)
在参与者选项卡上显示继承的角色。[mathias.leimgruber]
确保如果 IParticipationSupport 不活动，则参与选项卡没有操作控制元素。[mathias.leimgruber]
现在参与选项卡也可以在没有 IParticipationSupport 的情况下工作（只读）。[mathias.leimgruber]
1.3.1 (2014-03-14)
当禁用 allow_multiple_roles 时，默认不应将 Reader 角色添加到所选角色中，因为在这种情况下拥有多个角色没有意义。[jone]
1.3.0 (2014-03-14)
通过参与者视图添加更改角色的可能性。[mathias.leimgruber]
1.2.2 (2014-03-12)
修复在访问例如子站时的问题。[elioschmutz]
1.2.1 (2014-02-10)
正确编码邮件头。[tschanzt]
1.2.0 (2014-02-03)
使参与者视图对普通用户可用。当用户权限不足时，视图将移除管理界面（邀请/移除参与者）。参与者视图的链接仍然受保护，当需要时可以在集成级别放置链接。[jone]
添加法语和英语翻译。[jone]
更新德语翻译。[jone]
添加 dexterity 支持。[jone]
1.1.3 (2014-01-09)
所有者不能通过参与者视图被移除。[mathias.leimgruber]
1.1.2 (2013-09-16)
修复参与者视图中 unicode 解码错误。[jone]
1.1.1 (2013-08-28)
参与者视图：显示邀请者的全名而不是其 ID。[jone]
1.1 (2013-08-26)
在参与者视图中添加移除待处理邀请的可能性。[mathias.leimgruber]
修复参与者列表中的 UnicodeDecodeError。[mathias.leimgruber]
当禁用多角色时，将邀请表单中的角色字段设置为必填项。[mathias.leimgruber]
当配置单角色时，允许授予“Reader”角色。[jone]
配置是否可以在邀请表单中传递一个或多个角色。[mathias.leimgruber]
从参与者视图中删除不必要的信息，添加更好的描述。[mathias.leimgruber]
在覆盖层中打开邀请表单。[mathias.leimgruber]
在参与者概览中显示所有参与者以及待处理邀请。[mathias.leimgruber]
1.0.6 (2013-04-23)
修复翻译中的拼写错误。[Julian Infanger]
修复当匿名访问 @@invitations 时重定向到登录表单的问题。[jone]
1.0.5 (2013-03-27)
为参与者选项卡中的按钮添加了类。[Julian Infanger]
1.0.4 (2013-01-21)
使用 fieldsets 提供更好的 UI 体验。[mathias.leimgruber]
一些德语翻译。[mathias.leimgruber]
1.0.2 (2012-10-10)
修复选择和取消选择所有复选框的 JavaScript。[Julian Infanger]
为邀请视图中的按钮添加了默认类，以便在主题中进行样式化。[Julian Infanger]
通过电子邮件地址扩展邀请发送消息。[mathias.leimgruber]
接受视图：添加禁用重定向的可选参数。这在视图在其他进程（如注册）中被调用时是必要的。[jone]
修复重定向循环：在没有邀请时重定向到根。[jone]
1.0.1 (2012-03-05)
修复电子邮件头中的 unicode 错误。[jinfanger]
1.0b2 (2011-03-29)
修复 setters roles 方法，用于没有 roles 属性的旧邀请。[mathias.leimgruber]
1.0b1 (2011-02-10)
如果用户被邀请，则设置“came_from”。[mathias.leimgruber]
为邀请选择额外的角色。[mathias.leimgruber]
添加对无效邀请的条件。[mathias.leimgruber]
1.0a3 (2010-12-22)
修复在 participation.pt 中的问题 - 不要显示组。[mathias.leimgruber]
1.0a2 (2010-11-30)
加载 plone.app.workflow。[mathias.leimgruber]
1.0a1 (2010-10-26)
初始实现。[jbaumann]
