Metadata-Version: 2.1
Name: django-richmin
Version: 0.2.7
Summary: Customized lte-bootstrap django admin theme with some useful tools
Home-page: https://github.com/mymy47/django-richmin
Author: my47
Author-email: mymy47@gmail.com
License: MIT License
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: django<6,>4


# Django richmin (Rich Admin)

Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look richy

## Installation
```shell
pip install django-richmin
```

#### Support Iframe in admin popups

Add this config to django settings.py:
```python
X_FRAME_OPTIONS = 'SAMEORIGIN'
```

## Global Filter Usage
- First of all, add 'GlobalFilterMixin' to your admin model and put it in the first inheritance hierarchy e.g.
  ```python
    from richmin.admin_mixin import GlobalFilterMixin
  
    class FooAdmin(GlobalFilterMixin, admin.ModelAdmin)
  ```
- Add 'global_filter' in your admin class. This field is a list of tuples.
  The first item of the tuple is the relation between model and field and the second item
  is the model name. Implement it like this:
  ```python
    global_filters = [
      ('bar', 'bar'),
      ('bar__baz', 'baz'),
    ]
  ```

## Features
- Drop-in admin skin, all configuration optional
- Customisable side menu
- Customisable top menu
- Customisable user menu
- 4 different Change form templates (horizontal tabs, vertical tabs, carousel, collapsible)
- Bootstrap 4 modal (instead of the old popup window, optional)
- Search bar for any given model admin
- Customisable UI (via Live UI changes, or custom CSS/JS)
- Responsive
- Select2 drop-downs
- Bootstrap 4 & AdminLTE UI components
- Using the latest [adminlte](https://adminlte.io/) + [bootstrap](https://getbootstrap.com/)

## Thanks
This was initially a Fork of https://github.com/farridav/django-jazzmin

- Based on AdminLTE 3: https://adminlte.io/
- Using Bootstrap 4: https://getbootstrap.com/
- Using Font Awesome 5: https://fontawesome.com/
