django-vkontakte-board 0.7.1

Django Vkontakte Board
======================

[](http://badge.fury.io/py/django-vkontakte-board) [](https://travis-ci.org/ramusus/django-vkontakte-board) [](https://coveralls.io/r/ramusus/django-vkontakte-board)

应用程序允许通过Vkontakte API使用标准Django模型与群组讨论进行交互

安装
---------

pip install django-vkontakte-board

在`settings.py`中需要添加

INSTALLED_APPS = (
...
'oauth_tokens',
'taggit',
'vkontakte_api',
'vkontakte_places,
'vkontakte_groups',
'vkontakte_users',
'vkontakte_board',
)

# oauth-tokens 设置
OAUTH_TOKENS_HISTORY = True # 在数据库中保留过期的访问令牌
OAUTH_TOKENS_VKONTAKTE_CLIENT_ID = '' # 应用程序ID
OAUTH_TOKENS_VKONTAKTE_CLIENT_SECRET = '' # 应用程序密钥
OAUTH_TOKENS_VKONTAKTE_SCOPE = ['ads,wall,photos,friends,stats'] # 应用程序作用域
OAUTH_TOKENS_VKONTAKTE_USERNAME = '' # 用户登录名
OAUTH_TOKENS_VKONTAKTE_PASSWORD = '' # 用户密码
OAUTH_TOKENS_VKONTAKTE_PHONE_END = '' # 用户手机号码最后四位

API方法覆盖
--------------------

* [board.getTopics](http://vk.com/dev/board.getTopics) – 返回指定群组讨论中的主题列表；
* [board.getComments](http://vk.com/dev/board.getComments) – 返回指定主题中的消息列表；

使用示例
---------------------

### 通过群组方法获取群组讨论

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_topics()
【主题：奥林匹克圣火接力 ► 在此主题中提出问题】,
【主题：新年促销活动 "与奖品一起迎接新年！收集温暖的熊公司！" ► 提问和讨论】,
'...(剩余元素省略)...']

小组讨论可通过管理器访问

>>> group.topics.count()
12

### 通过管理器获取小组讨论

>>> from vkontakte_board.models import Topic
>>> Topic.remote.fetch(group=group, all=True)
【主题：奥林匹克圣火接力 ► 在此主题中提出问题】,
【主题：新年促销活动 "与奖品一起迎接新年！收集温暖的熊公司！" ► 提问和讨论】,
'...(剩余元素省略)...']

### 通过讨论方法获取讨论评论

>>> from vkontakte_groups.models import Group
>>> from vkontakte_board.models import Topic
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> topic = Topic.remote.fetch(group=group, ids=[26523718])[0]
>>> topic.fetch_comments()
[<评论：评论对象>,
<评论：评论对象>,
'...(剩余元素省略)...']

讨论评论可通过管理器访问

>>> topic[0].comments.count()
39

### 通过管理器获取讨论评论

>>> from vkontakte_groups.models import Group
>>> from vkontakte_board.models import Topic, Comment
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> topic = Topic.remote.fetch(group=group, ids=[26523718])[0]
>>> Comment.remote.fetch(topic=topic)
[<评论：评论对象>,
<评论：评论对象>,
'...(剩余元素省略)...']