Similar to the ProductApplication, CustomerApplication ties all of the customer views and URLs into a single class which can be extended. We get some lovely URL namespacing for free.

oscar/apps/customer/__init__.py

@@ -0,0 +1,34 @@
+from django.conf.urls.defaults import patterns, url, include
+from django.contrib.auth.decorators import login_required
+from oscar.apps.customer.views import AccountSummaryView, OrderHistoryView, \
+    OrderHistoryView, OrderDetailView, OrderLineView, AddressListView, AddressUpdateView, AddressDeleteView
+from oscar.core.application import Application
+
+class CustomerApplication(Application):
+    name = 'customer'
+    summary_view = AccountSummaryView
+    order_history_view = OrderHistoryView
+    order_detail_view = OrderDetailView
+    order_line_view = OrderLineView
+    address_list_view = AddressListView
+    address_update_view = AddressUpdateView
+    address_delete_view = AddressDeleteView 
+
+    def get_urls(self):
+        urlpatterns = patterns('django.contrib.auth.views',
+            url(r'^login/$', 'login', {'template_name': 'admin/login.html'}, name='login'),
+            url(r'^logout/$', 'login', name='logout'),
+        )
+        
+        urlpatterns += patterns('',
+            url(r'^$', login_required(self.summary_view.as_view()), name='summary'),
+            url(r'^orders/$', login_required(self.order_history_view.as_view()), name='order-list'),
+            url(r'^orders/(?P<order_number>[\w-]*)/$', login_required(self.order_detail_view.as_view()), name='order'),
+            url(r'^orders/(?P<order_number>[\w-]*)/(?P<line_id>\w+)$', login_required(self.order_line_view), name='order-line'),
+            url(r'^addresses/$', login_required(self.address_list_view.as_view()), name='address-list'),
+            url(r'^addresses/(?P<pk>\d+)/$', login_required(self.address_update_view.as_view()), name='address'),
+            url(r'^addresses/(?P<pk>\d+)/delete/$', login_required(self.address_delete_view.as_view()), name='address-delete'),            
+        )
+        return urlpatterns
+
+application = CustomerApplication()

oscar/apps/customer/urls.py

@@ -1,21 +0,0 @@
-from django.conf.urls.defaults import *
-from django.contrib.auth.decorators import login_required
-
-from oscar.core.decorators import class_based_view
-from oscar.core.loading import import_module
-import_module('customer.views', ['OrderHistoryView', 'OrderDetailView', 'OrderLineView',
-                                 'AddressBookView', 'AddressView'], locals())
-
-urlpatterns = patterns('django.contrib.auth.views',
-    url(r'^login/$', 'login', {'template_name': 'admin/login.html'}, name='oscar-customer-login'),
-    url(r'^logout/$', 'login', name='oscar-customer-logout'),
-)
-
-urlpatterns += patterns('oscar.apps.customer.views',
-    url(r'^profile/$', 'profile', name='oscar-customer-profile'),
-    url(r'^order-history/$', OrderHistoryView.as_view(), name='oscar-customer-order-history'),
-    url(r'^order/(?P<order_number>[\w-]*)/$', login_required(class_based_view(OrderDetailView)), name='oscar-customer-order-view'),
-    url(r'^order/(?P<order_number>[\w-]*)/line/(?P<line_id>\w+)$', login_required(class_based_view(OrderLineView)), name='oscar-customer-order-line'),
-    url(r'^address-book/$', AddressBookView.as_view(), name='oscar-customer-address-book'),
-    url(r'^address/(?P<address_id>\d+)/$', login_required(class_based_view(AddressView)), name='oscar-customer-address'),
-)

oscar/apps/customer/views.py

@@ -1,6 +1,6 @@
 from django.shortcuts import get_object_or_404
 from django.contrib.auth.decorators import login_required
