plone.app.vocabularies 6.0.1

语言

plone.app.vocabularies.AvailableContentLanguages

所有已知语言

plone.app.vocabularies.SupportedContentLanguages

当前配置/支持的门户内容语言

用户、组、安全

plone.app.vocabularies.Users

门户用户（可搜索）。

plone.app.vocabularies.Groups

门户组（可搜索）。

plone.app.vocabularies.Principals

门户的组和用户组合（可搜索）。值以 group:... 或 user:... 前缀。

上述三个词汇表的工厂类是为了子类化而设计的，以便在子类中过滤结果。后过滤方法通过覆盖 plone.app.vocabularies.principals.BaseFactory 子类的 def use_principal_triple(self, principal_triple): 方法来实现。 use_principal_triple 参数 principal_triple 是一个三元组 (value, token, title)。 use_principal_triple 预期在三元组被添加到词汇表时返回 True，如果它需要被跳过则返回 False。请注意，词汇表中可能有许多值，如数千个，并且需要进行过滤。子类需要有 source 属性，其值是 user、group 或 principal 之一。别忘了在 ZCML 中注册新的词汇表！

plone.app.vocabularies.Roles

门户中的所有可能角色

plone.app.vocabularies.Permissions

门户中的所有可能权限

文本输入字段

plone.app.vocabularies.AllowedContentTypes

