Collection of generally useful vocabularies for Plone.
Project description
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
Catalog
- plone.app.vocabularies.Keywords
It either displays all Subjects aka Tags aka Keywords used by the portals content. Or if there is a IEditingSchema.subjects_of_navigation_root boolean set to True in the registry, the getNavigationRootObject is used as the section and only keywords used in this section are part of the vocabulary.
Developers can subclass plone.app.vocabularies.catalog.KeywordVocabulary, it is build to be developer friendly. keyword_index property may be redefined to use a different index than ‘Subject’ for the Keywords. path_index property may be redefined to use a different index than path for the sections path section method may be redefined to located the section keywords should be restricted to.
- plone.app.vocabularies.Catalog
Generic queryable catalog
Theme
- plone.app.vocabularies.Skins
Themes/ skins available in the portal.
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
3.0 (2016-06-12)
Breaking changes:
CatalogVocabulary now takes a query for it’s constructor instead of a LazyMap of brains and lazy loads terms. Also, in __contains__, do a UID query instead of checking the entire contents of the result. This prevents potential DOS with custom code where the whole contents of the catalog would get loaded with terms created for it on every validation attempt. [vangheem]
New features:
Optional allow to filter keyword vocabulary to a current section based on the current context. The class was build for easy subclassing - and still is. It allows to override the section fetching logic in a subclass. The default logic is first to look in the controlpanel if there is a IEditingSchema.subjects_of_navigation_root boolean. If its True the getNavigationRootObject is used as the section and only keywords used in this section are part of the vocabulary. Otherwise all keywords in the index are displayed. [jensens]
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]
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for plone.app.vocabularies-3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fb535a4ec386f078eb4b521b2a43d335e9d6b6cdfb0f0b20860bb89de53ff14 |
|
MD5 | f5bd7b1ba97ac0ea9123cf1f582bb4fe |
|
BLAKE2b-256 | 50d6412403a4b96ae3f31545b77ec3502aa68124759ce1b8bd41c938383f1248 |