Django Admin List Filter Dropdown 使用教程

Django Admin List Filter Dropdown 使用教程

django-admin-list-filter-dropdownUse dropdowns in Django admin list filter项目地址:https://gitcode.com/gh_mirrors/dj/django-admin-list-filter-dropdown

1. 项目的目录结构及介绍

django-admin-list-filter-dropdown/
├── django_admin_listfilter_dropdown/
│   ├── __init__.py
│   ├── filters.py
│   ├── templates/
│   │   └── django_admin_listfilter_dropdown/
│   │       └── dropdown_filter.html
├── docs/
├── .gitignore
├── LICENSE
├── MANIFEST.in
├── README.md
├── setup.py

• django_admin_listfilter_dropdown/: 核心代码目录，包含过滤器实现和模板。
  • __init__.py: 模块初始化文件。
  • filters.py: 过滤器类定义文件。
  • templates/: 模板文件目录，包含自定义过滤器模板。
• docs/: 文档目录。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• MANIFEST.in: 打包清单文件。
• README.md: 项目说明文档。
• setup.py: 项目安装配置文件。

2. 项目的启动文件介绍

项目没有特定的启动文件，因为它是一个 Django 应用扩展，需要在 Django 项目中集成使用。通常，你需要在 Django 项目的 settings.py 中添加应用配置，并在 admin.py 中使用过滤器。

3. 项目的配置文件介绍

settings.py

在 Django 项目的 settings.py 文件中，添加以下配置以启用该应用：

INSTALLED_APPS = [
    ...
    'django_admin_listfilter_dropdown',
    ...
]

admin.py

在 Django 项目的 admin.py 文件中，使用过滤器类：

from django_admin_listfilter_dropdown.filters import DropdownFilter, RelatedDropdownFilter, ChoiceDropdownFilter
from django.contrib import admin
from .models import YourModel

class YourModelAdmin(admin.ModelAdmin):
    list_filter = (
        ('a_charfield', DropdownFilter),
        ('a_choicefield', ChoiceDropdownFilter),
        ('a_foreignkey_field', RelatedDropdownFilter),
    )

admin.site.register(YourModel, YourModelAdmin)

通过以上配置，你可以在 Django 管理界面中使用下拉菜单进行过滤。

django-admin-list-filter-dropdownUse dropdowns in Django admin list filter项目地址:https://gitcode.com/gh_mirrors/dj/django-admin-list-filter-dropdown