Package: djangocms-twitter
djangocms-twitteris a upgrade-friendly plugin, mostly derived from original
implementation indjango CMScore.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 anddjangocms-twittercan 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.InstallationFirst-time installationAdddjangocms_twittertoINSTALLED_APPSApply migrations:$ python manage.py migrate djangocms_twitterInsert the plugins in the page and configure them as stated inUsage.Upgrade from the in-core pluginRemovecms.plugins.twitterfromINSTALLED_APPSAdddjangocms_twittertoINSTALLED_APPSApply migrations:$ python manage.py migrate djangocms_twitterModify the plugins instances according toUsage.Check yourTemplates.UsageTwitterRecentEntriesPluginFor 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
astemplatesfor this django CMS plugin:Create the twitter-side widgetLogin in your twitter account;Go tohttps://twitter.com/settings/widgets;Create new widget;Select “user timeline” as source;Configure the options (theme, colours etc) as described inhttps://dev.twitter.com/docs/embedded-timelines;Create widget;get the value ofdata-widget-idin the embed code;Plugin instances datadata-widget-idvalue 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.Add or edit theTwitterplugin in you placeholders;Fill in the Twitter widget it field using thedata-widget-idvalue from
the previous step;Save the plugin;TwitterSearchPluginThe twitter widget used by this plugin is entirely configured on the twitter
website.Create the twitter-side widgetLogin in your twitter account;Go tohttps://twitter.com/settings/widgets;Create new widget;Select “Search” as source;Configure the search query;Configure the options (theme, colours etc) as described inhttps://dev.twitter.com/docs/embedded-timelines;Create widget;get the value ofdata-widget-idin the embed code;Plugin instances dataAdd or edit theTwitter Searchplugin in you placeholders;Fill in the Twitter widget it field using thedata-widget-idvalue from
the previous step;Optionally fill-in the query field in the plugin form; this is only used for
non-javascript enabled browser, as thedata-widget-idwill take over on
javascript-enabled ones;Save the plugin;TemplatesOlder 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; seehttps://dev.twitter.com/docs/embedded-timelines#optionsfor further info.To apply them you need to modify the plugin templates:cms/plugins/twitter_timeline.html: forTwitterRecentEntriesPlugincms/plugins/twitter_search_widget.html: forTwitterSearchPlugin