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. - 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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ce0f92f4243b4d612c1de663d3498f57fda89614ac2f762c51b61b9662f3c8e9 |
|
MD5 | 7544d01bdf562557347741e4833f8500 |
|
BLAKE2b-256 | 7a51de67874f4b8df111325c4c1803670adbc7c65b2df2da573f6623d77508d0 |
Close
Hashes for django_admin_global_search-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7d0385433fdd24772811054a90d32dfa0a93c1ef53b26eff75913e0ab28ed7f2 |
|
MD5 | a22dfaaeb45796c3d41a7f7689825e08 |
|
BLAKE2b-256 | 5f28c4744ebe43e768fff96b91deb7e582bd4ce2e355f39c0b7f6bbc141c36c0 |