Skip to content

Latest commit

 

History

History
106 lines (58 loc) · 2.09 KB

README.md

File metadata and controls

106 lines (58 loc) · 2.09 KB

Banner

Duoshuo Python SDK

本SDK支持用Python语言开发的网站,对其提供[多说]插件的支持。

Requirements

Python 2.6+

Django 1.2+ (如果在Django中使用)

Index

Python Useage

Django useage

Python Usage

作为Python models来使用

Core (__init__.py)

sdk核心功能: 交换token,生成授权链接,调用api接口


实例化duoshuoAPI

from duoshuo import DuoshuoAPI

code = reqeust.GET.get(code)

api = DuoshuoAPI(short_name=YOUR_DUOSHUO_SHORT_NAME, secret=YOUR_DUOSHUO_SECRET)

#例如要获取用户信息
api.users.details(user_id=1)

更多API可以查看多说开发文档

交换token

访问需要用户身份的接口时要先进行授权,采用OAuth2.0协议,Python SDK提供交换token的处理,实例化api后可以直接传入code来获取token:

code = reqeust.GET.get(code)

token = api.get_token(redirect_uri=redirect_uri, code=code)

Utils (utils.py)

多说常用处理: remote_auth字符串加密。


views.py:

from duoshuo.utils import remote_auth
sig = remote_auth(id=request.user.id, name=request.user.username, email=request.user.email)

template/xxx.html

duoshuoQuery['remote_auth'] = {{ sig }}

Widgets (widgets.py)

多说主要挂件:最新评论,最近访客

soon coming...

Django Usage

作为Django app来使用

0. 安装duoshuo插件

python setup.py install

INSTALLED_APPS = (
	...
	'duoshuo',
)

# settings.py
DUOSHUO_SECRET = '你的多说secret'
DUOSHUO_SHORT_NAME = '你的多说short name'

1. 导入已有数据

python manager.py ds_import user
python manager.py ds_import comment

2. 显示多说评论框

{% load duoshuo_tags %}

{% duoshuo_comments %}

#给多说评论框传递其他short name
{% duoshuo_comments '其他short name' %}

3. 用户登录后,在评论框显示本地身份

# 请放在多说评论框tag: {{ duoshuo_comments }} 之前
{{ request.user|remote_auth|safe }}