Metadata-Version: 1.1
Name: django-vkontakte-wall
Version: 0.4.6
Summary: Django implementation for vkontakte API Wall
Home-page: https://github.com/ramusus/django-vkontakte-wall
Author: ramusus
Author-email: ramusus@gmail.com
License: BSD
Download-URL: http://pypi.python.org/pypi/django-vkontakte-wall
Description: Django Vkontakte Wall
        =====================
        
        [![PyPI version](https://badge.fury.io/py/django-vkontakte-wall.png)](http://badge.fury.io/py/django-vkontakte-wall) [![Build Status](https://travis-ci.org/ramusus/django-vkontakte-wall.png?branch=master)](https://travis-ci.org/ramusus/django-vkontakte-wall) [![Coverage Status](https://coveralls.io/repos/ramusus/django-vkontakte-wall/badge.png?branch=master)](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',
            )
        
            # 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.getComments](http://vk.com/dev/wall.getComments) – получает комментарии к записи на стене пользователя;
        * [wall.getById](http://vk.com/dev/wall.getById) – получает записи со стен пользователей по их идентификаторам;
        * [wall.getLikes](http://vk.com/dev/wall.getLikes) – Получает информацию о пользователях которым нравится данная запись;
        * [wall.getReposts](http://vk.com/dev/wall.getReposts) – Позволяет получать список репостов заданной записи.
        
        В планах:
        
        * [wall.post](http://vk.com/dev/wall.post) – добавляет запись на стену.
        
        Использование парсера
        ---------------------
        
        * Получение сообщений со стены группы; *
        * Получение комментариев сообщения со стены группы; *
        * Получение лайков сообщения; *
        * Получение перепостов сообщения.
        
        (*) Дублирование функционала API
        
        Примеры использования
        ---------------------
        
        ### Получение сообщений по их идентификаторам
        
            >>> from vkontakte_wall.models import Post
            >>> Post.remote.fetch(ids=['5223304_130', '-16297716_126261'])
            [<Post: ...>, <Post: ...>]
        
        ### Получение сообщений со стены пользователя через метод пользователя
        
            >>> 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
        
        ### Получение сообщений со стены пользователя через менеджер
        
            >>> from vkontakte_users.models import User
            >>> user = User.remote.fetch(ids=[1])[0]
            >>> Post.remote.fetch_user_wall(user=user)
            [<Post: ...>, <Post: ...>, <Post: ...>, '...(remaining elements truncated)...']
        
        ### Получение сообщений со стены группы через метод группы
        
            >>> from vkontakte_groups.models import Group
            >>> group = Group.remote.fetch(ids=[16297716])[0]
            >>> group.fetch_posts()
            [<Post: Coca-Cola: ...>, <Post: Coca-Cola: ...>, '...(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)
            [<Post: ...>, <Post: ...>, <Post: ...>, '...(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)
            [<Comment: ...>, <Comment: ...>, <Comment: ...>, '...(remaining elements truncated)...']
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
