skip to navigation
skip to content

Not Logged In

django-vkontakte-users 0.3.6

Django implementation for vkontakte API Users

Latest Version: 0.8.1

Django Vkontakte Users [![Build Status]https://travis-ci.org/ramusus/django-vkontakte-users.png?branch=master]https://travis-ci.org/ramusus/django-vkontakte-users [![Coverage Status]https://coveralls.io/repos/ramusus/django-vkontakte-users/badge.png?branch=master]https://coveralls.io/r/ramusus/django-vkontakte-users
======================

Приложение позволяет взаимодействовать с профилями пользователей Вконтакте через Вконтакте API используя стандартные модели Django

Установка
---------

pip install django-vkontakte-users

В `settings.py` необходимо добавить:

INSTALLED_APPS = (
...
'oauth_tokens',
'vkontakte_api',
'vkontakte_places',
'vkontakte_users',
)

# 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
--------------------

* [users.get]http://vk.com/developers.php?oid=-1&p=users.get - возвращает расширенную информацию о пользователях;
* [friends.get]http://vk.com/developers.php?oid=-1&p=friends.get – возвращает список id друзей пользователя;

Примеры использования
---------------------

### Получение пользователей по ID

>>> from vkontakte_users.models import User
>>> User.remote.fetch(ids=[1,2,6])
[<user: Павел="" Дуров="">,
<user: Александра="" Владимирова="">,
<user: Николай="" Дуров="">]

### Получение пользователя по адресу страницы

>>> from vkontakte_users.models import User
>>> user = User.remote.get_by_slug('durov')
>>> user
<user: Павел="" Дуров="">
>>> user.__dict__
{'_state': <django.db.models.base.modelstate at="" 0xb2eba8c="">,
'about': u'Steve Dogs',
'activity': u'',
'albums': 3,
'audios': 111,
'bdate': u'10.10.1984',
'books': u'',
'city_id': 380,
'counters_updated': datetime.datetime(2012, 3, 14, 0, 13, 14, 819693),
'country_id': 160,
'facebook': u'',
'facebook_name': u'',
'faculty': 15,
'faculty_name': u'Филологический',
'fetched': datetime.datetime(2013, 2, 14, 15, 13, 46, 673793),
'first_name': u'Павел',
'followers': 3437985,
'friends': 524,
'friends_count': 0,
'games': u'',
'graduation': 2006,
'has_mobile': True,
'home_phone': u'',
'id': 2765,
'interests': u'',
'last_name': u'Дуров',
'livejournal': u'durov',
'mobile_phone': u'',
'movies': u"Flying Over Cuckoo's Nest, Rainman, Fight Club, Matrix, Equilibrium, Watchmen",
'mutual_friends': 0,
'notes': 6,
'photo': u'http://cs7003.userapi.com/v7003815/22a1/xgG9fb-IJ3Y.jpg'
'photo_big': u'http://cs7003.userapi.com/v7003685/1ddd/jZ8LZcwYN20.jpg'
'photo_medium': u'http://cs7003.userapi.com/v7003793/2184/qgHVkPyWj6A.jpg'
'photo_medium_rec': u'',
'photo_rec': u'',
'rate': None,
'relation': 1,
'remote_id': 1L,
'screen_name': u'durov',
'sex': 2,
'skype': u'',
'subscriptions': 1,
'sum_counters': 3438644,
'timezone': 3,
'tv': u'',
'twitter': u'durov',
'university': 1,
'university_name': u'СПбГУ',
'user_photos': 4,
'user_videos': 1,
'videos': 9,
'wall_comments': False}

### Получение друзей пользователя

>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> user.fetch_friends()
[<user: Александра="" Владимирова="">, <user: Илья="" Перекопский="">, <user: Николай="" Дуров="">, '...(remaining elements truncated)...']

Друзья пользователя доступны через менеджер

>>> user.friends_users.count()
668

### Получение сообщений со стены пользователя через метод пользователя

Для этого необходимо установить дополнительно приложение
[`django-vkontakte-wall`]http://github.com/ramusus/django-vkontakte-wall/ и добавить его в `INSTALLED_APPS`

>>> from vkontakte_users.models import User
>>> user = User.remote.fetch(ids=[1])[0]
>>> user.fetch_posts()
[<post: ...="">, <post: ...="">, <post: ...="">, '...(remaining elements truncated)...']

Сообщения пользователя доступны через менеджер

>>> user.wall_posts.count()
432

Комментарии всех сообщений пользователя доступны через менеджер

>>> user.wall_comments.count()
73637  
File Type Py Version Uploaded on Size
django-vkontakte-users-0.3.6.tar.gz (md5) Source 2013-07-06 44KB
  • Downloads (All Versions):
  • 163 downloads in the last day
  • 1003 downloads in the last week
  • 3691 downloads in the last month