You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

views.py 24KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595
  1. import datetime
  2. from decimal import Decimal as D, InvalidOperation
  3. from django.contrib import messages
  4. from django.utils.translation import ugettext_lazy as _
  5. from django.core.urlresolvers import reverse
  6. from django.core.exceptions import ObjectDoesNotExist
  7. from django.db.models.loading import get_model
  8. from django.db.models import fields, Q, Sum, Count
  9. from django.http import HttpResponse, HttpResponseRedirect, Http404
  10. from django.shortcuts import get_object_or_404
  11. from django.template.defaultfilters import date as format_date
  12. from django.utils.datastructures import SortedDict
  13. from django.views.generic import ListView, DetailView, UpdateView, FormView
  14. from django.conf import settings
  15. from oscar.core.loading import get_class
  16. from oscar.apps.dashboard.orders import forms
  17. from oscar.views.generic import BulkEditMixin
  18. from oscar.apps.dashboard.reports.csv_utils import CsvUnicodeWriter
  19. from oscar.apps.payment.exceptions import PaymentError
  20. from oscar.apps.order.exceptions import InvalidShippingEvent, InvalidStatus
  21. Order = get_model('order', 'Order')
  22. OrderNote = get_model('order', 'OrderNote')
  23. ShippingAddress = get_model('order', 'ShippingAddress')
  24. Line = get_model('order', 'Line')
  25. ShippingEventType = get_model('order', 'ShippingEventType')
  26. PaymentEventType = get_model('order', 'PaymentEventType')
  27. EventHandler = get_class('order.processing', 'EventHandler')
  28. class OrderStatsView(FormView):
  29. template_name = 'dashboard/orders/statistics.html'
  30. form_class = forms.OrderStatsForm
  31. def get(self, request, *args, **kwargs):
  32. return self.post(request, *args, **kwargs)
  33. def form_valid(self, form):
  34. ctx = self.get_context_data(form=form,
  35. filters=form.get_filters())
  36. return self.render_to_response(ctx)
  37. def get_form_kwargs(self):
  38. kwargs = super(OrderStatsView, self).get_form_kwargs()
  39. kwargs['data'] = self.request.GET
  40. return kwargs
  41. def get_context_data(self, **kwargs):
  42. ctx = super(OrderStatsView, self).get_context_data(**kwargs)
  43. filters = kwargs.get('filters', {})
  44. ctx.update(self.get_stats(filters))
  45. ctx['title'] = kwargs['form'].get_filter_description()
  46. return ctx
  47. def get_stats(self, filters):
  48. orders = Order.objects.filter(**filters)
  49. stats = {
  50. 'total_orders': orders.count(),
  51. 'total_lines': Line.objects.filter(order__in=orders).count(),
  52. 'total_revenue': orders.aggregate(
  53. Sum('total_incl_tax'))['total_incl_tax__sum'] or D('0.00'),
  54. 'order_status_breakdown': orders.order_by('status').values(
  55. 'status').annotate(freq=Count('id'))
  56. }
  57. return stats
  58. class OrderListView(ListView, BulkEditMixin):
  59. model = Order
  60. context_object_name = 'orders'
  61. template_name = 'dashboard/orders/order_list.html'
  62. form_class = forms.OrderSearchForm
  63. desc_template = _("%(main_filter)s %(name_filter)s %(title_filter)s"
  64. "%(upc_filter)s %(sku_filter)s %(date_filter)s"
  65. "%(voucher_filter)s %(payment_filter)s %(status_filter)s")
  66. paginate_by = 25
  67. description = ''
  68. actions = ('download_selected_orders',)
  69. current_view = 'dashboard:order-list'
  70. def get(self, request, *args, **kwargs):
  71. if 'order_number' in request.GET and request.GET.get('response_format', 'html') == 'html':
  72. try:
  73. order = Order.objects.get(number=request.GET['order_number'])
  74. except Order.DoesNotExist:
  75. pass
  76. else:
  77. return HttpResponseRedirect(reverse('dashboard:order-detail', kwargs={'number': order.number}))
  78. return super(OrderListView, self).get(request, *args, **kwargs)
  79. def get_desc_context(self, data=None):
  80. """Update the title that describes the queryset"""
  81. desc_ctx = {
  82. 'main_filter': _('All orders'),
  83. 'name_filter': '',
  84. 'title_filter': '',
  85. 'upc_filter': '',
  86. 'sku_filter': '',
  87. 'date_filter': '',
  88. 'voucher_filter': '',
  89. 'payment_filter': '',
  90. 'status_filter': '',
  91. }
  92. if 'order_status' in self.request.GET:
  93. status = self.request.GET['order_status']
  94. if status.lower() == 'none':
  95. desc_ctx['main_filter'] = _("Orders without an order status")
  96. else:
  97. desc_ctx['main_filter'] = _("Orders with status '%s'") % status
  98. if data is None:
  99. return desc_ctx
  100. if data['order_number']:
  101. desc_ctx['main_filter'] = _('Orders with number starting with "%s"') % data['order_number']
  102. if data['name']:
  103. desc_ctx['name_filter'] = _(" with customer name matching '%s'") % data['name']
  104. if data['product_title']:
  105. desc_ctx['title_filter'] = _(" including an item with title matching '%s'") % data['product_title']
  106. if data['upc']:
  107. desc_ctx['upc_filter'] = _(" including an item with UPC '%s'") % data['upc']
  108. if data['partner_sku']:
  109. desc_ctx['upc_filter'] = _(" including an item with ID '%s'") % data['partner_sku']
  110. if data['date_from'] and data['date_to']:
  111. desc_ctx['date_filter'] = _(" placed between %(start_date)s and %(end_date)s") % {
  112. 'start_date': format_date(data['date_from']),
  113. 'end_date': format_date(data['date_to'])}
  114. elif data['date_from']:
  115. desc_ctx['date_filter'] = _(" placed since %s") % format_date(data['date_from'])
  116. elif data['date_to']:
  117. date_to = data['date_to'] + datetime.timedelta(days=1)
  118. desc_ctx['date_filter'] = _(" placed before %s") % format_date(data['date_to'])
  119. if data['voucher']:
  120. desc_ctx['voucher_filter'] = _(" using voucher '%s'") % data['voucher']
  121. if data['payment_method']:
  122. desc_ctx['payment_filter'] = _(" paid for by %s") % data['payment_method']
  123. if data['status']:
  124. desc_ctx['status_filter'] = _(" with status %s") % data['status']
  125. return desc_ctx
  126. def get_queryset(self):
  127. """
  128. Build the queryset for this list.
  129. """
  130. queryset = self.model.objects.all().order_by('-date_placed')
  131. queryset = self.sort_queryset(queryset)
  132. # Look for shortcut query filters
  133. if 'order_status' in self.request.GET:
  134. self.form = self.form_class()
  135. status = self.request.GET['order_status']
  136. if status.lower() == 'none':
  137. status = None
  138. self.description = self.desc_template % self.get_desc_context()
  139. return self.model.objects.filter(status=status)
  140. if 'order_number' not in self.request.GET:
  141. self.description = self.desc_template % self.get_desc_context()
  142. self.form = self.form_class()
  143. return queryset
  144. self.form = self.form_class(self.request.GET)
  145. if not self.form.is_valid():
  146. return queryset
  147. data = self.form.cleaned_data
  148. if data['order_number']:
  149. queryset = self.model.objects.filter(number__istartswith=data['order_number'])
  150. if data['name']:
  151. # If the value is two words, then assume they are first name and last name
  152. parts = data['name'].split()
  153. allow_anon = getattr(settings, 'OSCAR_ALLOW_ANON_CHECKOUT', False)
  154. if len(parts) == 1:
  155. parts = [data['name'], data['name']]
  156. else:
  157. parts = [parts[0], parts[1:]]
  158. filter = Q(user__first_name__istartswith=parts[0]) |\
  159. Q(user__last_name__istartswith=parts[1])
  160. if allow_anon:
  161. filter |= Q(billing_address__first_name__istartswith=parts[0]) |\
  162. Q(shipping_address__first_name__istartswith=parts[0]) |\
  163. Q(billing_address__last_name__istartswith=parts[1]) |\
  164. Q(shipping_address__last_name__istartswith=parts[1])
  165. queryset = queryset.filter(filter).distinct()
  166. if data['product_title']:
  167. queryset = queryset.filter(lines__title__istartswith=data['product_title']).distinct()
  168. if data['upc']:
  169. queryset = queryset.filter(lines__upc=data['upc'])
  170. if data['partner_sku']:
  171. queryset = queryset.filter(lines__partner_sku=data['partner_sku'])
  172. if data['date_from'] and data['date_to']:
  173. # Add 24 hours to make search inclusive
  174. date_to = data['date_to'] + datetime.timedelta(days=1)
  175. queryset = queryset.filter(date_placed__gte=data['date_from']).filter(date_placed__lt=date_to)
  176. elif data['date_from']:
  177. queryset = queryset.filter(date_placed__gte=data['date_from'])
  178. elif data['date_to']:
  179. date_to = data['date_to'] + datetime.timedelta(days=1)
  180. queryset = queryset.filter(date_placed__lt=date_to)
  181. if data['voucher']:
  182. queryset = queryset.filter(discounts__voucher_code=data['voucher']).distinct()
  183. if data['payment_method']:
  184. queryset = queryset.filter(sources__source_type__code=data['payment_method']).distinct()
  185. if data['status']:
  186. queryset = queryset.filter(status=data['status'])
  187. self.description = self.desc_template % self.get_desc_context(data)
  188. return queryset
  189. def sort_queryset(self, queryset):
  190. sort = self.request.GET.get('sort', None)
  191. allowed_sorts = ['number',]
  192. if sort in allowed_sorts:
  193. direction = self.request.GET.get('dir', 'desc')
  194. sort = ('-' if direction == 'desc' else '') + sort
  195. queryset = queryset.order_by(sort)
  196. return queryset
  197. def get_context_data(self, **kwargs):
  198. ctx = super(OrderListView, self).get_context_data(**kwargs)
  199. ctx['queryset_description'] = self.description
  200. ctx['form'] = self.form
  201. return ctx
  202. def is_csv_download(self):
  203. return self.request.GET.get('response_format', None) == 'csv'
  204. def get_paginate_by(self, queryset):
  205. return None if self.is_csv_download() else self.paginate_by
  206. def render_to_response(self, context, **response_kwargs):
  207. if self.is_csv_download():
  208. return self.download_selected_orders(
  209. self.request,
  210. context['object_list'])
  211. return super(OrderListView, self).render_to_response(
  212. context, **response_kwargs)
  213. def get_download_filename(self, request):
  214. return 'orders.csv'
  215. def download_selected_orders(self, request, orders):
  216. response = HttpResponse(mimetype='text/csv')
  217. response['Content-Disposition'] = 'attachment; filename=%s' % self.get_download_filename(request)
  218. writer = CsvUnicodeWriter(response, delimiter=',')
  219. meta_data = (('number', _('Order number')),
  220. ('value', _('Order value')),
  221. ('date', _('Date of purchase')),
  222. ('num_items', _('Number of items')),
  223. ('status', _('Order status')),
  224. ('customer', _('Customer email address')),
  225. ('shipping_address_name', _('Deliver to name')),
  226. ('billing_address_name', _('Bill to name')),
  227. )
  228. columns = SortedDict()
  229. for k, v in meta_data:
  230. columns[k] = v
  231. writer.writerow(columns.values())
  232. for order in orders:
  233. row = columns.copy()
  234. row['number'] = order.number
  235. row['value'] = order.total_incl_tax
  236. row['date'] = format_date(order.date_placed, 'DATETIME_FORMAT')
  237. row['num_items'] = order.num_items
  238. row['status'] = order.status
  239. row['customer'] = order.email
  240. if order.shipping_address:
  241. row['shipping_address_name'] = order.shipping_address.name()
  242. else:
  243. row['shipping_address_name'] = ''
  244. if order.billing_address:
  245. row['billing_address_name'] = order.billing_address.name()
  246. else:
  247. row['billing_address_name'] = ''
  248. encoded_values = [unicode(value).encode('utf8') for value in row.values()]
  249. writer.writerow(encoded_values)
  250. return response
  251. class OrderDetailView(DetailView):
  252. model = Order
  253. context_object_name = 'order'
  254. template_name = 'dashboard/orders/order_detail.html'
  255. order_actions = ('save_note', 'delete_note', 'change_order_status',
  256. 'create_order_payment_event')
  257. line_actions = ('change_line_statuses', 'create_shipping_event',
  258. 'create_payment_event')
  259. def get_object(self, queryset=None):
  260. return get_object_or_404(self.model, number=self.kwargs['number'])
  261. def get_context_data(self, **kwargs):
  262. ctx = super(OrderDetailView, self).get_context_data(**kwargs)
  263. ctx['active_tab'] = kwargs.get('active_tab', 'lines')
  264. ctx['note_form'] = self.get_order_note_form()
  265. ctx['line_statuses'] = Line.all_statuses()
  266. ctx['shipping_event_types'] = ShippingEventType.objects.all()
  267. ctx['payment_event_types'] = PaymentEventType.objects.all()
  268. return ctx
  269. def get_order_note_form(self):
  270. post_data = None
  271. kwargs = {}
  272. if self.request.method == 'POST':
  273. post_data = self.request.POST
  274. note_id = self.kwargs.get('note_id', None)
  275. if note_id:
  276. note = get_object_or_404(OrderNote, order=self.object, id=note_id)
  277. if note.is_editable():
  278. kwargs['instance'] = note
  279. return forms.OrderNoteForm(post_data, **kwargs)
  280. def post(self, request, *args, **kwargs):
  281. self.object = self.get_object()
  282. order = self.object
  283. # Look for order-level action
  284. order_action = request.POST.get('order_action', '').lower()
  285. if order_action:
  286. if order_action not in self.order_actions:
  287. messages.error(self.request, _("Invalid action"))
  288. return self.reload_page_response()
  289. else:
  290. return getattr(self, order_action)(request, order)
  291. # Look for line-level action
  292. line_action = request.POST.get('line_action', '').lower()
  293. if line_action:
  294. if line_action not in self.line_actions:
  295. messages.error(self.request, "Invalid action")
  296. return self.reload_page_response()
  297. else:
  298. line_ids = request.POST.getlist('selected_line')
  299. line_quantities = []
  300. for line_id in line_ids:
  301. qty = request.POST.get('selected_line_qty_%s' % line_id)
  302. line_quantities.append(int(qty))
  303. lines = order.lines.filter(id__in=line_ids)
  304. if lines.count() == 0:
  305. messages.error(self.request, _("You must select some lines to act on"))
  306. return self.reload_page_response()
  307. return getattr(self, line_action)(request, order, lines, line_quantities)
  308. messages.error(request, _("No valid action submitted"))
  309. return self.reload_page_response()
  310. def reload_page_response(self, fragment=None):
  311. url = reverse('dashboard:order-detail', kwargs={'number': self.object.number})
  312. if fragment:
  313. url += '#' + fragment
  314. return HttpResponseRedirect(url)
  315. def save_note(self, request, order):
  316. form = self.get_order_note_form()
  317. success_msg = _("Note saved")
  318. if form.is_valid():
  319. note = form.save(commit=False)
  320. note.user = request.user
  321. note.order = order
  322. note.save()
  323. messages.success(self.request, success_msg)
  324. return self.reload_page_response(fragment='notes')
  325. ctx = self.get_context_data(note_form=form, active_tab='notes')
  326. return self.render_to_response(ctx)
  327. def delete_note(self, request, order):
  328. try:
  329. note = order.notes.get(id=request.POST.get('note_id', None))
  330. except ObjectDoesNotExist:
  331. messages.error(request, _("Note cannot be deleted"))
  332. else:
  333. messages.info(request, _("Note deleted"))
  334. note.delete()
  335. return self.reload_page_response()
  336. def change_order_status(self, request, order):
  337. new_status = request.POST['new_status'].strip()
  338. if not new_status:
  339. messages.error(request, _("The new status '%s' is not valid") % new_status)
  340. return self.reload_page_response()
  341. if not new_status in order.available_statuses():
  342. messages.error(request, _("The new status '%s' is not valid for this order") % new_status)
  343. return self.reload_page_response()
  344. handler = EventHandler()
  345. try:
  346. handler.handle_order_status_change(order, new_status)
  347. except PaymentError, e:
  348. messages.error(request, _("Unable to change order status due to payment error: %s") % e)
  349. else:
  350. msg = _("Order status changed from '%(old_status)s' to '%(new_status)s'") % {
  351. 'old_status': order.status,
  352. 'new_status': new_status}
  353. messages.info(request, msg)
  354. order.notes.create(user=request.user, message=msg,
  355. note_type=OrderNote.SYSTEM)
  356. return self.reload_page_response(fragment='activity')
  357. def change_line_statuses(self, request, order, lines, quantities):
  358. new_status = request.POST['new_status'].strip()
  359. if not new_status:
  360. messages.error(request, _("The new status '%s' is not valid") % new_status)
  361. return self.reload_page_response()
  362. errors = []
  363. for line in lines:
  364. if new_status not in line.available_statuses():
  365. errors.append(_("'%(status)s' is not a valid new status for line %(line_id)d") % {
  366. 'status': new_status,
  367. 'line_id': line.id})
  368. if errors:
  369. messages.error(request, "\n".join(errors))
  370. return self.reload_page_response()
  371. msgs = []
  372. for line in lines:
  373. msg = _("Status of line #%(line_id)d changed from '%(old_status)s' to '%(new_status)s'") % {
  374. 'line_id': line.id,
  375. 'old_status': line.status,
  376. 'new_status': new_status}
  377. msgs.append(msg)
  378. line.set_status(new_status)
  379. message = "\n".join(msgs)
  380. messages.info(request, message)
  381. order.notes.create(user=request.user, message=message,
  382. note_type=OrderNote.SYSTEM)
  383. return self.reload_page_response()
  384. def create_shipping_event(self, request, order, lines, quantities):
  385. code = request.POST['shipping_event_type']
  386. try:
  387. event_type = ShippingEventType._default_manager.get(code=code)
  388. except ShippingEventType.DoesNotExist:
  389. messages.error(request, _("The event type '%s' is not valid") % code)
  390. return self.reload_page_response()
  391. reference = request.POST.get('reference', None)
  392. try:
  393. EventHandler().handle_shipping_event(order, event_type, lines,
  394. quantities,
  395. reference=reference)
  396. except InvalidShippingEvent, e:
  397. messages.error(request, _("Unable to create shipping event: %s") % e)
  398. except InvalidStatus, e:
  399. messages.error(request, _("Unable to create shipping event: %s") % e)
  400. except PaymentError, e:
  401. messages.error(request, _("Unable to create shipping event due to payment error: %s") % e)
  402. else:
  403. messages.success(request, _("Shipping event created"))
  404. return self.reload_page_response()
  405. def create_order_payment_event(self, request, order):
  406. amount_str = request.POST.get('amount', None)
  407. try:
  408. amount = D(amount_str)
  409. except InvalidOperation:
  410. messages.error(request, _("Please choose a valid amount"))
  411. return self.reload_page_response()
  412. return self._create_payment_event(request, order, amount)
  413. def _create_payment_event(self, request, order, amount, lines=None,
  414. quantities=None):
  415. code = request.POST['payment_event_type']
  416. try:
  417. event_type = PaymentEventType._default_manager.get(code=code)
  418. except PaymentEventType.DoesNotExist:
  419. messages.error(request, _("The event type '%s' is not valid") % code)
  420. return self.reload_page_response()
  421. try:
  422. EventHandler().handle_payment_event(order, event_type, amount,
  423. lines, quantities)
  424. except PaymentError, e:
  425. messages.error(request, _("Unable to change order status due to payment error: %s") % e)
  426. else:
  427. messages.info(request, _("Payment event created"))
  428. return self.reload_page_response()
  429. def create_payment_event(self, request, order, lines, quantities):
  430. amount_str = request.POST.get('amount', None)
  431. # If no amount passed, then we add up the total of the selected lines
  432. if not amount_str:
  433. amount = D('0.00')
  434. for line, quantity in zip(lines, quantities):
  435. amount += int(quantity) * line.line_price_incl_tax
  436. else:
  437. try:
  438. amount = D(amount_str)
  439. except InvalidOperation:
  440. messages.error(request, _("Please choose a valid amount"))
  441. return self.reload_page_response()
  442. return self._create_payment_event(request, order, amount, lines,
  443. quantities)
  444. class LineDetailView(DetailView):
  445. model = Line
  446. context_object_name = 'line'
  447. template_name = 'dashboard/orders/line_detail.html'
  448. def get_object(self, queryset=None):
  449. try:
  450. return self.model.objects.get(pk=self.kwargs['line_id'])
  451. except self.model.DoesNotExist:
  452. raise Http404()
  453. def get_context_data(self, **kwargs):
  454. ctx = super(LineDetailView, self).get_context_data(**kwargs)
  455. ctx['order'] = self.object.order
  456. return ctx
  457. def get_changes_between_models(model1, model2, excludes=None):
  458. """
  459. Return a dict of differences between two model instances
  460. """
  461. if excludes is None:
  462. excludes = []
  463. changes = {}
  464. for field in model1._meta.fields:
  465. if not (isinstance(field, (fields.AutoField, fields.related.RelatedField))
  466. or field.name in excludes):
  467. if field.value_from_object(model1) != field.value_from_object(model2):
  468. changes[field.verbose_name] = (field.value_from_object(model1),
  469. field.value_from_object(model2))
  470. return changes
  471. def get_change_summary(model1, model2):
  472. """
  473. Generate a summary of the changes between two address models
  474. """
  475. changes = get_changes_between_models(model1, model2, ['search_text'])
  476. change_descriptions = []
  477. for field, delta in changes.items():
  478. change_descriptions.append(_("%(field)s changed from '%(old_value)s' to '%(new_value)s'") % {
  479. 'field': field,
  480. 'old_value': delta[0],
  481. 'new_value': delta[1]})
  482. return "\n".join(change_descriptions)
  483. class ShippingAddressUpdateView(UpdateView):
  484. model = ShippingAddress
  485. context_object_name = 'address'
  486. template_name = 'dashboard/orders/shippingaddress_form.html'
  487. form_class = forms.ShippingAddressForm
  488. def get_object(self, queryset=None):
  489. return get_object_or_404(self.model, order__number=self.kwargs['number'])
  490. def get_context_data(self, **kwargs):
  491. ctx = super(ShippingAddressUpdateView, self).get_context_data(**kwargs)
  492. ctx['order'] = self.object.order
  493. return ctx
  494. def form_valid(self, form):
  495. old_address = ShippingAddress.objects.get(id=self.object.id)
  496. response = super(ShippingAddressUpdateView, self).form_valid(form)
  497. changes = get_change_summary(old_address, self.object)
  498. if changes:
  499. msg = _("Delivery address updated:\n%s") % changes
  500. self.object.order.notes.create(user=self.request.user, message=msg,
  501. note_type=OrderNote.SYSTEM)
  502. return response
  503. def get_success_url(self):
  504. messages.info(self.request, _("Delivery address updated"))
  505. return reverse('dashboard:order-detail', kwargs={'number': self.object.order.number, })