Metadata-Version: 1.1
Name: collective.portlet.twitter
Version: 1.0b3
Summary: Twitter Widget Portlet - https://twitter.com/settings/widgets
Home-page: https://github.com/collective/collective.portlet.twitter
Author: Thiago Avelino
Author-email: thiagoavelinoster@gmail.com
License: GPLv2
Description: **********************
        Twitter Widget Portlet
        **********************
        
        .. contents:: Table of Contents
        
        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
        ---------------
        
        .. image:: https://secure.travis-ci.org/collective/collective.portlet.twitter.png?branch=master
            :target: http://travis-ci.org/collective/collective.portlet.twitter
        
        .. image:: https://coveralls.io/repos/collective/collective.portlet.twitter/badge.png?branch=master
            :target: https://coveralls.io/r/collective/collective.portlet.twitter
        
        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:
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.54.19%20AM.png
        
        Configure widget:
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.54.58%20AM.png
        
        Saved:
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.55.14%20AM.png
        
        Get widget id:
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.55.14%20AM-Get_id.png
        
        Add your widget ID into the **Data Widget ID** field as follows:
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.53.19%20AM.png
        
        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!
        
        .. image:: https://raw.github.com/collective/collective.portlet.twitter/master/docs/_img/Screen%20Shot%202012-11-09%20at%209.52.39%20AM.png
        
        .. _`opening a support ticket`: https://github.com/collective/collective.portlet.twitter/issues
        
        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
        
        You can find an updated list of package contributors on `GitHub`_.
        
        Development sponsored by `tv1.com`_ and Open Multimedia.
        
        .. _`Thiago Avelino`: https://github.com/avelino
        .. _`GitHub`: https://github.com/collective/collective.portlet.twitter/contributors
        .. _`tv1.com`: http://www.grupotv1.com.br/pt-br/tv1-com/
        
        There's a frood who really knows where his towel is
        ---------------------------------------------------
        
        1.0b3 (2013-10-09)
        ^^^^^^^^^^^^^^^^^^
        
        - 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.
        
Keywords: plone portlet twitter widget
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
