Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Twitter feed widget for django-fluent-contents

Project Description

fluentcms-twitterfeed

Twitter feed widget for django-fluent-contents

Installation

First install the module, preferably in a virtual environment. It can be installed from PyPI:

pip install fluentcms-twitterfeed

Backend Configuration

First make sure the project is configured for django-fluent-contents.

Then add the following settings:

INSTALLED_APPS += (
    'fluentcms_twitterfeed',
)

The database tables can be created afterwards:

python ./manage.py migrate

Now, the TwitterSearchPlugin and TwitterRecentEntriesPlugin can be added to your PlaceholderField and PlaceholderEditorAdmin admin screens.

Frontend Configuration

Make sure that all plugin media files are exposed by django-fluent-contents:

{% load fluent_contents_tags %}

{% render_content_items_media %}

This tag should be placed at the bottom of the page, after all plugins are rendered. For more configuration options - e.g. integration with django-compressor - see the template tag documentation.

CSS Code

The stylesheet code is purposefully left out, since authors typically like to provide their own styling.

JavaScript Code

No configuration is required for the JavaScript integration.

By default, the plugin includes all required JavaScript code.

HTML code

If needed, the HTML code can be overwritten by redefining fluentcms_twitterfeed/recent_entries.html add / or fluentcms_twitterfeed/search.html.

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 template for this content plugin:

  1. Go to https://twitter.com/settings/widgets and create new widget, select “User timeline” as source
  2. Configure the options (theme, colours etc) as described in https://dev.twitter.com/docs/embedded-timelines
  3. Get the value of data-widget-id in the embed code
  4. Add / modify the Recent twitter entries content plugin in django admin, fill in the widget id field using the data-widget-id value from the previous step

Note: 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.

TwitterSearchPlugin

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

  1. Go to https://twitter.com/settings/widgets and create new widget, select “Search” as source
  2. Configure the search query and options (theme, colours etc) as described in https://dev.twitter.com/docs/embedded-timelines
  3. Get the value of data-widget-id in the embed code
  4. Add / modify the Twitter search timeline content plugin in django admin, fill in the widget id field using the data-widget-id value from the previous step
  5. 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

Contributing

If you like this module, forked it, or would like to improve it, please let us know! Pull requests are welcome too. :-)

Release History

This version
History Node

1.0.1

History Node

1.0.0

History Node

0.0.1

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
fluentcms_twitterfeed-1.0.1-py2.py3-none-any.whl
(14.0 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Jan 8, 2018
fluentcms-twitterfeed-1.0.1.tar.gz
(11.7 kB) Copy SHA256 Hash SHA256
Source None Jan 8, 2018

Supported By

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