|
在上一章中，你創(chuàng)建了一個(gè)包括商品目錄和訂單系統(tǒng)的在線商店。你還學(xué)習(xí)了如何用Celery啟動(dòng)異步任務(wù)。在這一章中，你會(huì)學(xué)習(xí)如何在網(wǎng)站中集成支付網(wǎng)關(guān)。你還會(huì)擴(kuò)展管理站點(diǎn)，用于管理訂單和導(dǎo)出不同格式的訂單。 我們會(huì)在本章覆蓋以下知識(shí)點(diǎn)：
8.1 集成支付網(wǎng)關(guān)支付網(wǎng)關(guān)允許你在線處理支付。你可以使用支付網(wǎng)關(guān)管理用戶訂單，以及通過可靠的，安全的第三方代理處理支付。這意味著你不用考慮在自己的系統(tǒng)中存儲(chǔ)信用卡。 有很多支付網(wǎng)關(guān)可供選擇。我們將集成PayPal，它是最流行的支付網(wǎng)關(guān)之一。 PayPal提供了幾種方法在網(wǎng)站中集成它的網(wǎng)關(guān)。標(biāo)準(zhǔn)集成包括一個(gè) 8.1.1 創(chuàng)建PayPal賬戶你需要一個(gè)PayPal商家賬戶，才能在網(wǎng)站中集成支付網(wǎng)關(guān)。如果你還沒有PayPal賬戶，在這里注冊(cè)。確保你選擇了商家賬戶。 在注冊(cè)表單填寫詳細(xì)信息完成注冊(cè)。PayPal會(huì)給你發(fā)送一封郵件確認(rèn)賬戶。 8.1.2 安裝django-paypal
在終端使用以下命令安裝django-paypal： pip install django-paypal編輯項(xiàng)目的 INSTALLED_APPS = [ # ... 'paypal.standard.ipn',]這個(gè)應(yīng)用是django-paypal提供的，通過 在 # django-paypal settingsPAYPAL_RECEIVER_EMAIL = 'mypaypalemail@myshop.com'PAYPAL_TEST = True這些設(shè)置分別是：
打開終端執(zhí)行以下命令，同步django-paypal的模型到數(shù)據(jù)庫(kù)中： python manage.py migrate你會(huì)看到類似這樣結(jié)尾的輸出： Running migrations: Applying ipn.0001_initial... OK Applying ipn.0002_paypalipn_mp_id... OK Applying ipn.0003_auto_20141117_1647... OK Applying ipn.0004_auto_20150612_1826... OK Applying ipn.0005_auto_20151217_0948... OK Applying ipn.0006_auto_20160108_1112... OK Applying ipn.0007_auto_20160219_1135... OK現(xiàn)在django-paypal的模型已經(jīng)同步到數(shù)據(jù)庫(kù)中。你還需要添加django-paypal的URL模式到項(xiàng)目中。編輯 url(r'^paypal/', include('paypal.standard.ipn.urls')),讓我們把支付網(wǎng)關(guān)添加到結(jié)賬過程中。 8.1.3 添加支付網(wǎng)關(guān)結(jié)賬流程是這樣的：
使用以下命令在項(xiàng)目中創(chuàng)建一個(gè)新應(yīng)用： python manage.py startapp payment我們將使用這個(gè)應(yīng)用管理結(jié)賬流程和用戶支付。 編輯項(xiàng)目的 INSTALLED_APPS = [ # ... 'paypal.standard.ipn', 'payment',]現(xiàn)在 from django.shortcuts import render, redirectfrom django.core.urlresolvers import reverse找到 # launch asynchronous taskorder_created.delay(order.id)return render(request, 'orders/order/created.html', {'order': order})替換為下面的代碼： # launch asynchronous taskorder_created.delay(order.id)request.session['order_id'] = order.idreturn redirect(reverse('payment:process'))創(chuàng)建訂單成功之后，我們用 編輯 from decimal import Decimalfrom django.conf import settingsfrom django.core.urlresolvers import reversefrom django.shortcuts import render, get_object_or_404from paypal.standard.forms import PayPalPaymentsFormfrom orders.models import Orderdef payment_process(request): order_id = request.session.get('order_id') order = get_object_or_404(Order, id=order_id) host = request.get_host() paypal_dict = { 'business': settings.PAYPAL_RECEIVER_EMAIL, 'amount': '%.2f' % order.get_total_cost().quantize(Decimal('.01')), 'item_name': 'Order {}'.format(order.id), 'invoice': str(order.id), 'currency_code': 'USD', 'notify_url': 'http://{}{}'.format(host, reverse('paypal-ipn')), 'return_url': 'http://{}{}'.format(host, reverse('payment:done')), 'cancel_return': 'http://{}{}'.format(host, reverse('payment:canceled')), } form = PayPalPaymentsForm(initial=paypal_dict) return render(request, 'payment/process.html', {'order': order, 'form': form})在
讓我們創(chuàng)建一個(gè)簡(jiǎn)單的視圖，當(dāng)支付完成，或者因?yàn)槟承┰蛉∠Ц?，讓PayPal重定向用戶。在同一個(gè) from django.views.decorators.csrf import csrf_exempt@csrf_exemptdef payment_done(request): return render(request, 'payment/done.html')@csrf_exemptdef payment_canceled(request): return render(request, 'payment/canceled.html')因?yàn)镻ayPal可以通過POST重定向用戶到這些視圖的任何一個(gè)，所以我們用 from django.conf.urls import urlfrom . import viewsurlpatterns = [ url(r'^process/$', views.payment_process, name='process'), url(r'^done/$', views.payment_done, name='done'), url(r'^canceled/$', views.payment_canceled, name='canceled'),]這些是支付流程的URL。我們包括了以下URL模式：
編輯 url(r'^payment/', include('payment.urls', namespace='payment')),記住把它放在 在 templates/ payment/ process.html done.html canceled.html編輯 {% extends 'shop/base.html' %}{% block title %}Pay using PayPal{% endblock title %}{% block content %} 這個(gè)模板用于渲染 編輯 {% extends 'shop/base.html' %}{% block content %} 用戶支付成功后，會(huì)重定向到這個(gè)模板頁面。 編輯 {% extends 'shop/base.html' %}{% block content %} 處理支付遇到問題，或者用戶取消支付時(shí)，會(huì)重定向到這個(gè)模板頁面。 讓我們嘗試完整的支付流程。 8.1.4 使用PayPal的Sandbox在瀏覽器中打開  最初，你會(huì)看到一個(gè)商家賬戶和一個(gè)PayPal自動(dòng)生成的個(gè)人測(cè)試賬戶。你可以點(diǎn)擊 點(diǎn)擊列表中  在 當(dāng)你的網(wǎng)站使用sandbox環(huán)境時(shí)，測(cè)試賬戶可以用來處理支付。導(dǎo)航到 在終端執(zhí)行 
你可以看一眼HTML源碼，查看生成的表單字段。 點(diǎn)擊  輸入顧客測(cè)試賬號(hào)的郵箱地址和密碼，然后點(diǎn)擊登錄按鈕。你會(huì)被重定向到以下頁面： 
現(xiàn)在點(diǎn)擊  點(diǎn)擊  支付成功！但是因?yàn)槲覀冊(cè)诒镜剡\(yùn)行項(xiàng)目，127.0.0.1不是一個(gè)公網(wǎng)IP，所以PayPal不能給我們的應(yīng)用發(fā)送支付狀態(tài)通知。我們接下來學(xué)習(xí)如何讓我們的網(wǎng)站可以從Internet訪問，從而接收IPN通知。 8.1.5 獲得支付通知IPN是大部分支付網(wǎng)關(guān)都會(huì)提供的方法，用于實(shí)時(shí)跟蹤購(gòu)買。當(dāng)網(wǎng)關(guān)處理完一個(gè)支付后，會(huì)立即給你的服務(wù)器發(fā)送一個(gè)通知。該通知包括所有支付細(xì)節(jié)，包括狀態(tài)和用于確認(rèn)通知來源的支付簽名。這個(gè)通知作為獨(dú)立的HTTP請(qǐng)求發(fā)送到你的服務(wù)器。出現(xiàn)問題的時(shí)候，PayPal會(huì)多次嘗試發(fā)送通知。
我們將創(chuàng)建一個(gè)自定義接收函數(shù)，并把它連接到 在 from django.shortcuts import get_object_or_404from paypal.standard.models import ST_PP_COMPLETEDfrom paypal.standard.ipn.signals import valid_ipn_receivedfrom orders.models import Orderdef payment_notification(sender, **kwargs): ipn_obj = sender if ipn_obj.payment_status == ST_PP_COMPLETED: # payment was successful order = get_object_or_404(Order, id=ipn_obj.invoice) # mark the order as paid order.paid = True order.save()valid_ipn_received.connect(payment_notification)我們把
當(dāng) 8.1.6 配置我們的應(yīng)用你已經(jīng)在第六章學(xué)習(xí)了應(yīng)用配置。我們將為 在 from django.apps import AppConfigclass PaymentConfig(AppConfig): name = 'payment' verbose_name = 'Payment' def ready(self): # improt signal handlers import payment.signals在這段代碼中，我們?yōu)?code>payment應(yīng)用定義了一個(gè) 編輯 default_app_config = 'payment.apps.PaymentConfig'這會(huì)讓Django自動(dòng)加載你的自定義應(yīng)用配置類。你可以在這里閱讀更多關(guān)于應(yīng)用配置的信息。 8.1.7 測(cè)試支付通知因?yàn)槲覀冊(cè)诒镜丨h(huán)境開發(fā)，所以我們需要讓PayPal可以訪問我們的網(wǎng)站。有幾個(gè)應(yīng)用程序可以讓開發(fā)環(huán)境通過Internet訪問。我們將使用Ngrok，是最流行的之一。 從這里下載你的操作系統(tǒng)版本的Ngrok，并使用以下命令運(yùn)行： ./ngrok http 8000這個(gè)命令告訴Ngrok在8000端口為你的本地主機(jī)創(chuàng)建一個(gè)鏈路，并為它分配一個(gè)Internet可訪問的主機(jī)名。你可以看到類似這樣的輸入： Session Status onlineAccount lakerszhy (Plan: Free)Update update available (version 2.2.4, Ctrl-U to update)Version 2.1.18Region United States (us)Web Interface http://127.0.0.1:4040Forwarding http://c0f17d7c. -> localhost:8000Forwarding https://c0f17d7c. -> localhost:8000Connections ttl opn rt1 rt5 p50 p90 0 0 0.00 0.00 0.00 0.00Ngrok告訴我們，我們網(wǎng)站使用的Django開發(fā)服務(wù)器在本機(jī)的8000端口運(yùn)行，現(xiàn)在可以通過 完成支付處理后，在瀏覽器中打開
你也可以在這里使用PayPal的模擬器發(fā)送IPN。模擬器允許你指定通知的字段和類型。 除了 8.2 導(dǎo)出訂單到CSV文件有時(shí)你可能希望把模型中的信息導(dǎo)出到文件中，然后把它導(dǎo)入到其它系統(tǒng)中。其中使用最廣泛的格式是 8.2.1 在管理站點(diǎn)你添加自定義操作Django提供了大量自定義管理站點(diǎn)的選項(xiàng)。我們將修改對(duì)象列表視圖，在其中包括一個(gè)自定義的管理操作。 一個(gè)管理操作是這樣工作的：用戶在管理站點(diǎn)的對(duì)象列表頁面用復(fù)選框選擇對(duì)象，然后選擇一個(gè)在所有選中選項(xiàng)上執(zhí)行的操作，最后執(zhí)行操作。下圖顯示了操作位于管理站點(diǎn)的哪個(gè)位置： 
你可以編寫一個(gè)常規(guī)函數(shù)來創(chuàng)建自定義操作，該函數(shù)需要接收以下參數(shù)：
當(dāng)在管理站點(diǎn)觸發(fā)操作時(shí)，會(huì)執(zhí)行這個(gè)函數(shù)。 我們將創(chuàng)建一個(gè)自定義管理操作，來下載一組訂單的CSV文件。編輯 import csvimport datetimefrom django.http import HttpResponsedef export_to_csv(modeladmin, request, queryset): opts = modeladmin.model._meta response = HttpResponse(content_type='text/csv') response['Content-Disposition'] = 'attachment;filename={}.csv'.format(opts.verbose_name) writer = csv.writer(response) fields = [field for field in opts.get_fields() if not field.many_to_many and not field.one_to_many] # Write a first row with header information writer.writerow([field.verbose_name for field in fields]) # Write data rows for obj in queryset: data_row = [] for field in fields: value = getattr(obj, field.name) if isinstance(value, datetime.datetime): value = value.strftime('%d/%m/%Y') data_row.append(value) writer.writerow(data_row) return responseexport_to_csv.short_description = 'Export to CSV'在這段代碼中執(zhí)行了以下任務(wù)：
我們創(chuàng)建了一個(gè)通用的管理操作，可以添加到所有 最后，如下添加 calss OrderAdmin(admin.ModelAdmin): # ... actions = [export_to_csv]在瀏覽器中打開  選中幾條訂單，然后在選擇框中選擇 ID,first name,last name,email,address,postal code,city,created,updated,paid1,allen,iverson,lakerszhy@gmail.com,北京市朝陽區(qū),100012,北京市,11/05/2017,11/05/2017,False2,allen,kobe,lakerszhy@gmail.com,北京市朝陽區(qū),100012,北京市,11/05/2017,11/05/2017,False正如你所看到的，創(chuàng)建管理操作非常簡(jiǎn)單。 8.3 用自定義視圖擴(kuò)展管理站點(diǎn)有時(shí)，你可能希望通過配置 讓我們創(chuàng)建一個(gè)自定義視圖，顯示訂單的相關(guān)信息。編輯 from django.contrib.admin.views.decorators import staff_member_requiredfrom django.shortcuts import get_object_or_404from .models import Order@staff_member_requireddef admin_order_detail(request, order_id): order = get_object_or_404(Order, id=order_id) return render(request, 'admin/orders/order/detail.html', {'order': order})
現(xiàn)在編輯 url(r'^admin/order/(?P在 admin/ orders/ order/ detail.html編輯 {% extends 'admin/base_site.html' %}{% load static %}{% block extrastyle %} {% endblock extrastyle %}{% block title %} Order {{ order.id }} {{ block.super }}{% endblock title %}{% block breadcrumbs %} {% endblock breadcrumbs %}{% block content %} 這個(gè)模板用于在管理站點(diǎn)顯示訂單詳情。模板擴(kuò)展自Django管理站點(diǎn)的 為了使用靜態(tài)文件，我們可以從本章的示例代碼中獲得它們?？截?code>orders應(yīng)用的 我們使用父模板中定義的塊引入自己的內(nèi)容。我們顯示訂單信息和購(gòu)買的商品。 當(dāng)你想要擴(kuò)展一個(gè)管理模板時(shí)，你需要了解它的結(jié)構(gòu)，并確定它存在哪些塊。你可以在這里查看所有管理模板。 如果需要，你也可以覆蓋一個(gè)管理模板。把要覆蓋的模板拷貝到 最后，讓我們?yōu)楣芾碚军c(diǎn)的列表顯示頁中每個(gè) from django.core.urlresolvers import reversedef order_detail(obj): return 'View'.format(reverse('orders:admin_order_detail', args=[obj.id]))order_detail.allow_tags = True這個(gè)函數(shù)接收一個(gè)
然后編輯 class OrderAdmin(admin.ModelAdmin): list_display = [... order_detail]在瀏覽器中打開  點(diǎn)擊任何一個(gè)訂單的  8.4 動(dòng)態(tài)生成PDF單據(jù)我們現(xiàn)在已經(jīng)有了完成的結(jié)賬和支付系統(tǒng)，可以為每個(gè)訂單生成PDF單據(jù)了。有幾個(gè)Python庫(kù)可以生成PDF文件。一個(gè)流行的生成PDF文件的Python庫(kù)是Reportlab。你可以在這里查看如果使用Reportlab輸出PDF文件。 大部分情況下，你必須在PDF文件中添加自定義樣式和格式。你會(huì)發(fā)現(xiàn)，讓Python遠(yuǎn)離表現(xiàn)層，渲染一個(gè)HTML模板，然后把它轉(zhuǎn)換為PDF文件更加方便。我們將采用這種方法，在Django中用模塊生成PDF文件。我們會(huì)使用WeasyPrint，它是一個(gè)Python庫(kù)，可以從HTML模板生成PDF文件。 8.4.1 安裝WeasyPrint首先，為你的操作系統(tǒng)安裝WeasyPrint的依賴，請(qǐng)?jiān)L問這里。 然后用以下命令安裝WeasyPrint： pip install WeasyPrint8.4.2 創(chuàng)建PDF模板我們需要一個(gè)HTML文檔作為WeasyPrint的輸入。我們將創(chuàng)建一個(gè)HTML模板，用Django渲染它，然后把它傳遞給WeasyPrint生成PDF文件。 在 這是PDF單據(jù)的模板。在這個(gè)模板中，我們顯示所有訂單詳情和一個(gè)包括商品的HTML的 8.4.3 渲染PDF文件我們將創(chuàng)建一個(gè)視圖，在管理站點(diǎn)中生成已存在訂單的PDF單據(jù)。編輯 from django.conf import settingsfrom django.http import HttpResponsefrom django.template.loader import render_to_stringimport weasyprint@staff_member_requireddef admin_order_pdf(request, order_id): order = get_object_or_404(Order, id=order_id) html = render_to_string('orders/order/pdf.html', {'order': order}) response = HttpResponse(content_type='application/pdf') response['Content-Disposition'] = 'filename='order_{}.pdf''.format(order.id) weasyprint.HTML(string=html).write_pdf(response, stylesheets=[weasyprint.CSS(settings.STATIC_ROOT + 'css/pdf.css')]) return response這個(gè)視圖用于生成訂單的PDF單據(jù)。我們用 因?yàn)槲覀冃枰褂?code>STATIC_ROOT設(shè)置，所以需要把它添加到我們項(xiàng)目中。這是項(xiàng)目的靜態(tài)文件存放的路徑。編輯 STATIC_ROOT = os.path.join(BASE_DIR, 'static/')接著執(zhí)行 You have requested to collect static files at the destinationlocation as specified in your settings: /Users/lakerszhy/Documents/GitHub/Django-By-Example/code/Chapter 8/myshop/staticThis will overwrite existing files!Are you sure you want to do this?輸入
編輯 url(r'admin/order/(?P現(xiàn)在，我們可以編輯管理列表顯示頁面，為 def order_pdf(obj): return 'PDF'.format(reverse('orders:admin_order_pdf', args=[obj.id]))order_pdf.allow_tags = Trueorder_pdf.short_description = 'PDF bill'把 class OrderAdmin(admin.ModelAdmin): list_display = [..., order_detail, order_pdf]如果你為可調(diào)用對(duì)象指定了 在瀏覽器中打開 點(diǎn)擊任意一條訂單的PDF鏈接。你會(huì)看到生成的PDF文件，下圖是未支付的訂單： 已支付訂單如下圖所示： 8.4.4 通過郵件發(fā)送PDF文件當(dāng)收到支付時(shí)，讓我們給顧客發(fā)送一封包括PDF單據(jù)的郵件。編輯 from django.template.loader import render_to_stringfrom django.core.mail import EmailMessagefrom django.conf import settingsimport weasyprintfrom io import BytesIO然后在 # create invoice e-mailsubject = 'My Shop - Invoice no. {}'.format(order.id)message = 'Please, find attached the invoice for your recent purchase.'email = EmailMessage(subject, message, 'admin@myshop.com', [order.email])# generate PDFhtml = render_to_string('orders/order/pdf.html', {'order': order})out = BytesIO()stylesheets = [weasyprint.CSS(settings.STATIC_ROOT + 'css/pdf.css')]weasyprint.HTML(string=html).write_pdf(out, stylesheets=stylesheets)# attach PDF fileemail.attach('order_{}.pdf'.format(order.id), out.getvalue(), 'application/pdf')# send e-mailemail.send()在這個(gè)信號(hào)中，我們用Django提供的 記得在項(xiàng)目 現(xiàn)在打開Ngrok提供的應(yīng)用URL，完成一筆新的支付，就能在郵件中收到PDF單據(jù)了。 8.5 總結(jié)在這一章中，你在項(xiàng)目中集成了支付網(wǎng)關(guān)。你自定義了Django管理站點(diǎn)，并學(xué)習(xí)了如果動(dòng)態(tài)生成CSV和PDF文件。 下一章會(huì)深入了解Django項(xiàng)目的國(guó)際化和本地化。你還會(huì)創(chuàng)建一個(gè)優(yōu)惠券系統(tǒng)和商品推薦引擎。 |
||||||||||||||||||||||||
|
|
