collective.portlet.twitter 1.0rc1

Twitter Widget Portlet - https://twitter.com/settings/widgets

Table of Contents

• Life, the Universe, and Everything

• Mostly Harmless

• Don’t Panic

  • Installation

  • Usage

• Share and Enjoy

• Changelog

  • 1.0rc1 (2014-09-10)

  • 1.0b3 (2013-10-09)

  • 1.0b2 (2013-06-28)

  • 1.0b1 (2013-04-24)

Life, the Universe, and Everything

This portlet allows you to easily embed and customise JavaScript-based Twitter widgets into your Plone site.

To read and understand more about such widgets, and to create your own, visit https://twitter.com/settings/widgets.

Mostly Harmless

Got an idea? Found a bug? Let us know by opening a support ticket.

Don’t Panic

Installation

To enable this package in a buildout-based installation:

1. Edit your buildout.cfg and add add the following to it:

   [buildout]
   ...
   eggs =
       collective.portlet.twitter

After updating the configuration you need to run ‘’bin/buildout’’, which will take care of updating your system.

Go to the ‘Site Setup’ page in a Plone site and click on the ‘Add-ons’ link.

Check the box next to collective.portlet.twitter and click the ‘Activate’ button.

Note

You may have to empty your browser cache and save your resource registries in order to see the effects of the product installation.

Usage

Create twitter widget:

Configure widget:

Saved:

Get widget id:

Add your widget ID into the Data Widget ID field as follows:

For more information on the variety of client-side options (such as theme, link color, width, height, and so forth) that can be configured within this portlet’s settings, see Twitter’s development documentation at https://dev.twitter.com/docs/embedded-timelines#customization.

Make any customisations you’d like and click Save.

That’s it!

Share and Enjoy

collective.portlet.twitter would not have been possible without the contribution of the following people:

• Thiago Avelino (original developer)

• Gonzalo Almeida

• Héctor Velarde

• David Beitey

You can find an updated list of package contributors on GitHub.

Development sponsored by tv1.com and Open Multimedia.

Changelog

There’s a frood who really knows where his towel is.

1.0rc1 (2014-09-10)

• Add Brazilian Portuguese and Spanish translations. [hvelarde]

• Fix issue with escaping non-basestring values [enkidulan]

1.0b3 (2013-10-09)

• Fix package distribution; we are not including anymore the screenshots used in the documentation reducing significatively the egg size. [hvelarde]

• Fix potential XSS (arbitrary injection) issue by escaping and quoting all attributes being set on the rendered portlet. [davidjb]

1.0b2 (2013-06-28)

• Fix specifying the data-related attribute without a value. [davidjb]

• Add ability to customise portlet header text and ability to show just the Twitter widget (omit border). [davidjb]

• Link portlet title to the user’s Twitter timeline. [davidjb]

• Update descriptions for Twitter client configuration to be end-user readable and add examples. [davidjb]

• Add tweet-limit client-side configuration option to control the number of tweets displayed. [davidjb]

• Add titles and descriptions to the portlet add and edit pages. [davidjb]

• Remove tal:attributes specification from Twitter link in portlet page template. This is already handled by the HTML tag creation code, and lead to rendering failure in some cases (see https://bugs.launchpad.net/zope2/+bug/1004588). [davidjb]

1.0b1 (2013-04-24)

• Initial release.