Installation and setup

Requirements

Non-Drupal

• The developer application added on facebook (to setup the application on facebook's side)
• Facebook client API (See the README.txt for information about PHP4 vs PHP5)<
• simplexml (php 4)

Drupal Modules

• fb - this module (see installation instructions below)
• Actions 2.5 or higher - Allows the module to update the profile pages during cron jobs, page updates, etc..
• Token
• Clean URLs - a core module that should be enabled for links to work properly

Installing the module, theme, and client APIs

1. Choose the right version of Drupal for Facebook.
2. Upload and extract the module into the /sites/"yoursite"/modules folder (not the root modules folder used for core modules)
3. Consult the README.txt in the fb folder you've extracted. It may contain information more up-to-date than this page.
4. Drupal for facebook (fb) uses a Facebook Markup Language theme to render content on the facebook platform. It allows for a different look in the facebook app while still keeping a normal theme when people access your site directly. To install the theme you must link or move the contents of ./fb/themes/ into a Drupal themes directory.
5. For the module to talk with the facebook platform, Drupal for facebook (fb) needs the facebook API. See the README.txt for notes about PHP4 vs PHP5. The default choice depends on which version of Drupal for Facebook used.
   Extract Drupal for facebook (fb) into the ./modules/fb directory, so you have ./modules/fb/facebook-platform/.
6. As instructed by Facebook PHP4 extract and instal Simplexml.
7. Edit the settings.php file (somewhere in the sites directory) to include settings.inc (in this directory). For example:
   
   <?php

//This is at the very end of your settings.php file...

// Drupal for Facebook settings.
require_once "sites/all/modules/fb/fb_settings.inc";
// Note: path could be "profiles/custom/modules/fb/fb_settings.inc" depending on the setup.)
?>
8. Enable the Facebook modules via the drupal admin pages, as usual. This requires the fb.module and fb_app.module to be enabled. It is available but not required to enable the other modules.

Permissions

Once the module is installed a new content type called Facebook Application will be enabled. Set the permissions under node for creating and editing the new content type appropriately.

As facebook users login to your Drupal for facebook application they will be given the option to login to create new users. Consider if any special role and/or single user is needed.