https://github.com/ramusus/django-vkontakte-wall
Django implementation for vkontakte API Walls
https://github.com/ramusus/django-vkontakte-wall
Last synced: 7 months ago
JSON representation
Django implementation for vkontakte API Walls
- Host: GitHub
- URL: https://github.com/ramusus/django-vkontakte-wall
- Owner: ramusus
- License: bsd-3-clause
- Created: 2012-12-20T08:45:09.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2016-03-14T12:35:18.000Z (over 10 years ago)
- Last Synced: 2025-11-27T19:01:58.895Z (8 months ago)
- Language: Python
- Size: 206 KB
- Stars: 11
- Watchers: 7
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Django Vkontakte Wall
=====================
[](http://badge.fury.io/py/django-vkontakte-wall) [](https://travis-ci.org/ramusus/django-vkontakte-wall) [](https://coveralls.io/r/ramusus/django-vkontakte-wall)
Приложение позволяет взаимодействовать со стенами Вконтакте, сообщениями и комментариями на них через Вконтакте API и парсер используя стандартные модели Django
Установка
---------
pip install django-vkontakte-wall
В `settings.py` необходимо добавить:
INSTALLED_APPS = (
...
'oauth_tokens',
'taggit',
'vkontakte_api',
'vkontakte_places',
'vkontakte_users',
'vkontakte_groups',
'vkontakte_wall',
'm2m_history',
)
# oauth-tokens settings
OAUTH_TOKENS_HISTORY = True # to keep in DB expired access tokens
OAUTH_TOKENS_VKONTAKTE_CLIENT_ID = '' # application ID
OAUTH_TOKENS_VKONTAKTE_CLIENT_SECRET = '' # application secret key
OAUTH_TOKENS_VKONTAKTE_SCOPE = ['ads,wall,photos,friends,stats'] # application scopes
OAUTH_TOKENS_VKONTAKTE_USERNAME = '' # user login
OAUTH_TOKENS_VKONTAKTE_PASSWORD = '' # user password
OAUTH_TOKENS_VKONTAKTE_PHONE_END = '' # last 4 digits of user mobile phone
Покрытие методов API
--------------------
* [wall.get](http://vk.com/dev/wall.get) – возвращает список записей со стены;
* [wall.getById](http://vk.com/dev/wall.getById) – получает записи со стен пользователей по их идентификаторам;
* [wall.getLikes](http://vk.com/dev/wall.getLikes) – получает информацию о пользователях которым нравится данная запись;
* [wall.post](http://vk.com/dev/wall.post) – публикует новую запись на своей или чужой стене;
* [wall.edit](http://vk.com/dev/wall.edit) – редактирует запись на стене;
* [wall.delete](http://vk.com/dev/wall.delete) – удаляет запись со стены;
* [wall.restore](http://vk.com/dev/wall.restore) – восстанавливает удаленную запись на стене пользователя;
* [wall.getComments](http://vk.com/dev/wall.getComments) – получает комментарии к записи на стене пользователя;
* [wall.addComment](http://vk.com/dev/wall.addComment) – добавляет комментарий к записи на стене пользователя или сообщества;
* [wall.editComment](http://vk.com/dev/wall.editComment) – редактирует комментарий на стене пользователя или сообщества;
* [wall.deleteComment](http://vk.com/dev/wall.deleteComment) – удаляет комментарий текущего пользователя к записи на своей или чужой стене;
* [wall.restoreComment](http://vk.com/dev/wall.restoreComment) – восстанавливает комментарий текущего пользователя к записи на своей или чужой стене;
Использование парсера
---------------------
* Получение сообщений со стены группы; *
* Получение комментариев сообщения со стены группы; *
* Получение лайков сообщения; *
* Получение перепостов сообщения.
(*) Дублирование функционала API
Примеры использования
---------------------
### Получение сообщений по их идентификаторам
>>> from vkontakte_wall.models import Post
>>> Post.remote.fetch(ids=['5223304_130', '-16297716_126261'])
[, ]
### Получение сообщений со стены пользователя через метод пользователя
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> user.fetch_posts()
[, , , '...(remaining elements truncated)...']
Сообщения пользователя доступны через менеджер
>>> user.wall_posts.count()
432
Комментарии всех сообщений пользователя доступны через менеджер
>>> user.wall_comments.count()
73637
### Получение сообщений со стены пользователя через менеджер
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> Post.remote.fetch_user_wall(user=user)
[, , , '...(remaining elements truncated)...']
### Получение сообщений со стены группы через метод группы
>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> group.fetch_posts()
[, , '...(remaining elements truncated)...']
Сообщения группы доступны через менеджер
>>> group.wall_posts.count()
5498
Комментарии всех сообщений группы доступны через менеджер
>>> group.wall_comments.count()
73637
### Получение сообщений со стены группы через менеджер
>>> from vkontakte_groups.models import Group
>>> group = Group.remote.fetch(ids=[16297716])[0]
>>> Post.remote.fetch_group_wall(group=group)
[, , , '...(remaining elements truncated)...']
### Получение комментариев сообщения со стены группы через менеджер
>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> post = user.wall_posts.all()[0]
>>> Comment.remote.fetch_user_post(post=post)
[, , , '...(remaining elements truncated)...']
### Публикация записи на стене
>>> post = Post.objects.create(**param)
>>> print post.text
'message'
или
>>> post = Post()
>>> post.text = 'message'
....
>>> post.save()
>>> post.text
'message'
### Редактирование опубликованной записи
>>> post = Post.objects.get(remote_id='5223304_130')
>>> post.text = 'Edited message'
>>> post.save()
>>> post.text
'Edited message'
### Удаление опупбликованной записи
>>> post.delete() # Запись не удаляется из БД,
>>> post.archived
True # вместо этого аттрибуту archived присваивается True
### Востановление удаленной записи
>>> post.restore() # Запись не создается заново
>>> post.archived
False # вместо этого аттрибуту archived присваивается False
### Публикация коментария к записи на стене
>>> test_comment = Comment.objects.create(**compent_param)
>>> test_comment
или
>>> comment = Comment()
>>> comment.text = 'text'
....
>>> comment.save()
>>> comment.remote_id
'123123_123'
>>> comment.text
'text'
### Редактирование опубликованного комментария
>>> edited_message = 'Edited comment message'
>>> comment = Comment.objects.get(...)
>>> comment.text = 'Edited comment message'
>>> comment.save()
>>> comment.text
'Edited comment message'
### Удаление опупбликованного комментария
>>> test_comment.delete() # Запись не удаляется из БД,
>>> test_comment.archived
True # вместо этого аттрибуту archived присваивается True
### Востановление удаленного комментария
>>> test_comment.restore() # Запись не создается заново
>>> test_comment.archived
False # вместо этого аттрибуту archived присваивается False