跳转到主要内容

提供contact-contenttype

项目描述

简介

本软件包提供contact contenttype。

安装

将软件包作为依赖项添加到您的setup.py

setup(...
      install_requires=[
        'ftw.contacts',
      ])

或您的buildout配置

[instance]
eggs += ftw.contacts

并重新运行buildout。

对于Plone 4.x,请添加 eggs += ftw.contacts [‘plone4’] 选项。

安装通用设置配置文件。

功能概述

  • 具有ajax搜索功能的联系目录

  • 联系内容类型

  • 联系人的KML表示

  • 联系人的vCard表示

  • 如果您安装了[zipexport]附加组件,请与ftw.zipexport集成

  • 如果您安装了[simplelayout]附加组件,请与ftw.simplelayout集成

  • 与LDAP服务的联系人同步

外观

ftw.contacts软件包提供了一个直观的联系人目录…

https://raw.github.com/4teamwork/ftw.contacts/master/docs/images/contactdirectory.png

… 具有详细的联系人视图。

https://raw.github.com/4teamwork/ftw.contacts/master/docs/images/contact.png

工作原理

联系文件夹

这是一个dexterity内容类型,用作要列出的联系人的容器。

安装ftw.contacts软件包后,您可以将Contactfolder添加到您的Plone站点。

Contactfolder提供了所有可用联系人的直观概览。默认情况下,将显示前20个联系人,您可以通过单击列表末尾的“加载更多”按钮来加载更多联系人。

字母过滤器允许用户快速查找联系人。此外,还可以通过搜索字段查找联系人。

所有请求都是异步的,并与大量联系人一起工作。

联系人

这是一个灵活的内容类型,可以添加到 联系人文件夹 中。

联系人 列出了联系人的所有可用属性。

您还有可能在一个地图上显示联系人的位置。

此外,您还可以下载联系人的 KML 表示形式或 vCard 表示形式。

与ftw.simplelayout集成

这是一个用于 ftw.simplelayout 的插件。请确保在安装此插件之前,您已经在您的 Plone 站点上安装了 ftw.simplelayout

将 simplelayout 扩展添加到您的 egg 中

[instance]
eggs += ftw.contacts [simplelayout]

运行 buildout 并安装 ftw.contacts.simplelayout:default 配置文件

您将获得一个新的内容类型 MemberBlock,该类型在内容页中可用。

如果您不了解 ftw.simplelayout,请阅读 https://github.com/4teamwork/ftw.simplelayout

MemberBlock

成员块将联系人与简单布局页面连接起来。您只需定义一次联系人属性,然后可以通过成员块重复使用它们。

与ftw.geo集成

将 geo 扩展添加到您的 egg 中

[instance]
eggs += ftw.contacts [geo]

运行 buildout 并安装 ftw.contacts.geo:default 配置文件

安装 geo 扩展后,如果输入了有效的地址,您将在每个联系人类型上看到地图层。

如果您不了解 ftw.geo,请阅读 https://github.com/4teamwork/ftw.geo

通过LDAP同步联系人

同步是通过 sync_contacts 入口执行的。同步的配置如下

  • 要执行同步的 Plone 网站:参数 -p - 只有在存在多个网站时才需要。

  • 联系人文件夹的路径:在注册表中配置为 IContactsSettings.contacts_path

  • LDAP 属性到联系人字段的映射以及用作 ID 的字段:注册一个 ILDAPAttributeMapper 实用工具。默认值:DefaultLDAPAttributeMapper

  • acl_users 内部的 LDAP 插件 ID:在注册表中配置为 IContactsSettings.ldap_plugin_id

  • 联系人的基础 DN。参数 -b - 默认为插件中配置的基础 DN

  • 仅获取联系人的 LDAP 查询过滤器。参数 -f - 默认为 (objectClass=*)

从多个LDAP源同步联系人

要同步多个来源(acl_users 中的多个插件),需要一个配置文件。通过 -c 参数传递文件的路径。

