The Gigya Module for Drupal 6 provides a single API that aggregates authentication and social APIs from Facebook Connect, MySpace ID, Twitter, Yahoo, LinkedIn and OpenID providers including Google, AOL and WordPress.

Gigya’s Module for Drupal makes it easy to:

  • Authenticate users via Facebook, MySpace, Twitter and other OpenID providers.
  • Increase site traffic by sending status updates to social networks.
  • Increase user acquisition by enabling people to invite their friends to your site.
  • Customize the user experience by integrating account information from social networks.

There is a webinar, which provides a walkthrough of an older version of the Gigya Module. This video includes tips for implementing Gigya socialize on your Drupal site.

Dependencies

The Gigya module requires an account for Gigya. Administrators can either setup applications on the social network or have Gigya provision those applications for your site.

Although it is not an absolute requirement most of the functionality of the module comes when using Trigger module to configure triggers for actions such as sending a newsfeed update to social networks when a user registers for the site, updates their profile, or posts a comment.

Server time settings are critical to the Gigya Module. In order to secure the process of communicating with the server it is important that the server's time and timezone be set to the correct time.

Before reporting bugs please make sure you are running the latest -dev version or version from CVS. Bugs in the Gigya API should be reported at http://forum.gigya.com -- the module's issue queue is for problems with the Drupal module.

Installation

Installing the Gigya Socialize module requires more than downloading and enabling the module.

Step 1: Setting up your Gigya Account

  1. Sign up for an account on the Gigya website.
  2. After you have an account, configure your 'site details' in the Site setup section. (The Socialize Setup wiki page on Gigya's site provides detailed instructions for the required steps to setup your site, and specific directions for setting up applications in Facebook, MySpace and Twitter.)
  3. For Social Integration:
    • You will need toSet up your own 'applications' on each of the the Social Networks you would like to integrate with on your site. (Gigya can provision those applications for you, but it may take a few days.)
    • Note: For Facebook: make sure to Enable status updates in Facebook.
    • Note: For Google, Yahoo!, and AOL you need to make sure OpenID is checked.
  4. Note the Gigya API Key and the Secret Key from Gigya's Site setup page, you will need these when configuring the Drupal module on your own site.

Step 2: Installing the Gigya module on your Drupal site

  1. Download the module and install per the usual process.
  2. Go to Administer > Site Configuration > Gigya.
  3. Paste the Gigya API Key and the Secret Key in the corresponding text-areas at the top of the page.
  4. Enable the features you would like to use on your site.

Step 3: Configuring Gigya Socialize Actions in Drupal

  1. Go to Administer > Site Configuration > Actions.
  2. Add actions from the Make a new advanced action available section:
    • Share Comments
      • Select share comment data via Gigya....
      • Click Create.
      • Configure the messages that will be displayed to the person posting the comment, as well as what should appear within the social networks.
      • Note that you may want to add the same action 3 different times for when comments are created, updated, and deleted if you want the messages to read differently for each trigger.
    • Share Content
      • Select share node data via Gigya...
      • Click Create.
      • Configure the messages that will be displayed to the person posting the content, as well as what should appear within the social networks.
      • Note that you may want to add the same action 2 or 3 different times for when content is created, updated, created OR updated, and deleted if you want the messages to read differently for each trigger.
    • Share Membership information
      • Select share user data via Gigya...
      • Click Create.
      • Configure the messages that will be displayed to the person changing their profile, as well as what should appear within the social networks.
      • Note that you may want to add the same action 1 - 5 different times for when accounts are created, updated, and deleted, or for when people log in and log out of your site.

Step 4: Configuring Triggers to use your Gigya Socialize Actions in Drupal

  1. Go to Administer > Site Building > Triggers.
  2. Add actions for what your site should do:
    • Share Comments:
      1. Click on the Comments tab.
      2. Assign the action(s) you defined above.
      3. Click Assign.
    • Share Content:
      1. Click on the Content tab.
      2. Assign the action(s) you defined above.
      3. Click Assign.
    • Share Membership information:
      1. Click on the Users tab.
      2. Assign the action(s) you defined above.
      3. Click Assign.

Its imperative that you run update.php after updating the module. Although db changes are usually rare, this can be a common reason why an upgrade results in odd errors.

Gigya Terms of Use

The Gigya Drupal module is licensed under the same license as Drupal core.

The Gigya Platform service (which the module uses) is free for:
1) Non-Production testing and evaluation purposes
2) Production use for non-commercial purposes, so long as not more than one thousand (1,000) unique member site users authenticate via the services in any calendar month.
To learn more, please read the Gigya Member Agreement at: http://www.gigya.com/public/content/agreement.aspx.

Clients who purchase a paid subscription from Gigya receive advanced features, full support, consulting services and a SLA. To learn more please contact Gigya at: http://www.gigya.com/public/Contact