Hello world

这将是你使用 WEGO 的一个简单起步，放轻松，WEGO 不会给你带来太多理解上的压力，但开始前，我们希望你对 Django 或 Tornado 有一定的使用经验，如果两者你都还没尝试过，我们推荐文档更优秀的 Django 作为你的起步 (https://www.djangoproject.com/)。(和 python2.x 用户的约定: 使用 unicode 类型传递包含中文的字符串如: u’中文’)

初始化

我们建议把 wego 的初始化放入你的配置文件内，如 django 的 settings.py，下面所需的参数都可以在微信公众平台获得 (https://mp.weixin.qq.com)。

import wego

# wego 初始化, 对应信息可以登录微信公众平台获取
w = wego.init(
    # 应用ID (开发 -> 基本配置)
    APP_ID='',
    # 应用密钥 (开发 -> 基本配置)
    APP_SECRET='',
    # 注册域名, 微信公众平台左侧: 接口权限-> 网页授权获取用户基本信息内配置, 需加上 http(s):// 以 / 结尾
    REGISTER_URL='http://www.example.com/',
    # WEGO 助手 'wego.helpers.tornado_helper'
    HELPER='wego.helpers.official.DjangoHelper',
)

如果你是 tornado 用户，那么我们建议启动 tornado 时配置一下 cookie_secret (http://tornado-zh.readthedocs.io/zh/latest/guide/security.html)，以增强安全性

注意：文档内的 w 变量将特指 wego.init 返回的 WegoApi 实例。

Hello world

让 wego 和你打个招呼~

# 将上面初始化后的实例 w import 进来
from somewhere import w

# django
@w.login_required
def index(request):
    hello = 'Hello %s!' % request.wx_user.nickname
    return HttpResponse(hello)

# tornado
class IndexHandler(tornado.web.RequestHandler):
    @w.login_required
    def get(self):
        hello = 'Hello %s!' % self.wx_user.nickname
        return self.write(hello)

将 url 指向对应的函数或类，然后访问这个 url，是不是成功了？虽然不是标准的网页没有漂亮的样式字也有些小，但是热情还是在的。

更多参数的初始化

这是一个使用了更多初始化参数的例子，完整参数的示例请移步至 初始化参数说明。

# wego 初始化, 对应信息可以登录微信公众平台获取
w = wego.init(
    # 应用ID (开发 -> 基本配置)
    APP_ID='',
    # 应用密钥 (开发 -> 基本配置)
    APP_SECRET='',
    # 注册域名, 微信公众平台左侧: 接口权限-> 网页授权获取用户基本信息内配置, 需加上 http(s):// 以 / 结尾
    REGISTER_URL='http://www.example.com/',
    # WEGO 助手 'wego.helpers.tornado_helper'
    HELPER='wego.helpers.official.DjangoHelper',

    # -- 使用微信支付时才填以下参数 --
    # 商户号
    MCH_ID='',
    # 商户密钥
    MCH_SECRET='',
    # apiclient_cert.pem 证书路径
    CERT_PEM_PATH='/path/to/apiclient_cert.pem',
    # apiclient_key.pem 证书路径
    KEY_PEM_PATH='/path/to/apiclient_key.pem',
    # 微信支付服务器回调路径
    PAY_NOTIFY_PATH='/a/',

    # -- 使用服务器消息推送才填以下参数 --
    # 推送 Token (开发 -> 基本配置)
    PUSH_TOKEN='',
    # 推送 EncodingAESKey (开发 -> 基本配置)
    PUSH_ENCODING_AES_KEY='',

    # 选填，微信用户授权登录强制跳转路径, 如 '/'、'/jump'、'/redirect'
    REDIRECT_PATH='/',
    # 选填，微信用户授权跳转回来 state 参数的值
    REDIRECT_STATE='/',
    # 选填, 用户信息缓存过期时间, 单位秒, 不填则不缓存用户数据
    USERINFO_EXPIRE=60*3,
    # 选填, DEBUG 模式下, 微信支付为 1 分钱
    DEBUG=True,
)