每个来源仅需要的属性是 ldap_plugin_id`。默认情况下,base_dn 将默认为插件的基础 DN,filter 将默认为 (objectClass=*)

为了避免 ID 冲突,可以指定一个 userid_prefix。然后,前缀将应用于此来源的所有联系人。当现有网站想要添加第二个来源但已经同步了联系人时,则应仅指定新来源的前缀。使用此方法,现有来源的 ID 不会更改,并且已同步的联系人仍然可以被识别。这对于客户可能已经向联系人添加了附加信息(例如图片)非常重要。如果 ID 发生变化,则同步将无法识别它们,并可能将它们删除!

作用域可以设置为:SCOPE_BASESCOPE_ONELEVELSCOPE_SUBTREESCOPE_SUBORDINATE

[
    {
        "ldap_plugin_id": "intern",
        "base_dn": "ou=Employees,ou=Users,dc=4teamwork,dc=ch",
        "filter": "(objectClass=*)"
    },
    {
        "ldap_plugin_id": "extern",
        "userid_prefix": "extern-",
        "base_dn": "ou=Customers,ou=Users,dc=4teamwork,dc=ch",
        "filter": "(objectClass=*)",
        "scope": "SCOPE_ONELEVEL"
    }
]

兼容性

Plone 4.3 和 5.1

https://jenkins.4teamwork.ch/job/ftw.contacts-master-test-plone-4.3.x.cfg/badge/icon

变更日志

1.11.1 (2023-01-18)

  • 修复在删除成员块后未进行垃圾回收时,在联系人详细信息视图上get_membership渲染的问题。[mathias.leimgruber]

1.11.0 (2021-07-29)

  • 实现配置vcard编码的选项。[mathias.leimgruber]

  • 将默认编码更改为Windows-1252以支持Outlook。[mathias.leimgruber]

1.10.5 (2020-11-25)

  • 修复从版本1.10.3升级时造成的影响,该版本移除了所有行为。[mathias.leimgruber]

警告:请不要升级到版本1.10.3,它很可能破坏MemberBlock。[mathias.leimgruber]

1.10.4 (2020-11-20)

  • 在联系人上始终返回False给getIcon。[mathias.leimgruber]

1.10.3 (2020-10-02)

  • 删除Plone 5中的过时行为。[Nachtalb]

  • 修复包含成员块的损坏内容页面。[Nachtalb]

1.10.2 (2020-08-04)

  • 修复metadata.xml中的contenttree依赖关系,因为它已从版本1.4.0中删除。[mathias.leimgruber]

  • 从Plone 5配置文件中删除过时的行为。[Nachtalb]

1.10.1 (2020-02-21)

  • 去除ldap同步的值。[Nachtalb]

1.10.0 (2020-02-20)

  • 支持联系人同步的ldap范围属性。[Nachtalb]

1.9.6 (2020-02-14)

  • 修复i18n构建。[djowett-ftw]

  • 修复在重命名联系人时尝试设置标题字段导致的object_rename错误。[djowett-ftw]

  • 改进README中的英文,并明确Plone的支持版本(4.3和5.1)。[djowett-ftw]

1.9.5 (2020-01-31)

  • 修复删除spamProtect使用的问题。[mathias.leimgruber]

1.9.4 (2020-01-31)

  • 移除spamProtect脚本的使用,因为它在Plone 5中不再可用。[mathias.leimgruber]

1.9.3 (2020-01-09)

  • 将ftw.contacts portal_types翻译添加到plone域。[tinagerber]

1.9.2 (2019-12-14)

  • 提供预编译包。[tinagerber]

1.9.1 (2019-11-29)

  • 使用unittest而不是unittest2。[jone]

1.9.0 (2019-06-12)

  • 添加Plone 5.1支持。[busykoala]

1.8.0 (2019-04-01)

  • 在同步脚本中设置安全。[mbaechtold]

  • 在同步脚本中触发不同的事件。[mbaechtold]

1.7.2 (2019-03-13)

  • 修复“显示更多”按钮错误隐藏的问题。[mbaechtold]

1.7.1 (2019-01-22)

  • 修复图像同步问题。[mbaechtold]

1.7.0 (2019-01-21)

  • 在同步期间支持额外的DX行为。[mbaechtold]

1.6.1 (2018-01-31)

  • 修复联系人同步中的重音id和组对象。[lknoepfel]

1.6.0 (2018-01-31)

  • 将联系人同步扩展到处理多个ldap源。[lknoepfel]

  • 将Plone站点可添加类型的配置移至simplelayout配置文件。[raphael-s]

1.5.3 (2017-10-12)

  • 在联系人模板中在地址和城市之间添加逗号。[raphael-s]

1.5.2 (2017-09-29)

  • 修复联系人摘要视图。[Kevin Bieri]

1.5.1 (2017-08-04)

  • 出于一致性原因,在成员块中为电子邮件字段添加标签。[Kevin Bieri]

  • 使成员块更加健壮。[mbaechtold]

  • 改进联系人详细信息视图。[mbaechtold]

1.5.0 (2017-05-15)

  • 为隐藏列表视图中的联系人图像添加联系人文件夹设置。[raphael-s]

1.4.8 (2017-04-13)

  • 修复n行行分布。[Kevin Bieri]

  • 在卡片中使用联系人标题的链接。[Kevin Bieri]

1.4.7 (2017-04-07)

  • 修复javascript计算的行分布问题。[Kevin Bieri]

1.4.6 (2017-03-07)

  • 默认在Plone站点上可添加MemberBlock。[raphael-s]

1.4.5 (2017-02-28)

  • 为loadmore按钮使用主色调。[Kevin Bieri]

1.4.4 (2017-02-01)

  • 按容器标题对成员资格按字母顺序排序(在联系人详细信息视图中)。替换1.4.3。[mbaechtold]

1.4.3 (2017-01-26)

  • 按字母顺序对成员资格进行排序(在联系人详细信息视图中)。[mbaechtold]

1.4.2 (2016-12-19)

  • 如果行后没有内容,则在成员块模板中减少行中断开符的数量(以减少下一个块前的空间)。[mbaechtold]

1.4.1 (2016-11-10)

  • 修复在utls.py(get_backreferences)中的权限检查。它是“View”而不是“zope2.View”。[mathias.leimgruber]

1.4.0 (2016-09-13)

  • 联系人详细信息视图上的成员资格链接现在指向包含成员块的容器,而不是成员块本身。[mbaechtold]

  • 添加选项以在联系人详细信息视图中隐藏地图。[mbaechtold]

  • 添加选项以在联系人详细信息视图中隐藏成员资格。[mbaechtold]

  • 添加 ftw.referencewidget 并使用它代替 formwidget.contenttree。[tschanzt]

  • 从 egov.contactdirectory 迁移的 Inplace 迁移器。[jone]

  • 如果成员块上勾选了“获取地址”选项,则显示成员块的联系人功能。[mbaechtold]

  • 安装“collective.geo.openlayers”的新版本。这使得“ftw.openlayerhotfix”变得过时。[mbaechtold]

1.3.0 (2016-08-10)

  • 对于 simplelayout 扩展,从 ftw.simplelayout 移除 metadata.xml-dependencie。该扩展是 ftw.simplelayout 的插件,不应安装它。[elioschmutz]

  • 添加 ldap-to-contact 同步。[lknoepfel]

1.2.0 (2016-03-30)

  • 重新设计 ftw.contacts。[Kevin Bieri]

1.1.0 (2016-03-30)

  • 由于地图实现的更改,移除不再使用的地理配置。[elioschmutz]

  • 修复针对地理引用联系人的地理位置查找。地图将通过视图组件不再渲染。它直接集成到 contact.pt 中,以便更好地控制。[elioschmutz]

  • 添加对地理引用联系人的缺失行为。[elioschmutz]

  • 修复 ftw.geo 集成中损坏的 profilehook 名称。[elioschmutz]

  • 禁用在视图组件中渲染地图小部件。现在地图将直接在 contact.pt 中渲染。[elioschmutz]

  • reload 视图名称更改为更具体的名称 reload_contacts。[elioschmutz]

  • 如果重新加载联系人,则触发事件。[elioschmutz]

  • 调整 contact_summary 模板以在详情中仅显示标题,如果它与组织名称不同。这发生在仅填写组织名称而没有填写姓氏和名字的情况下。[elioschmutz]

  • 修复 plonetheme.onegovbear 的 css 样式。[elioschmutz]

1.0.0 (2015-12-04)

  • 目前还没有变化

项目详情


下载文件

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

源分布

ftw.contacts-1.11.1.tar.gz (639.9 kB 查看哈希值)

上传时间

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面