Socialize Module for Drupal

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 those to their existing Drupal account.

A new section will appear at the bottom of the registration from (see screen shot below), that allows the user to link his existing Drupal account to the Social Network credentials he logged in with:

Public Registrations Settings

This 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.

Widget Design

This following configuration section provides several parameters for configuring the look-and-feel of the Gigya Socialize Login Widget. You can specify captions, sizes and colors:

Advanced Settings

The following section provides some options for advanced UI configuration:

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 Widget.

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:

• login - supported by all the Social Networks.
• notifications - currently supported only by Facebook.
• friends - currently supported by Facebook, MySpace, Twitter and Yahoo.
• status - currently supported by Facebook, MySpace, Twitter and Yahoo.
• newsfeed - currently supported by Facebook and Yahoo.

For example, if you check the "newsfeed" checkbox, your Edit Connections Widget will include only social networks which support newsfeeds. Currently this means that your Edit Connections Widget 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 Widget.

Design customization

You may specify caption, sizes and colors for the Edit Connections Widget. This is done in a similar manner as for the Login Widget.

Advanced Settings

The following section provides some advanced UI configuration settings:

Walkthrough Example

In this example, we would like to pop the "Share" widget each time a user comments on a Story. 

Step 1: Create a new "Share UI of Gigya Socialize" Action. 

Step 2: Configure the Action:

• Edit the Description text: we have concatenated "for Comment" to the default text (as shown in the screenshot below).
• In the Default User Message field, type the text: "!user posted a new comment".

• Hit the "Save" button.

Step 3: Assign Action to Trigger

• Proceed to the Comments Triggers page:  Administer->Site Building->Triggers->Comments.
• Find the relevant Trigger: "After saving a new comment".
• Select the relevant Action: "Share UI of Gigya Socialize for Comment".
• Press the "Assign" button.

That's it! From now on, each time a user comments on a Story, he will be presented with the Share widget, which will give him the option to post his comment to various Social Networks.

In the following example, a user named "Assafeleven Esh" posted a comment on a Story named "Sunday Story":

After pressing the "Share" button, the following item will appear on the Facebook News Feed stream of the user and of his friends:

Advanced: Adding a media item to published user actions

You can add a media item (image/video) to the News Feed items that are published automatically through the "Share UI of Gigya Socialize" action. This involves editing the Gigya Module code.

Here is an example of a published action that includes a video:

To add a media item to published actions, please follow these instructions:

1. Go to the Gigya Module archive that you have downloaded and installed, and search for "gigya.module" file.
2. Open the file in an editor.
3. Search for function gigya_shareUI_mediaItem_js()
4. Add the following code to the beginning of the method, right after the first line of code (instead of the commented code):
   • For Image:

     $mediaItem_js  .= ' mediaItemType="image"; ';
     $mediaItem_js  .= ' mediaItemSrc="INSERT-HERE-YOUR-IMAGE-URL"; ' ;
     $mediaItem_js  .= ' mediaItemHref="INSERT-HERE-URL-OF-A-LINK-TO-ASSOCIATE-WITH-THE-IMAGE"; ' ;
     

     
     For example:

     $mediaItem_js .= ' mediaItemType="image"; ';
     $mediaItem_js .= ' mediaItemSrc="http://www.marketresearchbulletin.com/wp-content/uploads/2009/09/mickey_mouse.jpg"; ' ;
     $mediaItem_js .= ' mediaItemHref="http://disney.go.com/mickeymouse/video2.html"; ' ;
     

   
   
   • For Video:

     $mediaItem_js  .= ' mediaItemType="flash"; ';
     $mediaItem_js  .= ' mediaItemSrc="INSERT-HERE-YOUR-VIDEO-URL"; ';
     $mediaItem_js  .= ' mediaItemPreviewUrl="INSERT-HERE-A-PREVIEW-IMAGE-URL"; ';
     
     

     
     For example:

     $mediaItem_js .= ' mediaItemType="flash"; ';
     $mediaItem_js .= ' mediaItemSrc="http://www.youtube.com/v/fzzjgBAaWZw&hl=en&fs=1"; ';
     $mediaItem_js .= ' mediaItemPreviewUrl="http://graphics8.nytimes.com/images/2006/01/02/science/03cute.large2.jpg"; ';

    

   The complete method should look similar to that:

   function gigya_shareUI_mediaItem_js() {
   
       $mediaItem_js = '';
   
   
       // The code you enter comes here:
       //----------------------------------------------------------------------------------------------------------------
   
       $mediaItem_js  .= ' mediaItemType="image"; ';
       $mediaItem_js  .= ' mediaItemSrc="http://www.marketresearchbulletin.com/wp-content/uploads/2009/09/mickey_mouse.jpg"; ' ; 
       $mediaItem_js  .= ' mediaItemHref="http://disney.go.com/mickeymouse/video2.html"; ' ;  
   
       //-----------------------------------------------------------------------------------------------------------------
   
   
       $mediaItem_js .= ' if (typeof(mediaItemType)!="undefined") { ';
       $mediaItem_js .= '   if  ( null!=mediaItemType && ""!=mediaItemType ) { ';
      $mediaItem_js .= '     if ( mediaItemType=="image" ) { ';
      $mediaItem_js .= '       if (typeof(mediaItemSrc)!="undefined" && typeof(mediaItemHref)!="undefined" ){  ';
      $mediaItem_js .= '         if (null!=mediaItemSrc && ""!=mediaItemSrc && null!=mediaItemHref && ""!=mediaItemHref ) { ';
      $mediaItem_js .= '            var mediaItem = { ';    $mediaItem_js .= '              src: window.mediaItemSrc, ';
      $mediaItem_js .= '              href: window.mediaItemHref, ';
      $mediaItem_js .= '              type: window.mediaItemType ';
      $mediaItem_js .= '            }; ';
      $mediaItem_js .= '            act.addMediaItem(mediaItem);';
      $mediaItem_js .= '         } ';
       $mediaItem_js .= '       } ';
      $mediaItem_js .= '     } '; 
      $mediaItem_js .= '     else { ';/* video */ 
      $mediaItem_js .= '       if (typeof(mediaItemSrc)!="undefined" && typeof(mediaItemPreviewUrl)!="undefined" 
                                              && typeof(mediaItemTitle)!="undefined" && typeof(mediaItemHref)!="undefined"){  ';
      $mediaItem_js .= '         if (null!=mediaItemSrc && ""!=mediaItemSrc && null!=mediaItemPreviewUrl && ""!=mediaItemPreviewUrl 
                                                 && null!=mediaItemHref && ""!=mediaItemHref && null!=mediaItemTitle && ""!=mediaItemTitle) { ';
       $mediaItem_js .= '            var mediaItem = { ';
      $mediaItem_js .= '              src: window.mediaItemSrc, ';
      $mediaItem_js .= '              href: window.mediaItemHref, ';
      $mediaItem_js .= '              title: window.mediaItemTitle, ';
      $mediaItem_js .= '              previewImageURL: window.mediaItemPreviewUrl, ';
      $mediaItem_js .= '              type: window.mediaItemType ';
      $mediaItem_js .= '            }; ';
      $mediaItem_js .= '            act.addMediaItem(mediaItem);';
      $mediaItem_js .= '         } ';
      $mediaItem_js .= '       } ';
      $mediaItem_js .= '     } ';
      $mediaItem_js .= '   } ';
      $mediaItem_js .= ' } ';
   
   return $mediaItem_js;
   
   }