Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/app-generator/ecommerce-django-stripe
Django Stripe Sample - Soft UI Design (Free Sample) | AppSeed
https://github.com/app-generator/ecommerce-django-stripe
django-and-stripe django-ecom django-ecommerce django-ecommerce-project django-sample django-stripe django-stripe-sample django-template ecommerce ecommerce-application ecommerce-django ecommerce-django-project stripe-sample
Last synced: 16 days ago
JSON representation
Django Stripe Sample - Soft UI Design (Free Sample) | AppSeed
- Host: GitHub
- URL: https://github.com/app-generator/ecommerce-django-stripe
- Owner: app-generator
- License: other
- Created: 2022-10-13T05:49:51.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-17T03:31:54.000Z (about 1 month ago)
- Last Synced: 2024-10-19T05:51:45.639Z (30 days ago)
- Topics: django-and-stripe, django-ecom, django-ecommerce, django-ecommerce-project, django-sample, django-stripe, django-stripe-sample, django-template, ecommerce, ecommerce-application, ecommerce-django, ecommerce-django-project, stripe-sample
- Language: HTML
- Homepage: https://blog.appseed.us/django-stripe-mini-ecommerce/
- Size: 9.1 MB
- Stars: 58
- Watchers: 3
- Forks: 15
- 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 eCommerce Starter](https://github.com/app-generator/rocket-ecommerce)** 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 & Stripe**.
---
> For a **complete set of features** and long-term support, check out **[Dynamic Django](https://app-generator.dev/docs/developer-tools/dynamic-django/index.html)**, a powerful starter that incorporates:
- ✅ [Dynamic DataTables](https://app-generator.dev/docs/developer-tools/dynamic-django/datatables.html): using a single line of configuration, the data saved in any table is automatically managed
- ✅ [Dynamic API](https://app-generator.dev/docs/developer-tools/dynamic-django/api.html): any model can become a secure API Endpoint using DRF
- ✅ [Dynamic Charts](https://app-generator.dev/docs/developer-tools/dynamic-django/charts.html): extract relevant charts without coding all major types are supported
- ✅ [CSV Loader](https://app-generator.dev/docs/developer-tools/dynamic-django/csv-loader.html): translate CSV files into Django Models and (optional) load the information
- ✅ Powerful [CLI Tools](https://app-generator.dev/docs/developer-tools/dynamic-django/cli.html) for the GIT interface, configuration editing, updating the configuration and database (create models, migrate DB)
## Manual Build
> 👉 **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)
## 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).