|
1 | | -# Django Admin Volt |
| 1 | +# [Django Admin Volt](https://github.com/app-generator/django-admin-volt) |
2 | 2 |
|
3 | | -Modern template for **Django Admin Interface** coded on top of **[Volt Dashboard](https://django-volt-dashboard.appseed-srv1.com/)** (free version). Volt Dashboard is a free and open source Bootstrap 5 Admin Dashboard featuring over 100 components, 11 example pages and 3 plugins with Vanilla JS. |
| 3 | +Modern template for **Django Admin Interface** coded on top of **Volt Dashboard**, an open-source `Boostrap 5` design. |
4 | 4 |
|
5 | | -> Originally coded by [Iman Karimi](https://github.com/imankarimi), actively supported by [AppSeed](https://appseed.us/) via Github (issues tracker) and [Discord](https://discord.gg/fZC6hup). |
| 5 | +> Actively supported by [AppSeed](https://appseed.us/) via `Email` and `Discord`. |
6 | 6 |
|
7 | 7 | <br> |
8 | 8 |
|
9 | 9 | **Links & Resources** |
10 | 10 |
|
11 | | -- [Django Volt Dashboard](https://appseed.us/admin-dashboards/django-dashboard-volt) - Open-source starter that uses the same UI Kit |
| 11 | +- [Django Volt Dashboard](https://appseed.us/product/volt-dashboard/django/) - free starter with the same design |
12 | 12 | - [Django Volt Dashboard](https://django-volt-dashboard.appseed-srv1.com/) - LIVE Demo |
13 | | -- More [Django Dashboards](https://appseed.us/admin-dashboards/django) provided by AppSeed |
14 | 13 |
|
15 | 14 | <br /> |
16 | 15 |
|
17 | | -## Why Django Admin Volt? |
| 16 | +## Why `Django Admin Volt` |
18 | 17 |
|
19 | | -- Bootstrap 5 Design: **[Volt Dashboard](https://django-volt-dashboard.appseed-srv1.com/)** (Free version) provided by **Themesberg** |
20 | | -- New fresh look |
21 | | -- Responsive mobile interface |
22 | | -- Useful admin home page |
23 | | -- Minimal template overriding |
24 | | -- Easy integration |
| 18 | +- Modern `Bootstrap 5` Design |
| 19 | +- `Responsive Interface` |
| 20 | +- `Minimal Template` overriding |
| 21 | +- `Easy integration` |
25 | 22 |
|
26 | 23 | <br /> |
27 | 24 |
|
@@ -55,55 +52,6 @@ $ pip install git+https://github.com/app-generator/django-admin-volt.git |
55 | 52 |
|
56 | 53 | <br /> |
57 | 54 |
|
58 | | -> All programs you add in **INSTALLED_APPS** should look like this: **APP_NAME.apps.APP_NAMEConfig**. |
59 | | -
|
60 | | -In this feature, we considered that each App can have its own icon, so we ask users to use this feature according to the method. Also in apps.py of each program according to the example add the icon field in the corresponding class. You can go **[here](https://fontawesome.com/v4.7/icons/)** to use more icons |
61 | | - |
62 | | - |
63 | | -```python |
64 | | - |
65 | | - from django.apps import AppConfig |
66 | | - |
67 | | - class APP_NAMEConfig(AppConfig): |
68 | | - name = 'APP_NAME' |
69 | | - icon = 'ICON_CLASS' # for example: icon = 'fa fa-users' |
70 | | -``` |
71 | | - |
72 | | -<br /> |
73 | | - |
74 | | -> Make sure `django.template.context_processors.request` context processor is enabled in settings.py (Django 1.8+ way): |
75 | | -
|
76 | | -```python |
77 | | - |
78 | | - TEMPLATES = [ |
79 | | - { |
80 | | - 'BACKEND': 'django.template.backends.django.DjangoTemplates', |
81 | | - 'DIRS': [], |
82 | | - 'APP_DIRS': True, |
83 | | - 'OPTIONS': { |
84 | | - 'context_processors': [ |
85 | | - ... |
86 | | - 'django.template.context_processors.request', |
87 | | - ... |
88 | | - ], |
89 | | - }, |
90 | | - }, |
91 | | - ] |
92 | | -``` |
93 | | - |
94 | | -:warning: **Warning!!** |
95 | | -* Before Django 1.8 you should specify context processors different way. Also use ``django.core.context_processors.request`` instead of ``django.template.context_processors.request``. |
96 | | - |
97 | | -```python |
98 | | - from django.conf import global_settings |
99 | | - |
100 | | - TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + ( |
101 | | - 'django.core.context_processors.request', |
102 | | - ) |
103 | | -``` |
104 | | - |
105 | | -<br /> |
106 | | - |
107 | 55 | > Collect static if you are in production environment: |
108 | 56 |
|
109 | 57 | ```bash |
@@ -134,5 +82,7 @@ Access the `admin` section in the browser: `http://127.0.0.1:8000/` |
134 | 82 |
|
135 | 83 |  |
136 | 84 |
|
| 85 | +<br /> |
| 86 | + |
137 | 87 | --- |
138 | | -**Django Admin Volt** - Provided by **AppSeed [App Generator](https://appseed.us/)** |
| 88 | +**[Django Admin Volt](https://github.com/app-generator/django-admin-volt)** - Provided by **[AppSeed](https://appseed.us/)** |
0 commit comments