djangocms-twitter2 0.1.1

The easiest way to display tweets for your django-cms powered site, using the latest Twitter 1.1 API. It's a great option for embedding tweets on your site without third-party widgets.

Use djangocms-twitter2 to embed a timeline for Tweets from an individual user, a user’s favorites or any search query or hashtag.

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

Preview

Please click on thumbnail for bigger image.

Quickstart

1. Install djangocms-twitter2:

   pip install djangocms-twitter2

2. Add djangocms_twitter to INSTALLED_APPS:

   INSTALLED_APPS = (
       ...
       'connected_accounts',
       'connected_accounts.providers',
       'djangocms_twitter',
       ...
   )

3. To enable Twitter as a provider for django-connected — you can register an app on Twitter via https://apps.twitter.com/app/new:

   CONNECTED_ACCOUNTS_TWITTER_CONSUMER_KEY = '<twitter_consumer_key>'
   CONNECTED_ACCOUNTS_TWITTER_CONSUMER_SECRET = '<twitter_consumer_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_TWITTER_PLUGIN_MODULE = _('Generic')

Name of the plugin:

DJANGOCMS_TWITTER_PLUGIN_NAME = _('Twitter')

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

DJANGOCMS_TWITTER_PAGE_ONLY = False

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

DJANGOCMS_TWITTER_PARENT_CLASSES = None

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

DJANGOCMS_TWITTER_REQUIRE_PARENT = False

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

DJANGOCMS_TWITTER_TEXT_ENABLED = False

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

DJANGOCMS_TWITTER_DEFAULT_TEMPLATE = 'djangocms_twitter/default.html'

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

DJANGOCMS_TWITTER_TEMPLATES = (
    ('djangocms_twitter/default.html', _('Default')),
)

You may also like…

• djangocms-disqus - https://github.com/mishbahr/djangocms-disqus

• djangocms-fbcomments - https://github.com/mishbahr/djangocms-fbcomments

• djangocms-forms — https://github.com/mishbahr/djangocms-forms

• djangocms-gmaps — https://github.com/mishbahr/djangocms-gmaps

• djangocms-instagram — https://github.com/mishbahr/djangocms-instagram

• djangocms-responsive-wrapper — https://github.com/mishbahr/djangocms-responsive-wrapper

• djangocms-youtube — https://github.com/mishbahr/djangocms-youtube