plone.app.vocabularies 2.3.0

Collection of generally useful vocabularies for Plone.

Overview

A collection of generally useful vocabularies for Plone.

It is implemented using zope.schema.vocabulary. Intended to be used as a base and example for custom vocabularies.

Common Named Vocabularies

Languages

plone.app.vocabularies.AvailableContentLanguages

all known languages

plone.app.vocabularies.SupportedContentLanguages

currently configured/supported content languages for the portal

Users, Groups, Security

plone.app.vocabularies.Users

user of the portal (searchable)

plone.app.vocabularies.Groups

groups of the portal (searchable)

plone.app.vocabularies.Roles

all possible roles in the portal

Text Input Field

plone.app.vocabularies.AllowedContentTypes

Configured allowed mime-types (text/*) for text input fields

plone.app.vocabularies.AllowableContentTypes

All possible mime types (text/*) for text input fields

plone.app.vocabularies.AvailableEditors

Configured WYSIWIG editors

Portal Types

plone.app.vocabularies.PortalTypes

All portal-types installed in the portal

plone.app.vocabularies.ReallyUserFriendlyTypes

Static filtered list of portal-types. Filter is a list of portal_type ids (strings) defined at plone.app.vocabularies.types.BAD_TYPES.

plone.app.vocabularies.UserFriendlyTypes

Portal types filtered as ‘user friendly’ by the Types Tool.

Portal actions

plone.app.vocabularies.Actions

All the actions category ids. Used in Actions portlet.

plone.app.vocabularies.PortalActionCategories

All the actions categories (ids + translated title). Used in Actions control panel.

Workflows

plone.app.vocabularies.Workflows

All installed workflows

plone.app.vocabularies.WorkflowStates

All titles of workflow states - for any workflow installed

plone.app.vocabularies.WorkflowTransitions

All titles of workflow transitions - for any workflow installed

Syndication/ Feeds

plone.app.vocabularies.SyndicationFeedTypes

Configured allowed feed types

plone.app.vocabularies.SyndicatableFeedItems

Folders or Collections on the first two navigation levels (depth=2) relative to the site root. Value is UID of the Folder or Collection, term is title of it (searchable)

Catalog

plone.app.vocabularies.Keywords

All Subjects aka Tags aka Keywords used by the portals content

plone.app.vocabularies.Catalog

Generic queryable catalog

Theme

plone.app.vocabularies.Skins

Themes/ skins available in the portal.

Date/Time Related

plone.app.vocabularies.Timezones

all timezones provided by pytz

plone.app.vocabularies.CommonTimezones

common timezones provided by ‘pytz’. This are those a user would choose from and is not too much confused.

plone.app.vocabularies.AvailableTimezones

timezones configured in the portal.

plone.app.vocabularies.Weekdays

the seven weekdays in fullname. Value is the day number start counting at zero on monday. Title of the term is an i18n messagestring in plonelocales namespace, so it translates.

plone.app.vocabularies.WeekdaysAbbr

same as above but with 3 character abbreviations.

plone.app.vocabularies.WeekdaysShort

same as above but with 2 character abbreviations.

plone.app.vocabularies.Month

same as above but with month names starting with zero in january.

plone.app.vocabularies.MonthAbbr

same as above but with 3 character abbreviations.

Images

plone.app.vocabularies.ImagesScales

All image scales which are avaiable on Plone site.

API/ Tools

plone.app.vocabularies.terms.TermWithDescription (class)

A SimpleTerm accepting additionally a description parameter. Like title it may be used for display.

plone.app.vocabularies.terms.BrowsableTerm (class)

A term which may be browsed. In a vocabulary those are used to identify terms which are actually browsable (e.g. those representing folders).

plone.app.vocabularies.terms.safe_simpleterm_from_value (function)

Create a SimpleTerm from a dirty or untrusted value. Token is encoed carefully and Title converted to unicode.

plone.app.vocabularies.terms.safe_simplevocabulary_from_values (function)

Create a SimpleVocabulary from a iterable (list) of dirty or untrusted values. Utilizes above safe_simpleterm_from_value to achieve this.

Source Code

Contributors please read the document Process for Plone core’s development

Sources are at the Plone code repository hosted at Github.

Changelog

2.3.0 (2016-06-07)

New features:

• Refactor KeywordsVocabulary logic of term construction from dirty values out into own functions. Document functions in README. [jensens]

2.2.5 (2016-05-25)

Bug fixes:

• Fix bug where queries would not be parsed correctly for date queries on the catalog vocabulary [vangheem]

2.2.4 (2016-04-26)

New:

• Add ImagesScales vocabulary. [bsuttor]

Fixes:

• increase readability of code in CatalogSource. [jensens]

2.2.3 (2016-03-03)

New:

• Vocabulary for permissions [ebrehault]

• Vocabulary for portal action categories [ebrehault]

2.2.2 (2016-02-25)

Fixes:

• Restrict Catalog vocabulary to search current Navigation Root unless path is specified. [alecm]

2.2.1 (2015-12-03)

Fixes:

• Make user vocabulary handle non-ASCII characters. This fixes https://github.com/plone/plone.app.widgets/issues/120 [davisagli]

2.2.0 (2015-10-28)

Fixes:

• Updated version to 2.2.0, as the previous release introduced an incompatibility with Plone 4.3. [maurits]

• Pull default_charset value from the configuration registry. [esteele]

2.1.21 (2015-09-07)

• Pull available_editors values from the configuration registry. [esteele]

2.1.20 (2015-08-13)

• Cleanup: PEP8, decorators for zca, et al. Also pimped the README. [jensens]

2.1.19 (2015-07-29)

• Fixed SyndicatableFeedItems to allow unicode characters in objects titles. [Gagaro]

2.1.18 (2015-06-05)

• change CatalogSource to be able to validate path strings in addition to UIDs [vangheem]

2.1.17 (2015-05-13)

• default to having english with AvailableContentLanguageVocabularyFactory to fix issue that happens sometimes when setting language and multilingual is not installed [vangheem]

• Fix issue with missing context in plone.app.vocabularies.Users. [pbauer]

2.1.16 (2014-09-07)

• Added the missing Authenticated and Anonymous roles within the RolesVocabulary`. [ichim-david]

• Cleanup. [thet]

2.1.15 (2014-04-11)

• Make KeywordsVocabulary more customizeable using an keyword_index class variable to allow users to inherit and just override that attribute to build their own keyword vocabularies. [saily]

• Add datetime related vocabularies: timezones, weekdays, months. This are moved from plone.app.event and extended by to be more complete. [yenzenz]

• Add catalog source which can eventually replace the vocabulary. [davisagli]

2.1.14 (2014-02-23)

• Add actions vocabulary. [giacomos]

2.1.13 (2014-01-27)

2.1.12 (2013-11-14)

• provide proper contains method for catalog results [vangheem]

• fallback to getSite for grabbing portal_catalog [vangheem]

• catalog vocabulary query could be None [garbas]

• getTerm and getTermByToken were not really checking if item is in the vocabulary list [garbas]

• use sort_on and sort_order in catalog vocabulary [vangheem]

2.1.11 (2013-07-18)

• Add documentation to SlicableVocabulary, fix handling of internal structure [do3cc]

• SlicableVocabulary context is not needed when initialing [garbas]

• KeywordsVocabularyFactory now accepts query which filters keywords listed in vocabulary [garbas]

• add support for a catalog vocabulary [vangheem]

2.1.10 (2013-01-30)

• UsersVocabulary should search on fullname . [garbas]

2.1.9 (2013-01-13)

• adding users vocabulary (lazy loading of users) also supports searching over users. [garbas]

2.1.8 (2012-10-03)

• Make KeywordsVocabulary work with unicode and non-unicode vocabularies. [thet]

• Fix exceptions with workflow states/transitions titles when their titles contained encoded characters [ericof]

• Fix exception with workflow vocabulary when workflow titles contained UTF-8 encoded characters [miohtama]

• Add syndication feed types vocabulary [vangheem]

2.1.7 (2012-07-02)

• Depend on zope.formlib instead of zope.app.form. [davisagli]

• Remove hard dependency on Archetypes. [davisagli]

2.1.6 (2012-04-09)

• Made our mock queryUtility in the tests more life like. This avoids test failures in combination with zope.pagetemplate 3.6.0 or higher. [maurits]

2.1.5 - 2011-12-22

• Ensure that the keywords vocabulary term titles are unicode values, as per zope.schema.interfaces.ITitledTokenizedTerm. [mj]

2.1.4 - 2011-12-22

• Ensure that the keywords vocabulary term tokens are 7-bit values, as per zope.schema.interfaces.ITokenizedTerm. [mj]

2.1.3 - 2011-07-04

• Roles vocabulary is translated and sorted by translated role id. Fixes http://dev.plone.org/plone/ticket/11958. [WouterVH]

2.1.2 - 2011-04-21

• Types vocabularies are sorted by translated titles. [thomasdesvenain]

• Add MANIFEST.in. [WouterVH]

• Transitions vocabulary is translated and sorted by transition id. [thomasdesvenain]

2.1.1 - 2011-03-02

• Exclude ‘text/x-plone-outputfilters-html’ from the allowable content types vocabulary. [davisagli]

2.1 - 2011-02-10

• Remove “Discussion Item” from BAD_TYPES vocabulary. [timo]

2.0.2 - 2010-10-27

• Translation of workflow states vocabularies didn’t work in some contexts. [thomasdesvenain]

2.0.1 - 2010-07-18

• Update license to GPL version 2 only. [hannosch]

2.0 - 2010-07-01

• Internationalized editor label (especially for ‘None’ value). [thomasdesvenain]

2.0b4 - 2010-06-13

• Use the standard libraries doctest module. [hannosch]

2.0b3 - 2010-04-07

• Add a vocabulary to list all Keywords (via the Subject index). [esteele]

• Avoid ConstraintNotSatisfied-error when GS-importing the default navigation portlet. Fixes https://dev.plone.org/plone/ticket/8380 [WouterVH]

2.0b2 - 2010-01-24

• In the skins vocabulary, give the ‘Plone Default’ skin the title ‘(Unstyled)’ to reduce confusion, now that Sunburst is actually the default. [davisagli]

2.0b1 - 2009-12-27

• Added missing zope.browser dependency. [hannosch]

2.0a2 - 2009-12-16

• Avoid the last use of SimpleVocabulary.fromItems. This refs http://dev.plone.org/plone/ticket/6480. [hannosch]

• Removed funky Acquisition handling for vocabularies inside addforms. This closes http://dev.plone.org/plone/ticket/9408. [hannosch]

2.0a1 - 2009-11-14

• Avoid dependencies on zope.app.pagetemplate and zope.app.schema. [hannosch]

• Added AvailableEditors vocabulary. [robgietema]

• Removed ChangeSet from the BAD_TYPES as this is not a portal type anymore. [maurits]

• Use the ITerms interface from the new zope.browser package. [hannosch]

• Specified package dependencies. [hannosch]

1.0.6 - 2008-11-06

• Made the tests forward-compatible with Python 2.6. [hannosch]

• The QuerySearchableTextSourceView made terms with string titles. However zope.app.form.browser.source assumes it to be unicode, with the result that you get unicode errors if you have non-ascii characters. [regebro]

1.0.5 - 2008-08-18

• Documentation updates. [hannosch]

1.0.4 - 2008-03-09

• Added option to omit the current folder in a browse query, this is used for the UberSelectionWidget. [fschulze]

1.0.3 - 2008-02-13

• Added tests for the catalog, groups and users sources. Fixed three bugs, where a LookupError was not raised. [hannosch]

• Added tests for the special term classes. [hannosch]

• Added tests for the language, security, skins, types and workflow vocabularies. [hannosch]

1.0.2 - 2007-12-24

• Fixed invalid context argument passed into the translation machinery in the workflow state vocabulary. This fixes http://dev.plone.org/plone/ticket/7492. [hannosch]

• Added optional default query string to searchable text source. [fschulze]

• Correct name for attributes. [wichert]

1.0.1 - 2007-08-17

• Fixed catalog vocabulary when dealing with the degenerate-case of an empty value. This makes it work better with the UberSelectionWidget. [optilude]

• Made catalog vocabulary less fragile for simple/short queries. [optilude]

1.0 - 2007-08-14

• Fixed ReallyUserFriendlyTypesVocabulary to include the Messages for type names. This refs http://dev.plone.org/plone/ticket/6911. [hannosch]

1.0rc3 - 2007-07-28

• Fixed missing history. [hannosch]

1.0rc2 - 2007-07-27

• Fixed to return localized workflow state names. [deo]

1.0rc1 - 2007-07-09

• Added new ReallyUserFriendlyTypes and a BAD_TYPES list, which are used to filter out types which are not content types at all. [hannosch]

• Added new AvailableContentLanguages and SupportedContentLanguages vocabularies. [hannosch]

• If we have a users vocabulary, we should have a groups one :) [optilude]

• Make use of description-aware terms [optilude]

• Allow parameterisation of the query, so that we can restrict to folders-only, for example. [optilude]

• Add a user source, so that we can use the UberSelectionWidget on users. [optilude]

1.0b3 - 2007-05-1

• Back to getToolByName we go. [wichert]

1.0b2 - 2007-03-23

• Replaced getToolByName with getUtility. [hannosch]

1.0b1 - 2007-03-05

• Added workflow vocabulary. [optilude]

• Added UserFriendlyTypes vocabulary. [hannosch]

1.0a2 - 2007-02-06

• Some initial vocabularies. [hannosch, optilude]

• Initial package structure. [zopeskel]