django-vkontakte-photos 0.8.0

Django Vkontakte Photos
=======================

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

应用程序允许通过Vkontakte API使用Django标准模型与Vkontakte的相册和照片进行交互

安装
---------

pip install django-vkontakte-photos

在`settings.py`中需要添加

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

# 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方法覆盖
--------------------

* [photos.getAlbums](http://vk.com/dev/photos.getAlbums) – 返回用户专辑列表；
* [photos.get](http://vk.com/dev/photos.get) – 返回专辑中的照片列表；
* [photos.getComments](http://vk.com/dev/photos.getComments) – 返回照片的评论列表；
* [photos.createComment](http://vk.com/dev/photos.createComments) – 创建照片的新评论；
* [photos.deleteComment](http://vk.com/dev/photos.deleteComments) – 删除照片的评论；
* [photos.restoreComment](http://vk.com/dev/photos.restoreComments) – 恢复已删除的照片评论；
* [photos.editComment](http://vk.com/dev/photos.editComments) – 更改照片评论的文本；

计划中

* [photos.getById](http://vk.com/dev/photos.getById) – 返回照片信息；
* [photos.getAllComments](http://vk.com/dev/photos.getAllComments) – 返回按反时间顺序排序的特定相册或用户所有相册的评论列表。

使用解析器
---------------------

* 获取照片的评论数量；
* 获取照片的点赞数量；

(*) 复制API功能

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

### 通过群组方法获取群组照片专辑

为此需要安装额外的应用程序
[`django-vkontakte-groups`](http://github.com/ramusus/django-vkontakte-groups/) 并将其添加到 `INSTALLED_APPS`

>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_albums()
[<Album: Coca-Cola привозила кубок мира по футболу FIFA>,
<Album: Старая реклама Coca-Cola>,
'...(剩余元素被截断)...']

群组照片专辑可通过管理器访问

>>> group.photo_albums.count()
47

群组所有专辑的照片可通过管理器访问

>>> group.photos.count()
4432

### 通过管理器获取群组照片专辑

>>> from vkontakte_groups.models import Group
>>> from vkontakte_photos.models import Album
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> Album.remote.fetch(group=group, ids=[106769855])
[<Album: Coca-Cola привозила кубок мира по футболу FIFA>]

### 通过管理器获取用户专辑的照片

为此需要安装额外的应用程序
[`django-vkontakte-users`](http://github.com/ramusus/django-vkontakte-users/) 并将其添加到 `INSTALLED_APPS`

>>> from vkontakte_users.models import User
>>> from vkontakte_photos.models import Album, Photo
>>> user = User.remote.fetch(ids=[1])[0]
>>> album = Album.remote.fetch(user=user, ids=[159337866])[0]
>>> Photo.remote.fetch(album=album)
[<Photo: Photo object>,
<Photo: Photo object>,
<Photo: Photo object>,
<Photo: Photo object>]