Skip to main content

Tools for logging changes made from Django admin

Project description

django-admin-blame

django-admin-blame is a Django app providing mixins for tracking date and author of model changes from django admin.

Build Status codecov PyPI version

Description

Often it is useful to know date and author of object creation or modification. django-admin-blame provides a django model mixin with fields:

  • created (datetime) - timestamp of object creation
  • created_by (FK to User) - reference to an admin user who created this object through admin site
  • modified (datetime) - timestamp of last object modification
  • modified_by (FK to User) - reference to an admin user who made last changes to this object through admin site. If changes has been made somewhere else, field value is reset to None.

Installation

pip install django-admin-blame

Working example is in testproject.testapp.

  1. Enable middleware in django settings:
    MIDDLEWARE.append('admin_log.middleware.AdminLogMiddleware')
    
  2. Add model mixin to your models:
    from django.db import models
    
    from admin_log.models import AdminLogMixin
    
    
    class Subject(AdminLogMixin, models.Model):
        title = models.CharField(max_length=50)
        content = models.TextField()
    
  3. Add admin mixin to corresponding model admin:
    from django.contrib import admin
    
    from admin_log.admin import AdminLogMixin
    from testproject.testapp import models
    
    
    @admin.register(models.Subject)
    class SubjectAdmin(AdminLogMixin, admin.ModelAdmin):
        pass
    

Now you have readonly fields with date and author of last revision in admin "edit" page.

Download files

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

Source Distribution

django-admin-blame-1.1.1.tar.gz (5.6 kB view hashes)

Uploaded Source

Built Distribution

django_admin_blame-1.1.1-py3-none-any.whl (6.0 kB view hashes)

Uploaded Python 3

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