# Django XLAdmin Enhanced
A modern, enhanced version of Django XAdmin - a powerful admin interface for Django applications.
## Features
- **Modern UI**: Clean and responsive admin interface
- **Plugin System**: Extensible plugin architecture
- **Advanced Filtering**: Powerful filtering and search capabilities
- **Import/Export**: Built-in data import/export functionality
- **Permissions**: Fine-grained permission control
- **Customizable**: Highly customizable admin interface
- **Multi-language**: Internationalization support
- **Dashboard**: Customizable dashboard with widgets
## Installation
```bash
pip install django-xladmin-enhanced
```
## Quick Start
1. Add `xladmin` to your `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
# ...
'xladmin',
'crispy_forms',
'import_export',
'reversion',
# ...
]
```
2. Replace Django's default admin in your main `urls.py`:
```python
import xladmin
xladmin.autodiscover()
from xladmin.plugins import xversion
xversion.register_models()
urlpatterns = [
path('xladmin/', xladmin.site.urls),
# ...
]
```
3. Create an admin configuration file `adminx.py` in your app:
```python
import xladmin
from .models import YourModel
class YourModelAdmin(object):
list_display = ['field1', 'field2', 'field3']
search_fields = ['field1', 'field2']
list_filter = ['field3']
xladmin.site.register(YourModel, YourModelAdmin)
```
4. Run migrations:
```bash
python manage.py makemigrations
python manage.py migrate
```
## Configuration
### Settings
Add these settings to your Django settings file:
```python
# Crispy Forms
CRISPY_TEMPLATE_PACK = 'bootstrap3'
# XLAdmin Settings
XLADMIN_TITLE = 'Your Admin Title'
XLADMIN_FOOTER_TITLE = 'Your Footer'
```
### Plugins
XLAdmin Enhanced comes with several built-in plugins:
- **Actions**: Batch actions for model instances
- **Filters**: Advanced filtering options
- **Bookmarks**: Save and manage bookmarks
- **Export**: Export data in various formats
- **Import**: Import data from files
- **Charts**: Display charts and graphs
- **Images**: Image handling and thumbnails
- **RelField**: Related field enhancements
- **Refresh**: Auto-refresh functionality
- **Details**: Enhanced detail views
- **Editable**: Inline editing capabilities
- **Relate**: Related object management
- **Portal**: Dashboard portal widgets
- **QuickForm**: Quick form creation
- **Wizard**: Multi-step form wizard
- **Ajax**: AJAX functionality
- **Aggregation**: Data aggregation tools
- **Mobile**: Mobile-responsive interface
- **Passwords**: Password management
- **Multiselect**: Multiple selection widgets
- **Themes**: Theme customization
- **Language**: Multi-language support
- **QuickFilter**: Quick filtering options
- **Sortable**: Drag-and-drop sorting
- **Topnav**: Top navigation enhancements
- **Portal**: Dashboard customization
## Advanced Usage
### Custom Plugins
You can create custom plugins by extending the base plugin classes:
```python
from xladmin.plugins import BaseAdminPlugin
class MyCustomPlugin(BaseAdminPlugin):
def init_request(self, *args, **kwargs):
# Plugin initialization logic
pass
```
### Theming
Customize the admin interface appearance:
```python
class MyModelAdmin(object):
# Custom CSS and JS
class Media:
css = {
'all': ('my_admin.css',)
}
js = ('my_admin.js',)
```
## Requirements
- Python >= 3.8
- Django >= 3.2
- django-crispy-forms >= 1.14.0
- django-import-export >= 2.8.0
- django-reversion >= 5.0.0
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Support
If you encounter any issues or have questions, please file an issue on the GitHub repository.
## Changelog
### Version 1.0.0
- Initial release
- Enhanced UI and UX
- Modern plugin system
- Improved performance
- Better documentation
Raw data
{
"_id": null,
"home_page": "https://github.com/enhanced-team/django-xladmin-enhanced",
"name": "django-xladmin-enhanced",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "django admin xladmin enhanced interface",
"author": "Enhanced Team",
"author_email": "enhanced@example.com",
"download_url": "https://files.pythonhosted.org/packages/7e/81/4bc49d7d0505e3c186244e39f112fa6a344c8b4c6d8468c09c698fca4af5/django_xladmin_enhanced-1.0.2.tar.gz",
"platform": null,
"description": "# Django XLAdmin Enhanced\r\n\r\nA modern, enhanced version of Django XAdmin - a powerful admin interface for Django applications.\r\n\r\n## Features\r\n\r\n- **Modern UI**: Clean and responsive admin interface\r\n- **Plugin System**: Extensible plugin architecture\r\n- **Advanced Filtering**: Powerful filtering and search capabilities\r\n- **Import/Export**: Built-in data import/export functionality\r\n- **Permissions**: Fine-grained permission control\r\n- **Customizable**: Highly customizable admin interface\r\n- **Multi-language**: Internationalization support\r\n- **Dashboard**: Customizable dashboard with widgets\r\n\r\n## Installation\r\n\r\n```bash\r\npip install django-xladmin-enhanced\r\n```\r\n\r\n## Quick Start\r\n\r\n1. Add `xladmin` to your `INSTALLED_APPS`:\r\n\r\n```python\r\nINSTALLED_APPS = [\r\n # ...\r\n 'xladmin',\r\n 'crispy_forms',\r\n 'import_export',\r\n 'reversion',\r\n # ...\r\n]\r\n```\r\n\r\n2. Replace Django's default admin in your main `urls.py`:\r\n\r\n```python\r\nimport xladmin\r\nxladmin.autodiscover()\r\n\r\nfrom xladmin.plugins import xversion\r\nxversion.register_models()\r\n\r\nurlpatterns = [\r\n path('xladmin/', xladmin.site.urls),\r\n # ...\r\n]\r\n```\r\n\r\n3. Create an admin configuration file `adminx.py` in your app:\r\n\r\n```python\r\nimport xladmin\r\nfrom .models import YourModel\r\n\r\nclass YourModelAdmin(object):\r\n list_display = ['field1', 'field2', 'field3']\r\n search_fields = ['field1', 'field2']\r\n list_filter = ['field3']\r\n\r\nxladmin.site.register(YourModel, YourModelAdmin)\r\n```\r\n\r\n4. Run migrations:\r\n\r\n```bash\r\npython manage.py makemigrations\r\npython manage.py migrate\r\n```\r\n\r\n## Configuration\r\n\r\n### Settings\r\n\r\nAdd these settings to your Django settings file:\r\n\r\n```python\r\n# Crispy Forms\r\nCRISPY_TEMPLATE_PACK = 'bootstrap3'\r\n\r\n# XLAdmin Settings\r\nXLADMIN_TITLE = 'Your Admin Title'\r\nXLADMIN_FOOTER_TITLE = 'Your Footer'\r\n```\r\n\r\n### Plugins\r\n\r\nXLAdmin Enhanced comes with several built-in plugins:\r\n\r\n- **Actions**: Batch actions for model instances\r\n- **Filters**: Advanced filtering options\r\n- **Bookmarks**: Save and manage bookmarks\r\n- **Export**: Export data in various formats\r\n- **Import**: Import data from files\r\n- **Charts**: Display charts and graphs\r\n- **Images**: Image handling and thumbnails\r\n- **RelField**: Related field enhancements\r\n- **Refresh**: Auto-refresh functionality\r\n- **Details**: Enhanced detail views\r\n- **Editable**: Inline editing capabilities\r\n- **Relate**: Related object management\r\n- **Portal**: Dashboard portal widgets\r\n- **QuickForm**: Quick form creation\r\n- **Wizard**: Multi-step form wizard\r\n- **Ajax**: AJAX functionality\r\n- **Aggregation**: Data aggregation tools\r\n- **Mobile**: Mobile-responsive interface\r\n- **Passwords**: Password management\r\n- **Multiselect**: Multiple selection widgets\r\n- **Themes**: Theme customization\r\n- **Language**: Multi-language support\r\n- **QuickFilter**: Quick filtering options\r\n- **Sortable**: Drag-and-drop sorting\r\n- **Topnav**: Top navigation enhancements\r\n- **Portal**: Dashboard customization\r\n\r\n## Advanced Usage\r\n\r\n### Custom Plugins\r\n\r\nYou can create custom plugins by extending the base plugin classes:\r\n\r\n```python\r\nfrom xladmin.plugins import BaseAdminPlugin\r\n\r\nclass MyCustomPlugin(BaseAdminPlugin):\r\n def init_request(self, *args, **kwargs):\r\n # Plugin initialization logic\r\n pass\r\n```\r\n\r\n### Theming\r\n\r\nCustomize the admin interface appearance:\r\n\r\n```python\r\nclass MyModelAdmin(object):\r\n # Custom CSS and JS\r\n class Media:\r\n css = {\r\n 'all': ('my_admin.css',)\r\n }\r\n js = ('my_admin.js',)\r\n```\r\n\r\n## Requirements\r\n\r\n- Python >= 3.8\r\n- Django >= 3.2\r\n- django-crispy-forms >= 1.14.0\r\n- django-import-export >= 2.8.0\r\n- django-reversion >= 5.0.0\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## Support\r\n\r\nIf you encounter any issues or have questions, please file an issue on the GitHub repository.\r\n\r\n## Changelog\r\n\r\n### Version 1.0.0\r\n- Initial release\r\n- Enhanced UI and UX\r\n- Modern plugin system\r\n- Improved performance\r\n- Better documentation\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Enhanced Django xAdmin - A modern admin interface for Django",
"version": "1.0.2",
"project_urls": {
"Bug Reports": "https://github.com/enhanced-team/django-xladmin-enhanced/issues",
"Documentation": "https://django-xladmin-enhanced.readthedocs.io/",
"Homepage": "https://github.com/enhanced-team/django-xladmin-enhanced",
"Source": "https://github.com/enhanced-team/django-xladmin-enhanced"
},
"split_keywords": [
"django",
"admin",
"xladmin",
"enhanced",
"interface"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "df017ad5af6d5f21433cab249a24e2669307c4547904487b45f9d1832072d946",
"md5": "4d55c467b665c5315998ed22a9a718d9",
"sha256": "f1ba8fbe9134fb5ed6ed4dc7590280ffbbe10f9be68e53adb71c9ae9b89e666c"
},
"downloads": -1,
"filename": "django_xladmin_enhanced-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4d55c467b665c5315998ed22a9a718d9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 1238286,
"upload_time": "2025-09-14T10:01:34",
"upload_time_iso_8601": "2025-09-14T10:01:34.335817Z",
"url": "https://files.pythonhosted.org/packages/df/01/7ad5af6d5f21433cab249a24e2669307c4547904487b45f9d1832072d946/django_xladmin_enhanced-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7e814bc49d7d0505e3c186244e39f112fa6a344c8b4c6d8468c09c698fca4af5",
"md5": "e463319eca485e94db3bda0cd8510ddd",
"sha256": "c5189f766cd88064d8768917e252f077ed13d2c912706eabf9b212e21a1661b8"
},
"downloads": -1,
"filename": "django_xladmin_enhanced-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "e463319eca485e94db3bda0cd8510ddd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1063262,
"upload_time": "2025-09-14T10:01:36",
"upload_time_iso_8601": "2025-09-14T10:01:36.142420Z",
"url": "https://files.pythonhosted.org/packages/7e/81/4bc49d7d0505e3c186244e39f112fa6a344c8b4c6d8468c09c698fca4af5/django_xladmin_enhanced-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-14 10:01:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "enhanced-team",
"github_project": "django-xladmin-enhanced",
"github_not_found": true,
"lcname": "django-xladmin-enhanced"
}
JSON
