Home
Softono
wowy

wowy

Open source MIT Jinja
GitHub
214
Stars
38
Forks
1
Issues
9
Watchers
1 year
Last Commit
E-commerce Platforms Web Development Payment & Checkout

About wowy

WOWY is a modern, full-featured e-commerce platform built with Django 4.x, designed to provide a seamless shopping experience for both customers and administrators. This comprehensive solution offers robust product management with multi-image support, real-time cart operations, and wishlist functionality, alongside a powerful admin dashboard

Platforms

Web Self-hosted

Languages

Jinja

Links

Source Code
m
Published by
manjurulhoque
Visit View Profile

README.md

View on GitHub

WOWY E-commerce Platform πŸ›οΈ

A full-featured e-commerce platform built with Django, featuring a robust admin panel and modern user interface.

WOWY is a modern, full-featured e-commerce platform built with Django 4.x, designed to provide a seamless shopping experience for both customers and administrators. This comprehensive solution offers robust product management with multi-image support, real-time cart operations, and wishlist functionality, alongside a powerful admin dashboard for detailed analytics and reporting. The platform features a clean, responsive design that works flawlessly across all devices, while incorporating essential e-commerce capabilities like PDF invoice generation, dynamic category management, and detailed sales tracking. With its focus on user experience and administrative efficiency, WOWY provides everything needed to run a successful online store, from comprehensive product catalogs to advanced customer engagement tools, all backed by a solid Django foundation.

Live: Demo

πŸ“Έ Screenshots

Home Page Home page with product listings and category navigation

Product variant Page Product variant page

Admin products page Admin products page

User dashboard User dashboard

Admin orders page Admin orders page

Admin categories page Admin categories page

🌟 Features

Product Management

  • ✨ Comprehensive product catalog
  • πŸ“Έ Multiple product images with primary image support
  • 🏷️ Category management
  • πŸ’° Price and discount management
  • πŸ“¦ Stock tracking
  • πŸ” Advanced product search and filtering

Order Management

  • πŸ›’ Shopping cart functionality
  • πŸ“‹ Order tracking and history
  • πŸ“„ PDF invoice generation
  • πŸ“Š Order status management
  • 🚚 Delivery tracking

User Management

  • πŸ‘₯ Customer accounts and profiles
  • πŸ“ User registration and authentication
  • πŸ’ Wishlist functionality
  • πŸ“ Multiple shipping address support
  • πŸ” Secure password management

Admin Dashboard

  • πŸ“Š Sales analytics and reporting
  • πŸ“ˆ Revenue tracking
  • πŸ‘₯ Customer analytics
  • πŸ“¦ Product performance metrics
  • πŸ’³ Payment method analysis

Payment Integration

  • πŸ’³ Stripe payment gateway integration
  • πŸ’Έ Secure payment processing with 3D Secure support
  • 🏦 Multiple payment methods (Credit Card, Cash on Delivery)
  • πŸ’° Automatic payment status tracking
  • πŸ” Secure key management with djstripe

Site Configuration

  • ��️ General settings management
  • πŸ“§ Email configuration
  • πŸ’° Currency settings
  • 🎨 Site appearance customization

Reporting System

  • πŸ“Š Sales reports
  • πŸ“ˆ Product performance analysis
  • πŸ‘₯ Customer insights
  • πŸ’³ Payment method analytics
  • πŸ“‰ Custom date range filtering

Product Variant System

The system supports product variants with different sizes and colors. This allows for better inventory management and more flexible product offerings.

Features

  • Variant Management

    • Add multiple variants per product
    • Support for size and color combinations
    • Individual pricing per variant
    • Separate stock tracking for each variant
    • SKU management for variants

  • Admin Interface

    • Easy variant creation and editing
    • Bulk variant management
    • Stock level monitoring
    • Price range display

  • Shopping Experience

    • Size and color selection
    • Dynamic price updates
    • Stock availability check
    • Clear variant options display
    • Cart integration with variants

Usage

  1. Creating Product Variants

    - Go to Admin > Products > View Product
- Click "Manage Variants"
- Add variants with size/color combinations
- Set price and stock for each variant

  2. Managing Stock

    - Stock is tracked per variant
- Out-of-stock variants are automatically disabled
- Low stock warnings in admin panel

  3. Shopping Cart

    - Variants are added to cart separately
- Price is determined by selected variant
- Stock check during checkout

API Endpoints

  • GET /products/api/variant/

    • Get variant details by product_id, size, and color
    • Returns price, stock, and variant ID

  • POST /cart/api/add/

    • Add variant to cart
    • Requires product_id, variant_id, and quantity

Technical Details

  • Variant model includes:

    • Size (optional)
    • Color (optional)
    • SKU
    • Price
    • Stock level
    • Product reference

  • Frontend uses:

    • Dynamic variant selection
    • Real-time price updates
    • Stock availability checks
    • Cart integration

πŸ› οΈ Tech Stack

Backend

  • Python 3.x
  • Django 4.x
  • Django REST Framework
  • PostgreSQL/Sqlite

