django-easycart-ng

A simple and flexible shopping cart for Django projects.

django-easycart-ng is a lightweight, reusable shopping cart app for Django. It provides essential cart functionality with a clean API, making it easy to integrate into any Django project.

✨ Features

• Simple Cart Management: Add, remove, and update items with ease.
• Generic Product Support: Works with any product model using a generic product_id field.
• Wishlist: Allow users to save products for later.
• Session Support: (Coming soon) Support for anonymous users via sessions.
• Admin Integration: Full admin interface for managing carts and wishlists.
• Template Tags: Easy access to cart data in templates.
• Lightweight: Minimal dependencies (only Django).
• Extensible: Easy to customize and extend.

📦 Installation

1. Install the package:

pip install django-easycart-ng

2. Add cart to your INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    "cart.apps.CartConfig",
    # ...
]

3. Run migrations:

python manage.py migrate

4. Add the context processor (optional but recommended):

TEMPLATES = [
    {
        # ...
        "OPTIONS": {
            "context_processors": [
                # ...
                "cart.context_processors.cart_total",
            ],
        },
    },
]

🚀 Quick Start

Add an item to the cart:

from cart.models import Cart

# Get or create the user's cart
cart, _ = Cart.objects.get_or_create(user=request.user)

# Add an item
cart.add_item(
    product_id=1,
    quantity=2,
    price=99.99,
    size="Large",  # Extra data
)

Get cart total:

total_price = cart.get_total_price()
total_items = cart.get_total_items()

Use template tags:

{% load cart_tags %}

<p>Total items: {% get_cart_total_items %}</p>
<p>Total price: ${% get_cart_total_price %}</p>

{% if request.user.is_authenticated %}
    <a href="{% url 'cart_detail' %}">View Cart</a>
{% endif %}

📚 API Reference

Cart Model

Wishlist Model

🛠️ Development Setup

To contribute to this package, follow these steps:

1. Clone the repository:

git clone https://github.com/reza-khalili-dev/django-easycart-ng.git
cd django-easycart-ng

2. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install development dependencies:

pip install -e .[dev]

4. Run tests:

pytest

📄 License

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

⭐ Show Your Support

If you find this package useful, please give it a ⭐ on GitHub!

📧 Contact

• Author: Reza Khalili
• Email: arsalankhalili688@gmail.com
• Linkedin www.linkedin.com/in/reza-khalili-developer
• GitHub: https://github.com/reza-khalili-dev