Skip to content

Commit 6c3f6f0

Browse files
app-generatorapp-generator
committed
v1.0.12 - Docs & Product Links
1 parent 225e94a commit 6c3f6f0

File tree

3 files changed

+19
-165
lines changed

3 files changed

+19
-165
lines changed

‎CHANGELOG.md‎

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

3+
## [1.0.12] 2024-11-06
4+
### Changes
5+
6+
- Update [Django Admin Datta Able - Documentation](https://app-generator.dev/docs/products/django-libs/theme-datta-able.html) Link
7+
- Update [Django Admin Datta Able - Sample Product](https://app-generator.dev/product/datta-able/django/) Link
8+
- Added [Getting Started with Django](https://app-generator.dev/docs/technologies/django/index.html) Link
9+
310
## [1.0.11] 2024-09-17
411
### Changes
512

‎README.md‎

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

3-
Modern template for **Django** that covers `Admin Section`, all authentication pages (registration included) crafted on top of **[Datta Able](https://appseed.us/product/datta-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 **Datta Able Dashboard**, an open-source **Bootstrap** design.
54

6-
> Actively supported by [AppSeed](https://appseed.us/) via `Email` and `Discord`.
5+
- [Django Admin Datta Able](https://app-generator.dev/docs/products/django-libs/theme-datta-able.html) - Documentation & Support Links
6+
- [Django Datta Able Dashboard](https://app-generator.dev/product/datta-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 Datta Able](https://appseed.us/product/datta-able/django/) - `Product page`
13-
- `Features`: Fully-configured, `CI/CD` via Render
14-
- UI Kit: **Datta Able** (open-source, Bootstrap 4 version) by [CodedThemes](https://bit.ly/37fF9RT)
13+
- Design: Datta Able (Bootstrap)
1514
- **Sections Covered**:
1615
- `Admin Section`, reserved for `superusers`
1716
- `All pages` managed by `Django.contrib.AUTH`
@@ -20,161 +19,9 @@ an open-source `Bootstrap` design from [CodedThemes](https://bit.ly/37fF9RT).
2019

2120
<br />
2221

23-
![Datta Able (enhaced with dark mode) - Open-Source Seed project generated by AppSeed.](https://user-images.githubusercontent.com/51070104/176118649-7233ffbc-6118-4f56-8cda-baa81d256877.png)
24-
25-
<br />
26-
27-
## Why [Django Datta Able](https://appseed.us/product/datta-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-datta
44-
// OR
45-
$ pip install git+https://github.com/app-generator/django-admin-datta.git
46-
```
47-
48-
<br />
49-
50-
> Add `admin_datta` 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_datta.apps.AdminDattaConfig',
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_datta` 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_datta.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_datta
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-
| | |-- footer.html # Footer component
128-
| | |-- sidebar.html # Sidebar component
129-
| | |-- navigation.html # Navigation Bar
130-
| | |-- scripts.html # Scripts Component
131-
| |
132-
| |-- layouts/
133-
| | |-- base.html # Masterpage
134-
| | |-- base-auth.html # Masterpage for Auth Pages
135-
| |
136-
| |-- pages/
137-
| |-- index.html # Dashboard Page
138-
| |-- profile.html # Profile Page
139-
| |-- *.html # All other pages
140-
|
141-
|-- ************************************************************************
142-
```
143-
144-
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.
145-
146-
For instance, if we want to customize the `index.html` these are the steps:
147-
148-
- `Step 1`: create the `templates` DIRECTORY inside your app
149-
- `Step 2`: configure the project to use this new template directory
150-
- Edit `settings.py` TEMPLATES section
151-
- `Step 3`: copy the `footer.html` from the original location (inside your ENV) and save it to the `YOUR_APP/templates` DIR
152-
- Source PATH: `<YOUR_ENV>/LIB/admin_datta/templates/pages/index.html`
153-
- Destination PATH: `YOUR_APP/templates/pages/index.html`
154-
- Edit the `index.html` (Destination PATH)
155-
156-
At this point, the default version of the `index.html` shipped in the library is ignored by Django.
157-
158-
In a similar way, all other files and components can be customized easily.
159-
160-
<br />
161-
162-
## [Datta Able](https://appseed.us/product/datta-able-pro/django/) `PRO Version`
163-
164-
> For more components, pages and priority on support, feel free to take a look at this **Django** starter:
165-
166-
Designed for those who like bold elements and beautiful websites, **[Datta Able](https://appseed.us/product/datta-able-pro/django/)** is the most stylish Admin Design compare to all other Bootstrap Templates.
167-
It comes with high feature-rich pages and components with fully developer-centric code.
168-
169-
- [Django Datta PRO](https://appseed.us/product/datta-able-pro/django/) - product page
170-
- `Enhanced UI` - more pages and components
171-
- `Priority` on support
172-
173-
<br >
174-
175-
![Datta Able PRO - Full-Stack Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/170474361-a58da82b-fff9-4a59-81a8-7ab99f478f48.png)
22+
![Django Datta Able - Modern template for Django Admin Section crafted on top of a modern Bootstrap Design.](https://user-images.githubusercontent.com/51070104/176118649-7233ffbc-6118-4f56-8cda-baa81d256877.png)
17623

17724
<br />
17825

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

‎setup.py‎

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

99
setup(
1010
name='django-admin-datta',
11-
version='1.0.11',
11+
version='1.0.12',
1212
zip_safe=False,
1313
packages=find_packages(),
1414
include_package_data=True,
15-
description='Modern template for Django admin interface',
15+
description='Modern template for Django Admin - Datta Able Design',
1616
long_description=README,
1717
long_description_content_type="text/markdown",
18-
url='https://appseed.us/product/datta-able/django/',
18+
url='https://app-generator.dev/docs/products/django-libs/theme-datta-able.html',
1919
author='AppSeed.us',
2020
author_email='[email protected]',
2121
license='MIT License',

0 commit comments

Comments
 (0)