Skip to content

Commit b46c957

Browse files
app-generatorapp-generator
committed
v1.0.37 - Update Product Links
1 parent a898c3b commit b46c957

File tree

3 files changed

+24
-302
lines changed

3 files changed

+24
-302
lines changed

‎CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# Change Log
22

3+
## [1.0.37] 2024-11-11
4+
### Changes
5+
6+
- Update RM Links:
7+
- 👉 [Django Datta Able](https://app-generator.dev/docs/products/django/datta-able/index.html) - **Complete Documentation**
8+
- 👉 [Django Datta Able](https://app-generator.dev/product/datta-able/django/) - Product Page
9+
- 👉 [Get Support](https://app-generator.dev/ticket/create/) via Email and Discord
10+
311
## [1.0.36] 2024-09-17
412
### Changes
513

‎README.md

Lines changed: 16 additions & 278 deletions
Original file line numberDiff line numberDiff line change
@@ -1,290 +1,28 @@
1-
# [Datta Able Django](https://appseed.us/product/datta-able/django/)
21

3-
Open-source **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** provided by `AppSeed` on top of a modern design. **[Datta Able](https://appseed.us/product/datta-able/django/)** Bootstrap Lite is the most stylized Bootstrap 4 Template, among all other Lite/Free admin templates in the market. It comes with high feature-rich pages and components with fully developer-centric code - design from `CodedThemes`.
2+
# [Django Datta Able](https://app-generator.dev/product/datta-able/django/)
43

5-
- 👉 [Datta Able Django](https://appseed.us/product/datta-able/django/) - `Product page`
6-
- 👉 [Datta Able Django](https://django-datta-able.appseed-srv1.com/) - `LIVE demo`
4+
Open-source **Django** project crafted on top of **Datta Able Dashboard**, an open-source `Bootstrap` design.
5+
The product is designed to deliver the best possible user experience with highly customizable feature-rich pages.
76

8-
<br />
9-
10-
## Features
11-
12-
> `Have questions?` Contact **[Support](https://appseed.us/support/)** (Email & Discord) provided by **AppSeed**
13-
14-
| Free Version | [PRO Version](https://appseed.us/product/datta-able-pro/django/) | [Custom Development](https://appseed.us/custom-development/) |
15-
| --------------------------------------| --------------------------------------| --------------------------------------|
16-
| ✓ **Django 4.2.9** | **Everything in Free**, plus: | **Everything in PRO**, plus: |
17-
| ✓ Bootstrap 4 UI | ✅ **PRO Bootstrap 5 UI**, `Dark-Mode` | ✅ **1 Week** `Custom Development` |
18-
| ✓ API Generator | ✅ **OAuth** `GitHub` | ✅ **Team**: PM, Developer, Tester |
19-
| ✓ DataTables | ✅ `API`, **[Charts](https://django-datta-pro.onrender.com/charts/)** | ✅ Weekly Sprints |
20-
| ✓ `Docker` | ✅ **[Enhanced DataTables](https://django-datta-pro.onrender.com/tables/)** | ✅ Technical Specs |
21-
| ✓ `CI/CD` Flow via Render | ✅ **Celery** (`async tasks`) | ✅ Documentation |
22-
| ✓ `Free Support` (GitHub Issues) | ✅ **Media Files Manager** | ✅ **30 days Delivery Warranty** |
23-
| - | ✅ **Extended User Profiles** | ✅ [CI/CD for AWS, DO](https://appseed.us/terms/#section-ci-cd) **(Extra)** |
24-
| - | ✅ **Automated e2e Tests** | - |
25-
| - | ✅ `Private REPO Access` | - |
26-
| - | ✅ **[Premium Support](https://appseed.us/support/)** | - |
27-
| ------------------------------------ | ------------------------------------ | ------------------------------------|
28-
| ✓ [LIVE Demo](https://django-datta-able.appseed-srv1.com/) | 🚀 [LIVE Demo](https://django-datta-pro.onrender.com/) | **[Get in Touch ➡️](https://appseed.us/custom-development/)** |
29-
30-
31-
![Datta Able (enhanced with dark mode) - Open-Source Seed project generated by AppSeed.](https://user-images.githubusercontent.com/51070104/176118649-7233ffbc-6118-4f56-8cda-baa81d256877.png)
32-
33-
<br />
34-
35-
## Django Framework
36-
37-
Django is a high-level Python web framework designed for rapid development of secure and maintainable websites. Here are the core features:
38-
39-
- Model-View-Template (MVT) architecture:
40-
- Models define your data structure
41-
- Views handle the logic and processing
42-
- Templates manage the presentation
43-
- Built-in admin interface for easy content management
44-
- Object-Relational Mapping (ORM) for database interactions without writing SQL
45-
- URL routing system to map URLs to views
46-
- Form handling and validation
47-
- Built-in security features (e.g., protection against SQL injection, cross-site scripting)
48-
- Scalable and suitable for both small and large projects
49-
50-
To get started, you'll need Python installed. Then you can install Django, create a project, define models, set up views and templates, and run your development server.
51-
52-
<br />
53-
54-
## Start with `Docker`
55-
56-
> 👉 **Step 1** - Download the code from the GH repository (using `GIT`)
57-
58-
```bash
59-
$ git clone https://github.com/app-generator/django-datta-able.git
60-
$ cd django-datta-able
61-
```
62-
63-
<br />
64-
65-
> 👉 **Step 2** - Start the APP in `Docker`
66-
67-
```bash
68-
$ docker-compose up --build
69-
```
70-
71-
Visit `http://localhost:5085` in your browser. The app should be up & running.
7+
- 👉 [Django Datta Able](https://app-generator.dev/docs/products/django/datta-able/index.html) - **Complete Documentation**
8+
- 👉 [Django Datta Able](https://django-datta-able.appseed-srv1.com/) - LIVE Demo
9+
- 👉 [Get Support](https://app-generator.dev/ticket/create/) via Email and Discord
7210

7311
<br />
7412

75-
## Environment
76-
77-
Create a new `.env` file using sample `env.sample`. The meaning of each variable can be found below:
78-
79-
- `DEBUG`: if `True` the app runs in development mode
80-
- For production value `False` should be used
81-
- For `MySql` persistence
82-
- Install the DB Driver: `pip install mysqlclient`
83-
- Create DB and assign a new user (full rights)
84-
- Edit `.env` to match the DB, user, and password
85-
86-
<br />
87-
88-
## Manual Build
89-
90-
> Download the code
91-
92-
```bash
93-
$ git clone https://github.com/app-generator/django-datta-able.git
94-
$ cd django-datta-able
95-
```
96-
97-
<br />
98-
99-
### 👉 Set Up for `Unix`, `MacOS`
100-
101-
> Install modules via `VENV`
102-
103-
```bash
104-
$ virtualenv env
105-
$ source env/bin/activate
106-
$ pip3 install -r requirements.txt
107-
```
108-
109-
<br />
110-
111-
> Set Up Database
112-
113-
```bash
114-
$ python manage.py makemigrations
115-
$ python manage.py migrate
116-
```
117-
118-
<br />
119-
120-
> Generate API
121-
122-
```bash
123-
$ python manage.py generate-api -f
124-
```
125-
126-
<br />
127-
128-
> Start the APP
129-
130-
```bash
131-
$ python manage.py createsuperuser # create the admin
132-
$ python manage.py runserver # start the project
133-
```
134-
135-
At this point, the app runs at `http://127.0.0.1:8000/`.
136-
137-
<br />
138-
139-
### 👉 Set Up for `Windows`
140-
141-
> Install modules via `VENV` (windows)
142-
143-
```
144-
$ virtualenv env
145-
$ .\env\Scripts\activate
146-
$ pip3 install -r requirements.txt
147-
```
148-
149-
<br />
150-
151-
> Set Up Database
152-
153-
```bash
154-
$ python manage.py makemigrations
155-
$ python manage.py migrate
156-
```
157-
158-
<br />
159-
160-
> Start the APP
161-
162-
```bash
163-
$ python manage.py createsuperuser # create the admin
164-
$ python manage.py runserver # start the project
165-
```
166-
167-
168-
At this point, the app runs at `http://127.0.0.1:8000/`.
169-
170-
<br />
171-
172-
<br />
173-
174-
## Codebase Structure
175-
176-
The project is coded using a simple and intuitive structure presented below:
177-
178-
```bash
179-
< PROJECT ROOT >
180-
|
181-
|-- core/
182-
| |-- settings.py # Project Configuration
183-
| |-- urls.py # Project Routing
184-
|
185-
|-- home/
186-
| |-- views.py # APP Views
187-
| |-- urls.py # APP Routing
188-
| |-- models.py # APP Models
189-
| |-- tests.py # Tests
190-
| |-- templates/ # Theme Customisation
191-
| |-- pages #
192-
| |-- custom-index.py # Custom Dashboard
193-
|
194-
|-- requirements.txt # Project Dependencies
195-
|
196-
|-- env.sample # ENV Configuration (default values)
197-
|-- manage.py # Start the app - Django default start script
198-
|
199-
|-- ************************************************************************
200-
```
201-
202-
<br />
203-
204-
## How to Customize
205-
206-
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.
207-
The theme used to style this starter provides the following files:
208-
209-
```bash
210-
# This exists in ENV: LIB/admin_datta
211-
< UI_LIBRARY_ROOT >
212-
|
213-
|-- templates/ # Root Templates Folder
214-
| |
215-
| |-- accounts/
216-
| | |-- auth-signin.html # Sign IN Page
217-
| | |-- auth-signup.html # Sign UP Page
218-
| |
219-
| |-- includes/
220-
| | |-- footer.html # Footer component
221-
| | |-- sidebar.html # Sidebar component
222-
| | |-- navigation.html # Navigation Bar
223-
| | |-- scripts.html # Scripts Component
224-
| |
225-
| |-- layouts/
226-
| | |-- base.html # Masterpage
227-
| | |-- base-auth.html # Masterpage for Auth Pages
228-
| |
229-
| |-- pages/
230-
| |-- index.html # Dashboard Page
231-
| |-- profile.html # Profile Page
232-
| |-- *.html # All other pages
233-
|
234-
|-- ************************************************************************
235-
```
236-
237-
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.
238-
239-
> For instance, if we want to **customize the index.html** these are the steps:
240-
241-
- ✅ `Step 1`: create the `templates` DIRECTORY inside the `home` app
242-
- ✅ `Step 2`: configure the project to use this new template directory
243-
- `core/settings.py` TEMPLATES section
244-
- ✅ `Step 3`: copy the `index.html` from the original location (inside your ENV) and save it to the `home/templates` DIR
245-
- Source PATH: `<YOUR_ENV>/LIB/admin_black_pro/pages/index.html`
246-
- Destination PATH: `<PROJECT_ROOT>home/templates/pages/index.html`
247-
248-
> To speed up all these steps, the **codebase is already configured** (`Steps 1, and 2`) and a `custom dashboard` can be found at this location:
249-
250-
`home/templates/pages/custom-index.html`
251-
252-
By default, this file is unused because the `theme` expects `index.html` (without the `custom-` prefix).
253-
254-
In order to use it, simply rename it to `index.html`. Like this, the default version shipped in the library is ignored by Django.
255-
256-
In a similar way, all other files and components can be customized easily.
257-
258-
<br />
259-
260-
## Deploy on [Render](https://render.com/)
261-
262-
- Create a Blueprint instance
263-
- Go to https://dashboard.render.com/blueprints this link.
264-
- Click `New Blueprint Instance` button.
265-
- Connect your `repo` which you want to deploy.
266-
- Fill the `Service Group Name` and click on the `Update Existing Resources` button.
267-
- After that, your deployment will start automatically.
268-
269-
At this point, the product should be LIVE.
270-
271-
<br />
272-
273-
## [Datta Able Django](https://appseed.us/product/datta-able-pro/django/) `PRO Version`
274-
275-
> For more components, pages, and priority on support, feel free to take a look at this amazing starter:
276-
277-
Designed for those who like bold elements and beautiful websites, **Datta Able** is the most stylish Bootstrap 4 Admin Template compare to all other Bootstrap admin templates. It comes with high feature-rich pages and components with fully developer-centric code.
278-
279-
- 👉 [Django Datta PRO](https://appseed.us/product/datta-able-pro/django/) - product page
280-
- ✅ `Enhanced UI` - more pages and components
281-
- ✅ `Priority` on support
13+
## Features
28214

283-
<br >
15+
- **Django 4.1.12**
16+
- Best Practices
17+
- API Generator
18+
- DataTables
19+
- [Datta Able Dashboard](https://app-generator.dev/docs/templates/bootstrap/datta-able.html) - Full Integration
20+
- `CI/CD` Flow via Render
21+
- `Docker`
28422

285-
![Datta Able PRO - Full-Stack Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/170474361-a58da82b-fff9-4a59-81a8-7ab99f478f48.png)
23+
![Django Datta Able - Open-Source Django Starter](https://user-images.githubusercontent.com/51070104/176118649-7233ffbc-6118-4f56-8cda-baa81d256877.png)
28624

28725
<br />
28826

28927
---
290-
[Datta Able Django](https://appseed.us/product/datta-able/django/) - Open-source starter provided by **[AppSeed](https://appseed.us/)**.
28+
[Django Datta Able](https://app-generator.dev/product/datta-able/django/) - Open-Source **Django** Starter provided by [App Generator](https://app-generator.dev)

‎README_deploy.md

Lines changed: 0 additions & 24 deletions
This file was deleted.

0 commit comments

Comments
 (0)