Skip to content

Commit bd65152

Browse files
committed
v1.0.3 - Fix for Dj 5, Update RM Links
1 parent d9d5b14 commit bd65152

File tree

4 files changed

+25
-167
lines changed

4 files changed

+25
-167
lines changed

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
# CHANGELOG
22

3+
## [1.0.3] 2024-11-16
4+
### Changes
5+
6+
- Remove `length_is` filter
7+
- Deprecated in Django 5.1
8+
- Update RM Links:
9+
- [Django Admin Gradient Able](https://app-generator.dev/docs/products/django-libs/theme-gradient-able.html) - Documentation & Support Links
10+
- [Django Gradient Able Dashboard](https://app-generator.dev/product/gradient-able/django/) - The product that uses the library
11+
- [Getting Started with Django](https://app-generator.dev/docs/technologies/django/index.html) - Learn how to code **Django** Projects
12+
313
## [1.0.2] 2023-02-27
414
### Changes
515

README.md

Lines changed: 9 additions & 161 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
1-
# [Django Admin Gradient](https://appseed.us/product/gradient-able/django/)
1+
# [Django Gradient Able](https://app-generator.dev/docs/products/django-libs/theme-gradient-able.html)
22

3-
Modern template for **Django** that covers `Admin Section`, all authentication pages (registration included) crafted on top of **[Gradient Able](https://appseed.us/product/gradient-able/django/)**,
4-
an open-source `Bootstrap` design from [CodedThemes](https://bit.ly/37fF9RT).
3+
Modern template for **Django Admin**, Auth Pages (registration included) crafted on top of **Gradient Able Dashboard**, an open-source **Bootstrap** design.
54

6-
> Actively supported by [AppSeed](https://appseed.us/) via `Email` and `Discord`.
5+
- [Django Admin Gradient Able](https://app-generator.dev/docs/products/django-libs/theme-gradient-able.html) - Documentation & Support Links
6+
- [Django Gradient Able Dashboard](https://app-generator.dev/product/gradient-able/django/) - The product that uses the library
7+
- [Getting Started with Django](https://app-generator.dev/docs/technologies/django/index.html) - Learn how to code **Django** Projects
78

89
<br />
910

10-
**Links & Resources**
11+
## **Features**
1112

12-
- [Django Gradient Able](https://appseed.us/product/gradient-able/django/) - `Product page`
13-
- `Features`: Fully-configured, `CI/CD` via Render
14-
- UI Kit: **Gradient Able** (open-source, Bootstrap 4 version) by [CodedThemes](https://bit.ly/37fF9RT)
13+
- Design: **[Gradient Able](https://app-generator.dev/docs/templates/bootstrap/gradient-able.html)** (Bootstrap)
1514
- **Sections Covered**:
1615
- `Admin Section`, reserved for `superusers`
1716
- `All pages` managed by `Django.contrib.AUTH`
@@ -20,160 +19,9 @@ an open-source `Bootstrap` design from [CodedThemes](https://bit.ly/37fF9RT).
2019

2120
<br />
2221

23-
![Gradient Able - Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/171583187-c4ca1bef-b535-458e-9250-8d62ba1f5b30.png)
24-
25-
<br />
26-
27-
## Why [Django Admin Gradient](https://appseed.us/product/gradient-able/django/)
28-
29-
- Modern [Bootstrap](https://www.admin-dashboards.com/bootstrap-5-templates/) Design
30-
- `Responsive Interface`
31-
- `Minimal Template` overriding
32-
- `Easy integration`
33-
34-
<br />
35-
36-
## How to use it
37-
38-
<br />
39-
40-
> **Install the package** via `PIP`
41-
42-
```bash
43-
$ pip install django-admin-gradient
44-
// OR
45-
$ pip install git+https://github.com/app-generator/django-admin-gradient.git
46-
```
47-
48-
<br />
49-
50-
> Add `admin_gradient` application to the `INSTALLED_APPS` setting of your Django project `settings.py` file (note it should be before `django.contrib.admin`):
51-
52-
```python
53-
INSTALLED_APPS = (
54-
...
55-
'admin_gradient.apps.AdminGradientConfig',
56-
'django.contrib.admin',
57-
)
58-
```
59-
60-
<br />
61-
62-
> Add `LOGIN_REDIRECT_URL` and `EMAIL_BACKEND` of your Django project `settings.py` file:
63-
64-
```python
65-
LOGIN_REDIRECT_URL = '/'
66-
# EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
67-
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
68-
```
69-
70-
<br />
71-
72-
> Add `admin_gradient` urls in your Django Project `urls.py` file
73-
74-
```python
75-
from django.urls import path, include
76-
77-
urlpatterns = [
78-
...
79-
path('', include('admin_gradient.urls')),
80-
]
81-
```
82-
83-
<br />
84-
85-
> **Collect static** if you are in `production environment`:
86-
87-
```bash
88-
$ python manage.py collectstatic
89-
```
90-
91-
<br />
92-
93-
> **Start the app**
94-
95-
```bash
96-
$ # Set up the database
97-
$ python manage.py makemigrations
98-
$ python manage.py migrate
99-
$
100-
$ # Create the superuser
101-
$ python manage.py createsuperuser
102-
$
103-
$ # Start the application (development mode)
104-
$ python manage.py runserver # default port 8000
105-
```
106-
107-
Access the `admin` section in the browser: `http://127.0.0.1:8000/`
108-
109-
<br />
110-
111-
## How to Customize
112-
113-
When a template file is loaded, `Django` scans all template directories starting from the ones defined by the user, and returns the first match or an error in case the template is not found.
114-
The theme used to style this starter provides the following files:
115-
116-
```bash
117-
# This exists in ENV: LIB/admin_gradient
118-
< UI_LIBRARY_ROOT >
119-
|
120-
|-- templates/ # Root Templates Folder
121-
| |
122-
| |-- accounts/
123-
| | |-- auth-signin.html # Sign IN Page
124-
| | |-- auth-signup.html # Sign UP Page
125-
| |
126-
| |-- includes/
127-
| | |-- sidebar.html # Sidebar component
128-
| | |-- navigation.html # Navigation Bar
129-
| | |-- scripts.html # Scripts Component
130-
| |
131-
| |-- layouts/
132-
| | |-- base.html # Masterpage
133-
| | |-- base-auth.html # Masterpage for Auth Pages
134-
| |
135-
| |-- pages/
136-
| |-- index.html # Dashboard Page
137-
| |-- user-profile.html # Profile Page
138-
| |-- *.html # All other pages
139-
|
140-
|-- ************************************************************************
141-
```
142-
143-
When the project requires customization, we need to copy the original file that needs an update (from the virtual environment) and place it in the template folder using the same path.
144-
145-
For instance, if we want to customize the `index.html` these are the steps:
146-
147-
- `Step 1`: create the `templates` DIRECTORY inside your app
148-
- `Step 2`: configure the project to use this new template directory
149-
- Edit `settings.py` TEMPLATES section
150-
- `Step 3`: copy the `footer.html` from the original location (inside your ENV) and save it to the `YOUR_APP/templates` DIR
151-
- Source PATH: `<YOUR_ENV>/LIB/admin_gradient/templates/pages/index.html`
152-
- Destination PATH: `YOUR_APP/templates/pages/index.html`
153-
- Edit the `index.html` (Destination PATH)
154-
155-
At this point, the default version of the `index.html` shipped in the library is ignored by Django.
156-
157-
In a similar way, all other files and components can be customized easily.
158-
159-
<br />
160-
161-
## [Gradient Able](https://appseed.us/product/gradient-able-pro/django/) `PRO Version`
162-
163-
> For more components, pages and priority on support, feel free to take a look at this **Django** starter:
164-
165-
Designed for those who like bold elements and beautiful websites, **[Gradient Able](https://appseed.us/product/gradient-able-pro/django/)** is the most stylish Admin Design compare to all other Bootstrap Templates.
166-
It comes with high feature-rich pages and components with fully developer-centric code.
167-
168-
- [Gradient Datta PRO](https://appseed.us/product/datta-able-pro/django/) - product page
169-
- `Enhanced UI` - more pages and components
170-
- `Priority` on support
171-
172-
<br >
173-
174-
![Gradient Able PRO - Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/171583582-d9652e7e-f420-4cf0-8eb1-dda3c79f8c18.png)
22+
![Django Gradient Able - Modern template for Django Admin Section crafted on top of a modern Bootstrap Design.](https://user-images.githubusercontent.com/51070104/171583187-c4ca1bef-b535-458e-9250-8d62ba1f5b30.png)
17523

17624
<br />
17725

17826
---
179-
**[Django Admin Gradient](https://appseed.us/product/gradient-able/django/)** - Modern Admin Interface provided by **[AppSeed](https://appseed.us/)**
27+
**[Django Gradient Able](https://app-generator.dev/docs/products/django-libs/theme-gradient-able.html)** - Modern Django Admin Interface provided by **[App-Generator](https://app-generator.dev)**

admin_gradient/templates/admin/includes/fieldset.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,12 @@
77
{% for line in fieldset %}
88
<div class="row">
99
<div class="{% if line.fields.0 in 'last_login, date_joined' %}col-md-6{% else %}col-md-12{% endif %}">
10-
<div class="mb-4 {% if line.fields|length_is:'1' and line.errors %} errors{% endif %}{% if not line.has_visible_field %} hidden{% endif %}{% for field in line %}{% if field.field.name %} field-{{ field.field.name }}{% endif %}{% endfor %}">
11-
{% if line.fields|length_is:'1' %}{{ line.errors }}{% endif %}
10+
<div class="mb-4 {% if line.fields|length == 1 and line.errors %} errors{% endif %}{% if not line.has_visible_field %} hidden{% endif %}{% for field in line %}{% if field.field.name %} field-{{ field.field.name }}{% endif %}{% endfor %}">
11+
{% if line.fields|length == 1 %}{{ line.errors }}{% endif %}
1212
{% for field in line %}
13-
{# <div{% if not line.fields|length_is:'1' %} class="fieldBox{% if field.field.name %} field-{{ field.field.name }}{% endif %}{% if not field.is_readonly and field.errors %} errors{% endif %}{% if field.field.is_hidden %} hidden{% endif %}"{% elif field.is_checkbox %} class="checkbox-row"{% endif %}>#}
13+
{# <div{% if not line.fields|length == 1 %} class="fieldBox{% if field.field.name %} field-{{ field.field.name }}{% endif %}{% if not field.is_readonly and field.errors %} errors{% endif %}{% if field.field.is_hidden %} hidden{% endif %}"{% elif field.is_checkbox %} class="checkbox-row"{% endif %}>#}
1414

15-
{% if not line.fields|length_is:'1' and not field.is_readonly %}
15+
{% if not line.fields|length == 1 and not field.is_readonly %}
1616
{{ field.errors }}
1717
{% endif %}
1818

setup.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@
88

99
setup(
1010
name='django-admin-gradient',
11-
version='1.0.2',
11+
version='1.0.3',
1212
zip_safe=False,
1313
packages=find_packages(),
1414
include_package_data=True,
1515
description='Modern template for Django admin interface',
1616
long_description=README,
1717
long_description_content_type="text/markdown",
18-
url='https://appseed.us/product/gradient-able/django/',
18+
url='https://app-generator.dev/docs/products/django-libs/theme-gradient-able.html',
1919
author='AppSeed.us',
2020
author_email='support@appseed.us',
2121
license='MIT License',

0 commit comments

Comments
 (0)