Screenshot of Thor Gallery live at thorsteel.eu

This project is not covered by Drupal’s security advisory policy.

Thor Gallery is a robust gallery wrapper for a Facebook album.

Thor Gallery will make it possible to add any public album on Facebook to your Drupal site. It displays the images in the Facebook album using the AD Gallery frontend.

Requirements

  • Facebook account
  • Public Facebook album
  • Facebook application with App ID and App Secret, see Configuration for help

Dependencies

Thor Gallery depends on the following libraries:

Installation

  1. Install as usual, see Installing contributed modules (Drupal 5 and 6) for further information.
  2. If Facebook PHP SDK isn't installed already, download and unpack it to libraries folder sites/all/libraries/facebook-php-sdk or sites/sitename/libraries in multisite environment.
  3. If AD Gallery isn't installed already, download AD Gallery and unpack it to libraries folder sites/all/libraries/ad-gallery or sites/sitename/libraries in multisite environment.

Configuration

  1. Set up Facebook application:
    1. Go to developers.facebook.com
    2. Log in
    3. Click on Apps in the menu
    4. Click on Create New App button to create the application
    5. Fill in the App name of your choice (everything else is irrelevant) and continue
    6. You're done. Save App ID and App Secret, you'll need them to configure Thor Gallery
  2. Configure Thor Gallery at Administer > Site configuration > Thor Gallery
    1. Set Facebook App ID and App Secret
    2. Set the width and the height of the gallery
    3. Set the delay of the gallery. This will be used to display an image until the next one gets animated in
    4. Set the autostart value of the gallery. If Autostart is checked, slideshow will begin instantly after loading the module
    5. Ensure that the library dependencies are met.
      If all necessary libraries are installed, no errors are displayed on module configuration page. Otherwise follow Installation steps 2-3.

Every Thor Gallery item has a Facebook album URL which will be used to fetch the images. To find the URL of your public Facebook album, navigate to the album and copy the URL from the location bar. The URL should look like http://www.facebook.com/media/set/?set=a.272789389397738.78506.197926163550728&type=1

Troubleshooting

  • "No images in this gallery. Sorry!" displayed despite of the images in a
    Facebook album.
    • Confirm if your App ID and Secret are correct. Check the log
      at Administer > Logging and alerts > Database Logging for clues.
    • Make sure your Facebook album is public (see Requirements).
  • Error "Facebook PHP SDK not found!" displayed. Check library dependencies.
  • Error "AD Gallery library not found!" displayed. Check library dependencies.

Working examples

Drupal 7 version will follow once Drupal 6 version has matured. Watch the space here or follow @tekkie on Twitter for the freshest news.

Project information

Releases