-from django.views.generic import ListView
+from django.views.generic import ListView, DetailView, UpdateView, DeleteView
 from django.core.urlresolvers import reverse
 from django.http import HttpResponseRedirect
 from django.contrib import messages
@@ -10,55 +10,72 @@ from django.template.response import TemplateResponse
 from oscar.apps.address.forms import UserAddressForm
 from oscar.view.generic import ModelView
 from oscar.core.loading import import_module
-import_module('address.models', ['UserAddress'], locals())
-import_module('order.models', ['Order', 'Line'], locals())
-import_module('basket.models', ['Basket'], locals())
+
 import_module('basket.factory', ['BasketFactory'], locals())
 
-@login_required
-def profile(request):
-    u"""Return a customers's profile"""
-    # Load last 5 orders as preview
-    orders = Order._default_manager.filter(user=request.user)[0:5]
-    return TemplateResponse(request, 'oscar/customer/profile.html', {'orders': orders})
-    
-        
+from django.db.models import get_model
+
+order_model = get_model('order', 'Order')
+order_line_model = get_model('order', 'Line')
+basket_model = get_model('basket', 'Basket')
+user_address_model = get_model('address', 'UserAddress')
+
+
+class AccountSummaryView(ListView):
+    u"""Customer order history"""
+    context_object_name = "orders"
+    template_name = 'oscar/customer/profile.html'
+    paginate_by = 20
+    model = order_model
+
+    def get_queryset(self):
+        u"""Return a customer's orders"""
+        return self.model._default_manager.filter(user=self.request.user)[0:5]
+
+
 class OrderHistoryView(ListView):
     u"""Customer order history"""
     context_object_name = "orders"
     template_name = 'oscar/customer/order-history.html'
     paginate_by = 20
+    model = order_model
 
     def get_queryset(self):
         u"""Return a customer's orders"""
-        return Order._default_manager.filter(user=self.request.user)
+        return self.model._default_manager.filter(user=self.request.user)
 
 
-class OrderDetailView(ModelView):
+class OrderDetailView(DetailView):
     u"""Customer order details"""
-    template_file = "oscar/customer/order.html"
     
-    def get_model(self):
-        u"""Return an order object or 404"""
-        return get_object_or_404(Order, user=self.request.user, number=self.kwargs['order_number'])
+    model = order_model
     
-    def handle_GET(self, order):
-        self.response = TemplateResponse(self.request, self.template_file, {'order': order})
-        
+    def get_template_names(self):
+        return ["oscar/customer/order.html"]    
+    
+    def get_queryset(self):
+        return self.model._default_manager.filter(user=self.request.user)
+    
+    def get_object(self):
+        try:
+            return self.get_queryset().get(number=self.kwargs['order_number'])
+        except self.model.DoesNotExist:
+            raise Http404()
+
         
 class OrderLineView(ModelView):
     u"""Customer order line"""
     
     def get_model(self):
         u"""Return an order object or 404"""
-        order = get_object_or_404(Order, user=self.request.user, number=self.kwargs['order_number'])
+        order = get_object_or_404(order_model, user=self.request.user, number=self.kwargs['order_number'])
         return order.lines.get(id=self.kwargs['line_id'])
     
     def handle_GET(self, line):
-        return HttpResponseRedirect(reverse('oscar-customer-order-view', kwargs={'order_number': line.order.number}))
+        return HttpResponseRedirect(reverse('customer:order', kwargs={'order_number': line.order.number}))
     
     def handle_POST(self, line):
-        self.response = HttpResponseRedirect(reverse('oscar-customer-order-view', kwargs={'order_number': line.order.number}))
+        self.response = HttpResponseRedirect(reverse('customer:order', kwargs={'order_number': line.order.number}))
         super(OrderLineView, self).handle_POST(line)
     
     def do_reorder(self, line):
@@ -69,7 +86,7 @@ class OrderLineView(ModelView):
         # We need to pass response to the get_or_create... method
         # as a new basket might need to be created
         self.response = HttpResponseRedirect(reverse('oscar-basket'))
