Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django generic basket application. Allow to put in basket any object and view orders in the Django admin interface

Project Description


  1. Add basket to INSTALLED_APPS

  2. Add basket.middleware.BasketMiddleware to MIDDLEWARE_CLASSES

  3. Add basket to urlpatterns in your

    urlpatterns += patterns('', (r'^basket/', include('basket.urls')))
  4. Sync your database:

    ./ syncdb
  5. Collect static files:

    ./ collectstatic


Load basket tags:

{% load basket_tags %}

Add panel with summary information to template (probably, you want to include this panel in every page):

{% include 'basket/panel.html' %}

In order to basket javascript works, you have to add jQuery and basket.js to all pages with order buttons:

<script type="text/javascript" src=""></script>
<script type="text/javascript" src="{{ STATIC_URL }}basket/js/basket.js"></script>

Finally, at the item page

{% add_basket_button object 'button_text' 'added_text' 'already_in_text' 'template_name' %}

Where object is avaiable to order, 'button_text' is the text printed on the add button, 'added_text' is the text that appears near the add button, and 'already_in_text' is the text placed above the add button when page loaded. Unrequired 'template_name' is the path to rendered template.

Available settings


Default: price

All objects in basket should have this attribute for price calculations. Otherwise price will be 0.0


Default: basket.forms.DefaultOrderForm

This form class used for order confirmation. By default it has required fields: customer name, customer phone, delivery address, convenient time to call and optional textarea for comment. All information stored in order comment in admin interface.


Default: True

If set to True, user will see checkboxes near all items at basket page. If checkbox is unchecked, item will be deleted from basket.


Default: False

If set to True, user will see delete icons near all items at basket page. When user click on icon, item will be deleted from basket by AJAX request and basket page will be automatically updated.


Default: basket.settings.DEFAULT_ORDER_STATUSES

An iterable (e.g., a list or tuple) of 2-tuples to use as choices for Order’s status field.


Default: ‘New order from site’

Subject for message emailed to managers after an order confirmed.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-basket-0.4.5.tar.gz (44.6 kB) Copy SHA256 Checksum SHA256 Source Jul 4, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting