Introduction
============

Make permission management easier in Plone.

Provides several new permission / role management views:

- A sitemap like, filterable permission overview.
- Remove user/group permission recursively.
- Copy existing permission/role settings from one to another user.
- Exports/imports user/group permissions/roles recursively.

  - Export only structure (folderish types).
  - Export using relative paths.

- A better sharing view:

  - Search for users.
- Temporary stores your selection over multiple search operations.


Usage
-----

- Add ``ftw.permissionmanager`` to your buildout configuration:

::

    [instance]
    eggs +=
        ftw.permissionmanager

- Install the generic import profile.

- Configure the types that should be visible in the recursive sharing view by setting it in the registry.
  You can do this configuring it in ``portal_registry`` or by adding a ``registry.xml`` to your
  generic setup profile::

    <registry>

        <record name="ftw.permissionmanager.manage_types">
            <value>
                <element>Folder</element>
                <element>Document</element>
            </value>
        </record>

    </registry>



Links
=====

- Main github project repository: https://github.com/4teamwork/ftw.permissionmanager
- Issue tracker: https://github.com/4teamwork/ftw.permissionmanager/issues
- Package on pypi: http://pypi.python.org/pypi/ftw.permissionmanager
- Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.permissionmanager

Copyright
=========

This package is copyright by `4teamwork <http://www.4teamwork.ch/>`_.

``ftw.permissionmanager`` is licensed under GNU General Public License, version 2.

.. image:: https://cruel-carlota.pagodabox.com/0aedf121b182f20d668ecc65c6741f4d
   :alt: githalytics.com
   :target: http://githalytics.com/4teamwork/ftw.permissionmanager

Changelog
=========


2.1.1 (2014-02-10)
------------------

- Make a POST request to the updateSharingInfo view.
  [mathias.leimgruber]


2.1.0 (2013-11-04)
------------------

- Replace jq by $ (Plone 4.3 compatibility).
  [mathias.leimgruber]

- Add custom ajax search handler on sharing view.
  It returns the selected users too.
  [mathias.leimgruber]

- Since plone.app.workflow >= 2.1.4 the sharing-view uses 'index' instead 'template'
  variable to access the page-template.
  plone.app.workflow >= 2.1.4 is integrated in Plone >= 4.3.2
  For backward compatibility we use both variables.
  [elioschmutz]


2.0 (2013-05-24)
----------------


- Use also the patched sharing.py for updateSharingInfo (ajax call).
  [mathias.leimgruber]

- Add dropdown to select encoding.
  [tschanzt]

- Drop KSS for custom sharing view.
  [jone]

- Drop compatibility for Plone <= 4.2.
  [jone]

- Sharing view: No longer limit visible roles. Visibility of roles is
  determined by delegate permissions.
  [buchi]

- Prevent duplicated userids.
  [mathias.leimgruber]

- Advanced sharing: disable right and left column in order to gain space.
  [jone]

- Advanced sharing: make table not sortable (it's a tree).
  [jone]


1.4.7 (2012-10-16)
------------------

- Fix typo in german translation.
  [jone]


1.4.6 (2012-07-30)
------------------

- Sharing view: do not list roles for which the user has no delegate permission.
  [jone]

- Sharing view: move visible roles configuration to a seperate method
  for making it easier to customize it.
  [jone]

- Encode User/Group ID with utf-8 to prevent unicodeerrors
  [tschanzt]


1.4.5 (2012-06-13)
------------------

- Show User-ID in local roles listing and search form.
  [mathias.leimgruber]


1.4.4 (2012-05-08)
------------------

- Use new test buildout config and fix some translations.
  [mathias.leimgruber]

- Prepare Readme for public release
  [mathias.leimgruber]


1.4.3 (2012-05-01)
------------------

- Fix choose all function on sharing.pt
  [mathias.leimgruber]


1.4.2 (2012-04-30)
------------------

- Fix german translations
  [mathias.leimgruber]


1.4.1 (2012-04-02)
------------------

- Added checkbox to choose if only folderish types will be export