|
|
|
|
Socialize Module for DrupalFrom $1Table of contents
IntroductionGigya Socialize Module for Drupal provides a single API that aggregates authentication and social APIs from Facebook Connect, MySpace ID, Twitter, Yahoo and OpenID providers including Google, AOL and WordPress. The Gigya module for Drupal is fully configurable, requiring little time to install. Gigya’s Socialize Module for Drupal makes it easy for Drupal site owners to:
We invite you to watch our webinar, which provides a walkthrough of the Gigya Socialize Module and tips for implementing it on your Drupal site. Installing the Gigya Socialize ModuleInstalling the Gigya Socialize module requires a bit more than downloading and enabling the module. Please follow the Gigya Module installation steps:
Note: Please make sure you have installed the preliminary required modules, which are defined in the Dependencies section on the Gigya Socialize Module page on drupal.org
Configuring the Gigya Socialize ModuleTo configure the Gigya Socialize Module, login as Site Administrator and then go to Administer->Site Configuration->Gigya. Your configuration options are:
Networks available to socializeSelect the social networks that you wish to make available for user authentication:
Your selection will affect the user interface of the Gigya Login Component, which will now display the icons of the selected social networks:
Share with a friend settingsThis feature enables the user to send a direct message ("notification") in Facebook and Twitter, telling friends about a particular content item and driving traffic back to your site via the link in the notification. Enabling this feature will add a link to the links area at the bottom of each content item. When the user clicks the link, a popup dialog opens, in which the user can select friends and send them a message about the related content item. You may configure the "Share with friends" feature in the following ways:
In the following example, we specify the following configuration: the link text will be "Share with friends" and the link will appear at the bottom of each Page but not at the bottom of each Story. You may also see the specified text for the suggested message: This is a screenshot of the outcome - a "Share with friends" link at the bottom of a Page:
When a user clicks the link, a popup opens enabling the user to select friends. The popup displays the "suggested message" text previously specified. Pressing the "OK" button will send a notification to all selected friends.
Socialize status update optionsThe "status update" feature enables the user to automatically post status updates to his social network profile when creating or editing content on the Drupal site. If you choose to do so, you may add a small "Post update to Social Network" sub-form to the bottom of the Node-Add and Note-Edit forms, as shown in the following screenshot:
Using this sub-form, the user may edit the default suggested status text and select whether or not to post it. If the user decides to post, her status will be updated automatically when pressing the "Save" button. The user's status will be updated on all the social networks to which the user is currently connected and which support status updates. The following social networks currently support status updates: Facebook, Myspace, Twitter, Yahoo.
You may configure the status update feature by:
In the following example, we chose to add the "Post update to Social Networks" sub-form only to Story related forms. We have also edited the suggested status text:
This is a screenshot of the outcome - a "Post update to Social Networks" sub-form at the bottom of a Create Story form. Please note, too, that we have specified a suggested status text:
When the user clicks the "Save" button, his status will be automatically updated on all the social networks to which he is connected. The following screenshot shows the new status posted on Facebook:
Please note the translation of !user, !title and !tinyurl in the status text.
Parameters for Login UIConfigIn this section you may configure the user interface of the Login block area.
Login configuration options are: Required capabilities for login providers
"Provider" refers to a social network or an OpenID provider, such as Facebook, Myspace, Yahoo, Gmail, etc, which is used for authentication and social services. Each checkbox represents capabilities which the provider may possess. Not all the providers possess the entire list of capabilities. The following list specifies the capabilities of each currently supported provider:
For example, if you check the "friends" checkbox, your Socialize Login component will include only providers which support friends. This currently means that your Socialize Login component will include only Facebook, MySpace, Twitter and Yahoo buttons. In the future, however, if more providers support "friends" these providers will automatically figure on the Login component. Suppress Drupal loginIf you check the following checkbox, your Login block area will include only the Gigya Socialize Login component and exclude Drupal's standard login.
Note: Adding "/user" to your site's URL points to a page that includes the standard Drupal login. If you disable the standard Drupal login, the site administrator will be able to log in via the "/user" page.
Allow Public RegistrationsThis section is an extension and refinement of Drupal's standard "User" settings->"Public Registration" section. We have introduced a new option: whether or not to allow users to create regular Drupal accounts outside Socialize.
The first option, which is a new option that is not offered by the standard Drupal "User" settings, means that users can create new accounts only via Socialize registration. This option should be used in conjunction with checking the "Suppress Drupal login" checkbox above. The second and third options allow users to create Drupal accounts directly, without using Socialize. This is possible only if the "Suppress Drupal login" checkbox above is not checked. Component DesignThis following configuration section provides several parameters for configuring the look-and-feel of the Gigya Socialize Login component. You can specify captions, sizes and colors:
Advanced SettingsThe following section provides some options for advanced UI configuration:
URL redirect after loginThis 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, let's assume 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 URLThis 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 which 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 IDIn this field, you can define an alternative container in which the Gigya Login Component will be displayed. By default, the component is placed in divConnect, which is Drupal's standard Login block area. Use Facebook ConnectWhen this checkbox is checked, Gigya Socialize will pop-up the Facebook Connect UI when logging in the user using her Facebook account (i.e., when the user presses the Facebook button on the Login UI). For more information, please refer to Using Facebook Connect. Login UIConfig Advanced codingThe Gigya website features a Login Component Setup Wizard. This Setup Wizard allows you to modify some settings, while previewing the changes as you make them. The Wizard then generates code which 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 Component Setup Wizard:
Parameters for friends UIConfigThe Gigya Socialize Friends Selection component appears inside a popup whenever a user clicks a "Share with Friends" link. The component presents the user's list of friends from all the social networks to which he is connected. The component lets users browse and select a group of friends to whom they can send messages (you can find a screenshot of the Friends Selection component in the Share with a friend settings section above). This configuration section provides several options for configuring the look-and-feel of the Gigya Socialize Friends Selection component. You may specify caption, sizes and colors:
Advanced SettingsThe following section provides some options for advanced UI configuration: FriendsUI container IDIn this field, you can define an alternative container in which the Gigya Friend Selection Component will be displayed Friends UIConfig Advanced codingThe Gigya website provides a Friend Selection Component Setup Wizard. The Setup Wizard lets you modify some settings, while previewing the changes as you make them. The Wizard generates code which is based on your modifications. You may grab the generated code and paste it into the "Friends UIConfig Advanced coding" textbox. The settings provided by the code in this textbox overrides the Friends UI settings above.
Parameters for editConnections UIConfigThe Gigya Socialize Edit Connections component enables ones 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 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 Socialize Edit Connections component appears in My Account -> Edit -> Social Networks:
The component 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 Socialize Edit Connections component. Required services for socialize connect
In this section you can determine which social networks will be available for the user to connect to, using the Edit Connections component. Each of the checkboxes represents a Social Network capability. Not all the Social Networks possess the entire list of capabilities. The following list specifies the capabilities of the currently supported providers:
For example, if you check the "newsfeed" checkbox, your Edit Connections component will include only social networks which support newsfeeds. Currently this means that your Edit Connections component will include only Facebook and Yahoo buttons. In the future, however, if more social networks support newsfeeds they will automatically appear in the Edit Connections component. Design customizationYou may specify caption, sizes and colors for the Edit Connections component. This is done in the same way as for the Friend Selector and Login Components. Advanced SettingsThe following section provides some advanced UI configuration settings: editConnectionsUI container IDIn this field you may define an alternative container in which you want to display the Gigya Friend Selection Component. editConnectionsUI UIConfig Advanced codingThis textbox is for advanced UI customizations. It employs Gigya's UIConfig parameter, which is an XML string that provides detailed control over the look-and-feel of the component. The settings provided by the code in this textbox override the Edit Connections UI settings above. Gigya <=> Drupal Profile MappingsThis section enables one 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. Each profile field includes a dropdown with fields that Gigya can provide. The list of fields that Gigya can provide depends on which social network the user is connected to and what information he has provided on that network.
Socialize Actions and TriggersThe option of using Actions and Triggers constitutes a significant part of the customizable abilities which the Gigya Socialize Module features. The Gigya Socialize Module provides two Drupal advanced actions: These actions need to be created and configured first before they may be used. Once you have configured the Gigya Module Actions, the next step is to proceed to the Triggers Module page and assign these actions to system events.
This section explains how to create and configure the Gigya Socialize Actions, and provides a walkthrough example for each Action.
Post to Gigya Socialize Newsfeed ActionThis action generates and posts a Newsfeed. The Newsfeed feature is currently supported by Facebook and Yahoo. The configuration options for this Action are:
Walkthrough ExampleIn this example, we would like to have a Newsfeed posted each time a user comments on a Story. Step 1: Create a new "Post to Gigya Socialize Newsfeed" Action. Step 2: Configure the Action:
Step 3: Assign Action to Trigger
That's it! From now on, each time a user comments on a Story, a new Action will automatically be added to his Facebook Newsfeed and Yahoo Updates, as shown below:
The above screenshot is of a generated Newsfeed as it appears on Facebook, where: "Assaften" is the user name. "has commented on" is the Default Action (Verb) Message we had defined in step 2. "Sunday Story..." is the title of the Story that the user ("Assaften") has commented on. Update Social Network Status with Gigya Socialize ActionWhen this Action is triggered, the user will be presented with a popup which gives her the option to update her status on her social networks. The configuration options for this Action are:
The following configuration fields are relevant if this Action is triggered by a "Users" Trigger (e.g., "Trigger: After a user account has been created"):
The following configuration fields are relevant, if this Action is triggered by a "Content / Comments" Trigger (e.g., "Trigger: After saving a new comment"):
Walkthrough ExampleIn this example, we would like to update the user's Status each time he creates a new Story. Step 1: Create a new "Update Social Networking Status with Gigya Socialize" Action. Step 2: Configure the Action:
Step 3: Assign Action to Trigger
That's it! From now on, each time a user creates and saves a new Story, he will be presented with the following popup:
Please note the default Update Status message that is suggested to the user (hint - this is the text that we have entered in the Node/comment default message text field in Step 2). If the user chooses to press the "Save" button, his status will be updated on all the Social Networks to which he is connected. Please note the "Never Show this Again" checkbox. If the user decides to check this checkbox, this popup will not be presented to him again.
Tags:
|
||||
|