Skip to content

About

Show all LogEntry objects in the Django admin site

Resources

Stars

114 stars

Watchers

6 watching

Forks

Repository files navigation

django-logentry-admin

ci pypi-version

Show all LogEntry objects in the Django admin site.

Django records every addition, change and deletion made through the admin, but only shows each user their own last few actions. This app adds the whole log to the admin:

  • a list of every entry, filtered by staff user, content type and action, searchable by object and change message, and browsable by date
  • links from each entry to the object and the user it concerns, on the admin site you are using
  • a read-only page per entry, since the log is a record: entries cannot be added, changed or deleted

Superusers see the log, and so do staff users with the "Can view log entry" or "Can change log entry" permission. Either one only lets them read it.

Originally based on Django snippet 2484.

Supported versions

  • Django 5.2, 6.0, 6.1
  • Python 3.10 to 3.14 (Django 6.0 and later need Python 3.12 or later)

Installation

Install with pip:

pip install django-logentry-admin

Or install from source:

git clone https://github.com/yprez/django-logentry-admin.git
cd django-logentry-admin
pip install .

Then add it to INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    "logentry_admin",
]

The log appears in the admin under "Administration", as "Log entries". It is translated into Azerbaijani, Brazilian Portuguese, Esperanto and Russian.

Development

The project uses uv. Set up the environment and run the tests with coverage:

uv sync
uv run coverage run -m pytest
uv run coverage report

Run them against a particular Python and Django version, in a throwaway environment that leaves the one above as it is:

uv run --isolated --python 3.12 --with "django~=5.2.0" pytest

The translations need GNU gettext. After changing a message in the code, update the catalogs, translate, compile them and commit both the .po and .mo files; CI checks that they match:

cd src/logentry_admin
uv run django-admin makemessages --all
uv run django-admin compilemessages

To release, set the new version in pyproject.toml, give it a dated heading in the changelog (v1.2.0 - 02/11/2026), merge, then publish a GitHub release tagged v<version>. The release workflow refuses a version whose changelog heading has no date, then builds it and uploads it to PyPI.

About

Show all LogEntry objects in the Django admin site

Resources

Stars

114 stars

Watchers

6 watching

Forks

Releases

Packages

Used by

Contributors

Languages