Metadata-Version: 1.1
Name: django-facebook-photos
Version: 0.2.1
Summary: Django implementation for Facebook Graph API Photos and Albums
Home-page: https://github.com/ramusus/django-facebook-photos
Author: ramusus
Author-email: ramusus@gmail.com
License: BSD
Download-URL: http://pypi.python.org/pypi/django-facebook-photos
Description: Django Vkontakte Photos
        =======================
        
        [![PyPI version](https://badge.fury.io/py/django-vkontakte-photos.png)](http://badge.fury.io/py/django-vkontakte-photos) [![Build Status](https://travis-ci.org/ramusus/django-vkontakte-photos.png?branch=master)](https://travis-ci.org/ramusus/django-vkontakte-photos) [![Coverage Status](https://coveralls.io/repos/ramusus/django-vkontakte-photos/badge.png?branch=master)](https://coveralls.io/r/ramusus/django-vkontakte-photos)
        
        Приложение позволяет взаимодействовать с фотоальбомами и фотографиями Вконтакте используя стандартные модели Django через Вконтакте API
        
        Установка
        ---------
        
            pip install django-vkontakte-photos
        
        В `settings.py` необходимо добавить:
        
            INSTALLED_APPS = (
                ...
                'oauth_tokens',
                'taggit',
                'vkontakte_api',
                'vkontakte_places,
                'vkontakte_groups',
                'vkontakte_users',
                'vkontakte_photos',
            )
        
            # 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
        --------------------
        
        * [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>,
             '...(remaining elements truncated)...']
        
        Фотоальбомы группы доступны через менеджер
        
            >>> 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>]
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
