Skip to main content

A django app that provides extra features including masquerading, local timezone support on users, an audit log for tracking admin and view-based data changes and activities, and support for Company models and added fields to User model.

Project description

.. image:: https://circleci.com/gh/foundertherapy/django-users-plus.svg?style=svg
:target: https://circleci.com/gh/foundertherapy/django-users-plus

========
Accounts
========

Accounts is an app that adds the following features to your Django project::

1. An swappable User model that uses email as the username for sign in, and has a timezone field (and supporting middleware) that will show localized times in the Admin site.

2. The ability to sign-in as another User from the User admin screen. This is enabled for superusers, any User that has masquerading permissions. By default, staff users cannot sign-in as other users, and they can never sign in as a superuser (bypassing permission checks) even with masquerading permission.

3. A configurable audit log model that can track a number of admin activities automatically, and can be extended to track additional ones through direct use or through signals. The audit log automatically tracks the user signed into the admin, and if a user is masquerading as another user, that's noted as well.

- User creation
- User login
- User logout
- User email change
- Masquerade start
- Masquerade end
- Password change
- Password reset
- Activate user
- Deactivate user
- Company name change


Quick start
-----------
1. Add "accounts" to your INSTALLED_APPS setting like this::

INSTALLED_APPS = [
...
'accounts',
'django.contrib.sites',
]

2. Create your own models for Company, User, and AuditLogEvent, and related Admin classes that inherit from the base models provided in this library. You cannot use the models as provided because they are all declared abstract. This allows you to easily implement a relationship between User and Company that (at the moment) is very difficult to have built into the provided abstract base models. For example::

class MyCompany(models.BaseCompany):
bar = django.db.models.CharField(max_length=100)


class MyUser(models.BaseUser):
foo = django.db.models.CharField(max_length=100)
company = django.db.models.ForeignKey('MyCompany', null=True, related_name='users')


class MyAuditLogEvent(models.BaseAuditLogEvent):
baz = django.db.models.CharField(max_length=100)

3. Configure the swappable User model in settings::

AUTH_USER_MODE = '<app_name>.<your User-inherited model>'

4. Configure the swappable AuditLogEvent model for event logging. This is optional, but without it the AuditLogEvent signals will not work::

ACCOUNTS_ENABLE_AUDIT_LOG = True
ACCOUNTS_AUDIT_LOG_EVENT_MODEL = '<app name>.<your AuditLogEvent-inherited model>'

5. Include the accounts URLconf in your project urls.py like this::

url(r'^', include('accounts.urls')),

6. To enable timezone support for users in the Admin site, add the following to MIDDLEWARE_CLASSES::

MIDDLEWARE_CLASSES = (
...
'accounts.middleware.TimezoneMiddleware',
)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-users-plus-1.1.0.tar.gz (17.3 kB view details)

Uploaded Source

File details

Details for the file django-users-plus-1.1.0.tar.gz.

File metadata

File hashes

Hashes for django-users-plus-1.1.0.tar.gz
Algorithm Hash digest
SHA256 bcd6e9e8f446f370e40e6b477306358617eeb772c16d4906134aec5cc0cb6eef
MD5 25927d6dc49b3edb76946cb3ca3722ab
BLAKE2b-256 58de61f36741f3d850e8b4c94bf65548b2242eedf2f662cfe427fc53fc05d438

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page