Metadata-Version: 1.1
Name: cs.auth.facebook
Version: 1.2
Summary: Facebook authentication plugin for Plone
Home-page: https://github.com/codesyntax/cs.auth.facebook
Author: Mikel Larreategi
Author-email: mlarreategi@codesyntax.com
License: GPL
Description: Introduction
        ============
        
        A PAS plugin to login into a Plone Site using Facebook.
        
        * Log in to a Plone site through Facebook: when a user requests to log in to the Plone site he will be redirected to Facebook so that he provides the credentials there, then he will be redirected back to the Plone site and will be identified there.
        
        * The user will be a standard Plone user, so Roles or Group membership can be set.
        
        * Minimal user information is kept in Plone such as full name, Facebook ID, photo and e-mail (if available) of the user. This is kept to avoid permanent requests to Facebook API. This information is refreshed each time the user logs in to the site.
        
        
        Installation and getting started
        --------------------------------
        
        1. Buildout
        
           Add `cs.auth.facebook` to your ``buildout.cfg`` eggs list::
        
            [buildout]
            ...
            eggs =
                cs.auth.facebook
                
           Or as a required install dependency of your own addon ``setup.py``::
        
            install_requires=[
                ...
                'cs.auth.facebook',
            ], 
        
        2. Create a new Facebook app at https://developers.facebook.com/app and fill 
           in the required data in the plugin's control panel form.
        
        3. Install the product in the Plone Control Panel and provide the app_id 
           and app_secret in the configuration panel.
        
           Now you see the "Facebook Login" button viewlet. To customize the placement of this
           viewlet please check out the `Plone Viewlet Documentation <http://goo.gl/RyUORn>`_ 
        
        4. Alternatively you can enable an action in portal_actions with the following configuration
           (see ``profiles/default/actions.xml`` within this package)::
        
            <object name="portal_actions" meta_type="Plone Actions Tool"
               xmlns:i18n="http://xml.zope.org/namespaces/i18n">
                <object name="user" meta_type="CMF Action Category">
                    <object name="login_facebook" meta_type="CMF Action" i18n:domain="cs.auth.facebook">
                        <property name="title" i18n:translate="">Log in with Facebook</property>
                        <property name="description" i18n:translate=""></property>
                        <property name="url_expr">string:${globals_view/navigationRootUrl}/@@facebook-login</property>
                        <property name="icon_expr"></property>
                        <property name="available_expr">python:member is None</property>
                        <property name="permissions">
                            <element value="View"/>
                        </property>
                        <property name="visible">False</property>
                    </object>
                </object>
            </object>
        
        
        Behind the scenes
        -----------------
        
        The Facebook Login Viewlet uses the new Facebook JavaScript SDK v4.0 to ensure
        the proper popup for every target device. You don't have to care about this.
        
        For more information on FB JSDK checkout the `Facebook Developers Login Documentation <https://developers.facebook.com/docs/facebook-login/login-flow-for-web/v4.0>`_
        
        
        Credit
        ------
        
        This product re-distributes a lot of code written by Martin Aspeli
        (aka @optilude) in his book "Professional Plone 4 Development" and
        available under GPL license in his personal GitHub account with
        the name 'optilux.facebookauth':
        
          https://github.com/optilude/optilux/tree/chapter-16/src/optilux.facebookauth
        
        
        Compatibility
        =============
        
        Plone 4.x
        Plone 5.x
        
        Changelog
        =========
        
        1.2 (2019-10-09)
        ----------------
        
        - Updated to Facebook API 4.0
          [sarn0ld]
        
        1.1 (2017-05-10)
        ----------------
        
        - Facebook Login with JavaScript SDK v2.1
          [petschki]
        - add Facebook Login Viewlet
          [petschki]
        - disable old style portal_action by default. code is still there (see documentation)
          [petschki]
        - Fix access_token processing
        - Remove Welcome message
        
        1.1b1 (2014-10-22)
        ------------------
        
        - Remove dependency on collective.beaker. Optional Beaker support is available
          with https://pypi.python.org/pypi/Products.BeakerSessionDataManager
          since we use Zope's session_data_manager
          [petschki]
        
        1.0.3 (2014-10-21)
        ------------------
        
        - Add german translation
          [petschki]
        
        - Encoding unicode user credentials.
          see http://goo.gl/63Kyuo for more info
          [petschki]
        
        
        1.0.2 (2014-10-10)
        ------------------
        
        - Fix dependencies includes
          [erral]
        
        1.0.1 (2014-10-10)
        ------------------
        
        - Fix docs
          [erral]
        
        1.0 (2014-10-10)
        ----------------
        
        - Fix user search
          [erral]
        
        - Fix to be able to add the plugin through the ZMI
          [erral]
        
        
        1.0b2 (2012-10-16)
        ------------------
        
        - FaceBook users are now PloneUsers
          [erral]
        
        - Implement user search in storage
          [erral]
        
        - Get properties from self data storage instead of relying on Session
          [erral]
        
        - Change user action name not to clash with Plone's login
          [erral]
        
        
        1.0b1 (2012-07-13)
        ------------------
        
        - Initial release
          [erral]
        
Keywords: plone pas login facebook authentication
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
