A global search for Django Admin UI
Project description
Django Admin Global Search
Introduction
This Django application introduces a GlobalSearchView, designed to perform a global search across various models within the Django admin site.
Features
- Global Search: Enables searching across multiple models from a single query.
- Dynamic Model Inclusion: Automatically includes models that define
global_search_fields
, allowing for flexible search configurations. - Admin Integration: Provides direct links to the admin change page for each search result, facilitating easy editing.
Getting Started:
Prerequisites
- Python versions 3.8+.
- Django version 3+
Installation Steps
Install with command pip install django-admin-global-search
.
Usage
To use django-admin-global-search
in your Django project, you need to update your models and URL configurations.
- Add
admin_global_search
to yourINSTALLED_APPS
setting beforedjango.contrib.admin
.
INSTALLED_APPS = [
"admin_global_search",
"django.contrib.admin",
"django.contrib.auth",
"django.contrib.contenttypes",
...
]
- Ensure your models have a
global_search_fields
attribute that specifies the fields to be included in the search. Example:
class Artist(models.Model):
name = models.CharField(max_length=100)
bio = models.TextField(blank=True)
global_search_fields = ("name", "bio")
def __str__(self):
return self.name
- Update your project's urls.py to include the GlobalSearchView. Example:
...
from admin_global_search.views import GlobalSearchView
urlpatterns = [
path("admin/", admin.site.urls),
path("search/", GlobalSearchView.as_view(), name="admin_global_search"),
...
]
Contributing
Contributions to the project are welcome. To contribute:
- Fork the repository.
- Create a new feature branch for your contribution.
- Commit your changes with a descriptive message.
- Push your changes to GitHub.
- Submit a pull request for review.
License
The project is made available under the BSD 3-Clause License. Please refer to the LICENSE file for more details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for django_admin_global_search-0.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2bd19c0c17bc0b31794ded779a62b1f8cbd2cb30897e92ed6295950a20234e26 |
|
MD5 | c9f891c513b845b035e4e85946706c2d |
|
BLAKE2b-256 | d8cc6c6d90dffb20229cae03f283df430f158889aef6a116311064e385c4baea |
Close
Hashes for django_admin_global_search-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 14f1636c1cbd083c6f0e91131fc8d6352170f5e7650c575b11a0d06d6cd9dcd5 |
|
MD5 | b4524523233401974710fb8d413f3989 |
|
BLAKE2b-256 | 4cc4b0f88e874d1906f0c58ef411b246c4dc45113410862a5e48797009407bea |