.. image:: https://github.com/collective/collective.contact.core/actions/workflows/main.yml/badge.svg
:target: https://github.com/collective/collective.contact.core/actions/workflows/main.yml
.. image:: https://coveralls.io/repos/collective/collective.contact.core/badge.png?branch=master
:target: https://coveralls.io/r/collective/collective.contact.core?branch=master
Introduction
============
This add-on is part of the ``collective.contact.*`` suite. For an overview and a demo of these suite, see `collective.contact.demo <https://github.com/collective/collective.contact.demo>`__.
A Plone add-on that provides a directory where you create persons, organizations, sub-organizations and positions.
How-to
======
First, create a directory in your site. This directory will contain all the informations related to your contacts.
You can then add organizations to this directory. An organization can contain organizations (such as services, divisions or department) or positions (such as CEO, mayor or developer).
You can also add persons to this directory. A person is a physical person that can hold one or more positions or be member of one or more organizations.
To associate a person with an organization or a position, add a held position content type in the person's context.
Consider the following:
* the person type will contain personal contact details
* the held_position type will contain professional contact details
Modify your directory to customize the organization types and the position types that you will associate with your organizations, sub-organizations and positions.
Look at the test data profile collective.contact.core test data for detailed examples.
Configuration
=============
The following configuration can be adapted in the plone registry (prefix=IContactCoreParameters):
* person_contact_details_private : boolean, default to True.
The person contact details are private and will not be used in other context, like held position.
* person_title_in_title : boolean, default to True.
Display person title in displayed person's title.
* use_held_positions_to_search_person : boolean, default to True.
Use held positions to search persons.
* use_description_to_search_person : boolean, default to True.
Use description to search persons.
* display_contact_photo_on_organization_view : boolean, default to True.
Display contact photo on organization view.
* contact_source_metadata_content : choice, default to get_full_title.
Choose information displayed after a search in contact widget.
Localization
============
In some countries (i.e. France) the format of an address is `<nr> <street>` instead of `<street> <nr>`.
You can provide a translation for the `address_line` i18n-msgid in the collective.contact.core translations if this is the case for your country.
You can also patch `collective.contact.core.behaviors.ADDRESS_FIELDS` to make the number field show up before the street in add and edit forms.
In your addon, create a `patches.py` file with this content::
from collective.contact.core import behaviors
behaviors.ADDRESS_FIELDS[0:2] = reversed(behaviors.ADDRESS_FIELDS[0:2])
behaviors.ADDRESS_FIELDS_PLUS_PARENT[2:4] = reversed(behaviors.ADDRESS_FIELDS_PLUS_PARENT[2:4])
and import it in your `__init__.py` so the patches takes effect.
Translations
------------
This product has been translated into
- German.
- Spanish.
- French.
- Italian.
- Slovenian.
You can contribute for any message missing or other new languages, join us at `Plone Collective Team <https://www.transifex.com/plone/plone-collective/>`_ into *Transifex.net* service with all world Plone translators community.
Installation
============
Install collective.contact.core by adding it to your buildout file:
[buildout]
...
eggs =
collective.contact.core
and then running "bin/buildout", next enable the product in your plone site.
Contribute
==========
Have an idea? Found a bug? Let us know by `opening a ticket`_.
- Issue Tracker: https://github.com/collective/collective.contact.core/issues
- Source Code: https://github.com/collective/collective.contact.core
- Documentation: https://github.com/collective/collective.contact.demo/blob/master/README.md
.. _`opening a ticket`: https://github.com/collective/collective.contact.core/issues
Contributors
============
- Gauthier Bastien, IMIO
- Vincent Fretin, Ecreall
- Stéphan Geulette, IMIO
- Cédric Messiant, Ecreall
- Frédéric Peters, Entr'ouvert
- Thomas Desvenain, Ecreall
- Leonardo J. Caballero G., Plone Venezuela
- Laurent Lasudry, Affinitic
Changelog
=========
1.42.0 (2023-09-13)
-------------------
- Set mail index lowercase.
[sgeulette]
1.41 (2023-09-07)
-----------------
- Improved date ranges.
[sgeulette]
1.40 (2023-07-20)
-----------------
- Added plone.app.iterate dependency.
[sgeulette]
- Replaced subscribers grok declaration by zcml
[sgeulette]
- Added subscribers docstrings
[sgeulette]
- fix: [DMS-949] min & max for start_date, end_date
[bleybaert]
1.39 (2022-06-14)
-----------------
- Added `safe_utils.py` that will only include safe utils.
[gbastien]
- Added validation for identifiers token INameTokenTableRowSchema.
[odelaere]
1.38 (2022-02-03)
-----------------
- Removed useless imports in collective.contact.core.schema.
Import ContactList or ContactChoice should be done from collective.contact.widget.schema
[odelaere]
- Added parameter `display_photo_label_on_views` that will display the field photo
`label` instead of default behavior that is only displaying the photo without label.
[gbastien]
1.37 (2021-10-20)
-----------------
- Add image path when exporting
[boulch]
1.36 (2021-04-20)
-----------------
- In vocabulary.OrganizationTypesOrLevels, use `getRequest` instead
`context.REQUEST` to get the current request, in some case like when using a
`plone.restapi` endpoint, `context.REQUEST` could not have an `URL`.
[gbastien]
- Replaced SearchableText indexers by IDynamicTextIndexExtender adapters.
So another extender using IDynamicTextIndexExtender also works (like
collective.behavior.internalnumber).
[sgeulette]
1.35 (2021-01-14)
-----------------
- Added `utils.get_position_type_name` that will return a `position_type name`
for a given `directory` and `position_type token`.
[gbastien]
1.34 (2020-10-07)
-----------------
- Added robot test for collective.contatc.widget 1.12 version.
[daggelpop]
1.33 (2020-08-18)
-----------------
- Add new `enterprise number` field for organization content type
[laulaz]
- Updated Title to work with transmogrifier
[sgeulette]
- Updated birthday widget to manage dates range
[sgeulette]
- Added `create_organization.png` icon useable if necessary
[gbastien]
1.32 (2020-05-08)
-----------------
- Add Transifex.net service integration to manage the translation process.
[macagua]
- Add Spanish translation
[macagua]
- Removed duplicated code displaying two times the logo in organization view.
[gbastien]
1.31 (2020-04-07)
-----------------
- Do not execute integrity check for content types that are not related to this package.
This prevent issues with plone.app.iterate.
[mpeeters]
1.30 (2020-02-06)
-----------------
- Avoid an error when we try to remove a working copy from plone.app.iterate
[mpeeters]
- Display `description` on the organization view. Field `description` may be
filled but was not displayed.
[gbastien]
1.29 (2019-11-25)
-----------------
- Removed overlay on heldposition actions in person view.
[sgeulette]
- Added option to display belowcontenttitle viewlet on contact views.
[sgeulette]
1.28 (2019-11-04)
-----------------
- Ensure than export is unicode encoding.
[boulch]
1.27 (2019-09-20)
-----------------
- Added contact_source metadata to be used in contact widget.
[sgeulette]
- If person details privacy is True, contact details on person don't search related items.
[sgeulette]
1.26 (2019-06-28)
-----------------
- Set `cacheable="True"` for `style.css` in `cssregistry.xml`.
[gbastien]
- Keep div and CSS id `viewlet-below-content-body` when rendering
`plone.belowcontentbody` viewlets on various views.
[gbastien]
- Extended `utils.get_gender_and_number` to manage parameters `use_by` and
`use_to` that will add new values to returned result prepended by
`'B'` or `'T'`.
[gbastien]
- Added email index
[sgeulette, daggelpop]
1.25 (2019-05-16)
-----------------
- Call `@@gender_person_title_mapping.json` from JS on `portal_url`.
[gbastien]
1.24 (2019-01-31)
-----------------
- Added method `held_position.get_label` to get the `held_position` label so it
is easy to override.
[gbastien]
- Removed check on `ajax_load` when rendering `plone.abovecontenttitle` and
`plone.belowcontentbody` viewlet managers or it is not possible to render any
viewlet when content is displayed in an overlay. This was done for
`directory`, `contact`, `organization`, `person` and `position` views.
[gbastien]
1.23 (2018-11-20)
-----------------
- Removed useless Attribute field `is_created` from `IPerson` schema.
Added corresponding migration.
[gbastien]
- Make `held_position.get_title` return unicode.
[gbastien]
- Added parameter `include_person_title=True` to `person.get_title` and to
`held_position.get_person_title` so we get person `firstname/lastname`
without `person_title`.
[gbastien]
- Added image field `person.signature`.
[gbastien]
1.22 (2018-10-12)
-----------------
- Render `plone.abovecontenttitle` and `plone.belowcontentbody` viewlets
in the directory view.
[gbastien]
- Removed useless call to `plone.belowcontent` viewlet in person view.
[gbastien]
1.21 (2018-09-11)
-----------------
- On persons listed on the directory view, display held_positions when hovering
person title (tooltip).
[gbastien]
- Display organization details (tooltip) when hovering organization link.
- Make it easy to override the way sub organizations are displayed on an
organization by calling a @@suborganizations view.
[gbastien]
- Use a tag `<h3>` to display label of `Organizations` and `Positions` contained
in an `Organization` like it is already the case for `Held positions` and
`Other contacts`.
[gbastien]
- Do not use `unittest2` anymore, use `unittest` instead.
[gbastien]
1.20 (2018-07-20)
-----------------
- Added 'utils.get_gender_and_number' that returns the gender and number of a
given list of contacts. This is useful to manage gender (female/male) and
number (singular/plural) for generated words.
[gbastien]
1.19 (2018-07-09)
-----------------
- Add email to SearchableText of a person. Useful when fixing contact data for
smtp error reports after sending a newsletter with collective.contact.mailaction
[fRiSi]
1.18 (2018-06-07)
-----------------
- Use real full title in held_position and position get_full_title methods.
Necessary to display to the end user the right organization, without ambiguity.
[sgeulette]
- Prevent address fields from being erased if they are changed programmaticaly before any manual edition.
[thomasdesvenain]
- Prevent title ascii error on organization vcard export.
[bsuttor]
- Prevent fatal error if there is no organization on held_position.
[thomasdesvenain]
- Prevent error when person is None on held_position.
[Gagaro]
- Use another version than 1.2.8 for plone.app.textfield as version 1.2.9
fixes issue we had in tests.
(See https://github.com/plone/plone.app.textfield/issues/22).
[gbastien]
- Display positions on the organization view respecting order (getObjPositionInParent).
[gbastien]
- Display various content title consistently everywhere in the application.
[gbastien, sgeulette]
- Display content icon before content title.
[gbastien]
- Added parameter display_contact_photo_on_organization_view to the registry,
it True (default), the contact photo is displayed in the @@othercontacts, if
False, the person content_type icon is displayed.
[gbastien]
1.17 (2017-10-02)
-----------------
- Fix get_valid_url mehtod when there is accent into url.
[bsuttor]
1.16 (2017-09-22)
-----------------
- Set person_contact_details_private option to true by default.
[sgeulette]
1.15 (2017-05-30)
-----------------
- Fix robot tests.
[thomasdesvenain]
- Don't purge behaviors when reinstalling.
[sgeulette]
- Set plone.app.textfield maximum version as 1.2.7
[thomasdesvenain]
1.14 (2017-05-16)
-----------------
- Lint for code-analysis.
[bsuttor]
1.13 (2017-05-16)
-----------------
- Set IContactDetails behavior on held_position type.
Person contact details are considered as personal data.
[sgeulette]
- Use a python view to provide gender/person title mapping. In this way, the terms can be translated.
[cedricmessiant]
- Avoid error in addcontact when there is no directory.
[cedricmessiant]
- Prevent fatal error 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]
- Refactor: move complex sortable title methods into content objects.
[thomasdesvenain]
1.12 (2017-01-17)
-----------------
- Change field order for address (`<street> <nr>` - as this is more common in most countries)
* address format can be localized by using msgid `address_line`
* field order in add and edit forms can be patched (see README for details)
(fixes #29) [fRiSi]
- Fixed indexing a held position which organization has been removed.
[thomasdesvenain]
- Add translations for de, it, fr and sl.
[fRiSi]
1.11 (2016-10-13)
-----------------
- Fix setup_relation_dependency when many are setup on the same page.
[thomasdesvenain]
- Fix "create contact" widget link when master organization field value has
changed or has become empty.
[thomasdesvenain]
1.10 (2016-10-05)
-----------------
- Fix AddContact form problem with security hotfix 20160830
[ebrehault]
1.9 (2016-07-07)
----------------
- Reindex suborganizations (and positions and held positions) when an
organization is modified.
[vincentfretin]
- Use start and end indexes for held_position.
[sgeulette]
1.8 (2016-03-31)
----------------
- Hide contact types from the navigation.
[pcdummy]
- Sort sub organizations by folder position in organization view
[sgeulette]
1.7 (2016-03-04)
----------------
- Do not hide token column in edit mode
[sgeulette]
- Expose person_title in held_position
[ebrehault]
1.6 (2015-11-24)
----------------
- Fix slave field creation button for held positions
[ebrehault]
- Fix organization searchable text when related organizations
[ebrehault]
- Allow reorder on directory fields
[cedricmessiant]
- Fix prelabel_for_portal_type signature.
Some javascript fixes or improvements.
[vincentfretin]
- Use different views/schemas for different use cases for add-contact widget
[cedricmessiant]
1.5 (2015-06-02)
----------------
- Feature: Display held positions start date and end date on organization view.
[cedricmessiant]
- Feature: Add custom settings to override prelabel and label of the 'Create' link in widget.
[cedricmessiant]
- Added italian translation
[keul]
- JSLint fixes (invalid commas)
[keul]
1.4 (2015-04-03)
----------------
- Fix javascript that was disabled by error in addcontact view.
- Feature: Add parameter to choose if we want to use description to search
persons.
[cedricmessiant]
- UI: Turn phone numbers into clickable tel: links.
[jazwsophie]
- Feature: Add parameter to choose if we want to use held positions to search
persons.
[cedricmessiant]
1.3 (2014-09-11)
----------------
- Feature: Simple validator for phone number.
[thomasdesvenain]
- UI: If website doesn't start with http, add http:// at its beginning.
[cedricmessiant]
- UI: Open external web site in a new window.
[vincentfretin]
- UI: Avoid the contact information of a person be displayed two times
when it fall backs from organization or function.
[thomasdesvenain]
- UI: If a contact field is dependent to a position or an organization,
we update 'add new' link of the contact field
so that the 'position' or 'organization' field is pre-selected in the overlay.
[thomasdesvenain]
- UI: use classes instead of ids on address because it can be used
several times on the same page.
[thomasdesvenain]
- API: added a nonfallbackcontactdetails view that displays only direct contact details.
Useful when you want to display contact details of a contact and contact details
of objects it is related to on the same page: it avoids double displays.
Apply it on held positions view.
[thomasdesvenain]
- Fix: If held position implements IContactDetails behavior,
then show contact details fields on add contact form.
[thomasdesvenain]
- Fix: If 'use parent address' has been selected,
ensure content address fields are cleared.
[thomasdesvenain]
- Fix: Hide use parent address:
- works in overlays,
- always display use parent address on held position if it implements contact details.
[thomasdesvenain]
- Fix: Avoid failure on person
if for any reason person title, firstname or lastname attribute is not set.
[thomasdesvenain]
- Fix: Switch street and additional data on address view.
[thomasdesvenain]
- Fix: address fallback in excel export.
[thomasdesvenain]
- Fix: VCard - avoid failure if no 'person_title' is set on content.
[thomasdesvenain]
- Fix: Contact might not have any aq_parent
[ebrehault]
- Hide 'Use parent address' checkbox only if it is not checked and if parent
address is empty
[ebrehault]
1.2 (2014-06-16)
----------------
- Contact details of a person fallbacks to person's main position
get from IPersonHeldPositions adapter.
[thomasdesvenain]
- Added an IPersonHeldPositions adapter that gets positions sorted by status :
a main position, all current positions, closed positions.
[thomasdesvenain]
- Sort get_held_positions on organization.
[cedricmessiant]
- Add plone.abovecontenttitle viewlet manager to person, organization, position
and contact (held_position) views.
[vincentfretin]
- js functions have a namespace.
[thomasdesvenain]
- Add an api to make dependencies between a contact field and an other one.
(needs collective.contact.widget >= 1.2)
[thomasdesvenain]
- Add parameter to choose if we want to display person title in person's displayed title.
[cedricmessiant]
- Tools for excel export with collective.excelexport:
- renderer for contact field,
- exportable to show person infos on held_position export.
[thomasdesvenain]
1.1 (2014-03-11)
----------------
- Remove meta_type override because it breaks copy support.
[thomasdesvenain]
- Fix if for any reason use_parent_address is True, content has an address and
has no parent with an address.
[thomasdesvenain]
- Add help messages on add contact form.
[thomasdesvenain]
- Display more information about "other contacts" in organization view.
[cedricmessiant]
- Add ICustomSettings adapter lookup in widget settings utility to be
able to overrides add_url_for_portal_type method in some projects.
[vincentfretin]
- Rewrite every contact content view in separate views (basefields, contactdetails, etc) so
that we can override only a specific part of the view in customer projects.
[cedricmessiant]
- Rename all contact content views to "view".
[cedricmessiant]
- Add hcard microformat (see http://microformats.org/wiki/hcard) for person and organization.
[cedricmessiant]
- Use a macro to display contact details.
[thomasdesvenain]
- Manage case users have uploaded non-image formats for logo or photo.
[thomasdesvenain]
- Display behavior fields on contactable views
once they are in default fieldset.
[thomasdesvenain]
- Fixed: keep order of TTW fields displayed on view pages.
[thomasdesvenain]
- Add tooltip overviews for held positions, persons, positions and organizations.
[cedricmessiant]
- Use thumb scale for logos and photos.
[cedricmessiant]
- Add icon for 'Create Contact' link on position and organization pages.
[cedricmessiant]
- Customize sortable_title indexer for Person and Held Position
and add a corresponding brain
metadata (to enable use of this index in collective.contact.facetednav
alphabetic search widget).
[cedricmessiant]
- A content that just implements IContactDetails behavior
is adaptatable to IContactable and have a VCal export.
[thomasdesvenain]
- We can hide Use parent address field using a permission:
"collective.contact.core.UseParentAddress"
So it is possible to remove this feature via rolemap
or remove it on some content types via workflow.
[thomasdesvenain]
- Don't crash when deleting position or organization if a held position is
associated with it. Show relations that will be broken
(plone.app.linkintegrity integration).
[vincentfretin]
- Fix ObjectModifiedEvent subscribers to not reindex if event is
a ContainerModifiedEvent.
[vincentfretin]
- Don't show use_parent_address checkbox if there is no parent address.
[cedricmessiant]
- Fix parent address in add forms.
[cedricmessiant]
- Add more robot framework tests.
[cedricmessiant]
- Add 'Create Contact' link on position view.
[cedricmessiant]
- Use full title instead of Title in position view title.
[cedricmessiant]
- Show organization's and root organization's name in position's full title.
[cedricmessiant]
- Add first organization title in held position's title.
[cedricmessiant]
- Added logo and activity rich field on organization type.
[thomasdesvenain]
- Fixed generate id from title on held positions and persons.
[thomasdesvenain]
- When we get the address of a contact, if the most direct address is empty,
look for the next.
[thomasdesvenain]
- Added Fax and Website fields to IContactDetails and IContactable.
[thomasdesvenain]
- Fixed javascript in @@add-organization view.
[vincentfretin]
- Fixed use parent address if we set Contact Details behaviour on held positions.
[thomasdesvenain]
- Add vCard support to organizations
[ebrehault]
1.0 (2013-09-13)
----------------
- Birthday is now optional as a behaviour.
[thomasdesvenain]
- Use (-200, 1) years range for birthday field.
[vincentfretin]
- "Add new" popup link is renamed from "Add ..." to "Create ..."
[thomasdesvenain]
- New behaviour to add a "Related organizations" field on a content type.
[thomasdesvenain]
- Plain text search improvements:
- we can find persons with organization names, functions names,
- the same for held positions,
- indexation is updated when organization or function changes
[thomasdesvenain]
- Messages that document better the organization / position held position
adding process.
[thomasdesvenain]
- Display position label in title of held position view page.
[thomasdesvenain]
- Added an additional input text label to held positions,
used on titles if held_position is directly related to an organization.
[thomasdesvenain]
- Display contacts on organization page.
[thomasdesvenain]
- We can find a function with the organization name.
[thomasdesvenain]
- Fixed field customization view.
[vincentfretin, thomasdesvenain]
- Fixed held_position field showing in Add contact overlay if Plone site id
is different of Plone.
[vincentfretin]
- Added workflows for contact objects.
[cedricmessiant]
0.11 (2013-03-11)
-----------------
- Fixed bug with default views.
[cedricmessiant]
0.10 (2013-03-07)
-----------------
- Fixed MANIFEST.in
[cedricmessiant]
0.9 (2013-03-07)
----------------
- Initial release
[cedricmessiant]
Raw data
{
"_id": null,
"home_page": "https://github.com/collective/collective.contact.core",
"name": "collective.contact.core",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "plone contact management organization person position",
"author": "\"Cedric Messiant\"",
"author_email": "cedricmessiant@ecreall.com",
"download_url": "https://files.pythonhosted.org/packages/30/09/c80608b0b9fd635ed1eae3a59e5a32ba83dbf5b71cf6e483a5bc808d520b/collective.contact.core-1.42.0.tar.gz",
"platform": null,
"description": ".. image:: https://github.com/collective/collective.contact.core/actions/workflows/main.yml/badge.svg\n :target: https://github.com/collective/collective.contact.core/actions/workflows/main.yml\n\n.. image:: https://coveralls.io/repos/collective/collective.contact.core/badge.png?branch=master\n :target: https://coveralls.io/r/collective/collective.contact.core?branch=master\n\n\nIntroduction\n============\n\nThis add-on is part of the ``collective.contact.*`` suite. For an overview and a demo of these suite, see `collective.contact.demo <https://github.com/collective/collective.contact.demo>`__.\n\nA Plone add-on that provides a directory where you create persons, organizations, sub-organizations and positions.\n\n\nHow-to\n======\n\nFirst, create a directory in your site. This directory will contain all the informations related to your contacts.\n\nYou can then add organizations to this directory. An organization can contain organizations (such as services, divisions or department) or positions (such as CEO, mayor or developer).\n\nYou can also add persons to this directory. A person is a physical person that can hold one or more positions or be member of one or more organizations.\nTo associate a person with an organization or a position, add a held position content type in the person's context.\n\nConsider the following:\n\n* the person type will contain personal contact details\n* the held_position type will contain professional contact details\n\nModify your directory to customize the organization types and the position types that you will associate with your organizations, sub-organizations and positions.\n\nLook at the test data profile collective.contact.core test data for detailed examples.\n\n\nConfiguration\n=============\n\nThe following configuration can be adapted in the plone registry (prefix=IContactCoreParameters):\n\n* person_contact_details_private : boolean, default to True.\n The person contact details are private and will not be used in other context, like held position.\n* person_title_in_title : boolean, default to True.\n Display person title in displayed person's title.\n* use_held_positions_to_search_person : boolean, default to True.\n Use held positions to search persons.\n* use_description_to_search_person : boolean, default to True.\n Use description to search persons.\n* display_contact_photo_on_organization_view : boolean, default to True.\n Display contact photo on organization view.\n* contact_source_metadata_content : choice, default to get_full_title.\n Choose information displayed after a search in contact widget.\n\nLocalization\n============\n\nIn some countries (i.e. France) the format of an address is `<nr> <street>` instead of `<street> <nr>`.\n\nYou can provide a translation for the `address_line` i18n-msgid in the collective.contact.core translations if this is the case for your country.\n\nYou can also patch `collective.contact.core.behaviors.ADDRESS_FIELDS` to make the number field show up before the street in add and edit forms.\n\nIn your addon, create a `patches.py` file with this content::\n\n from collective.contact.core import behaviors\n behaviors.ADDRESS_FIELDS[0:2] = reversed(behaviors.ADDRESS_FIELDS[0:2])\n behaviors.ADDRESS_FIELDS_PLUS_PARENT[2:4] = reversed(behaviors.ADDRESS_FIELDS_PLUS_PARENT[2:4])\n\nand import it in your `__init__.py` so the patches takes effect.\n\n\nTranslations\n------------\n\nThis product has been translated into\n\n- German.\n\n- Spanish.\n\n- French.\n\n- Italian.\n\n- Slovenian.\n\nYou can contribute for any message missing or other new languages, join us at `Plone Collective Team <https://www.transifex.com/plone/plone-collective/>`_ into *Transifex.net* service with all world Plone translators community.\n\n\nInstallation\n============\n\nInstall collective.contact.core by adding it to your buildout file:\n\n [buildout]\n\n ...\n\n eggs =\n collective.contact.core\n\n\nand then running \"bin/buildout\", next enable the product in your plone site.\n\n\nContribute\n==========\n\nHave an idea? Found a bug? Let us know by `opening a ticket`_.\n\n- Issue Tracker: https://github.com/collective/collective.contact.core/issues\n- Source Code: https://github.com/collective/collective.contact.core\n- Documentation: https://github.com/collective/collective.contact.demo/blob/master/README.md\n\n.. _`opening a ticket`: https://github.com/collective/collective.contact.core/issues\n\nContributors\n============\n\n- Gauthier Bastien, IMIO\n- Vincent Fretin, Ecreall\n- St\u00e9phan Geulette, IMIO\n- C\u00e9dric Messiant, Ecreall\n- Fr\u00e9d\u00e9ric Peters, Entr'ouvert\n- Thomas Desvenain, Ecreall\n- Leonardo J. Caballero G., Plone Venezuela\n- Laurent Lasudry, Affinitic\n\nChangelog\n=========\n\n1.42.0 (2023-09-13)\n-------------------\n\n- Set mail index lowercase.\n [sgeulette]\n\n1.41 (2023-09-07)\n-----------------\n\n- Improved date ranges.\n [sgeulette]\n\n1.40 (2023-07-20)\n-----------------\n\n- Added plone.app.iterate dependency.\n [sgeulette]\n- Replaced subscribers grok declaration by zcml\n [sgeulette]\n- Added subscribers docstrings\n [sgeulette]\n- fix: [DMS-949] min & max for start_date, end_date\n [bleybaert]\n\n1.39 (2022-06-14)\n-----------------\n\n- Added `safe_utils.py` that will only include safe utils.\n [gbastien]\n- Added validation for identifiers token INameTokenTableRowSchema.\n [odelaere]\n\n1.38 (2022-02-03)\n-----------------\n\n- Removed useless imports in collective.contact.core.schema.\n Import ContactList or ContactChoice should be done from collective.contact.widget.schema\n [odelaere]\n- Added parameter `display_photo_label_on_views` that will display the field photo\n `label` instead of default behavior that is only displaying the photo without label.\n [gbastien]\n\n1.37 (2021-10-20)\n-----------------\n\n- Add image path when exporting\n [boulch]\n\n1.36 (2021-04-20)\n-----------------\n\n- In vocabulary.OrganizationTypesOrLevels, use `getRequest` instead\n `context.REQUEST` to get the current request, in some case like when using a\n `plone.restapi` endpoint, `context.REQUEST` could not have an `URL`.\n [gbastien]\n- Replaced SearchableText indexers by IDynamicTextIndexExtender adapters.\n So another extender using IDynamicTextIndexExtender also works (like\n collective.behavior.internalnumber).\n [sgeulette]\n\n1.35 (2021-01-14)\n-----------------\n\n- Added `utils.get_position_type_name` that will return a `position_type name`\n for a given `directory` and `position_type token`.\n [gbastien]\n\n1.34 (2020-10-07)\n-----------------\n\n- Added robot test for collective.contatc.widget 1.12 version.\n [daggelpop]\n\n1.33 (2020-08-18)\n-----------------\n\n- Add new `enterprise number` field for organization content type\n [laulaz]\n- Updated Title to work with transmogrifier\n [sgeulette]\n- Updated birthday widget to manage dates range\n [sgeulette]\n- Added `create_organization.png` icon useable if necessary\n [gbastien]\n\n1.32 (2020-05-08)\n-----------------\n\n- Add Transifex.net service integration to manage the translation process.\n [macagua]\n- Add Spanish translation\n [macagua]\n- Removed duplicated code displaying two times the logo in organization view.\n [gbastien]\n\n\n1.31 (2020-04-07)\n-----------------\n\n- Do not execute integrity check for content types that are not related to this package.\n This prevent issues with plone.app.iterate.\n [mpeeters]\n\n\n1.30 (2020-02-06)\n-----------------\n\n- Avoid an error when we try to remove a working copy from plone.app.iterate\n [mpeeters]\n- Display `description` on the organization view. Field `description` may be\n filled but was not displayed.\n [gbastien]\n\n1.29 (2019-11-25)\n-----------------\n\n- Removed overlay on heldposition actions in person view.\n [sgeulette]\n- Added option to display belowcontenttitle viewlet on contact views.\n [sgeulette]\n\n1.28 (2019-11-04)\n-----------------\n\n- Ensure than export is unicode encoding.\n [boulch]\n\n1.27 (2019-09-20)\n-----------------\n\n- Added contact_source metadata to be used in contact widget.\n [sgeulette]\n- If person details privacy is True, contact details on person don't search related items.\n [sgeulette]\n\n1.26 (2019-06-28)\n-----------------\n\n- Set `cacheable=\"True\"` for `style.css` in `cssregistry.xml`.\n [gbastien]\n- Keep div and CSS id `viewlet-below-content-body` when rendering\n `plone.belowcontentbody` viewlets on various views.\n [gbastien]\n- Extended `utils.get_gender_and_number` to manage parameters `use_by` and\n `use_to` that will add new values to returned result prepended by\n `'B'` or `'T'`.\n [gbastien]\n- Added email index\n [sgeulette, daggelpop]\n\n1.25 (2019-05-16)\n-----------------\n\n- Call `@@gender_person_title_mapping.json` from JS on `portal_url`.\n [gbastien]\n\n1.24 (2019-01-31)\n-----------------\n\n- Added method `held_position.get_label` to get the `held_position` label so it\n is easy to override.\n [gbastien]\n- Removed check on `ajax_load` when rendering `plone.abovecontenttitle` and\n `plone.belowcontentbody` viewlet managers or it is not possible to render any\n viewlet when content is displayed in an overlay. This was done for\n `directory`, `contact`, `organization`, `person` and `position` views.\n [gbastien]\n\n1.23 (2018-11-20)\n-----------------\n\n- Removed useless Attribute field `is_created` from `IPerson` schema.\n Added corresponding migration.\n [gbastien]\n- Make `held_position.get_title` return unicode.\n [gbastien]\n- Added parameter `include_person_title=True` to `person.get_title` and to\n `held_position.get_person_title` so we get person `firstname/lastname`\n without `person_title`.\n [gbastien]\n- Added image field `person.signature`.\n [gbastien]\n\n1.22 (2018-10-12)\n-----------------\n\n- Render `plone.abovecontenttitle` and `plone.belowcontentbody` viewlets\n in the directory view.\n [gbastien]\n- Removed useless call to `plone.belowcontent` viewlet in person view.\n [gbastien]\n\n1.21 (2018-09-11)\n-----------------\n\n- On persons listed on the directory view, display held_positions when hovering\n person title (tooltip).\n [gbastien]\n- Display organization details (tooltip) when hovering organization link.\n- Make it easy to override the way sub organizations are displayed on an\n organization by calling a @@suborganizations view.\n [gbastien]\n- Use a tag `<h3>` to display label of `Organizations` and `Positions` contained\n in an `Organization` like it is already the case for `Held positions` and\n `Other contacts`.\n [gbastien]\n- Do not use `unittest2` anymore, use `unittest` instead.\n [gbastien]\n\n1.20 (2018-07-20)\n-----------------\n\n- Added 'utils.get_gender_and_number' that returns the gender and number of a\n given list of contacts. This is useful to manage gender (female/male) and\n number (singular/plural) for generated words.\n [gbastien]\n\n1.19 (2018-07-09)\n-----------------\n\n- Add email to SearchableText of a person. Useful when fixing contact data for\n smtp error reports after sending a newsletter with collective.contact.mailaction\n [fRiSi]\n\n1.18 (2018-06-07)\n-----------------\n\n- Use real full title in held_position and position get_full_title methods.\n Necessary to display to the end user the right organization, without ambiguity.\n [sgeulette]\n\n- Prevent address fields from being erased if they are changed programmaticaly before any manual edition.\n [thomasdesvenain]\n\n- Prevent title ascii error on organization vcard export.\n [bsuttor]\n\n- Prevent fatal error if there is no organization on held_position.\n [thomasdesvenain]\n\n- Prevent error when person is None on held_position.\n [Gagaro]\n\n- Use another version than 1.2.8 for plone.app.textfield as version 1.2.9\n fixes issue we had in tests.\n (See https://github.com/plone/plone.app.textfield/issues/22).\n [gbastien]\n\n- Display positions on the organization view respecting order (getObjPositionInParent).\n [gbastien]\n\n- Display various content title consistently everywhere in the application.\n [gbastien, sgeulette]\n\n- Display content icon before content title.\n [gbastien]\n\n- Added parameter display_contact_photo_on_organization_view to the registry,\n it True (default), the contact photo is displayed in the @@othercontacts, if\n False, the person content_type icon is displayed.\n [gbastien]\n\n1.17 (2017-10-02)\n-----------------\n\n- Fix get_valid_url mehtod when there is accent into url.\n [bsuttor]\n\n\n1.16 (2017-09-22)\n-----------------\n\n- Set person_contact_details_private option to true by default.\n [sgeulette]\n\n1.15 (2017-05-30)\n-----------------\n\n- Fix robot tests.\n [thomasdesvenain]\n\n- Don't purge behaviors when reinstalling.\n [sgeulette]\n\n- Set plone.app.textfield maximum version as 1.2.7\n [thomasdesvenain]\n\n\n1.14 (2017-05-16)\n-----------------\n\n- Lint for code-analysis.\n [bsuttor]\n\n\n1.13 (2017-05-16)\n-----------------\n\n- Set IContactDetails behavior on held_position type.\n Person contact details are considered as personal data.\n [sgeulette]\n\n- Use a python view to provide gender/person title mapping. In this way, the terms can be translated.\n [cedricmessiant]\n\n- Avoid error in addcontact when there is no directory.\n [cedricmessiant]\n\n- Prevent fatal error if by chance a held position related to a position or an organisation has been removed\n but the relation always exist. An error is logged.\n [thomasdesvenain]\n\n- Refactor: move complex sortable title methods into content objects.\n [thomasdesvenain]\n\n\n1.12 (2017-01-17)\n-----------------\n\n- Change field order for address (`<street> <nr>` - as this is more common in most countries)\n\n * address format can be localized by using msgid `address_line`\n * field order in add and edit forms can be patched (see README for details)\n\n (fixes #29) [fRiSi]\n\n- Fixed indexing a held position which organization has been removed.\n [thomasdesvenain]\n\n- Add translations for de, it, fr and sl.\n [fRiSi]\n\n1.11 (2016-10-13)\n-----------------\n\n- Fix setup_relation_dependency when many are setup on the same page.\n [thomasdesvenain]\n\n- Fix \"create contact\" widget link when master organization field value has\n changed or has become empty.\n [thomasdesvenain]\n\n1.10 (2016-10-05)\n-----------------\n\n- Fix AddContact form problem with security hotfix 20160830\n [ebrehault]\n\n1.9 (2016-07-07)\n----------------\n\n- Reindex suborganizations (and positions and held positions) when an\n organization is modified.\n [vincentfretin]\n\n- Use start and end indexes for held_position.\n [sgeulette]\n\n1.8 (2016-03-31)\n----------------\n\n- Hide contact types from the navigation.\n [pcdummy]\n\n- Sort sub organizations by folder position in organization view\n [sgeulette]\n\n1.7 (2016-03-04)\n----------------\n\n- Do not hide token column in edit mode\n [sgeulette]\n\n- Expose person_title in held_position\n [ebrehault]\n\n1.6 (2015-11-24)\n----------------\n\n- Fix slave field creation button for held positions\n [ebrehault]\n\n- Fix organization searchable text when related organizations\n [ebrehault]\n\n- Allow reorder on directory fields\n [cedricmessiant]\n\n- Fix prelabel_for_portal_type signature.\n Some javascript fixes or improvements.\n [vincentfretin]\n\n- Use different views/schemas for different use cases for add-contact widget\n [cedricmessiant]\n\n1.5 (2015-06-02)\n----------------\n\n- Feature: Display held positions start date and end date on organization view.\n [cedricmessiant]\n\n- Feature: Add custom settings to override prelabel and label of the 'Create' link in widget.\n [cedricmessiant]\n\n- Added italian translation\n [keul]\n\n- JSLint fixes (invalid commas)\n [keul]\n\n1.4 (2015-04-03)\n----------------\n\n- Fix javascript that was disabled by error in addcontact view.\n\n- Feature: Add parameter to choose if we want to use description to search\n persons.\n [cedricmessiant]\n\n- UI: Turn phone numbers into clickable tel: links.\n [jazwsophie]\n\n- Feature: Add parameter to choose if we want to use held positions to search\n persons.\n [cedricmessiant]\n\n\n1.3 (2014-09-11)\n----------------\n\n- Feature: Simple validator for phone number.\n [thomasdesvenain]\n\n- UI: If website doesn't start with http, add http:// at its beginning.\n [cedricmessiant]\n\n- UI: Open external web site in a new window.\n [vincentfretin]\n\n- UI: Avoid the contact information of a person be displayed two times\n when it fall backs from organization or function.\n [thomasdesvenain]\n\n- UI: If a contact field is dependent to a position or an organization,\n we update 'add new' link of the contact field\n so that the 'position' or 'organization' field is pre-selected in the overlay.\n [thomasdesvenain]\n\n- UI: use classes instead of ids on address because it can be used\n several times on the same page.\n [thomasdesvenain]\n\n- API: added a nonfallbackcontactdetails view that displays only direct contact details.\n Useful when you want to display contact details of a contact and contact details\n of objects it is related to on the same page: it avoids double displays.\n Apply it on held positions view.\n [thomasdesvenain]\n\n- Fix: If held position implements IContactDetails behavior,\n then show contact details fields on add contact form.\n [thomasdesvenain]\n\n- Fix: If 'use parent address' has been selected,\n ensure content address fields are cleared.\n [thomasdesvenain]\n\n- Fix: Hide use parent address:\n - works in overlays,\n - always display use parent address on held position if it implements contact details.\n\n [thomasdesvenain]\n\n- Fix: Avoid failure on person\n if for any reason person title, firstname or lastname attribute is not set.\n [thomasdesvenain]\n\n- Fix: Switch street and additional data on address view.\n [thomasdesvenain]\n\n- Fix: address fallback in excel export.\n [thomasdesvenain]\n\n- Fix: VCard - avoid failure if no 'person_title' is set on content.\n [thomasdesvenain]\n\n- Fix: Contact might not have any aq_parent\n [ebrehault]\n\n- Hide 'Use parent address' checkbox only if it is not checked and if parent\n address is empty\n [ebrehault]\n\n\n1.2 (2014-06-16)\n----------------\n\n- Contact details of a person fallbacks to person's main position\n get from IPersonHeldPositions adapter.\n [thomasdesvenain]\n\n- Added an IPersonHeldPositions adapter that gets positions sorted by status :\n a main position, all current positions, closed positions.\n [thomasdesvenain]\n\n- Sort get_held_positions on organization.\n [cedricmessiant]\n\n- Add plone.abovecontenttitle viewlet manager to person, organization, position\n and contact (held_position) views.\n [vincentfretin]\n\n- js functions have a namespace.\n [thomasdesvenain]\n\n- Add an api to make dependencies between a contact field and an other one.\n (needs collective.contact.widget >= 1.2)\n [thomasdesvenain]\n\n- Add parameter to choose if we want to display person title in person's displayed title.\n [cedricmessiant]\n\n- Tools for excel export with collective.excelexport:\n - renderer for contact field,\n - exportable to show person infos on held_position export.\n [thomasdesvenain]\n\n\n1.1 (2014-03-11)\n----------------\n\n- Remove meta_type override because it breaks copy support.\n [thomasdesvenain]\n\n- Fix if for any reason use_parent_address is True, content has an address and\n has no parent with an address.\n [thomasdesvenain]\n\n- Add help messages on add contact form.\n [thomasdesvenain]\n\n- Display more information about \"other contacts\" in organization view.\n [cedricmessiant]\n\n- Add ICustomSettings adapter lookup in widget settings utility to be\n able to overrides add_url_for_portal_type method in some projects.\n [vincentfretin]\n\n- Rewrite every contact content view in separate views (basefields, contactdetails, etc) so\n that we can override only a specific part of the view in customer projects.\n [cedricmessiant]\n\n- Rename all contact content views to \"view\".\n [cedricmessiant]\n\n- Add hcard microformat (see http://microformats.org/wiki/hcard) for person and organization.\n [cedricmessiant]\n\n- Use a macro to display contact details.\n [thomasdesvenain]\n\n- Manage case users have uploaded non-image formats for logo or photo.\n [thomasdesvenain]\n\n- Display behavior fields on contactable views\n once they are in default fieldset.\n [thomasdesvenain]\n\n- Fixed: keep order of TTW fields displayed on view pages.\n [thomasdesvenain]\n\n- Add tooltip overviews for held positions, persons, positions and organizations.\n [cedricmessiant]\n\n- Use thumb scale for logos and photos.\n [cedricmessiant]\n\n- Add icon for 'Create Contact' link on position and organization pages.\n [cedricmessiant]\n\n- Customize sortable_title indexer for Person and Held Position\n and add a corresponding brain\n metadata (to enable use of this index in collective.contact.facetednav\n alphabetic search widget).\n [cedricmessiant]\n\n- A content that just implements IContactDetails behavior\n is adaptatable to IContactable and have a VCal export.\n [thomasdesvenain]\n\n- We can hide Use parent address field using a permission:\n \"collective.contact.core.UseParentAddress\"\n So it is possible to remove this feature via rolemap\n or remove it on some content types via workflow.\n [thomasdesvenain]\n\n- Don't crash when deleting position or organization if a held position is\n associated with it. Show relations that will be broken\n (plone.app.linkintegrity integration).\n [vincentfretin]\n\n- Fix ObjectModifiedEvent subscribers to not reindex if event is\n a ContainerModifiedEvent.\n [vincentfretin]\n\n- Don't show use_parent_address checkbox if there is no parent address.\n [cedricmessiant]\n\n- Fix parent address in add forms.\n [cedricmessiant]\n\n- Add more robot framework tests.\n [cedricmessiant]\n\n- Add 'Create Contact' link on position view.\n [cedricmessiant]\n\n- Use full title instead of Title in position view title.\n [cedricmessiant]\n\n- Show organization's and root organization's name in position's full title.\n [cedricmessiant]\n\n- Add first organization title in held position's title.\n [cedricmessiant]\n\n- Added logo and activity rich field on organization type.\n [thomasdesvenain]\n\n- Fixed generate id from title on held positions and persons.\n [thomasdesvenain]\n\n- When we get the address of a contact, if the most direct address is empty,\n look for the next.\n [thomasdesvenain]\n\n- Added Fax and Website fields to IContactDetails and IContactable.\n [thomasdesvenain]\n\n- Fixed javascript in @@add-organization view.\n [vincentfretin]\n\n- Fixed use parent address if we set Contact Details behaviour on held positions.\n [thomasdesvenain]\n\n- Add vCard support to organizations\n [ebrehault]\n\n1.0 (2013-09-13)\n----------------\n\n- Birthday is now optional as a behaviour.\n [thomasdesvenain]\n\n- Use (-200, 1) years range for birthday field.\n [vincentfretin]\n\n- \"Add new\" popup link is renamed from \"Add ...\" to \"Create ...\"\n [thomasdesvenain]\n\n- New behaviour to add a \"Related organizations\" field on a content type.\n [thomasdesvenain]\n\n- Plain text search improvements:\n - we can find persons with organization names, functions names,\n - the same for held positions,\n - indexation is updated when organization or function changes\n\n [thomasdesvenain]\n\n- Messages that document better the organization / position held position\n adding process.\n [thomasdesvenain]\n\n- Display position label in title of held position view page.\n [thomasdesvenain]\n\n- Added an additional input text label to held positions,\n used on titles if held_position is directly related to an organization.\n [thomasdesvenain]\n\n- Display contacts on organization page.\n [thomasdesvenain]\n\n- We can find a function with the organization name.\n [thomasdesvenain]\n\n- Fixed field customization view.\n [vincentfretin, thomasdesvenain]\n\n- Fixed held_position field showing in Add contact overlay if Plone site id\n is different of Plone.\n [vincentfretin]\n\n- Added workflows for contact objects.\n [cedricmessiant]\n\n\n0.11 (2013-03-11)\n-----------------\n\n- Fixed bug with default views.\n [cedricmessiant]\n\n\n0.10 (2013-03-07)\n-----------------\n\n- Fixed MANIFEST.in\n [cedricmessiant]\n\n\n0.9 (2013-03-07)\n----------------\n\n- Initial release\n [cedricmessiant]\n\n\n\n",
"bugtrack_url": null,
"license": "gpl",
"summary": "Core package for collective.contact add-ons",
"version": "1.42.0",
"project_urls": {
"Download": "https://pypi.org/project/collective.contact.core",
"Homepage": "https://github.com/collective/collective.contact.core"
},
"split_keywords": [
"plone",
"contact",
"management",
"organization",
"person",
"position"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3009c80608b0b9fd635ed1eae3a59e5a32ba83dbf5b71cf6e483a5bc808d520b",
"md5": "732e1f0a4a30285315da0d83ef19b57d",
"sha256": "4eaa143a406777716cc85736d0c032fc8c7bcccaf1880af48d0568bb14aeccbb"
},
"downloads": -1,
"filename": "collective.contact.core-1.42.0.tar.gz",
"has_sig": false,
"md5_digest": "732e1f0a4a30285315da0d83ef19b57d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 110082,
"upload_time": "2023-09-13T12:48:37",
"upload_time_iso_8601": "2023-09-13T12:48:37.060097Z",
"url": "https://files.pythonhosted.org/packages/30/09/c80608b0b9fd635ed1eae3a59e5a32ba83dbf5b71cf6e483a5bc808d520b/collective.contact.core-1.42.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-13 12:48:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "collective",
"github_project": "collective.contact.core",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "collective.contact.core"
}
JSON
