Metadata-Version: 1.1
Name: django-tabular-permissions
Version: 1.0.2
Summary: Display django permissions in a tabular format that is user friendly, and highly customisable
Home-page: https://radev.io/
Author: Ramez Ashraf
Author-email: ramez@radev.io
License: BSD License
Description: django-tabular-permissions
        ##########################
        Display Django basic permissions (add, change & delete) in a tabular format that is user friendly, translatable and easy customized.
        If you have more customised permissions, the default `FilteredSelectMultiple` widget will also appear to handle those permissions.
        
        Features:
        ---------
        * Permissions are displayed in a active language with app and model ``verbose_name``.
        * Any extra custom permissions are displayed in the default admin widget for permissions.
        * Customize which apps, models to show in the permissions table. You can also set a exclude function for high-end customization.
        * RTL ready, Bootstrap ready.
        * Easy customize-able look.
        * Tested on Django 1.8 & Django 1.9.
        * Tested on Python 2.7, 3.4 & 3.5
        .. image:: https://travis-ci.org/RamezIssac/django-tabular-permissions.svg?branch=master
            :target: https://travis-ci.org/RamezIssac/django-tabular-permissions
        
        
        Installation
        ------------
        You can install `django-tabular-permissions` via Pypi::
        
            pip install django-tabular-permissions
        
        Usage:
        ------
        Simply add "tabular_permissions" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = [
                ...
                'tabular_permissions',
            ]
        
        then navigate to User and/or Group change form to see django-tabular-permissions in action.
        
        Settings:
        ---------
        
        * ``TABULAR_PERMISSIONS_EXCLUDE``
        
        Control which apps, models to show in the permissions table.
        By default tabular_permissions exclude contrib apps ``sessions`` , ``contenttypes`` and ``admin`` apps from 
        showing their models in the permissions table.
        You can add (or override) those apps and/or specify models to exclude, like this::
        
            TABULAR_PERMISSIONS_EXCLUDE = {
                'app': [],
                'model': [],
                'function': 'tabular_permissions.helpers.TabularPermissionDefaultExcludeFunction', 
                             # A dotted path to a class that implement ``__call__`` that takes model as an argument.
                'override': False # Set to True to override default behavior.
            }    
        
        
        * ``TABULAR_PERMISSIONS_AUTO_IMPLEMENT``
        
        By default, just by including `tabular_permissions` in your installed_apps, the ``django.contrib.admin.UserAdmin`` (and ``GroupAdmin``) are "patched" to include the tabular_permissions widget.
        If you have a custom UserAdmin, then set this option to False and make sure you either:
        
        1. Inherit from `TabularPermissionsUserAdmin` for User admin and from``TabularPermissionsGroupAdmin`` for group admin
        2. Inherit from ``UserTabularPermissionsAdminBase`` and ``GroupTabularPermissionsAdminBase`` before admin.ModelAdmin or UserAdmin/GroupAdmin,
        3. Set the user_permissions widget to ``tabular_permissions.widgets.TabularPermissionsWidget`` and remember to send a 3rd argument 'permissions' when in Group admin. See ``tabular_permissions.admin`` for information.
        
        
        * ``TABULAR_PERMISSIONS_TEMPLATE``
        
        Default to 'tabular_permissions/admin/tabular_permissions.html`.
        You can either extend or override this template for maximum control.
        
        
        Enjoy and feel free to report any bugs or make pull requests.
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
