sfFacebookConnectPlugin
=======================

The sfFacebookConnect plugin :

  * helps easily setup a Facebook Connect authentification on a symfony project using sfGuardUser

  * is also a good wrapper to create a Facebook application using symfony
  
I updated the initial implementation to work better with Symfony 1.4 and DoctrineGuard,
where profile data is handled a bit differently (e.g. SfGuardUser has an email_address field).

Installation
------------


  * Install the plugin by cloning the GIT repository:

        $ cd plugins
        $ git://github.com/mbrung/sfFacebookConnectPlugin.git sfFacebookConnectPlugin


  * Create your application on Facebook

        http://www.facebook.com/developers/


  * Configure your `app.yml` file with all the correct settings

        [yml]
        # default values
        all:
          facebook:
            api_key: xxx
            api_secret: xxx
            api_id: xxx
            redirect_after_connect: false
            redirect_after_connect_url: ''
            connect_signin_url: 'sfFacebookConnectAuth/signin'
            app_url: '/my-app'   # the facebook application canvas url
            guard_adapter: ~     # to customise a guard adapter
            js_framework: none # none, jQuery or prototype.
    
        # It is highly recommended to use a js framework if you want a correct experience in IE    
          sf_guard_plugin:
            profile_class: sfGuardUserProfile
            profile_field_name: user_id
            profile_facebook_uid_name: facebook_uid
            profile_email_name: email
            profile_email_hash_name: email_hash
    
          facebook_connect:
            load_routing:     true
            user_permissions: []         


  * Modify your `sfGuardUser` schema to add the 2 new columns needed

        [yml]
        # Doctrine schema sample
        sfGuardUser:
          columns:
            facebook_uid:     integer(4)
            email_hash:       varchar(255)

  * Enable the auth module in your `settings.yml`: `sfFacebookConnectAuth`

        [php]
        all:
          .settings:
            enabled_modules:      [default, sfFacebookConnectAuth]

  * (Optional) Enable the sample module in your `settings.yml`: `sfFacebookConnectDemo`

        [php]
        all:
          .settings:
            enabled_modules:      [default, sfFacebookConnectAuth, sfFacebookConnectDemo]

  * Eventually use the sfFacebook filters
  
  * etc. A lot still needs to be documented.
          
  * Clear your cache

        $ php symfony cc

  * Publish the plugin assets

        $ php symfony plugin:publish-assets