-        basket = basket_factory.BasketFactory().get_or_create_open_basket(self.request, self.response)
+        basket = BasketFactory().get_or_create_open_basket(self.request, self.response)
         
         # Convert line attributes into basket options
         options = []
@@ -79,9 +96,8 @@ class OrderLineView(ModelView):
         basket.add_product(line.product, 1, options)
         messages.info(self.request, "Line reordered")
         
-        
 
-class AddressBookView(ListView):
+class AddressListView(ListView):
     u"""Customer address book"""
     context_object_name = "addresses"
     template_name = 'oscar/customer/address-book.html'
@@ -89,32 +105,28 @@ class AddressBookView(ListView):
         
     def get_queryset(self):
         u"""Return a customer's addresses"""
-        return UserAddress._default_manager.filter(user=self.request.user)
+        return user_address_model._default_manager.filter(user=self.request.user)
+
+
+class AddressUpdateView(UpdateView):
+    form_class = UserAddressForm
+    model = user_address_model
     
+    def get_template_names(self):
+        return ["oscar/customer/address-form.html"]       
     
-class AddressView(ModelView):
-    u"""Customer address view"""
-    template_file = "oscar/customer/address-form.html"
+    def get_form_class(self):
+        return self.form_class
     
-    def get_model(self):
-        u"""Return an address object or a 404"""
-        return get_object_or_404(UserAddress, user=self.request.user, pk=self.kwargs['address_id'])
+    def get_success_url(self):
+        return reverse('customer:address', kwargs={'pk': self.get_object().pk })
+
+
+class AddressDeleteView(DeleteView):
+    model = user_address_model
     
-    def handle_GET(self, address):
-        form = UserAddressForm(instance=address)
-        self.response = TemplateResponse(self.request, self.template_file, {'form': form})
-        
-    def do_save(self, address):
-        u"""Save an address"""
-        form = UserAddressForm(self.request.POST, instance=address)
-        if form.is_valid():
-            a = form.save()
-            self.response = HttpResponseRedirect(reverse('oscar-customer-address-book'))
-        else:
-            self.response = TemplateResponse(self.request, self.template_file, {'form': form})
-            
-    def do_delete(self, address):
-        u"""Delete an address"""
-        address.delete()
-        self.response = HttpResponseRedirect(reverse('oscar-customer-address-book'))
-            
+    def get_success_url(self):
+        return reverse('customer:address-list')    
+    
+    def get_template_names(self):
+        return ["oscar/customer/address-delete.html"]

oscar/templates/layout.html

@@ -14,7 +14,7 @@
             </form>
             
             {% if user.is_authenticated %}
-                <a href="{% url oscar-customer-profile %}">Profile</a>
+                <a href="{% url customer:summary %}">Profile</a>
                 <a href="">Logout</a>
             {% else %}
                 <a href="">Login</a>

oscar/templates/oscar/checkout/gateway.html

@@ -9,7 +9,7 @@
 
 <dl>
     <dt>
-        <a href="">Register</a> or <a href="{% url oscar-customer-login %}">log-in</a>
+        <a href="">Register</a> or <a href="{% url customer:login %}">log-in</a>
     </dt>
     <dl>
         <p>Logging in now will give you access to your address book and ensure your
@@ -22,7 +22,7 @@
         <p>You can checkout without signing in or registering.  You will be given the opportunity to 
            register when checkout is complete.</p>
     </dl>
-</ol>
+</dl>
 
 {% endblock content %}
 

oscar/templates/oscar/customer/address-book.html

@@ -14,12 +14,8 @@
     {% for address in addresses %}
     <li>
         {{ address.summary }}
