fluentcms-twitterfeed 1.0.1

Twitter feed widget for django-fluent-contents

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