
*****************************************************************************
Name: Facebook Photos
Author: Hady Osman (hadyos@gmail.com)
Drupal: 6.x
*****************************************************************************

-- SUMMARY --

Are you running a fan page for your organisation that is running on Drupal? Do 
you have a lot photos on your Facebook profile that you would like to share 
'as-is' in your Drupal website? Then this module is exactly what you are after.

Facebook photos synchronises Drupal with your Facebook fan / profile page. This
means that you need only upload photos to Facebook without doing the same task
in Drupal. Another advantage of synching with your Facebook fan / profile page
is that all photos on your website will be referenced and loaded from Facebook; 
meaning that you don't lose any bandwidth when delivering content to users.

The following is a listing of this module's functionality:

	o Synchronise all Facebook albums into custom database tables in your 
	  Drupal instance. Your facebook photos themselves will not be imported, but
	  simply their URL references on facebook.
	  
	o Display your facebook photos in different methods. Currently supported:
	
	    * Standard HTML + CSS display
	    * jQuery lightBox
	    * Zen Flash Gallery


-- REQUIREMENTS --

	o PHP 5.2 or higher versions. 
	o Drupal 6.x. 
	o Facebook PHP Library: http://svn.facebook.com/svnroot/platform/clients/packages/facebook-platform.tar.gz 
	o Facebook API key: http://www.facebook.com/developers/


-- INSTALLATION --

	1. Upload the 'fbphotos' folder into your module directory, 
	
	2. Download the Facebook PHP libraries from http://svn.facebook.com/svnroot/platform/clients/packages/facebook-platform.tar.gz. 
	   Copy the content of the "php" folder into the "facebook-client" folder, 
	    
	3. Create a new application: http://www.facebook.com/developers/createapp.php (more information here: http://developers.facebook.com/get_started.php), leave app default settings. 

	4. Activate the module through your website's modules administration pages, 

	5. Configure the 'Facebook Photos' module by going to its 'Settings' page and setting the following:
	   (a) Facebook API Key
	   (b) Facebook Secret Key
	   (c) UID of the profile or fan page which photos should be ported from
	   
	6. From the 'Facebook Photos' settings page, copy the 'Canvas Callback URL' listed below and update the Facebook application Canvas > Canvas Callback URL,

	7. Synchronise your photos into your local Drupal instance from the 'Albums' tab in the Facebook Photos module.

