Skip to content

Commit e157faa

Browse files
app-generatorapp-generator
committed
UPD Django Section - All Products
1 parent 4d6d83f commit e157faa

29 files changed

+284
-275
lines changed

‎docs/products/django-dashboards/adminator.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_label: Django Adminator
77

88
<SubHeading>Open-source Django Starter coded on top Adminator design.</SubHeading>
99

10-
Django Admin Dashboard generated by the AppSeed platform on top of **Adminator** design, an iconic free dahsboard template.
10+
**[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by the AppSeed platform on top of **Adminator** design, an iconic free dahsboard template.
1111
**[Adminator](https://appseed.us/product/adminator/django/)** is one of the best open-source admin dashboard & control panel theme.
1212
Built on top of Bootstrap, `Adminator` provides a range of responsive, reusable, and commonly used components.
1313

‎docs/products/django-dashboards/adminlte.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_label: Django AdminLTE
77

88
<SubHeading>Open-source Django Starter coded on top AdminLTE, an iconic dashboard design.</SubHeading>
99

10-
Open-source **Django Dashboard** generated by `AppSeed` on top of an open-source Bootstrap Design.
10+
Open-source **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of an open-source Bootstrap Design.
1111
[AdminLTE](https://appseed.us/product/adminlte/django/) is a free and open source `Bootstrap` crafted and released for free by ColorLib.
1212

1313
- 👉 [Django AdminLTE](https://appseed.us/product/adminlte/django/) - `Product page`

‎docs/products/django-dashboards/argon-dashboard-pro.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_label: Django Argon PRO
77

88
<SubHeading>Premium Django Starter coded on top of Argon Bootstrap 4 design (Premium Version).</SubHeading>
99

10-
Premium **Django Dashboard** generated by `AppSeed` on top of a modern design.
10+
Premium **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of a modern design.
1111
**[Argon Dashboard](https://appseed.us/product/argon-dashboard-pro/django/)** is a premium `Bootstrap 4` Admin Dashboard featuring over 100 components, and 11 example pages.
1212

1313
- 🛒 [Django Argon PRO](https://appseed.us/product/argon-dashboard-pro/django/) - `Product page` (contains payment links)

‎docs/products/django-dashboards/argon-dashboard.mdx‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title : Django Argon Dashboard - Open-Source Starter
3-
sidebar_label: Django Argon Dashboard
2+
title : Django Argon - Open-Source Starter
3+
sidebar_label: Django Argon
44
---
55

6-
# [Django Argon Dashboard](https://appseed.us/product/argon-dashboard/django/)
6+
# [Django Argon](https://appseed.us/product/argon-dashboard/django/)
77

88
<SubHeading>Open-source Django Starter coded on top Argon Dashboard design (Free Version).</SubHeading>
99

10-
Open-source **Django Dashboard** generated by `AppSeed` on top of a modern design.
10+
Open-source **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of a modern design.
1111
**[Argon Dashboard](https://appseed.us/product/argon-dashboard/django/)** is a free and open source `Bootstrap 5` Admin Dashboard featuring over 100 components, 11 example pages and 3 plugins with Vanilla JS.
1212

1313
- 👉 [Django Argon Dashboard](https://appseed.us/product/argon-dashboard/django/) - `Product page`

‎docs/products/django-dashboards/argon-dashboard2-pro.mdx‎

Lines changed: 70 additions & 137 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,42 @@
11
---
2-
title: Django Argon2 BS5 PRO - Premium Starter
3-
sidebar_label: Django Argon2 BS5 PRO
2+
title: Django Argon BS5 PRO - Premium Starter
3+
sidebar_label: Django Argon BS5 PRO
4+
canonical: https://appseed.us/product/argon-dashboard2-pro/django/
45
---
56

6-
# [Django Argon2 PRO](https://appseed.us/product/argon-dashboard2-pro/django/)
7+
# [Django Argon Dash2 PRO](https://appseed.us/product/argon-dashboard2-pro/django/)
78

8-
<SubHeading>Premium Django Starter coded on top of Argon2 Dashboard Design (Premium BS5 Version).</SubHeading>
9+
<SubHeading>Premium Django Starter coded on top of Argon Dashboard 2 PRO design (Premium Version).</SubHeading>
910

10-
**Django** starter styled with **[Argon2 Design PRO](https://appseed.us/product/argon-dashboard2-pro/django/)**, a premium `Bootstrap 5` KIT from [Creative-Tim](https://bit.ly/3fKQZaL)
11+
**[Django Dashboard](https://appseed.us/admin-dashboards/django/)** styled with **[Argon Dashboard2 PRO](https://appseed.us/product/argon-dashboard2-pro/django/)**, a premium `Bootstrap 5` KIT from `Creative-Tim`
1112
The product is designed to deliver the best possible user experience with highly customizable feature-rich pages.
1213

13-
- 🛒 [Django Argon2 PRO](https://appseed.us/product/material-dashboard2-pro/django/) - `Product page` (contains payment links)
14-
- 👉 [Django Argon2 PRO](https://django-argon-dash2-pro.onrender.com/) - `LIVE Demo` on Render
14+
- 👉 [Django Argon Dash 2 PRO](https://appseed.us/product/argon-dashboard2-pro/django/) - `Product page`
15+
- 👉 [Django Argon Dash 2 PRO](https://django-argon-dash2-pro.onrender.com/) - `LIVE Demo`
1516

16-
:::info [**v1.0.1**](https://github.com/app-generator/django-argon-dashboard2-pro/releases) - release date `2023-06-12`
17+
:::info [**v1.0.5**](https://github.com/app-generator/django-argon-dashboard2-pro/releases) - release date `2024-08-09`
1718
:::
1819

19-
## ✅ **Features**
20-
21-
- `Up-to-date Dependencies`
22-
- `Design`: [Django Theme Argon2](https://github.com/app-generator/django-admin-argon2-pro) - `PRO Version`
23-
- `Sections` covered by the design:
24-
- **Admin section** (reserved for superusers)
25-
- **Authentication**: `Django.contrib.AUTH`, Registration
26-
- **All Pages** available in for ordinary users
20+
## **Features**
21+
22+
- `Up-to-date dependencies`
23+
- Database: `SQLite` (default), PgSQL, MySql
24+
- **Authentication**
25+
- `Session-Based authentication`
26+
- `Social Login`: **Github**
27+
- **User Extended profile**
28+
- **API** via DRF
29+
- DataTables
30+
- Charts
31+
- Celery (Async Tasks)
32+
- File Manager
2733
- `Docker`
28-
- `Deployment`
29-
- `CI/CD` flow via `Render`
3034

31-
![Argon Dashboard 2 PRO - Charts Page (Premium Bootstrap 5 Design)](https://user-images.githubusercontent.com/51070104/211157993-fd439b20-6117-4e02-b98c-9123866660e2.jpg)
35+
![Argon Dashboard 2 PRO - Main Charts Page (Premium Bootstrap 5 Design)](https://github.com/user-attachments/assets/e2bca541-ed94-4369-8ab7-361a7f112e69)
3236

37+
<br />
3338

34-
## ✅ Environment
39+
## Environment
3540

3641
To use the starter, [Python3](https://www.python.org) should be installed properly in the workstation.
3742
If you are not sure if Python is installed, please open a terminal and type `python --version`. Here is the full list with dependencies and tools required to build the app:
@@ -41,169 +46,98 @@ If you are not sure if Python is installed, please open a terminal and type `pyt
4146
- Basic development tools (g++ compiler, python development libraries ..etc) used by Python to compile the app dependencies in your environment.
4247
- (Optional) `Docker` - a popular virtualization software
4348

49+
<br />
4450

45-
## ✅ Manual Build
51+
## Start in `Docker`
4652

47-
> 👉 Download the code
53+
> **Step 1** - Download the [code](https://appseed.us/product/argon-dashboard2-pro/django/) and unzip the sources (requires a `purchase`).
4854
4955
```bash
50-
$ git clone https://github.com/app-generator/django-argon-dashboard2-pro.git
56+
$ unzip django-argon-dashboard2-pro.zip
5157
$ cd django-argon-dashboard2-pro
5258
```
5359

5460
<br />
5561

56-
> Export `GITHUB_TOKEN` in the environment. The value is provided by AppSeed during purchase.
57-
58-
This is required because the project has a private REPO dependency: `github.com/app-generator/priv-django-admin-argon-pro`
62+
> **Step 2** - Start the APP in `Docker`
5963
6064
```bash
61-
$ export GITHUB_TOKEN='TOKEN_HERE' # for Linux, Mac
62-
$ set GITHUB_TOKEN='TOKEN_HERE' # Windows CMD
63-
$ $env:GITHUB_TOKEN = 'TOKEN_HERE' # Windows powerShell
65+
# Optional (kill all existing containers)
66+
$ docker container kill $(docker ps -q) ; docker container rm $(docker ps -a -q) ; docker network prune -f
67+
# Start the APP
68+
$ docker-compose up --build
6469
```
6570

66-
> 👉 Install modules via `VENV`.
71+
Visit `http://localhost:5085` in your browser. The app should be up & running.
72+
73+
<br />
6774

75+
## Manual Build
76+
77+
> **Step 1** - Download the [code](https://appseed.us/product/argon-dashboard2-pro/django/) and unzip the sources (requires a `purchase`).
6878
6979
```bash
70-
$ virtualenv env
71-
$ source env/bin/activate
72-
$ pip install -r requirements.txt
80+
$ unzip django-argon-dashboard2-pro.zip
81+
$ cd django-argon-dashboard2-pro
7382
```
7483

75-
> 👉 Edit the `.env` using the template `.env.sample`.
84+
> **Step 2** - Create new `.env` from `env.sample`
7685
77-
```env
86+
The meaning of each variable can be found below:
7887

79-
# True for development, False for production
80-
DEBUG=True
88+
- `DEBUG`: if `True` the app runs in develoment mode
89+
- For production value `False` should be used
90+
- Edit `SECRET_KEY`: add strong secret key
8191

92+
> **Step 3** - Activate the Virtual Environment and Install Modules
93+
94+
```bash
95+
$ virtualenv env
96+
$ source env/bin/activate
97+
$ pip install -r requirements.txt
8298
```
8399

84-
> 👉 Set Up Database
100+
> **Step 4** - Migrate Database (by Default SQLite is used)
85101
86102
```bash
87103
$ python manage.py makemigrations
88104
$ python manage.py migrate
89105
```
90106

91-
> 👉 Create the Superuser
107+
> **Step 5** - Create Superuser
92108
93109
```bash
94110
$ python manage.py createsuperuser
95111
```
96112

97-
> 👉 Start the app
113+
> **Step 6** - Start the App
98114
99115
```bash
100116
$ python manage.py runserver
101117
```
102118

103119
At this point, the app runs at `http://127.0.0.1:8000/`.
104120

121+
<br />
105122

106-
## ✅ Manage App `Users`
107-
108-
By default, the starter is not provided with users. To access the private pages and the admin section (reserved for `superusers`) follow up the next sections.
109-
110-
### 👉 Create `Superusers`
111-
112-
To access the `admin` section, Django requires `superuser` privilegies. Let's create a new `superuser` and access the `admin` section of the project:
113-
114-
```bash
115-
$ python manage.py createsuperuser
116-
```
117-
118-
Once the `superuser` is successfully created, we can access the `admin` section:
119-
120-
`http://localhost:8000/admin/`
121-
122-
123-
## ✅ Codebase structure
124-
125-
The project is coded using a simple and intuitive structure presented below:
126-
127-
```bash
128-
< PROJECT ROOT >
129-
|
130-
|-- core/
131-
| |-- settings.py # Project Configuration
132-
| |-- urls.py # Project Routing
133-
|
134-
|-- home/
135-
| |-- views.py # APP Views
136-
| |-- urls.py # APP Routing
137-
| |-- models.py # APP Models
138-
| |-- tests.py # Tests
139-
|
140-
|-- requirements.txt # Project Dependencies
141-
|
142-
|-- env.sample # ENV Configuration (default values)
143-
|-- manage.py # Start the app - Django default start script
144-
|
145-
|-- ************************************************************************
146-
```
147-
148-
149-
## ✅ How to Customize
123+
## Start Celery
150124

151-
When a template file is loaded in the controller, `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.
152-
The theme used to style this starter provides the following files:
125+
- Make sure you have a Redis Server running: `redis://localhost:6379`
126+
- `$ redis-cli` and type `ping`
127+
- In the base directory inside `tasks_scripts` folder you need to write your scripts file.
128+
- Run the celery command from the CLI.
153129

154130
```bash
155-
# This is saved in ENV: LIB/admin_argon_pro
156-
< UI_LIBRARY_ROOT >
157-
158-
|
159-
|-- templates/ # Root Templates Folder
160-
| |
161-
| |-- accounts/
162-
| | |-- login.html # Sign IN Page
163-
| | |-- register.html # Sign UP Page
164-
| |
165-
| |-- includes/
166-
| | |-- footer.html # Footer component
167-
| | |-- sidebar.html # Sidebar component
168-
| | |-- navigation.html # Navigation Bar
169-
| | |-- scripts.html # Scripts Component
170-
| |
171-
| |-- layouts/
172-
| | |-- base.html # Masterpage
173-
| | |-- base-auth.html # Masterpage for Auth Pages
174-
| |
175-
| |-- pages/
176-
| |-- index.html # Index Page (presentation)
177-
| |-- settings.html # Settings Page
178-
| |-- dashboard.html # Dashboard page
179-
| |-- *.html # All other pages
180-
|
181-
|-- ************************************************************************
131+
$ export DJANGO_SETTINGS_MODULE="core.settings"
132+
$ celery -A apps.tasks worker -l info -B
182133
```
183134

184-
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.
185-
186-
> For instance, if we want to **customize the footer.html** these are the steps:
187-
188-
- ✅ `Step 1`: create the `templates` DIRECTORY inside the `home` app
189-
- ✅ `Step 2`: configure the project to use this new template directory
190-
- `core/settings.py` TEMPLATES section
191-
- ✅ `Step 3`: copy the `footer.html` from the original location (inside your ENV) and save it to the `home/templates` DIR
192-
- Source PATH: `<YOUR_ENV>/LIB/admin_argon_pro/includes/footer.html`
193-
- Destination PATH: `<PROJECT_ROOT>home/templates/includes/footer.html`
194-
195-
> To speed up all these steps, the **codebase is already configured** (`Steps 1, and 2`) and a `custom footer` can be found at this location:
196-
197-
`home/templates/includes/custom_footer.html`
198-
199-
By default, this file is unused because the `theme` expects `footer.html` (without the `custom_` prefix).
200-
201-
In order to use it, simply rename it to `footer.html`. Like this, the default version shipped in the library is ignored by Django.
202-
203-
In a similar way, all other files and components can be customized easily.
135+
- You will see a new route `Apps -> Tasks` in the sidebar.
136+
- You can start and cancel any task from the UI.
204137

138+
<br />
205139

206-
## ✅ Deploy on [Render](https://render.com/)
140+
## Deploy on [Render](https://render.com/)
207141

208142
- Create a Blueprint instance
209143
- Go to https://dashboard.render.com/blueprints this link.
@@ -214,8 +148,7 @@ In a similar way, all other files and components can be customized easily.
214148

215149
At this point, the product should be LIVE.
216150

217-
218-
## ✅ Resources
151+
## Resources
219152

220153
- 👉 Access [AppSeed](https://appseed.us/) for more starters and support
221-
- 👉 Get in touch for **[Custom Development Services](https://appseed.us/custom-development/)**
154+
- 👉 Get in touch for [Custom Development Services](https://appseed.us/custom-development/)

‎docs/products/django-dashboards/atlantis-dark-pro.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_label: Django Atlantis PRO
77

88
<SubHeading>Premium Django Starter coded on top of Atlantis Bootstrap Design (Premium Version).</SubHeading>
99

10-
Premium **Django Dashboard** generated by `AppSeed` on top of a modern Bootstrap 4 design.
10+
Premium **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of a modern Bootstrap 4 design.
1111
**[Atlantis Dark PRO Dashboard](https://appseed.us/product/atlantis-dark-pro/django/)** is a premium `Bootstrap 4` Admin Dashboard featuring over 50+ components, and 30 example pages.
1212

1313
- 🛒 [Django Atlantis PRO](https://appseed.us/product/atlantis-dark-pro/django/) - `Product page` (contains payment links)

‎docs/products/django-dashboards/atlantis-dark.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Django Atlantis - Open-Source Starter
3-
sidebar_label: Django Atlantis Dark
3+
sidebar_label: Django Atlantis
44
---
55

6-
# [Django Atlantis Dark ](https://appseed.us/product/atlantis-dark/django/)
6+
# [Django Atlantis](https://appseed.us/product/atlantis-dark/django/)
77

8-
Django Admin Dashboard generated by the AppSeed platform on top of Atlantis Dark design (free version) crafted by `ThemeKita`.
8+
**[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by the AppSeed platform on top of Atlantis Dark design (free version) crafted by `ThemeKita`.
99

1010
- 👉 [Atlantis Dark Django](https://appseed.us/product/atlantis-dark/django/) - `Product Page`
1111
- 👉 [Atlantis Dark Django](https://django-atlantis-dark.appseed-srv1.com/) - `LIVE Demo`

‎docs/products/django-dashboards/azia-dashboard.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_label: Django Azia Dashboard
77

88
<SubHeading>Open-source Django Starter coded on top Azia Dashboard design (free version).</SubHeading>
99

10-
Django Admin Dashboard generated by the AppSeed platform on top of **Azia Dashboard** design (free version) crafted by `BootstrapDash`.
10+
**[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by the AppSeed platform on top of **Azia Dashboard** design (free version) crafted by `BootstrapDash`.
1111

1212
:::info [**v1.0.3**](https://github.com/app-generator/django-azia-dashboard/releases) - release date `2022-06-10`
1313
:::

‎docs/products/django-dashboards/berry-dashboard-pro.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: Django Berry PRO - Premium Starter
3-
sidebar_label: Django Berry PRO
2+
title : Django Berry PRO - Premium Starter
3+
sidebar_label : Django Berry PRO
44
---
55

66
# [Django Berry PRO](https://appseed.us/product/berry-dashboard-pro/django/)
77

88
<SubHeading>Premium Django Starter coded on top of Berry Bootstrap design (Premium Version).</SubHeading>
99

10-
Premium **Django Dashboard** generated by `AppSeed` on top of a modern design. **[Berry Dashboard](https://appseed.us/product/berry-dashboard-pro/django/)** is a premium `Bootstrap `
10+
Premium **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of a modern design. **[Berry Dashboard](https://appseed.us/product/berry-dashboard-pro/django/)** is a premium `Bootstrap `
1111
Admin Dashboard featuring over 100 components, 11 example pages and 3 plugins with Vanilla JS.
1212

1313
- 🛒 [Django Berry PRO](https://appseed.us/product/berry-dashboard-pro/django/) - `Product page` (contains payment links)

‎docs/products/django-dashboards/berry-dashboard.mdx‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: Django Berry Dashboard - Open-Source Starter
3-
sidebar_label: Django Berry Dashboard
2+
title : Django Berry - Open-Source Starter
3+
sidebar_label: Django Berry
44
---
55

6-
# [Django Berry Dashboard](https://appseed.us/product/berry-dashboard/django/)
6+
# [Django Berry](https://appseed.us/product/berry-dashboard/django/)
77

88
<SubHeading>Open-source Django Starter coded on top Berry Dashboard design (Free Version).</SubHeading>
99

10-
Open-source **Django Dashboard** generated by `AppSeed` on top of a modern design.
10+
Open-source **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** generated by `AppSeed` on top of a modern design.
1111
** [Berry Dashboard](https://appseed.us/product/berry-dashboard/django/)** is a free and open source `Bootstrap 5` Admin Dashboard featuring over 100 components, 11 example pages and 3 plugins with Vanilla JS.
1212

1313
- 👉 [Django Berry](https://appseed.us/product/berry-dashboard/django/) - `Product page`

0 commit comments

Comments
 (0)