skip to navigation
skip to content

Not Logged In

django-vkontakte-iframe 0.4.1

Django app for developing (aka iframe applications

Django app for developing (aka largest, Russian social network) iframe applications.

Handles user authentication and registration.


$ pip install django-vkontakte-iframe


  • django-annoying for AutoOneToOneField


  • vkontakte >= 1.3 for request.vk_api and for populating cities and countries info via admin action.


  1. Register and configure vkontakte iframe application here:

  2. Add your app’s settings to

    VK_APP_ID = '1234567'                   # Application ID
    VK_APP_KEY = 'M1gytuHwni'               # Application key
    VK_APP_SECRET = 'MiRFwrDYwcYFCTD18EcY'  # Secure key
  3. Add ‘vk_iframe’ to INSTALLED_APPS.

  4. Add ‘vk_iframe.backends.VkontakteUserBackend’ to AUTHENTICATION_BACKENDS:

  5. Put ‘vk_iframe.middleware.AuthenticationMiddleware’, ‘vk_iframe.middleware.IFrameFixMiddleware’ and ‘vk_iframe.middleware.LoginRequiredMiddleware’ to MIDDLEWARE_CLASSES:

        # ...
        # ...
        # ...
        # ...

    Please note that ‘vk_iframe.middleware.AuthenticationMiddleware’ must be after ‘django.contrib.auth.middleware.AuthenticationMiddleware’ but before ‘django.middleware.locale.LocaleMiddleware’.

    ‘vk_iframe.middleware.LoginRequiredMiddleware’ must be after ‘vk_iframe.middleware.AuthenticationMiddleware’.

    Vkontakte visitors will be automatically registered and authorized as django users (username == vkontakte user id).

    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:


    If i18n is in use then vkontakte user’s language will be used as django’s user language.

  6. Run python ./ syncdb (or python ./ migrate vk_iframe if South is used)

  7. Optional: load initial geo data (cities and countries):

    python manage loaddata vk-geo
  8. If you want to store more user data then put the following line as the ‘First API request’ (‘Первый запрос к API’) option (in your app edit page at

  9. For IE: adjust P3P policy header value according to your site privacy policy by providing VK_P3P_POLICY option in your


    Default value is ‘IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT’. See for the full set of tags.

  10. That’s all. All your app’s visitors are now registered and authenticated django users. Additional profile data is available as user.vk_profile. vkontakte.API instance is available as request.vk_api if there is an access token available.


0.4.1 (2013-03-07)

  • django 1.5 support (thanks Maxim Syabro).

0.4 (2012-11-10)

  • request.vk_api with vkontakte.API instance (thanks Anton Smirnov);
  • Workaround for AttributeError in (thanks Evgeniy Kirov);
  • Improved Safari cookie fix (thanks Domantas Jackūnas);
  • IFrameFixMiddleware works now if user agent is not set (thanks Evgeniy Kirov).

0.3 (2011-11-28)

  • Auth backend is fixed (thanks Evgeniy Kirov and;
  • improved README;
  • IE fix: P3P policy headers are added (thanks Maxim Syabro for suggestion);
  • Opera and Safari cookies fix (thanks Evgeniy Kirov);
  • alternative OpenAPI authorization (thanks Evgeniy Kirov).

0.2 (2010-10-30)

  • Vkontakte user language is integrated with django i18n. Thanks Vasyl Nakvasiuk.
  • Error with InnoDB fixture loading is fixed.

0.1.1 (2010-10-09)

Bugfix: login was not allowed if user language was unknown. Full vkontakte language list. Thanks Vasyl Nakvasiuk.

0.1 (2010-09-06)

The first release

File Type Py Version Uploaded on Size
django-vkontakte-iframe-0.4.1.tar.gz (md5) Source 2013-03-07 34KB
  • Downloads (All Versions):
  • 7 downloads in the last day
  • 103 downloads in the last week
  • 456 downloads in the last month