This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

djangocms-twitter is a upgrade-friendly plugin, mostly derived from original implementation in django CMS core.

Due to the switch from v 1.0 to v 1.1 in the twitter API, the original plugin no longer works, and it’s going to be removed.

Other plugin exists (or you could just switch to plain twitter widgets), althogh, it’s still a bit frustrating to throw away existing plugins.

Contrary to the 1.0 API, Twitter 1.1 API requires you to create client side plugins in your profile and djangocms-twitter can do very little to avoid this. It delivers data-compatible plugins for straightforward upgrade.

Some field has been deprecated as no longer used by the twitter widgets. They have been left for easier upgrade.

Installation

First-time installation

  1. Add djangocms_twitter to INSTALLED_APPS

  2. Apply migrations:

    $ python manage.py migrate djangocms_twitter
    
  3. Insert the plugins in the page and configure them as stated in Usage.

Upgrade from the in-core plugin

  1. Remove cms.plugins.twitter from INSTALLED_APPS

  2. Add djangocms_twitter to INSTALLED_APPS

  3. Apply migrations:

    $ python manage.py migrate djangocms_twitter
    
  4. Modify the plugins instances according to Usage.

  5. Check your Templates.

Usage

TwitterRecentEntriesPlugin

For this plugin it’s not necessary to create a widget for every plugin in your website; you could just consider the widget you create on the Twitter website as templates for this django CMS plugin:

Create the twitter-side widget

  1. Login in your twitter account;
  2. Go to https://twitter.com/settings/widgets;
  3. Create new widget;
  4. Select “user timeline” as source;
  5. Configure the options (theme, colours etc) as described in https://dev.twitter.com/docs/embedded-timelines;
  6. Create widget;
  7. get the value of data-widget-id in the embed code;

Plugin instances data

data-widget-id value can be shared by any number of plugins instances, the plugin-provided user timeline will be shown, while the twitter widget graphics appearance will be used.

  1. Add or edit the Twitter plugin in you placeholders;
  2. Fill in the Twitter widget it field using the data-widget-id value from the previous step;
  3. Save the plugin;

TwitterSearchPlugin

The twitter widget used by this plugin is entirely configured on the twitter website.

Create the twitter-side widget

  1. Login in your twitter account;
  2. Go to https://twitter.com/settings/widgets;
  3. Create new widget;
  4. Select “Search” as source;
  5. Configure the search query;
  6. Configure the options (theme, colours etc) as described in https://dev.twitter.com/docs/embedded-timelines;
  7. Create widget;
  8. get the value of data-widget-id in the embed code;

Plugin instances data

  1. Add or edit the Twitter Search plugin in you placeholders;
  2. Fill in the Twitter widget it field using the data-widget-id value from the previous step;
  3. Optionally fill-in the query field in the plugin form; this is only used for non-javascript enabled browser, as the data-widget-id will take over on javascript-enabled ones;
  4. Save the plugin;

Templates

Older templates it’s no longer valid. Most of the graphic configuration must be done in when creating the widget on the Twitter website.

A limited set of client-side options exists to configure the widgets; see https://dev.twitter.com/docs/embedded-timelines#options for further info.

To apply them you need to modify the plugin templates:

  • cms/plugins/twitter_timeline.html: for TwitterRecentEntriesPlugin
  • cms/plugins/twitter_search_widget.html: for TwitterSearchPlugin
Release History

Release History

0.0.5

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
djangocms_twitter-0.0.5-py2.py3-none-any.whl (14.7 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Nov 13, 2015
djangocms-twitter-0.0.5.tar.gz (8.4 kB) Copy SHA256 Checksum SHA256 Source Nov 13, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting