Metadata-Version: 1.0
Name: collective.twitter.accounts
Version: 1.0.3
Summary: Provide Twitter integration for a Plone Site
Home-page: https://github.com/collective/collective.twitter.accounts
Author: Franco Pellegrini
Author-email: frapell@gmail.com
License: GPL
Description: ===========================
        collective.twitter.accounts
        ===========================
        
        .. contents:: Table of Contents
        
        Overview
        --------
        
        This product allows you to add Twitter_ accounts to a Plone site.
        
        It uses oAuth authentication.
        
        Usage
        -----
        
        - Go to the "Site Setup", then to the "Twitter" tool.
        - Choose wether to use Plone's default twitter application (PloneTweet) or a
          custom one.
        - If you choose to use a custom Twitter application, enter your consumer key
          and secret for it.
        - Click on "Request Twitter token".
        - A new link should've appeared below "Allow permission to your account".
          Click it in order to allow the app to use your Twitter account.
        - Copy the given token into the "Token" input field.
        - Click "Add".
        - If something went wrong, you need to click on "Request Twitter token" and
          the following link to get a new token and try again.
        
        Done.
        
        If you want to remove an account, simply click on its red cross next to its
        name. Be carefull, it will delete the account without confirmation, and it
        cannot be undone.
        
        Twitter Applications
        --------------------
        
        In order to allow external access to a twitter account, you need to register
        an "Application" in https://dev.twitter.com/ There's already a "PloneTweet"
        application registered that can be used, but if you want to use your own, just
        regiter it there.
        
        Actually posting or getting to/from Twitter
        -------------------------------------------
        
        This product just saves the needed data in order to post tweets or read them.
        You'll need additional products in order to do so, for example
        `collective.twitter.action`_ or `collective.twitter.portlets`_.
        
        .. _`collective.twitter.action`: http://pypi.python.org/pypi/collective.twitter.action
        .. _`collective.twitter.portlets`: http://pypi.python.org/pypi/collective.twitter.portlets
        .. _Twitter: http://twitter.com/
        
        
        Installation
        ------------
        
        To enable this product in a buildout-based installation:
        
        1. Edit your buildout.cfg and add ``collective.twitter.accounts`` to the list
           of eggs to install ::
        
            [buildout]
            ...
            eggs =
                collective.twitter.accounts
        
        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.twitter.accounts'' 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.
        
        
        Contributors
        ------------
        
        * Franco Pellegrini (frapell@gmail.com)
        
        * Héctor Velarde (hector.velarde@gmail.com)
        
        Development sponsored by Menttes.
        
        Changelog
        ---------
        
        1.0.3 (2012-04-10)
        ^^^^^^^^^^^^^^^^^^
        
        - Fixed distribution. [hvelarde]
        
        
        1.0.2 (2012-04-10)
        ^^^^^^^^^^^^^^^^^^
        
        - Updated tests. [hvelarde]
        - PEP8/Pyflakes. [hvelarde]
        - Updated documentation. [hvelarde]
        - Updated package classifiers. [hvelarde]
        - Moved to GitHub. [frapell]
        - Refactored the package to give its own dev/test buildout. [frapell]
        - Separated profiles for initial and default. [frapell]
        - Added an uninstall profile. [frapell]
        - Added some tests. [frapell]
        - Improved usability with a pop-up to authorize app. [frapell]
        
        
        1.0.1 (2011-07-26)
        ^^^^^^^^^^^^^^^^^^
        
        - Added Spanish internationalization. [frapell]
        
        
        1.0.0 (2011-07-25)
        ^^^^^^^^^^^^^^^^^^
        
        - Created a configlet to add and remove twitter accounts. [frapell]
        - Initial release.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