为文本输入字段配置的允许的 MIME 类型（text/*）

plone.app.vocabularies.AllowableContentTypes

文本输入字段的全部可能 MIME 类型（text/*）

plone.app.vocabularies.AvailableEditors

配置的 WYSIWIG 编辑器

门户类型

plone.app.vocabularies.PortalTypes

门户中安装的所有 portal-type

plone.app.vocabularies.ReallyUserFriendlyTypes

静态过滤后的 portal-type 列表。过滤器是定义在 plone.app.vocabularies.types.BAD_TYPES 的 portal_type ids（字符串）列表。

plone.app.vocabularies.UserFriendlyTypes

由类型工具过滤为“用户友好”的门户类型。

门户操作

plone.app.vocabularies.Actions

所有动作分类 ID。用于动作面板。

plone.app.vocabularies.PortalActionCategories

所有动作分类（ID + 翻译标题）。用于动作控制面板。

工作流

plone.app.vocabularies.Workflows

所有安装的工作流

plone.app.vocabularies.WorkflowStates

所有工作流状态的标题 - 对于安装的任何工作流

plone.app.vocabularies.WorkflowTransitions

所有工作流转换的标题 - 对于安装的任何工作流

聚合/源

plone.app.vocabularies.SyndicationFeedTypes

配置的允许的源类型

plone.app.vocabularies.SyndicatableFeedItems

相对于站点根的第一级和第二级导航级别上的文件夹或集合（深度=2）。值是文件夹或集合的 UID，术语是它的标题（可搜索）

目录

plone.app.vocabularies.Keywords

它要么显示所有主题、标签或关键词，这些是门户网站内容所使用的。或者如果注册表中有一个设置为True的 IEditingSchema.subjects_of_navigation_root 布尔值，则使用 getNavigationRootObject 作为部分，并且只有在该部分使用的关键词才属于词汇表。

开发人员可以继承 plone.app.vocabularies.catalog.KeywordVocabulary，它旨在对开发者友好。 keyword_index 属性可能被重新定义以使用与“主题”不同的索引来为关键词。 path_index 属性可能被重新定义以使用与 path 不同的索引来为部分路径。 section 方法可能被重新定义以确定应限制到哪些部分的关键词。

plone.app.vocabularies.Catalog

通用可查询目录

plone.app.vocabularies.MetadataFields

可用元数据字段的列表（目录大脑列），这些字段可以用作文件夹或集合列表中的表列。

主题

plone.app.vocabularies.Skins

门户中可用的主题/皮肤。

日期/时间相关

plone.app.vocabularies.Timezones

由 pytz 提供的所有时区。

plone.app.vocabularies.CommonTimezones

由“pytz”提供的常用时区。这是用户会选择的时间区，并且不会太混乱。

plone.app.vocabularies.AvailableTimezones

在门户中配置的时区。

plone.app.vocabularies.Weekdays

全名中的七天。值是从周一开始的零计数的天数。术语的标题是位于 plonelocales 命名空间中的 i18n 消息字符串，因此可以进行翻译。

plone.app.vocabularies.WeekdaysAbbr

与上面相同，但使用3个字符缩写。

plone.app.vocabularies.WeekdaysShort

与上面相同，但使用2个字符缩写。

plone.app.vocabularies.Month

与上面相同，但月份名称从一月开始，以零开始。

plone.app.vocabularies.MonthAbbr

与上面相同，但使用3个字符缩写。

图片

plone.app.vocabularies.ImagesScales

在Plone网站上可用的所有图像缩放。

6.0.1 (2024-07-31)

错误修复

• 使用 unidecode 对 ReallyUserFriendlyTypes 实现了排序。[rohnsha0] (#3985)

6.0.0 (2024-06-26)

破坏性更改

• 删除了对 portal_properties 的使用。在 getForbiddenContentTypes 中，我们曾检查 portal_properties.site_properties.forbidden_contenttypes。现在我们返回空值，因此弃用 getForbiddenContentTypes，将在 Plone 7 中删除。[maurits] (#125)

5.0.5 (2024-01-19)

内部

• 更新配置文件。[plone 开发者] (cfffba8c)

5.0.4 (2023-10-07)

错误修复

• 修复未翻译的表格列标题“标题”在collections和folders的listing_tabular中。[pbauer] (#82)

5.0.3 (2023-05-22)

错误修复

• 修复与plone.app.querystring的循环依赖。将.catalog.CatalogVocabularyFactory移动到plone.app.querystring.vocabularies，移动注册工厂的ZCML，移动测试并将带弃用警告的BBB代码放入位置。将.utils.parse_query（新名称为parseAndModifyFormquery）移动到plone.app.querystring.queryparser并将带弃用警告的BBB代码放入位置。[@jensens] (fix-circular-dep-paquerstring)

5.0.2 (2023-04-06)

错误修复

• 从plone.base导入导航根。因此，移除对plone.app.layout的传递循环依赖。[jensens] (#74)

5.0.1 (2023-03-22)

内部

• 更新配置文件。[plone 开发者] (b2d5d4a5)

5.0.0 (2022-11-30)

错误修复

• 最终发布。[gforcada] (#600)

5.0.0b1 (2022-08-31)

新功能

• 移除对CMFPlone的依赖（使用plone.base）。在图像词汇中使用实用程序而不是导入。isort/black（纯）和pyupgrade –py37-plus`。删除six的痕迹。版本提升到5.0。[jensens] (#72)

4.3.0 (2021-09-01)

新功能

• 添加新的StaticCatalogVocabulary类，提供创建可查询内容词汇的简化机制。允许使用例如AJAXSelectWidget来处理存储关系或UUID的字段。（#66）

4.2.2 (2021-02-16)

错误修复

• 更改词汇标记以使用base64.urlsafe_b64encode()。没有换行符，并可作为xml属性安全使用。参见社区帖子。[flipmcf] (#64)

4.2.1 (2020-09-26)

错误修复

• 修复了zope.site.hooks的弃用警告。（#3130）

4.2.0 (2020-06-30)

新功能

• 添加新的plone.app.vocabularies.MetadataFields词汇。[vincentfretin] (#62)

4.1.2 (2020-04-20)

错误修复

• 较小的打包更新。（#1）

4.1.1 (2019-08-29)

错误修复

• 主体词汇表：修复了处理来自多个PAS插件（如pasldap和mutable_properties）的结果。[60]

4.1.0 (2019-04-29)

新功能

• 重构了组词汇plone.app.vocabularies.Groups，这是用户词汇plone.app.vocabularies.Users的改进版本，是一个结合用户和组的新的主体词汇plone.app.vocabularies.Principals。在子类中应用过滤器的功能。所有内容都移动到principals.py，bbb导入已就位（user.py，security,py）。弃用了UserSource和GroupsSource实现。在README.rst中记录了新词汇。将doctests移动到unittests并添加了更多测试。好处：组验证速度快200倍；代码更少更干净；三个词汇表具有统一代码。[jensens] (#56)

4.0.7 (2018-09-27)

错误修复

• Python 3支持 [ale-rt, pbauer]

4.0.6 (2018-02-11)

错误修复

• 在没有提交查询时不要唤醒所有用户 [ale-rt]

4.0.5 (2018-02-05)

错误修复

• 修复了当在CMF 2.3+中未将目录注册为实用程序时失败的测试 [pbauer]

• 添加Python 2 / 3兼容性 [vincero]

4.0.4 (2017-07-03)

错误修复

• 让plone.app.vocabularies.SupportedContentLanguages在本地语言中返回语言标题。[thet]

• 移除unittest2依赖 [kakshay21]

4.0.3 (2017-05-10)

错误修复

• 在没有定义图像比例时返回空词汇表 [fgrcon]

4.0.2 (2017-03-29)

错误修复

• plone/Products.CMFPlone#1794: 使用宽容的词汇类型于数值索引的星期和月份词汇表，以避免破坏GenericSetup导入。[seanupton]

• plone/Products.CMFPlone#1268: 使用宽容的词汇类型于ReallyUserFriendlyTypes，以避免在plone.displayed_types（注册表）中插入新类型时破坏通用设置配置文件。[seanupton]

4.0.1 (2017-01-12)

错误修复

• 修复了4.0中引入的ParseError回退问题 [jensens]

4.0 (2016-11-17)

破坏性更改

• 将zope.formlib设置为可选。[gforcada]

• 将基于zope.formlib的词汇标记为已弃用。[gforcada]

错误修复

• 使代码遵循Plone风格指南。[gforcada]

• 在目录中修复：如果ZCTextIndex捕获到ParseError，则在没有给定SearchableText的情况下尝试。通常出现Query contains only common words（只提供停用词）并且结果未检索。从语义上讲，这意味着我们想要所有结果。[jensens]

3.0 (2016-06-12)

破坏性更改

• 现在，CatalogVocabulary 的构造函数接受一个查询，而不是 brains 的 LazyMap 以及惰性加载的术语。在 __contains__ 方法中，使用 UID 查询而不是检查结果的全部内容。这防止了自定义代码可能导致的潜在 DDoS 攻击，因为每次验证尝试时，整个目录的内容都会加载与它关联的术语。[vangheem]

新功能

• 可选地允许根据当前上下文过滤当前 部分 的关键词词汇表。该类是为了易于继承而构建的——现在仍然如此。它允许在子类中覆盖部分检索逻辑。默认逻辑是首先在控制面板中查找是否存在 IEditingSchema.subjects_of_navigation_root 布尔值。如果它是 True，则使用 getNavigationRootObject 作为部分，并且只包含在此部分中使用的关键词。否则，将显示索引中的所有关键词。[jensens]

2.3.0 (2016-06-07)

新功能

• 重构 KeywordsVocabulary 术语构建逻辑，从 脏 值中分离到自己的函数。在 README 中记录函数。[jensens]

2.2.5 (2016-05-25)

错误修复

• 从 CMFPlone 导入 getAllowedSizes 以避免对 plone.app.imaging 的依赖。[davisagli]

• 修复了查询无法正确解析目录词汇表中日期查询的 bug。[vangheem]

2.2.4 (2016-04-26)

新功能

• 添加 ImagesScales 词汇表。[bsuttor]

修复

• 提高 CatalogSource 代码的可读性。[jensens]

2.2.3 (2016-03-03)

新功能

• 权限词汇表。[ebrehault]

• 门户动作类别词汇表。[ebrehault]

2.2.2 (2016-02-25)

修复

• 除非指定路径，否则限制目录词汇表搜索当前导航根。[alecm]

2.2.1 (2015-12-03)

修复

• 使用户词汇表能够处理非 ASCII 字符。这修复了 https://github.com/plone/plone.app.widgets/issues/120 [davisagli]

2.2.0 (2015-10-28)

修复

• 更新版本到 2.2.0，因为之前的版本引入了与 Plone 4.3 不兼容的问题。[maurits]

• 从配置注册表中获取默认字符集值。[esteele]

2.1.21 (2015-09-07)

• 从配置注册表中获取 available_editors 值。[esteele]

2.1.20 (2015-08-13)

• 清理：PEP8，为 zca 等添加装饰器。还改进了 README。[jensens]

2.1.19 (2015-07-29)

• 修复了 SyndicatableFeedItems，使其能够处理对象标题中的 Unicode 字符。[Gagaro]

2.1.18 (2015-06-05)

• 将 CatalogSource 更改为能够验证路径字符串，而不是仅限于 UIDs [vangheem]

2.1.17 (2015-05-13)

• 默认使用英语，通过 AvailableContentLanguageVocabularyFactory 解决有时在设置语言且多语言未安装时出现的问题 [vangheem]

• 修复了 plone.app.vocabularies.Users 中缺少上下文的问题。[pbauer]

2.1.16 (2014-09-07)

• 在 RolesVocabulary 中添加了缺失的 Authenticated 和 Anonymous 角色。[ichim-david]

• 清理。[thet]

2.1.15 (2014-04-11)

• 通过使用 keyword_index 类变量，使 KeywordsVocabulary 更易于自定义，允许用户继承并仅覆盖该属性以构建自己的关键词词汇表。[saily]

• 添加与日期相关的词汇表：时区、星期、月份。这些是从 plone.app.event 中移除并扩展的，以更完整。[yenzenz]

• 添加可以最终替换词汇表的目录源。[davisagli]

2.1.14 (2014-02-23)

• 添加动作词汇表。[giacomos]

2.1.13 (2014-01-27)

2.1.12 (2013-11-14)

• 为目录结果提供合适的 contains 方法。[vangheem]

• 回退到 getSite 以获取 portal_catalog。[vangheem]

• 目录词汇表查询可以是 None。[garbas]

• getTerm 和 getTermByToken 并没有真正检查项目是否在词汇表中。[garbas]

• 在目录词汇表中使用 sort_on 和 sort_order。[vangheem]

2.1.11 (2013-07-18)

• 向 SlicableVocabulary 添加文档，修复内部结构的处理。[do3cc]

• SlicableVocabulary 上下文在初始化时不需要。[garbas]

• KeywordsVocabularyFactory 现在接受查询，该查询过滤词汇表中的关键词。[garbas]

• 添加对目录词汇表的支持。[vangheem]

2.1.10 (2013-01-30)

• UsersVocabulary 应该在 fullname 上进行搜索。[garbas]

2.1.9 (2013-01-13)

• 添加用户词汇（用户懒加载）也支持用户搜索。[garbas]

2.1.8 (2012-10-03)

• 使KeywordsVocabulary能够与Unicode和非Unicode词汇一起工作。[thet]

• 修复当工作流状态/转换标题包含编码字符时的异常。[ericof]

• 修复当工作流词汇中包含UTF-8编码字符时的异常。[miohtama]

• 添加内容聚合类型词汇。[vangheem]

2.1.7 (2012-07-02)

• 依赖zope.formlib而不是zope.app.form。[davisagli]

• 移除对Archetypes的硬依赖。[davisagli]

2.1.6 (2012-04-09)

• 在测试中使我们的模拟queryUtility更加逼真。这避免了与zope.pagetemplate 3.6.0或更高版本组合时的测试失败。[maurits]

2.1.5 - 2011-12-22

• 确保关键字词汇项标题是Unicode值，按照zope.schema.interfaces.ITitledTokenizedTerm。[mj]

2.1.4 - 2011-12-22

• 确保关键字词汇项标记是7位值，按照zope.schema.interfaces.ITokenizedTerm。[mj]

2.1.3 - 2011-07-04

• 角色词汇已翻译并按翻译后的角色ID排序。修复http://dev.plone.org/plone/ticket/11958。[WouterVH]

2.1.2 - 2011-04-21

• 类型词汇按翻译后的标题排序。[thomasdesvenain]

• 添加MANIFEST.in。[WouterVH]

• 转换词汇已翻译并按转换ID排序。[thomasdesvenain]

2.1.1 - 2011-03-02

• 从允许的内容类型词汇中排除“text/x-plone-outputfilters-html”。[davisagli]

2.1 - 2011-02-10

• 从BAD_TYPES词汇中移除“讨论项”。[timo]

2.0.2 - 2010-10-27

• 在某些上下文中，工作流状态词汇的翻译不起作用。[thomasdesvenain]

2.0.1 - 2010-07-18

• 将许可证更新为仅适用于GPL版本2。[hannosch]

2.0 - 2010-07-01

• 国际化编辑标签（特别是对于“无”值）。[thomasdesvenain]

2.0b4 - 2010-06-13

• 使用标准库的doctest模块。[hannosch]

2.0b3 - 2010-04-07

• 添加一个词汇表，列出所有关键字（通过主题索引）。[esteele]

• 避免GS导入默认导航小部件时发生ConstraintNotSatisfied-error。修复https://dev.plone.org/plone/ticket/8380。[WouterVH]

2.0b2 - 2010-01-24

• 在皮肤词汇中，将“Plone默认”皮肤的标题改为“(无样式)”，以减少混淆，因为Sunburst现在是默认的。[davisagli]

2.0b1 - 2009-12-27

• 添加了缺少的zope.browser依赖。[hannosch]

2.0a2 - 2009-12-16

• 避免最后使用SimpleVocabulary.fromItems。这参考http://dev.plone.org/plone/ticket/6480。[hannosch]

• 移除了在addforms中词汇的奇怪Acquisition处理。这关闭了http://dev.plone.org/plone/ticket/9408。[hannosch]

2.0a1 - 2009-11-14

• 避免对zope.app.pagetemplate和zope.app.schema的依赖。[hannosch]

• 添加了AvailableEditors词汇。[robgietema]

• 从BAD_TYPES中移除ChangeSet，因为这不再是门户类型。[maurits]

• 使用来自新zope.browser包的ITerms接口。[hannosch]

• 指定包依赖。[hannosch]

1.0.6 - 2008-11-06

• 使测试与Python 2.6兼容。[hannosch]

• QuerySearchableTextSourceView创建具有字符串标题的术语。然而，zope.app.form.browser.source假定它应该是Unicode，结果是如果包含非ascii字符，你会得到Unicode错误。[regebro]

1.0.5 - 2008-08-18

• 文档更新。[hannosch]

1.0.4 - 2008-03-09

• 添加了在浏览查询中省略当前文件夹的选项，这用于UberSelectionWidget。[fschulze]

1.0.3 - 2008-02-13

• 为目录、组和用户来源添加了测试。修复了三个错误，其中未引发LookupError。[hannosch]

• 为特殊术语类添加了测试。[hannosch]

• 为语言、安全、皮肤、类型和工作流词汇添加了测试。[hannosch]

1.0.2 - 2007-12-24

• 修复了在工作流状态词汇中传递给翻译机制的无效上下文参数。这修复了http://dev.plone.org/plone/ticket/7492。[hannosch]

• 为可搜索文本源添加了可选的默认查询字符串。[fschulze]

• 更正属性名称。[wichert]

1.0.1 - 2007-08-17

• 修复了处理空值时无效的目录词汇。这使得它与UberSelectionWidget更好地工作。[optilude]

• 使目录词汇对简单/简短查询更加健壮。[optilude]

1.0 - 2007-08-14

• 将“ReallyUserFriendlyTypesVocabulary”固定，以包含类型名称的消息。这参考了http://dev.plone.org/plone/ticket/6911。[hannosch]

1.0rc3 - 2007-07-28

• 修复了缺失的历史记录。[hannosch]

1.0rc2 - 2007-07-27

• 修复以返回本地化的工作流状态名称。[deo]

1.0rc1 - 2007-07-09

• 添加了新的“ReallyUserFriendlyTypes”和“BAD_TYPES”列表，这些列表用于过滤掉根本不是内容类型的类型。[hannosch]

• 添加了新的“AvailableContentLanguages”和“SupportedContentLanguages”词汇表。[hannosch]

• 如果我们有一个用户词汇表，我们应该有一个组词汇表 :) [optilude]

• 使用描述感知的术语 [optilude]

• 允许查询参数化，例如，我们可以限制仅为文件夹。[optilude]

• 添加一个用户来源，这样我们就可以在用户上使用UberSelectionWidget。[optilude]

1.0b3 - 2007-05-1

• 回到getToolByName。[wichert]

1.0b2 - 2007-03-23

• 用getUtility替换getToolByName。[hannosch]

1.0b1 - 2007-03-05

• 添加工作流词汇表。[optilude]

• 添加UserFriendlyTypes词汇表。[hannosch]

1.0a2 - 2007-02-06

• 一些初始词汇表。[hannosch, optilude]

• 初始包结构。[zopeskel]