WeChat-Django旨在为接入微信公众平台的django开发者提供便捷的微信功能封装及最基本的后台管理支持.

项目官方地址: https://github.com/Xavier-Lam/wechat-django

本拓展基于wechatpy ,支持的最低django版本为1.11.

目前没有使用在生产环境使用本项目的案例,编写了部分单元测试,并进行了一部分简单的徒手测试.

0.1.0只是一个预览版本,可能存在较多bug,并且有api及数据结构变更可能,欢迎贡献代码

• 功能
• 安装及配置
  • 初次安装
  • 直接加入项目
  • 更新
  • 配置
  • 日志
  • 注意事项
• 部分功能使用说明
  • 网页授权
  • 主动调用微信api
  • 自定义微信回复
• 后台使用简介
• 示例项目
• TODOS:
  • 计划的功能
  • 已知bug
• ChangeLog
  • 0.1.0

• 公众号管理
• 同步用户及用户查看,备注
• 菜单同步,查看及发布
• 同步公众号自动回复,管理自动回复,转发和自定义自动回复业务,接收消息日志
• 永久素材同步及查看
• 图文同步及查看
• 服务号网页授权
• 主动调用微信api封装
• 微信网页授权
• 后台权限管理

1. 运行pip install wechat-django[cryptography] 或 pip install wechat-django[pycrypto] 安装
2. 在settings.py的INSTALLED_APPS中添加wechat_django
3. 运行manage.py migrate wechat_django 来更新数据库结构
4. 在urls.py 中引入wechat_django.urls, 将其配置到urlpatterns中

至此,您已可以开始轻松使用wechat_django.项目尚未提供具体的使用文档,如需客制化需求,烦请先阅读代码

想使用最新特性或是自行编辑代码,可clone本项目后,采用pip install -e 直接安装到你的django项目目录

1. 运行pip install -U wechat-django
2. 运行python manage.py migrate wechat_django 来更新数据库结构

一般而言,默认配置足以满足需求

• 框架默认采用django的cache管理accesstoken,如果有多个进程,或是多台机器部署,请确保所有worker使用公用cache以免造成token争用,如果希望不使用django的cache管理accesstoken,可以在配置项中定义SessionStorage
• 请确保在https环境下部署,否则有secretkey泄露的风险

可通过wechat_django.oauth.wechat_auth装饰器进行网页授权,授权后,request将被附上一个名为wechat的wechat_django.oauth.WeChatOAuthInfo 对象,可通过 request.wechat.user 拿到wechat_django.models.WeChatUser实例,通过 request.wechat.app 拿到wechat_django.models.WeChatApp实例,以下是一个基本示例

from wechat_django.oauth import wechat_auth

@wechat_auth("your_app_name")
def your_view(request, *args, **kwargs):
    """:type request: wechat_django.models.request.WeChatOAuthRequest"""
    user = request.wechat.user

对于默认重定向行为不满意的,可以自定义response,具体的参数说明参见wechat_django.oauth.wechat_auth装饰器的docstring

对于class based view,可继承wechat_django.oauth.WeChatOAuthView类,具体参见代码

from wechat_django.models import WeChatApp
app = WeChatApp.get_by_name("your app name")
data = app.client.user.get_followers()

具体client的使用方式,请移步wechatpy文档

在后台配置自定义回复,填写自定义回复处理代码的路径,代码须由 wechat_django.decorators.message_handler 装饰对应的方法接收一个 wechat_django.models.WeChatMessageInfo 对象,返回字符串或一个 wechatpy.replies.BaseReply 对象

from wechat_django.decorators import message_handler

@message_handler
def custom_business(message):
    """
    :type message: wechat_django.models.WeChatMessageInfo
    """
    user = message.user
    msg = message.message
    text = "hello, {0}! we received a {1} message.".format(
        user, msg.type)
    return TextReply(content=text.encode())

参见管理后台使用简介 文档

可参考本项目sample文件夹

• 完善单元测试
• app层面的message log和reply log
• 后台表单验证
• 后台确认页

• accesstoken开放给第三方并对接第三方accesstoken
• 用户分组管理
• 消息响应日志/对话
• 客服消息
• 清理及保护永久素材
• 将部分actions改为object-tool
• 回复及一些查询缓存
• 菜单导入导出

• 公众号管理及基本用法封装
• 用户,自动回复,菜单,永久素材,图文的基本管理
• 微信网页授权
• 后台权限

Xavier-Lam@NetDragon