Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Order/Product approval extension for Django Oscar

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 oscar_approval
Octocat-spinner-32 .gitignore
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 README.rst
Octocat-spinner-32 requirements.txt
Octocat-spinner-32 setup.py
README.rst

Order approval for Oscar

This package provides order/product approval functionality for Oscar.

Getting started

Installation

Add 'oscar_approval' to INSTALLED_APPS and run:

./manage.py syncdb

to create the new database tables.

Oscar approval requires Oscar 0.6. For older Oscar 0.5 and 0.6, use release 0.1

Configuration

Edit your settings.py to set the following settings (example):

OSCAR_LINE_APPROVAL_STATUS = statuses.PENDING_AUTHORISATION
OSCAR_ORDER_APPROVAL_STATUS = statuses.PENDING_AUTHORISATION

Include approval urls in your application:

from oscar_approval.apps.approval.app import application as approval_application

(r'^approval/', include(approval_application.urls)),

Integration into the project

You may choose to integrate any of the following components:

  1. Product model extension:

    from oscar_approval.apps.catalogue.abstract_models import AbstractProduct as ApprovalAbstractProduct
    
        ...
    class Product(AbstractProduct, ApprovalAbstractProduct):
        ...
    
  2. Basic behaviour on receiving 'order_placed' signal:

    from oscar.apps.order.signals import order_placed
    from oscar_approval.apps.order.receivers import receive_order_placed
    
    order_placed.connect(receive_order_placed)
    

This receiver simply sets OSCAR_LINE_APPROVAL_STATUS and OSCAR_ORDER_APPROVAL_STATUS for lines and orders that require approval.

  1. Pin authorisation tab in the user profile:

    ...

  2. Dashboard application for managing reviewers and viewing approval event logs Extend user profile:

    from oscar_approval.apps.customer.abstract_models import AbstractProfile as ApproverProfile
    
    class Profile(ApproverProfile):
        ...
    

    Include dashboard application urls:

    from oscar_approval.apps.dashboard.app import application as approval_dashboard_application
    
    (r'^dashboard/approval/', include(approval_dashboard_application.urls))
    
Something went wrong with that request. Please try again.