.. contents::
Overview
========
This plone product allows you to import / export portal's members within CSV
files. Few properties may equally been set.
Description
===========
* after being installed with the Quickinstaller tool, it adds an additional
item in the control panel.
* Informations concerned are those managed by portal_registration and portal_membership.
(i.e. username, password, roles, emails, location, description ...)
* A CSV template is directly available via the control panel, to use as a base
for your own CSV file.
* There is no pretreatment. Data are used out-of-the-box. If any error occured
in the CSV while importing, you have to correct those yourself.
* On errors, this product allows you to download a CSV file only filled with the
matching lines. Use it to correct your errors, then retry.
Installation
============
* Use buildout, add atreal.usersinout in both of your egg and zcml sections.
Important
=========
Off course, those functionalities are only available for member with 'Manager' role.
Note
====
* Adding member in group(s) is now supported, but currently the export not
implemented.
* Global roles can be imported but currently not exported. Will be implemented soon.
Authors
=======
|atreal|_
* `atReal Team`_
- Matthias Broquet [tiazma]
.. |atreal| image:: http://www.atreal.fr/medias/atreal-logo-48.png
.. _atreal: http://www.atreal.fr/
.. _atReal Team: mailto:contact@atreal.fr
Contributors
============
* `atReal Team`_
- Romain BEYLERIAN [rbeylerian]
.. _atReal Team: mailto:contact@atreal.fr
Credits
=======
Thanks to Simon Kaser <simu> from raptus - raptus.com for roles / groups export
and german translation.
TODO
====
* Customizable CSV header.
Changelog
=========
1.2.3 (2015-10-27)
------------------
- Add uninstall profile.
[thet]
- Support of password export, from this blueprint:
http://play.pixelblaster.ro/blog/archive/2011/03/09/export-import-users-in-and-out-of-plone
[thet]
- Add ``z3c.autoinclude.plugin`` entry point.
[thet]
- PEP 8, cleanup.
[thet]
1.2.2 (2011-11-28)
------------------
* Fix behaviour when creating user with no group. [rbeylerian]
1.2.1 (2011-11-18)
------------------
* Update README.txt
[rbeylerian]
* Added conditional include of CMFCore permisssions.zcml for Plone 4.1 support
[rbeylerian]
* Update MANIFEST.in (now including docs folder, txt and .mo files)
[rbeylerian]
1.2
----------------
* Added export support for roles and groups [simu]
* Added filtering for results of acl_users.searchUsers to ignore entries from mutable_properties plugin which resulted in duplicate entries for users and entries for groups [simu]
* Fixed AttributeError raised when exporting and portal_membership.getMemberById returns None (eg. if there are groups created over the plone UI) [simu]
* Added german translation [simu]
1.1 beta1
----------------
* Added group creation / member assignment
* Corrected bug #2
http://plone.org/products/atreal.usersinout/issues/2
* Typos in french translation
[tiazma]
1.0 beta4
----------------
* Added translation support
* Added french translations
[Matthias Broquet a.k.a tiazma]
1.0 - Unreleased
----------------
* Initial release
[Matthias Broquet a.k.a tiazma]
