Installation and Setup

The installation of Drupal for FB is not your typical Drupal process so please pay close attention to the steps below.

Download

You will need two download two files:

• The Drupal for Facebook project file from http://drupal.org/project/fb. Choose the version appropriate for your version of Drupal.
• The Facebook platform from http://svn.facebook.com/svnroot/platform/clients/packages/facebook-platf...

Upload and Unpack

• Upload and unpack the FB module into /sites/all/modules directory on your server.
• While still in your server interface, open the FB module directory that was just created.
• Upload and unpack the Facebook platform (facebook-platform.tar.gz) in the FB module directory.

Configure your Settings.php file

Go to /sites/yoursitedirectory and open your settings.php file. Scroll to the bottom and paste the following:

Important: Facebook client libraries will not work properly if arg_separator.output is not &. The default value is &. Change this in settings.php. Make the value "&"

Canvas Page-Specific Setup

This step is required if your application supports Canvas Pages. If building a Facebook Connect-only application, you can safely skip this.

Enable the FB Theme

Open the FB module themes directory (/sites/all/modules/fb/themes) and copy the fb_fbml directory to /sites/all/themes.

Go to admin > site building > themes and enable the fb_fbml theme by checking its box and saving.

Enable the Drupal for Facebook Modules

Drupal for Facebook comes with several modules. Not all are required. Which ones you enable depends on which features your application supports.

Enable Required Modules

Only the most advanced users will choose not to enable the following.

• DFF Facebook API - Imports and uses the Facebook API
• DFF Applications - Allows Drupal to host Facebook Applications
• DFF User Management - Create local accounts for users of Facebook Apps
• DFF Devel - Blocks and messages that help when developing and debugging Apps. This will help for troubleshooting. To enable this, you need the Devel module. Use only on your development install, not on your production install.

And at least one more...

Also enable one (or both) of the following modules, depending on whether you are building Facebook Connect pages or Canvas pages:

• DFF Canvas Pages - Support for Facebook Canvas Pages.
• DFF Connect - Login to Drupal with Facebook username and password, and other fbConnect features.

Permissions

Go to admin > user management > permissions and give your role permission to administer, create, and edit FB applications. It is assumed that your role is an admin role and you have permission to do this.

Applications

Now, you can configure one or more applications, as described on the next page...