Zebra：Django中使用Stripe的简化库

1. 安装指南

首先，确保你已经安装了pip和Django环境。以下是安装Zebra的步骤：

1. 运行命令 pip install django-zebra 来安装Zebra库。

2. 在你的Django项目的settings.py文件中添加以下内容：

   INSTALLED_APPS += ("zebra",)
   STRIPE_SECRET = "YOUR-SECRET-API-KEY"
   STRIPE_PUBLISHABLE = "YOUR-PUBLISHABLE-API-KEY"
   

3. 如果你启用了ZEBRA_ENABLE_APP，运行命令 ./manage.py syncdb 来同步数据库。

4. （可选）添加webhook的URL到你的URL配置中：

   urlpatterns += patterns('',
       url(r'zebra/', include('zebra.urls', namespace="zebra", app_name='zebra')),
   )
   

5. 现在你可以享受Zebra带来的便捷billing功能了。

2. 项目使用说明

Zebra提供了处理Stripe的核心功能，包括表单、webhook处理器、抽象模型、混合类、信号和模板标签。以下是一些基本的使用方法：

Webhooks

Zebra处理所有来自Stripe的webhook调用，并触发一系列信号，你可以将你的应用程序连接到这些信号。要使用webhooks：

1. 包含zebra的URLs。
2. 更新你的Stripe账户，使其指向你的webhook URL（例如 https://www.mysite.com/zebra/webhooks）。
3. 连接到你关心的任何webhook信号。

Forms

StripePaymentForm 表单预设了与官方Stripe示例相同的字段。在你的视图中使用它：

if request.method == 'POST':
    zebra_form = StripePaymentForm(request.POST)
    if zebra_form.is_valid():
        # 处理表单数据
else:
    zebra_form = StripePaymentForm()

Template Tags

使用模板标签来设置Stripe环境和渲染基本的信用卡更新表单。在你的模板中添加以下内容：

{% extends "base.html" %}{% load zebra_tags %}

{% block head %}{{block.super}}
    {% zebra_head_and_stripe_key %}
{% endblock %}

{% block content %}
    {% zebra_card_form %}
{% endblock %}

3. 项目API使用文档

Zebra的API主要包括信号、表单和模板标签。以下是一些关键的API部分：

信号

Zebra提供了多种信号，你可以将这些信号连接到你的处理函数上，以响应不同的Stripe事件。例如：

from zebra.signals import zebra_webhook_recurring_payment_succeeded

def update_last_invoice_date(sender, **kwargs):
    # 处理逻辑
    zebra_webhook_recurring_payment_succeeded.connect(update_last_invoice_date)

表单

StripePaymentForm 表单用于处理用户支付信息。

模板标签

zebra_tags 提供了模板标签来帮助你在模板中集成Stripe功能。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细描述。简要概括如下：

1. 使用pip安装Zebra库。
2. 配置Django项目设置文件。
3. 同步数据库（如果启用了ZEBRA_ENABLE_APP）。
4. 添加webhook URL到Django的URL配置。

以上是关于Zebra库的详细技术文档，可以帮助用户安装和使用这个库来简化Django项目中的Stripe集成。