Metadata-Version: 2.1
Name: django-admin-numeric-filter
Version: 0.1.4
Summary: Numeric filters for Django admin
Home-page: http://github.com/lukasvinclav/django-admin-numeric-filter
License: UNKNOWN
Description: ![Screenshot](https://github.com/lukasvinclav/django-admin-numeric-filter/raw/master/screenshot.png)
        
        # django-admin-numeric-filter
        
        ![](https://img.shields.io/badge/Version-0.1.2-orange.svg?style=flat-square)
        ![](https://img.shields.io/badge/Django-2.0+-green.svg?style=flat-square)
        ![](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)
        
        django-admin-numeric-filter provides you several filter classes for Django admin which you can use to filter results in change list. It works in **list_filter** when a field name is defined as list where the first value is field name and second one is custom filter class (you can find classes below). 
        
        Don't forget to inherit your model admin from **admin_actions.admin.NumericFilterModelAdmin** to load custom CSS styles and JavaScript files declared in inner Media class.
        
        ## Getting started
        
        1. Installation
        
        ```bash
        pip install django-admin-numeric-filter
        ```
        
        ```bash
        pip install git+https://git@github.com/lukasvinclav/django-admin-numeric-filter.git
        ```
        
        2. Add **admin_numeric_filter** into **INSTALLED_APPS** in your settings file before **django.contrib.admin**.
        
        ## Sample admin configuration
        
        ```python
        from admin_numeric_filter.admin import NumericFilterModelAdmin, SingleNumericFilter, RangeNumericFilter, \
            SliderNumericFilter
        
        from .models import YourModel
        
        
        class CustomSliderNumericFilter(SliderNumericFilter):
            MAX_DECIMALS = 2
            STEP = 10
        
        
        @admin.register(YourModel)
        class YourModelAdmin(NumericFilterModelAdmin):
            list_filter = (
                ('field_A', SingleNumericFilter), # Single field search, __gte lookup
                ('field_B', RangeNumericFilter), # Range search, __gte and __lte lookup
                ('field_C', SliderNumericFilter), # Same as range above but with slider
                ('field_D', CustomSliderNumericFilter), # Filter with custom attributes
            )
        ```
        
        ## Filter classes
        
        | Class name                               | Description                            |
        |------------------------------------------|----------------------------------------|
        | admin_actions.admin.SingleNumericFilter  | Single field search, __gte lookup      |
        | admin_actions.admin.RangeNumericFilter   | Range search, __gte and __lte lookup   |
        | admin_actions.admin.SliderNumericFilter  | Same as range above but with slider    |
        
        
        ## Slider default options for certain field types
        
        | Django model field                       | Step                     | Decimal places             |
        |------------------------------------------|--------------------------|----------------------------|
        | django.db.models.fields.DecimalField()   | Based on decimal places  | max precision from DB      |
        | django.db.models.fields.FloatField()     | Based on decimal places  | field decimal_places attr  |
        | django.db.models.fields.IntegerField()   | 1                        | 0                          |
Keywords: django admin numeric filter
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: OS Independent
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Framework :: Django
Description-Content-Type: text/markdown