Frontend

  • HTML5
  • CSS3
  • JavaScript
  • jQuery
  • Bootstrap

Tools & Libraries

  • ReportLab (PDF generation)
  • Pillow (Image processing)
  • Django Crispy Forms
  • Django Debug Toolbar

Payment Gateways

  • Stripe
  • PayPal // not added yet

Development Tools

  • Git
  • VS Code
  • Black (Code formatting)
  • Flake8 (Code linting)

πŸ“¦ Installation

  1. Clone the repository

    git clone https://github.com/manjurulhoque/wowy.git wowy
cd wowy

  2. Create and activate virtual environment

    python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

  3. Install dependencies

    pip install -r requirements.txt

  4. Configure environment variables

    cp .env.example .env
# Edit .env with your settings:
# DATABASE_URL=postgresql://user:password@localhost:5432/dbname
# SECRET_KEY=your-secret-key
# DEBUG=True

  5. Run migrations

    python manage.py makemigrations
python manage.py migrate

  6. Create superuser

    python manage.py createsuperuser

  7. Run development server

    python manage.py runserver

Visit http://localhost:8000/admin to access the admin panel.

πŸ”§ Configuration

Environment Variables

  • DEBUG: Set to False in production
  • SECRET_KEY: Django secret key
  • DATABASE_URL: Database connection string
  • ALLOWED_HOSTS: Comma-separated list of allowed hosts
  • STRIPE_PUBLIC_KEY: Stripe public key
  • STRIPE_SECRET_KEY: Stripe secret key

Email Settings

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'your-smtp-server'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = '[email protected]'
EMAIL_HOST_PASSWORD = 'your-password'

πŸš€ Deployment

Production Deployment

  1. Set DEBUG=False in .env
  2. Configure your web server (Nginx/Apache)
  3. Set up SSL certificate
  4. Configure static files serving
  5. Set up database backup

πŸ’» Development

Code Style

We use Black for code formatting and Flake8 for linting:

black .
flake8

Running Tests

python manage.py test

Making Migrations

python manage.py makemigrations
python manage.py migrate

πŸ“ Documentation

API Documentation

API documentation is available at /api/docs/ when running in debug mode.

Model Documentation

  • Product: Product management
  • Order: Order processing
  • User: User management
  • Category: Product categorization
  • Cart: Shopping cart functionality
  • Wishlist: User wishlist management

🀝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘₯ Authors

πŸ™ Acknowledgments

  • Icons by Unicons
  • Admin template inspiration from AdminLTE
  • Django community
  • All contributors who have helped this project

πŸ“ž Support

For support, email [email protected]

πŸ”„ Project Status

Project is: in development

πŸ—ΊοΈ Roadmap

  • [ ] Mobile app integration
  • [ ] Advanced analytics dashboard
  • [ ] Multi-language support
  • [ ] Marketplace functionality
  • [ ] Advanced SEO features

πŸš€ Setup Instructions

Basic Setup

  1. Clone the repository

    git clone https://github.com/manjurulhoque/wowy.git gambo
cd gambo

  2. Create and activate virtual environment

    python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

  3. Install dependencies

    pip install -r requirements.txt

  4. Configure environment variables

    cp .env.example .env
# Edit .env with your settings:
# DATABASE_URL=postgresql://user:password@localhost:5432/dbname
# SECRET_KEY=your-secret-key
# DEBUG=True

  5. Run migrations

    python manage.py makemigrations
python manage.py migrate

  6. Create superuser

    python manage.py createsuperuser

  7. Run development server

    python manage.py runserver

Visit http://localhost:8000/admin to access the admin panel.

Stripe Integration Setup

  1. Install required packages:

    pip install stripe djstripe

  2. Add to INSTALLED_APPS:

    INSTALLED_APPS = [
 ...
 'djstripe',
]

  3. Configure Stripe in Django Admin:

  • Access Django Admin
  • Go to DJ Stripe > API Keys
  • Add two API keys:
    • Type: Secret (from Stripe Dashboard)
    • Type: Publishable (from Stripe Dashboard)

  1. Stripe Configuration in Settings:

    STRIPE_LIVE_MODE = False  # Change to True in production
DJSTRIPE_WEBHOOK_SECRET = "whsec_xxx"  # Get from Stripe Dashboard
DJSTRIPE_FOREIGN_KEY_TO_FIELD = "id"

  2. Webhook Setup (Production):

  • Create webhook endpoint in Stripe Dashboard
  • Point to: https://yourdomain.com/webhook/stripe/
  • Add webhook secret to DJSTRIPE_WEBHOOK_SECRET

Payment Flow

  1. Customer selects items and proceeds to checkout
  2. Chooses payment method (Stripe or Cash on Delivery)
  3. For Stripe:
    • Card details collected securely
    • Payment intent created
    • Order created upon successful payment
  4. Order confirmation and invoice generation

Deployment

Using Docker to deploy

⌨️ with ❀️ by Manjurul Hoque Rumi