1 Introduction

This project contains the open source Grails Facebook SDK Plugin that allows you to integrate the Facebook Platform on a website/app powered by Grails .

This plugin is a port of the official Facebook PHP SDK to Grails 2.0 .

It supports the latest OAuth2.0 authentication (required since October 1st 2011).

Grails Facebook SDK Plugin provides the following Grails artefacts:

• FacebookContext - A Spring bean to get current Facebook context in controllers, when running apps on Facebook.com and websites with the Facebook Platform .
• FacebookGraphClient - A client to call Facebook Graph API which is a wrapper around the rock solid RestFB java library version 1.6.10 (released September 03, 2012).
• FacebookJSTagLib - A collection of tags to easily integrate Facebook JS SDK in your GSPs.

Latest releases

WARNING: Since V2.3.0, Facebook Graph API v2.3 will be used. Make sure that your app is compatible with v2.3 upgrade .

Use grails.plugin.facebooksdk.apiVersion = 'v2.2' to override default behaviour.

Please check FacebookGraphClient doc for more info.

• 2015-05-04 V2.3.0 : v2.3 Facebook Graph API support (from now on, used by default) + RestFB dependency updated to 1.10.1
• 2015-01-08 V2.2.1 : minor bug fix for token for business parsing
• 2014-11-16 V2.2.0 : v2.2 Facebook Graph API support (from now on, used by default) + RestFB dependency updated to 1.7.0
• 2014-10-08 V2.1.0 : v2.1 Facebook Graph API support + RestFB dependency updated to 1.6.16
• 2014-07-28 V2.0.0 : v2.0 Facebook Graph API support
• 2014-05-23 V0.6.4 : version attribute added to initJS tag to choose API version for Facebook JS SDK (v1.0 or v2.0)
• 2014-05-19 V0.6.3 : customSelector attribute and config param added to tag lib
• 2014-04-28 V0.6.2 : bug fix in FacebookContext (use @PostConstruct instead of InitializingBean) to solve reloading issue since Grails 2.3.7 (GRAILS-7799)
• 2014-04-04 V0.6.1 : TagLib update (scripts are only included once in a page even if tags are used more than once)
• 2014-04-02 V0.6.0 : Resources Grails Plugin dependencies removed (to be compatible with Asset Pipeline Grails Plugin)
• 2014-02-12 V0.5.0 : RestFB dependency updated to 1.6.14
• 2013-12-06 V0.4.13 : bug fix in picture tag (secure mode)
• 2013-06-05 V0.4.12 : bug fix in sendLink tag (callback attribute)
• 2013-05-28 V0.4.11 : tokenRetrievalRetryCount config parameter added + doc update
• 2013-04-03 V0.4.10 : RestFB dependency updated to 1.6.12 + bug fix token exchange
• 2013-03-19 V0.4.9 : bug fix token exchange from code with concurrent requests (thanks to elegorod )
• 2013-01-03 V0.4.8 : bug fix token expiration time handling (in Facebook Page tabs)
• 2012-12-20 V0.4.7 : bug fix resources definition
• 2012-12-07 V0.4.6 : bug fix in invite/publish/send tags (encode text as HTML in attributes)
• 2012-12-05 V0.4.5 : bug fix in FacebookSignedRequest appData property
• 2012-11-15 V0.4.4 : for photo/video publishing, FacebookGraphClient publish method accepts now InputStream argument type (instead of FileInputStream only)
• 2012-10-29 V0.4.3 : tag lib improvements: channel integration (initJS tag and FacebookSdkController created), resources plugin integration (FacebookSdkResources created)
• 2012-10-10 V0.4.2 : bug fix in batch responses error handling
• 2012-09-25 V0.4.1 : bug fix in server side OAuth redirect
• 2012-10-25 V0.4.0 : complete refactoring to improve SDK architecture (FacebookContext implemented) and multiple Facebook apps support added
• 2012-09-03 V0.3.6 : RestFB dependency updated to 1.6.10, proxyHost and proxyPort added to config and signedRequest added to filter facebook map
• 2012-08-24 V0.3.5 : proxyHost and proxyPort parameters added to Graph/Rest client (thanks to Eduard Martini)
• 2012-07-23 V0.3.4 : bug fix in facebookAppService
• 2012-07-17 V0.3.3 : readTimeout parameter added to Graph/Rest client + upgrade to Grails 2.1 with wrapper
• 2012-06-12 V0.3.2 : bug fix in filter and plugin config
• 2012-06-12 V0.3.1 : package grails.plugins.facebooksdk renamed to grails.plugin.facebooksdk
• 2012-06-08 V0.3.0 : new documentation based on GDoc, FacebookRestClient added + bug fixes

Bugs

To report any bug, please use the project Issues section on GitHub.

Demo app

If you want to quickly run the SDK on a demo app, you can download Facebook SDK Grails - Demo .

About

The Grails Facebook SDK Plugin is not an official Facebook SDK such as Javascript , PHP , iOS and Android SDKs .

It is developed by AgoraPulse and licensed under the Apache Licence, Version 2.0 .