Package: collective.contact.widget
This add-on is part of thecollective.contact.*suite. For an overview and a demo of these suite, seecollective.contact.demo.This module provides a widget for contacts.You can add contact fields to your schema, like thisclass IMyProject(Interface):

    company = ContactChoice(
    title=_(u"Company"),
    source=ContactSourceBinder(portal_type=("organization",),
    )

        manager = ContactList(
        title=_(u"Project Manager"),
        value_type=ContactChoice(source=ContactSourceBinder(portal_type=("held_position",),
                                                            relations={'position': '/contacts/ecreall'})),
        )Example code means that ‘manager’ is a multi-valued contact field which
vocabulary gets held_position objects of site.
The vocabulary is restricted to objects that have a ‘position’ relation to ‘/contacts/ecreall’ object
(i.e. which are held_positions in ecreall company).You can add another filtering option like thiscompany = ContactChoice(
title=_(u”Company”),
source=ContactSourceBinder(portal_type=(“organization”,),
prefilter_vocabulary=’vocabulary or source’,
prefilter_default_value=’context aware method’,
)The prefilter vocabulary is displayed in the widget. The user can select a specific directory by example.
Each term value contains a criteria, like u’{“path”: “/Plone/directory1”}’ (beware to use “ in dict !).If you run this javascript expression :contactswidget.setup_relation_dependency(‘form.widgets.company’, ‘form.widgets.manager’, ‘position’)
the vocabulary of ‘manager’ field will be restricted to the held_positions of selected company.TranslationsThis product has been translated intoSpanish.French.You can contribute for any message missing or other new languages, join us atPlone Collective TeamintoTransifex.netservice with all world Plone translators community.ContributeHave an idea? Found a bug? Let us know byopening a ticket.Issue Tracker:https://github.com/collective/collective.contact.widget/issuesSource Code:https://github.com/collective/collective.contact.widgeteDocumentation:https://github.com/collective/collective.contact.demo/blob/master/README.mdTestsThis add-on is tested using Travis CI. The current status of the add-on is :LicenseThe project is licensed under the GPLv2.ContributorsVincent Fretin,vincentfretin@ecreall.comCédric MessiantStéphane GeuletteFrédéric PétersThomas Desvenain,thomas.desvenain@gmail.comEric Bréhault,ebrehault@gmail.comLeonardo Caballero,leonardocaballero@gmail.comChangelog1.13 (2022-06-21)Escaped contact title special characters interm-contactviewlet to avoid
script insertion (xss). This viewlet stores an hidden field used in a
dynamically js generation.
[sgeulette]Requirefutureinsetup.py.
[gbastien]1.12 (2020-10-07)Added prefiltering on widgets
[daggelpop, sgeulette]Add Transifex.net service integration to manage the translation process.
[macagua]Add Spanish translation
[macagua]1.11 (2019-09-20)Limit catalog results (with sort_limit) because solr sends None for higher limit results.
[sgeulette]Use contact_source metadata in widget result
[sgeulette]1.10 (2017-10-05)Set Content-type ‘text/plain’ headers to autocomplete request. This prevent “<!DOCTYPE html” tag.
[bsuttor]1.9 (2017-05-30)Fix optimization issue when vocabulary is restricted by a relation.
[thomasdesvenain]Prevent fatal error on autocomplete if by chance a held position related to a position or an organisation has been removed
but the relation always exist. An error is logged.
[thomasdesvenain]1.8 (2016-10-21)ContactChoice can now be used as master field when
plone.formwidget.masterselect >= 1.6 is installed.
[vincentfretin]1.7 (2016-07-07)Set matchSubset: false to fix autocomplete behavior with accents and not
doing a new ajax request.
[vincentfretin]Ensure that the required property for ContactList field works correctly
[mpeeters]1.6 (2016-03-31)Fix an exception with plone.formwidget.contenttree >= 1.0.11 that introduced
support for providing defaults to contenttrees.
[pcdummy]1.5 (2016-03-04)Add a querySelectSearchInput class to the input field.
[vincentfretin]Add display template for single selection field
[sgeulette]Fix buildout
[sgeulette]1.4 (2015-06-02)Remove prefill_person when clicking on Create Contact link (this behavior is
too difficult to understand for end users).
[cedricmessiant]Use a more generic selector for title so that it also works with behaviors.
[cedricmessiant]Use prelabel variable in template (so that you can override it in custom
settings, see collective.contact.core).
[cedricmessiant]Increase results to 50 items.
[vincentfretin]jQuery 1.9 compatibility.
[vincentfretin]Fix ContactSource search if no review_state parameter
[ebrehault]1.2.2 (2014-09-25)Add review_state parameter on ContactList and ContactChoice widgets.
[cedricmessiant]1.2.1 (2014-09-10)UI : improve prefill of add new contact overlay form.
[thomasdesvenain]1.2 (2014-06-02)We can give as source param a ‘relations’ value to filter on contents
related to an other content.
[thomasdesvenain]1.1 (2014-03-11)Don’t include closeOnClick: true in javascript, so it defaults to
global configuration.
[vincentfretin]UI improvements :
- Add contact link is displayed after user has filled a search.
- We have and explicit help message next to contact link.
- Contact creation form title is pre-filled with user search.
- The search input has a placeholder.
[thomasdesvenain]Execute prepOverlay only if it hasn’t been done yet, this avoid to have a
pbo undefined error when you have recursive overlays.
[vincentfretin]The jqueryui autocomplete plugin conflicts with the jquery autocomplete
plugin used by plone.formwidget.autocomplete, disable the jqueryui one.
[cedricmessiant]Do not break dexterity content type when we don’t have a REQUEST
(in async context).
[thomasdesvenain]We can add contact and contact list fields TTW on dexterity content types.
[thomasdesvenain]1.0 (2013-09-18)Check do_post_sort attribute on source to be able to disable the sorting.Declare dependencies on z3c.relationfield and plone.formwidget.contenttree.Remove ploneform-render-widget view for content provider, this is now
in plone.app.z3cform since 0.7.3.1.0rc1 (2013-03-27)Added hidden and rtf mode templates.
[vincentfretin]Don’t open tooltip in tooltip.
[vincentfretin]0.12 (2013-03-12)Decode title, returning unicode, to standardize term attributes
[sgeulette]0.11 (2013-03-11)Fixed UnicodeDecodeError in @@autocomplete-search
[vincentfretin]Internationalized two messages.
[vincentfretin]Don’t show tooltip if the mouse left the link.
[vincentfretin]Don’t call tokenToUrl if value is –NOVALUE–.
[vincentfretin]0.10 (2013-03-07)Nothing changed yet.0.9 (2013-03-07)Initial release.
[vincentfretin]