Skip to main content
https://badge.fury.io/py/djangocms-twitter.png https://pypip.in/d/djangocms-twitter/badge.png

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

Bitdeli badge

Metadata

Release files for djangocms-twitter 0.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for djangocms-twitter 0.0.5
File Size Uploaded Provenance Actions
djangocms-twitter-0.0.5.tar.gz 8.4 kB Without provenance Details for djangocms-twitter-0.0.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for djangocms-twitter 0.0.5
File Interpreter ABI Platform Actions
djangocms_twitter-0.0.5-py2.py3-none-any.whl Python 3, Python 2 none any Details for djangocms_twitter-0.0.5-py2.py3-none-any.whl

Total release size: 23.1 kB

Release files / djangocms-twitter-0.0.5.tar.gz

Download URL djangocms-twitter-0.0.5.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6bc6d2ad9ba43fe697ab0b1023c57ccf8278db4202700d0b26a862baa695fea6
BLAKE2b-256 checksum
How to use checksums
1f5a478751a289fab078498fa2bee7fcfb22c21403faa31dea96ce84d17d1e02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / djangocms_twitter-0.0.5-py2.py3-none-any.whl

Download URL djangocms_twitter-0.0.5-py2.py3-none-any.whl
Size 14.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
8fd4b5181c1e7f3716b390737a59bf2c8d52d1ce1e4c5056ccf11afc2ac37a6a
BLAKE2b-256 checksum
How to use checksums
129b17f56d1997aaa377df7f136131b7fe2ca84df1d05cca6c84ae561797a7dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for djangocms-twitter 0.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page