Wagtail ModelAdmin

Add any model in your project to the Wagtail admin. Formerly wagtail.contrib.modeladmin.

Links

• Documentation
• Changelog
• Contributing
• Discussions
• Security

Supported versions

• Python 3.8, 3.9, 3.10, 3.11
• Django 3.2, 4.1, 4.2
• Wagtail 5.0, 5.1

Installation

• python -m pip install wagtail-modeladmin
• Add wagtail_modeladmin to your INSTALLED_APPS setting.

  INSTALLED_APPS = [
      # ...
      "wagtail_modeladmin",
      # ...
  ]
  

Contributing

Install

To make changes to this project, first clone this repository:

git clone https://github.com/wagtail-nest/wagtail-modeladmin.git
cd wagtail-modeladmin

With your preferred virtualenv activated, install testing dependencies:

Using pip

python -m pip install --upgrade pip>=21.3
python -m pip install -e .[testing] -U

Using flit

python -m pip install flit
flit install

pre-commit

Note that this project uses pre-commit. It is included in the project testing requirements. To set up locally:

# go to the project directory
$ cd wagtail-modeladmin
# initialize pre-commit
$ pre-commit install

# Optional, run all checks once for this, then the checks will run only on the changed files
$ git ls-files --others --cached --exclude-standard | xargs pre-commit run --files

How to run tests

Now you can run tests as shown below:

tox

or, you can run them for a specific environment tox -e python3.10-django4.2-wagtail4.1 or specific test tox -e python3.10-django4.2-wagtail4.1-sqlite wagtail-modeladmin.tests.test_file.TestClass.test_method

To run the test app interactively, use tox -e interactive, visit http://127.0.0.1:8020/admin/ and log in with admin/changeme.