69 users Sign-in to change your status

The sfFacebookConnectPlugin provides multiples functionalities geared both at making Facebook Connect integration in a symfony website easy and also help develop Facebook applications. This is achieved by smoothly connecting sfGuard (Doctrine AND Propel) with Facebook and helping developers program without worrying about whether the application is FBML or IFrame/Facebook Connect. JavaScript Security WebServices

• Homepage
• Repository
• Report a bug
• Download package
• Browse source

IMPORTANT NOTE the repository is now : http://github.com/fabriceb/sfFacebookConnectPlugin

sfFacebookConnectPlugin is a Facebook Connect plugin for symfony that lets you add easily Facebook connect to your symfony website and/or develop IFrame-FBML agnostic Facebook applications

The sfFacebookConnectPlugin provides multiples functionalities geared both at making Facebook Connect integration in a symfony website easy and also help develop Facebook applications. This is achieved by smoothly connecting sfGuard (Doctrine AND Propel) with Facebook and helping developers program without worrying about whether the application is FBML or IFrame/Facebook Connect.

It is still in EARLY development phase.

It is tested for the moment in two very different environments: Propel/1.0 and Doctrine/1.2. There are nonetheless some issues depending on the versions on some options.

Feedback and questions are more than welcome. Just comment on the blog post: http://www.theodo.fr/blog/2009/08/a-facebook-connect-plugin-for-symfony/

To quickly contribute your patches, just fork the github branch and submit your commits to fabriceb

Developers

Name	Status	Email
Fabrice Bernhard	lead	moc.hctamolla <<ta>> becirbaf
Benjamin Grandfond	developer	rf.odoeht <<ta>> gnimajneb
Damien Alexandre	developer	moc.ega-revelc <<ta>> erdnaxelad
Thomas Parisot	developer	ten.mot-elcno <<ta>> samoht

License

Copyright (c) 2009 Fabrice Bernhard

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Releases for sf 1.4

Version	License	API	Released
1.1.1stable	MIT License	1.1.1stable	27/10/2010

Releases for sf 1.3

Version	License	API	Released
1.1.1stable	MIT License	1.1.1stable	27/10/2010

Releases for sf 1.2

Version	License	API	Released
1.1.1stable	MIT License	1.1.1stable	27/10/2010
1.0.0stable	MIT license	1.0.0stable	16/10/2009

Releases for sf 1.1

Version	License	API	Released
1.1.1stable	MIT License	1.1.1stable	27/10/2010
1.0.0stable	MIT license	1.0.0stable	16/10/2009

Releases for sf 1.0

Version	License	API	Released
1.1.1stable	MIT License	1.1.1stable	27/10/2010
1.0.0stable	MIT license	1.0.0stable	16/10/2009

Join this plugin team

Other releases

Release 1.1.1 - 27/10/2010

Release 1.0.0 - 16/10/2009

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

Installation

• Install the plugin

  $ svn co http://svn.symfony-project.com/plugins/sfFacebookConnectPlugin/trunk sfFacebookConnectPlugin
  

• Create your application on Facebook

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

• Configure your app.yml file with all the correct settings

  # 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 sfGaurdUserProfile schema to add the 3 new columns needed

  # Doctrine schema sample
  sfGuardUserProfile:
    tableName:     sf_guard_user_profile
    columns:
      user_id:          integer(4)
      first_name:       varchar(20)
      last_name:        varchar(20)
      facebook_uid:     integer(4)
      email:            varchar(255)
      email_hash:       varchar(255)
    relations:
      sfGuardUser:
        type: one
        foreignType: one
        class: sfGuardUser
        local: user_id
        foreign: id
        onDelete: cascade
        foreignAlias: Profile

• Enable the auth module in your settings.yml: sfFacebookConnectAuth

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

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

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

• Eventually make myUser.class.php extend sfFacebookUser

• 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