django-vkontakte-iframe 0.3

Django app for developing vk.com (aka vkontakte.ru largest, Russian social network) iframe applications.<br /><br />Handles user authentication and registration.<br />Installation<br /><br />$ pip install django-vkontakte-iframe<br /><br />Usage<br /><br /> 1. Register and configure vkontakte iframe application here: http://vkontakte.ru/apps.php?act=add<br /> 2. Add your app's settings to settings.py:<br /><br /> VK_APP_ID = '1234567' # Application ID<br /> VK_APP_KEY = 'M1gytuHwni' # Application key<br /> VK_APP_SECRET = 'MiRFwrDYwcYFCTD18EcY' # Secure key<br /><br /> 3. Add 'vk_iframe' to INSTALLED_APPS<br /> 4. Add 'vk_iframe.backends.VkontakteUserBackend' to AUTHENTICATION_BACKENDS:<br /><br /> AUTHENTICATION_BACKENDS = (<br /> 'django.contrib.auth.backends.ModelBackend',<br /> 'vk_iframe.backends.VkontakteUserBackend',<br /> )<br /><br /> 5. Put 'vk_iframe.middleware.AuthenticationMiddleware' and 'vk_iframe.middleware.LoginRequiredMiddleware' to MIDDLEWARE_CLASSES:<br /><br /> MIDDLEWARE_CLASSES = [<br /> # ...<br /> 'django.contrib.auth.middleware.AuthenticationMiddleware',<br /> # ...<br /> 'vk_iframe.middleware.AuthenticationMiddleware',<br /> # ...<br /> 'django.middleware.locale.LocaleMiddleware',<br /> # ...<br /> 'vk_iframe.middleware.LoginRequiredMiddleware',<br /> ]<br /><br /> Please note that 'vk_iframe.middleware.AuthenticationMiddleware' must be after 'django.contrib.auth.middleware.AuthenticationMiddleware' but before 'django.middleware.locale.LocaleMiddleware'.<br /><br /> 'vk_iframe.middleware.LoginRequiredMiddleware' must be after 'vk_iframe.middleware.AuthenticationMiddleware'.<br /><br /> Vkontakte visitors will be automatically registered and authorized as django users (username == vkontakte user id).<br /><br /> LoginRequiredMiddleware is an optional. It returns 403 for all unauthorized requests with urls not listed in settings.PUBLIC_URLS. You should enable it for security reasons. Example of PUBLIC_URLS:<br /><br /> PUBLIC_URLS = [<br /> '^admin/$',<br /> '^my-callback/',<br /> ]<br /><br /> If i18n is in use then vkontakte user's language will be used as django's user language.<br /> 6. Run python ./manage.py syncdb (or python ./manage.py migrate vk_iframe if South is used)<br /> 7. Optional: load initial geo data (cities and countries):<br /><br /> python manage loaddata vk-geo<br /><br /> 8. If you want to store more user data then put the following line as the 'First API request' ('? NY? A*???*? ?*??a*?? a* ? A*? A*? N*???*? N*???? ? N* API') option (in your app edit page at vkontakte.ru):<br /><br /> method=getProfiles&uids={viewer_id}&format=json&v=3.0&fields=uid,first_name,last_name,nickname,domain,sex,bdate,city,country,timezone,photo,photo_medium,photo_big,has_mobile,rate,contacts,education<br /><br /> 9. That's all. All your app's visitors are now registered and authenticated django users. Additional profile data is available as user.vk_profile.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Admin,  Callback,  Language,  Migrate,  Public Urls,  Python
Users rating:	0/10