Facebook SDK Grails Plugin
Groovy Java Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Facebook SDK Grails Plugin


The Facebook Platform is a set of APIs that make your application more social. Read more about integrating Facebook with your web site on the Facebook developer site.

This project contains the open source Facebook SDK Grails 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 V3.1.1 to Grails 2.0.

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

Facebook SDK Grails Plugin provides the following Grails artefacts:


Declare the plugin dependency in the BuildConfig.groovvy file, as shown here:

grails.project.dependency.resolution = {
		inherits("global") { }
		log "info"
		repositories {
				//your repositories
		dependencies {
				//your regular dependencies
		plugins {
				//here go your plugin dependencies
				runtime ':facebook-sdk:0.3.0'


Create a Facebook app on Facebook Developers, in order to get your own app ID and app secret.

Add your Facebook app parameters to your grails-app/conf/Config.groovy:

grails.plugins.facebooksdk.appId = {APP_ID}
grails.plugins.facebooksdk.appPermissions = {APP_PERMISSIONS}
grails.plugins.facebooksdk.appSecret = {APP_SECRET}

Getting started with a demo app

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

Integration with Shiro Grails Plugin

To see an example of integration with Shiro Grails Plugin, you can download Facebook SDK Grails - Shiro demo.


Project documentation is located here :

Latest releases

  • 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


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

Alpha status

This is an alpha release. The underlying APIs are generally stable, however we may make changes to the library in response to developer feedback.


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

It is developped by AgoraPulse.

The Facebook Grails SDK is licensed under the Apache Licence, Version 2.0.