https://github.com/app-generator/ecommerce-django-stripe-demo
Django Stripe Mini Ecommerce - Sample APP | AppSeed
https://github.com/app-generator/ecommerce-django-stripe-demo
appseed-sample django-stripe ecommerce
Last synced: 5 months ago
JSON representation
Django Stripe Mini Ecommerce - Sample APP | AppSeed
- Host: GitHub
- URL: https://github.com/app-generator/ecommerce-django-stripe-demo
- Owner: app-generator
- License: other
- Created: 2022-11-02T08:29:43.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-11-02T09:01:35.000Z (over 3 years ago)
- Last Synced: 2025-04-06T18:13:26.029Z (about 1 year ago)
- Topics: appseed-sample, django-stripe, ecommerce
- Language: HTML
- Homepage: https://www.youtube.com/watch?v=7U9qRKR-src
- Size: 8.66 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# [Django & Stripe](https://blog.appseed.us/django-stripe-mini-ecommerce/) `Mini eCommerce`
Open-source mini `eCommerce` project that loads the products from `JSON` files saved in the `templates directory` (no database required) and uses a decent UI for page styling - Powered by **Django**.
- 👉 [Django & Stripe Presentation](https://www.youtube.com/watch?v=7U9qRKR-src) - published on `YouTube`
- 👉 Free [Support](https://appseed.us/) via `Github` (issues tracker) and `Discord`.
> Roadmap & Features
| Status | Item | info |
| --- | --- | --- |
| ✅ | **Django** | For `backend logic` |
| ✅ | **Stripe** | `Payment processor` |
| ✅ | **[Soft UI Design](https://www.creative-tim.com/product/soft-ui-design-system?AFFILIATE=128200)** | (Free Version) by `Creative-Tim` |
| ✅ | **JSON** | `Products definition` - see [sample](./products/templates/products/product-air-zoom-pegasus.json) |
| ✅ | Automatic Products Discovery | Source DIR: [templates\products](./products/templates/products) |
| ✅ | **Dw Products from Stripe** | On going development via [Python Stripe Library](https://pypi.org/project/python-stripe/) |
| ❌ | **Docker** | - |
| ❌ | **CI/CD** | Render Deployment Platform |
https://user-images.githubusercontent.com/51070104/197837019-4634377f-c61f-4df1-9675-1365556be37f.mp4
## Quick Start
> 👉 **Step 1** - Download the code from the GH repository (using `GIT`)
```bash
$ git clone https://github.com/app-generator/ecommerce-django-stripe.git
$ cd ecommerce-django-stripe
```
> 👉 **Step 2** - Create `.env` using provided `env.sample`
Add `.env` file in your projects root directory and add the following credentials
```
DEBUG=True
SECRET_KEY=
STRIPE_SECRET_KEY=
STRIPE_PUBLISHABLE_KEY=
DOMAIN_URL=
```
> 👉 **Step 3** - Install dependencies
```bash
$ python -m venv env
$ source env/bin/activate
$ pip install -r requirements.txt
```
> 👉 **Step 4** - Migrate DB & Start the APP
```bash
$ python manage.py migrate
$ python manage.py runserver
```
Visit `http://localhost:8000` in your browser. The app should be up & running.
> 👉 **Step 5** - Access the products and initiate a payment
**IMPORTANT**: Make sure your Stripe account is running in `TEST Mode` and Use Test CC provided by Stripe:
- **CC Number**: `4242 4242 4242 4242`
- Any data for the rest of the fields
## Create a new Product
- Go to `products/templates/products` directory
- Create a new `JSON` file with data:
- `name`: Used in product page & Cards
- `price`: Used for payment
- `currency`: Used for payment
- `info`: used in cards
- `short_description`: used in product page
- `full_description`: used in product page
- Create Media Files
- Go to `products/static/products`
- Create a directory using the same name as for `JSON` file
- Create `card.jpg`: 500x335px
- Create `cover.jpg`: 2100x1400px
- Start or refresh the app
- The new product should be listed in the `home` page
- Product page is available at address:
- `http://127.0.0.1:8000/product//` where the SLUG is the name of the JSON file
## ✨ Load and create product from stripe
- Go to `Create Product` route in `Products` dropdown [You must be a superuser]
- On the left side there should be a button `Get Products From Stripe` this button will pull all the products associated with the stripe account. [demo](./products/static/products/demo/load-stripe-product.png)
- There will be product list, you can create a product by clicking the `Create` button. [demo](./products/static/products/demo/create-product.png)
- On the right side you will see the local product list and a button `Edit`.
- You can edit a product from here. [ID is not editable] [demo](./products/static/products/demo/edit-product.png)
> Sample product page generated for [Air ZOOM Pegasus](./products/templates/products/product-air-zoom-pegasus.json), assets loaded from [here](./products/static/products/product-air-zoom-pegasus)
> Homepage eCommerce cards
## Codebase structure
The project has a simple structure, represented as bellow:
```bash
< PROJECT ROOT >
|
|-- products/__init__.py
|-- products/
| |-- static/
| | |-- # CSS files, Javascripts files
| |
| |-- templates/
| | |
| | |-- includes/ # Page chunks, components
| | | |-- navigation.html # Top bar
| | | |-- sidebar.html # Left sidebar
| | | |-- scripts.html # JS scripts common to all pages
| | | |-- footer.html # The common footer
| | |
| | |-- layouts/ # App Layouts (the master pages)
| | | |-- base.html # Used by common pages like index, UI
| | | |-- base-fullscreen.html # Used by auth pages (login, register)
| | |
| | |-- products/ # Define your products here
| | | |-- nike-goalkeeper-match.json # Sample product
|
|-- requirements.txt
|
|-- run.py
|
|-- ************************************************************************
```
## Credits & Links
- [Django Framework](https://www.djangoproject.com/) - The official website
- [Stripe Dev Tools](https://stripe.com/docs/development) - official docs
---
**[Django & Stripe](https://blog.appseed.us/django-stripe-mini-ecommerce/) Mini eCommerce** - Free sample provided by [AppSeed](https://appseed.us).