djangocms-instagram

A simple but versatile Instagram plugin for your django-cms powered sites.


Keywords
djangocms-instagram
License
BSD-3-Clause
Install
pip install djangocms-instagram==0.1.1

Documentation

djangocms-instagram

http://img.shields.io/travis/mishbahr/djangocms-instagram.svg?style=flat-square Latest Version Downloads License http://img.shields.io/coveralls/mishbahr/djangocms-instagram.svg?style=flat-square

Use djangocms-instagram to display your latest photos or other users photos (from any non-private Instagram account), tagged photos, photos from a place or location or your liked photos.

This project requires django-connected and django-cms v3.0 or higher to be properly installed and configured. When installing the djangocms-instagram using pip, django-connected will also be installed automatically.

Preview

http://mishbahr.github.io/assets/djangocms-instagram/thumbnail/djangocms-instagram-001.png http://mishbahr.github.io/assets/djangocms-instagram/thumbnail/djangocms-instagram-002.png http://mishbahr.github.io/assets/djangocms-instagram/thumbnail/djangocms-instagram-003.png

Quickstart

  1. Install djangocms-instagram:

    pip install djangocms-instagram
    
  2. Add djangocms_instagram to INSTALLED_APPS:

    INSTALLED_APPS = (
        ...
        'connected_accounts',
        'connected_accounts.providers',
        'djangocms_instagram',
        ...
    )
    
  3. To enable Instagram as a provider for django-connected:

    CONNECTED_ACCOUNTS_INSTAGRAM_CONSUMER_KEY = '<instagram_client_id>'
    CONNECTED_ACCOUNTS_INSTAGRAM_CONSUMER_SECRET = '<instagram_client_secret>'
    
  4. Sync database (requires south>=1.0.1 if you are using Django 1.6.x):

    python manage.py migrate
    

Configuration

Plugin(s) Module - If module is None, plugin is grouped Generic group:

DJANGOCMS_INSTAGRAM_PLUGIN_MODULE = _('Generic')

Name of the plugin:

DJANGOCMS_INSTAGRAM_PLUGIN_NAME = _('Instagram')

Can this plugin only be attached to a placeholder that is attached to a page:

DJANGOCMS_INSTAGRAM_PAGE_ONLY = False

A list of Plugin Class Names. If this is set, this plugin may only be added to plugins listed here:

DJANGOCMS_INSTAGRAM_PARENT_CLASSES = None

Is it required that this plugin is a child of another plugin? Or can it be added to any placeholder:

DJANGOCMS_INSTAGRAM_REQUIRE_PARENT = False

Whether this plugin can be used in text plugins or not:

DJANGOCMS_INSTAGRAM_TEXT_ENABLED = False

The path to the default template used to render the template:

DJANGOCMS_INSTAGRAM_DEFAULT_TEMPLATE = 'djangocms_instagram/default.html'

or override the Design dropdown choices to have different design options:

DJANGOCMS_INSTAGRAM_TEMPLATES = (
    ('djangocms_instagram/default.html', _('Default')),
)

You may also like...