Metadata-Version: 1.0
Name: django-admin-search
Version: 0.1.1
Summary: The "Django Admin Search" is a advanced search modal for django admin
Home-page: https://github.com/shinneider/django_admin_search
Author: Shinneider Libanio da Silva
Author-email: shinneider-libanio@hotmail.com
License: MIT
Description: Django Admin Search
        ===================
        
        # Install:
            pip install django-admin-search
        
        # Usage:
        
        1. Add to your INSTALLED_APPS, in settings.py:
        
                INSTALLED_APPS = [  
                    ...
                    'django_admin_search',
                    ...
                ]  
        
        2. Create a search form for model:
        
                from .models import Area
                from django.forms import ModelForm, Form
                from django.forms import DateField, CharField, ChoiceField, TextInput
        
        
                class YourFormSearch(Form):
                    name = CharField(required=False)
                    date = DateField(required=False, widget=TextInput(
                        attrs={ 
                            'filter_method': '__gte',
                        }
                    ))
        
        3. In your admin:
        
                from django_admin_search.admin import BaseAdvacedSearchAdmin
                from .models import YourModel
                from .form import YourForm, YourFormSearch
        
                @register(YourModel)
                class ModelAdmin(BaseAdvacedSearchAdmin):
                    form = YourForm
                    search_form = YourFormSearch
        
        # Advanced:
        
        1. to multiple filters in same field:
        
                class YourFormSearch(Form):
                    ...
                    name = CharField(required=False)
                    begin = DateField(required=False, widget=TextInput(
                        attrs={
                            'filter_field': 'date', 
                            'filter_method': '__gte',
                        }
                    ))
                    end = DateField(required=False, widget=TextInput(
                        attrs={
                            'filter_field': 'date', 
                            'filter_method': '__lte',
                        }
                    ))
        
        2. add placeholder and mask
        
                class YourFormSearch(Form):
                    ...
                    date = DateField(required=False, widget=TextInput(
                        attrs={
                            'data-mask': "00/00/0000", 
                            'placeholder': 'MM/DD/YYYY'
                        }
                    ))
        
Platform: UNKNOWN