-        <a href="{% url oscar-customer-address address.id %}">Edit</a> | 
-        <form action="{% url oscar-customer-address address.id %}" method="post">
-            {% csrf_token %}
-            <input type="hidden" name="action" value="delete" />
-            <input type="submit" value="Delete" />
-        </form>
+        <a href="{% url customer:address address.id %}">Edit</a> | 
+		<a href="{% url customer:address-delete address.id %}">Delete</a>
     </li>
     {% endfor %}
 </ul>

oscar/templates/oscar/customer/address-delete.html

@@ -0,0 +1,20 @@
+{% extends "layout.html" %}
+
+{% load currency_filters %}
+
+{% block header %}
+<h2>Address book</h2>
+{% endblock header %}
+
+
+{% block content %}
+
+<h3>Confirm address deletion</h3>
+<form action="." method="post">
+    {% csrf_token %}
+    {{ form.as_p }}
+    <input type="submit" value="Delete address" />
+</form>
+
+{% endblock content %}
+

oscar/templates/oscar/customer/address-form.html

@@ -10,9 +10,8 @@
 {% block content %}
 
 <h3>Edit address</h3>
-<form action="{% url oscar-customer-address address.id %}" method="post">
+<form action="." method="post">
     {% csrf_token %}
-    <input type="hidden" name="action" value="save" />
     {{ form.as_p }}
     <input type="submit" value="Save address" />
 </form>

oscar/templates/oscar/customer/order-history.html

@@ -24,7 +24,7 @@
         <td>{{ order.total_incl_tax|currency }}</td>
         <td>{{ order.date_placed }}</td>
         <td>
-            <a href="{% url oscar-customer-order-view order.number %}">View order details</a>
+            <a href="{% url customer:order order.number %}">View order details</a>
         </td>
     </tr>
     {% endfor %}

oscar/templates/oscar/customer/order.html

@@ -58,7 +58,7 @@
         <td>{{ line.line_price_before_discounts_incl_tax|currency }}</td>
         <td>{{ line.shipping_status }}</td>
         <td>
-            <form action="{% url oscar-customer-order-line order.number line.id %}" method="POST">
+            <form action="{% url customer:order-line order.number line.id %}" method="POST">
                 {% csrf_token %}
                 <input type="hidden" name="action" value="reorder" />
                 <input type="submit" value="Re-order" />

oscar/templates/oscar/customer/profile.html

@@ -24,12 +24,12 @@
         <td>{{ order.total_incl_tax|currency }}</td>
         <td>{{ order.date_placed }}</td>
         <td>
-            <a href="{% url oscar-customer-order-view order.number %}">View</a>
+            <a href="{% url customer:order order.number %}">View</a>
         </td>
     </tr>
     {% endfor %}
 </table>
-<p><a href="{% url oscar-customer-order-history %}">View order history</a></p>
+<p><a href="{% url customer:order-list %}">View order history</a></p>
 
 
 
@@ -37,7 +37,7 @@
 
 <h3>Account settings</h3>
 <ul>
-    <li><a href="{% url oscar-customer-address-book %}">Manage address book</a></li>
+    <li><a href="{% url customer:address-list %}">Manage address book</a></li>
     <li><a href="">Change password</a></li>
 </ul>
 

oscar/urls.py

@@ -2,13 +2,14 @@ from django.conf.urls.defaults import *
 from django.conf import settings
 
 from oscar.apps.product import application as products_app
+from oscar.apps.customer import application as customer_app
 
 urlpatterns = patterns('',
     (r'products/', include(products_app.urls)),
     (r'basket/', include('oscar.apps.basket.urls')),
     (r'checkout/', include('oscar.apps.checkout.urls')),
     (r'order-management/', include('oscar.apps.order_management.urls')),
-    (r'accounts/', include('oscar.apps.customer.urls')),
+    (r'accounts/', include(customer_app.urls)),
     (r'promotions/', include('oscar.apps.promotions.urls')),
     (r'reports/', include('oscar.apps.reports.urls')),
     (r'search/', include('oscar.apps.search.urls')),