Table of contents
- 1. Introduction
- 2. Installing the Gigya Module
- 3. Configuring the Gigya Module
- 3.1. Networks Available to Gigya
- 3.1.1. Required Services for Gigya
- 3.2. Parameters for Login UIConfig
- 3.2.1. Plugin Design
- 3.2.2.
- 3.2.3. Suppress Drupal login
- 3.2.4. Enable Linking of Social Networks Accounts
- 3.2.5. Show Terms Link
- 3.2.6. Advanced LoginUI Settings
- 3.2.7. URL Redirect after Login
- 3.2.8. Custom Login Icons URL
- 3.2.9. LoginUI container ID
- 3.2.10. Login UIConfig Advanced coding
- 3.3. Parameters for Connect UIConfig
- 3.4. Profile Mappings
- 3.1. Networks Available to Gigya
Introduction
The Gigya Module for Drupal provides a single API that aggregates authentication and social APIs from Facebook Connect, MySpace ID, Twitter, Yahoo, LinkedIn, Microsoft and OpenID providers including Google, AOL and WordPress. The Gigya module for Drupal is fully configurable, requiring little time to install.
Gigya’s Module for Drupal makes it easy for Drupal site owners to:
-
Authenticate users via Facebook, MySpace, Twitter, Yahoo, LinkedIn, Google/Orkut, Microsoft and other OpenID providers, thereby increasing site registration rate by over 30%.
-
Increase user acquisition by enabling users to invite friends to the site, or to share site content or a specific event.
-
Increase site traffic by sending user status updates, tweets and newsfeed events to social networks. Drupal site owners can couple user actions on the site with sending social network status updates, tweets, and publishing newsfeed items.
-
Customize the user experience by making it easy for sites to integrate user profile and social graph data.
-
Easily configure user experience, design, and module functionality using the Drupal administration panel.
We invite you to watch our webinar, which provides a walkthrough of the Gigya Module and tips for implementing it on your Drupal site.
Installing the Gigya Module
Installing the Gigya module requires a bit more than downloading and enabling the module. Please follow the Gigya Module installation steps:
-
Download the module here and install, following to the usual module installation process.
-
Create an account in Gigya's website.
-
Configure your site details in the Site settings section of the Gigya website. The Gigya Setup wiki page provides detailed instructions and steps for setting up your site, as well as specific directions for setting up applications in Facebook, MySpace, Twitter, Yahoo, LinkedIn, Google/Orkut and Microsoft. Administrators can either setup applications on the social networks or have Gigya provide these applications for your site.
-
Copy the Gigya API Key and the Secret Key from Gigya's Dashboard page:
On your Drupal site, go to Administer->Site Configuration->Gigya Socialize Settings and paste the Gigya API Key and the Secret Key in the corresponding text fields at the top of the page:
Configuring the Gigya Module
To configure the Gigya Module, login as Site Administrator and then go to Administer->Site Configuration->Gigya Socialize Settings. Your configuration options are:
Networks Available to Gigya
Select the social networks that you wish to make available for user authentication:
Your selection will affect the user interface of the Gigya Login plugin, which will now display the icons of the selected social networks:
Required Services for Gigya
In this section you can determine to which social networks the user can connect and see friends.
Each of the checkboxes represents a social network capability. Not all the social networks have both capabilities. The following list specifies the capabilities of the currently supported providers:
-
login - supported by all the social networks.
-
friends - currently supported by Facebook, Myspace, Twitter, Yahoo and LinkedIn.
For example, if you check the "friends" checkbox, your site will include only social networks that support friend related features.
Parameters for Login UIConfig
In this section you may configure the user interface of the Login block area.
Login configuration options are:
Plugin Design
The following configuration section provides several parameters for configuring the look-and-feel of the Gigya Login Plugin. You can specify captions, sizes and colors:
Suppress Drupal login
If you check the following checkbox, your Login block area will include only Gigya's Login widget and exclude Drupal's standard login.
Enable Linking of Social Networks Accounts
Checking the following checkbox, will enable users to login with their Social Network credentials and map these to their existing Drupal account.
Show Terms Link
By checking the following checkbox, a small "Terms" link will be added to the bottom left corner of the Gigya Login Plugin.
The "Terms" link leads to Gigya's terms of service page.
Advanced LoginUI Settings
The following section provides some options for advanced UI configuration:
URL Redirect after Login
This field provides the option of specifying the URL to which users will be redirected after they log in. The default setting redirects the user to the "user" page. The URL you enter in this field should be relative to your site URL and should not contain an initial or final slash. Please do not enter the entire URL. For example, assuming your site's URL is "www.yoursite.com" and you enter "node/add" in this field. In this case, your users will be redirected to "www.yoursite.com/node/add" after logging in.
Custom Login Icons URL
This field lets you replace the icons of the social network buttons on the Login UI.
To replace the icons, first create a resource library SWF file that contains your custom icons (for guidance, please consult the Create a SWF file which contains your custom icons section), then enter the URL of your SWF file in this field.
LoginUI container ID
In this field, you can define an alternative container in which the Gigya Login Plugin will be displayed. By default, the Plugin is placed in divConnect, which is Drupal's standard Login block area.
Login UIConfig Advanced coding
The Gigya website features a Login Plugin Setup Wizard. This Setup Wizard allows you to modify some settings, while previewing the changes as you make them. The Wizard then generates code that is based on your modifications. You may grab the generated code and paste it into the "Login UIConfig Advanced coding" textbox. The settings which the code in this textbox provides override the corresponding Login UI settings that are defined in this page.
Gigya's Login Plugin Setup Wizard:
Parameters for Connect UIConfig
The Gigya Add Connections Plugin enables you to establish connections to additional social networks and disconnect existing connections. In addition to being able to login using a specific social network, users can connect to additional social networks so that they can send status updates, share with friends, etc. on multiple social networks. This also applies to regular Drupal logged in users. So, users who logged in using the standard Drupal login can now connect to one or more social networks and see their friends, send status updates, etc.
The Gigya Add Connections Plugin appears in My Account -> Edit -> Social Networks:
The Plugin displays user information from each social network to which the user is connected. It also provides a disconnect option and enables the user to connect to all the social networks to which she is not connected.
The configuration section provides several parameters for configuring the look-and-feel of the Gigya Add Connections Plugin.
Connect configuration options are:
Design Customization
You may specify caption, sizes and colors for the Add Connections Plugin. This is done in a similar manner to the Login Plugin (Administer->Site Configuration->Gigya Socialize Settings).
Advanced ConnectUI Settings
The following section provides some options for advanced UI configuration:
Add ConnectionsUI container ID
In this field you may define an alternative container in which you want to display the Gigya Friend Selection Plugin.
Add Connections UIConfig Advanced coding
The Gigya website features a Add Connections Setup Wizard. This Setup Wizard allows you to modify some settings, while previewing the changes as you make them. The Wizard then generates code that is based on your modifications. You may grab the generated code and paste it into the "Connect UIConfig Advanced coding" textbox. The settings which the code in this textbox provides overrides the corresponding Connect UI settings that are defined in this pag
Gigya's Add Connections Plugin Setup Wizard:
Profile Mappings
This section enables you to configure the mapping between user information fields that Gigya provides (by pulling from social networks) and profile fields in the Drupal website. The mapping configuration is used in the user registration; the registration form will be pre-populated with data pulled from the user's social network.
This configuration section includes the list of profile fields defined in your Drupal website. If for example you would like to have usernames combined from a user's first name and age - for exmaple James23, you should use the following tokens: [gigya-firstName]+[gigya-age] in the Drupal username field. The fields that Gigya can provide depend on the social network to which the user is connected to and what information he has provided on that network.
A new section will appear at the bottom of the registration form (see screenshot below), that allows the user to link his existing Drupal account to the social network credentials with which he logged in:
Comments