Contentish and VDEX Vocabularies for CMS Plone
Python Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.cache upgrade buildout configuration Mar 26, 2013
Products added interfaces for all vocabularies and terms -> fixes #4 Jul 3, 2015
docs update metadata-filesand folder-structure to current plone-convention… Apr 5, 2011
.gitignore added interfaces for all vocabularies and terms -> fixes #4 Jul 3, 2015
.travis.yml stay in buildout 1 land for Plone 4 Jul 3, 2015
CHANGES.txt Back to development: 1.6.8 Jul 30, 2015
CONTRIBUTORS.txt Compatibility with plone 4.3 Mar 25, 2013
MANIFEST.in manifest Mar 26, 2013
README.rst travis build info Mar 26, 2013
TODO.txt update metadata-filesand folder-structure to current plone-convention… Apr 5, 2011
base.cfg use newer version of plone.app.testing for Plone 4.2 tests for PTC re… Jul 3, 2015
bootstrap-buildout.py stay in buildout 1 land for Plone 4 Jul 3, 2015
bootstrap.py stay in buildout 1 land for Plone 4 Jul 3, 2015
buildout.cfg upgrade buildout configuration Mar 26, 2013
setup.py Back to development: 1.6.8 Jul 30, 2015
test-4.0.x.cfg upgrade buildout configuration Mar 26, 2013
test-4.1.x.cfg upgrade buildout configuration Mar 26, 2013
test-4.2.x.cfg upgrade buildout configuration Mar 26, 2013
test-4.3.x.cfg upgrade buildout configuration Mar 26, 2013
test-5.x.cfg conditionally exclude LinguaPlone tests Jun 27, 2015
travis-4.2.x.cfg use newer version of plone.app.testing for Plone 4.2 tests for PTC re… Jul 3, 2015
travis-4.3.x.cfg stay in buildout 1 land for Plone 4 Jul 3, 2015
travis-5.0.x.cfg removed old travis configs and fixed Plone 5 one Jul 3, 2015

README.rst

Introduction

ATVocabularyManager: a vocabulary managing portal tool for Plone

https://secure.travis-ci.org/collective/Products.ATVocabularyManager.png

Overview

  • ATVocabularyManager offers central through the Plone management of dynamic vocabularies.

  • This product is based on Archetypes and made to work with Archetypes as well as with other Products. It is intended use is within Archetypes Fields. Using it as a vocabulary provider for CMFMetadata worked out fine too. Integration with different other products will work as well.

  • to use a managed vocabulary simply add the term vocabulary = NamedVocabulary("myvocabulary") to the fields of your Archetypes Schema, import NamedVocabulary from this Product and create your vocabulary with id myvocabulary in 'portal_vocabularies' tool (available through Plone Site-Setup). NamedVocabulary accepts two extra arguments:

    • empty_first_item, needs a boolean for getting an empty item on top of the list, defaults to False;
    • custom_empty_first_item, needs a list of tuple containing a custom first item, defaults to None.
  • ATVocabularyManager supports:

    simple flat key

    value vocabularies

    tree like

    hierachical vocabularies (see Limitations)

    IMS Vocabulary Definition Exchange Format (VDEX) aware vocabularies

    with XML Import and Export. VDEX is i18n-aware by its nature and does not need LinguaPlone!

    Vocabularies are pluggable types.

    ATVocabularyManager is prepared for extension with your special vocabulary type. ArchGenXML will help you here. Each vocabulary term needs to be an CMF aware content type. Reuse normal rich content as a vocabularies.

ArchGenXML 1.4+ code-generator does full integration of ATVocabularyManager: via tagged value defined named vocabularies are registered transparently, VDEX-XML files are imported at install-time, stub vocabularies are created at install time and custom types are registered by just providing appropriate stereotypes.

ATVM is Linguaplone compatible (only tested with SimpleVocabulary, and TreeVocabulary). Add a simple vocabulary with some items, install and configure Linguaplone, translate the vocabulary to the language(s) of your choice, translate every item to the language(s) of your choice. NamedVocabulary() will return the vocabulary as usual, the keys will stay the same disregarding language settings, the values will show in the currently selected language. VDEX vocabularies are not using LinguaPlone, but are i18n-aware (imo much better than everything else).

You can do hierachy-aware searches on treevocabularies (for more information on this see doc/search_treevocabulary.txt) attention: curently certain changes in the term hierachy require a catalog rebuild (see Limitations).

Installation

This addon can be installed has any other addons. please follow official documentation

To speed up ATVocabularyManager you might want to associate it with a Cache-Manager.

Dependencies

  • Products.Archetypes
  • imsvdex
  • [Products.Linguaplone] optional

Limitations

TreeVocabulary catalog updates
If you are using the hierachy-aware catalog search support of tree-vocabularies you need to rebuild the uid_catalog and portal_catalog if you move a vocabularyterm that has other terms below it.
Creation/Edit of VDEX TTW is difficult.
Take an editor of your choice, create the vocab and upload it or help writing an UI.

Known Bugs

Support

Usally the authors are offering professional support. The classical well-working community support is found at the mailing-lists and IRC-channels announced at plone.org:http://plone.org