Metadata-Version: 1.0
Name: collective.facebook.accounts
Version: 1.0b3
Summary: This product allows you to associate Facebook accounts with a Plone site using OAuth authentication.
Home-page: https://github.com/collective/collective.facebook.accounts
Author: Franco Pellegrini
Author-email: frapell@gmail.com
License: GPL
Description: ============================
        collective.facebook.accounts
        ============================
        
        .. contents:: Table of Contents
        
        Life, the Universe, and Everything
        ----------------------------------
        
        This package allows you to associate `Facebook`_ accounts with a Plone site
        using `OAuth`_ authentication.
        
        Facebook accounts are added to the Plone site using a Facebook app. You can
        create your own from Facebook's `App Dashboard`_. Make sure to write down the
        app's "App ID/API Key".
        
        Don't Panic
        -----------
        
        - Go to the "Site Setup", then to the "Facebook" tool.
        - Choose from the "Permissions" section, which permissions you'll need to use.
          You can get further info on each one, from the `Permissions Reference`_
        - Write the "App ID/API Key" from your Facebook app (see prerequisites).
        - Click on "Request user auth"
        - If your browser asks to, click on "Leave this page".
        - Login with the Facebook account you want to use.
        - Allow permission for the app.
        
        Done, you should now be back at your Plone site, and see your account listed
        in the "Accounts" section in the tool.
        
        An expiration date is included too.
        
        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.
        
        Applications
        ^^^^^^^^^^^^
        
        If you want to authorize your application to access the Facebook API,
        for instance to show a portlet with a user's Wall, you can do just that:
        
        - Go to the "Site Setup", then to the "Facebook" tool.
        - Enter the "App/ID/API Key" and "App Secret" in the "Authorize new app"
          section.
        - Click on "Authenticate app".
        
        You should now see your application listed in the "Accounts" section.
        
        Actually posting or getting to/from Facebook
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        This product just saves the needed data in order to use the Facebook API.
        You'll need additional products in order to do so, for example
        `collective.facebook.portlets`_.
        
        Mostly Harmless
        ---------------
        
        Have an idea? Found a bug? Let us know by `opening a support ticket`_.
        
        .. _`Facebook`: http://www.facebook.com/
        .. _`collective.facebook.portlets`: http://pypi.python.org/pypi/collective.facebook.portlets
        .. _`App Dashboard`: https://developers.facebook.com/apps
        .. _`Permissions Reference`: https://developers.facebook.com/docs/reference/api/permissions/
        .. _`OAuth`: http://oauth.net/
        .. _`opening a support ticket`: https://github.com/collective/collective.facebook.accounts/issues
        
        
        Installation
        ------------
        
        To enable this product in a buildout-based installation:
        
        1. Edit your buildout.cfg and add ``collective.facebook.accounts`` to the list
           of eggs to install ::
        
            [buildout]
            ...
            eggs =
                collective.facebook.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.facebook.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.
        
        
        Share and Enjoy
        ---------------
        
        collective.facebook.accounts would not have been possible without the
        contribution of the following people:
        
        * Franco Pellegrini
        * Héctor Velarde
        * Silvestre Huens
        * Mark van Lent
        
        Development sponsored by Open Multimedia.
        
        
        Changelog
        ---------
        
        Because you have to know where your towel is.
        
        1.0b3 (2012-06-18)
        ^^^^^^^^^^^^^^^^^^
        
        - Implement Facebook application authorization. [markvl]
        
        - Add Dutch translations. [markvl]
        
        - Let the plone i18n domain handle some known strings. [markvl]
        
        
        1.0b2 (2012-05-16)
        ^^^^^^^^^^^^^^^^^^
        
        - Fixed uninstallation of control panel configlet. [frapell]
        
        - Tested for Plone 4.2 compatibility. [hvelarde]
        
        
        1.0b1 (2012-04-05)
        ^^^^^^^^^^^^^^^^^^
        
        - Initial release.
        
        
Keywords: plone facebook oauth
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: 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: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
