Advanced Sharing

A Full User Action Published on Facebook

Please take a look at the following user action as it appears when published on Facebook:

• This post appears on the user's wall and newsfeed as well as in the newsfeed streams of the user's friends.
• The post can be up to 500 pixels wide.
• The title is also a "Link Back" - clicking the title will link the user to the content source.
• The post can contain one action link with a max of 25 characters.

The Example Code

The following code snip creates and publishes the user action that is presented in the screenshot above:

// Constructing a UserAction Object 
var act = new gigya.socialize.UserAction();

// Setting the Title & Subtitle
act.setTitle("This is my title");
act.setSubtitle("This is my subtitle");

// Setting the Link Back
act.setLinkBack("http://www.gigya.com");

// Setting the Description
act.setDescription("This is my Description");

// Adding a Media Item (video)
var video = {
		        src: 'http://www.youtube.com/v/fzzjgBAaWZw&hl=en&fs=1',
		        previewImageURL: 'http://graphics8.nytimes.com/images/2006/01/02/science/03cute.large2.jpg',
		        type: 'flash'
		    }
act.addMediaItem(video);

// Adding an Action Link
act.addActionLink("Read More", "http://www.gigya.com");


// Publishing the User Action
gigya.socialize.showShareUI({  userAction:act });

The User Action Published on other Social Networks

Yahoo, Myspace, Twitter, and LinkedIn feed items are not as rich as Facebook's newsfeed. Thus, some of the data that we set in the user action in the code above is not presented on the feed streams of these social networks. This section describes, for each social network, which data is published, how and where.

status = User-Message + ". " + title + ": " + Link Back URL

tweet = User-Message + ". " + title + ": " + Link Back URL

The 'image' Media Type

A media object with the type attribute set to 'image' includes the following additional attributes:

• src - the photo URL.
• href - the URL to which the user will be taken if she clicks the photo.

In the following example, we add two images to the UserAction object:

var image = {
		        type: 'image',
		        src: 'http://www.infozoom.ru/wp-content/uploads/2009/08/d06_19748631.jpg',
		        href: 'http://www.infozoom.ru'
		      }

act.addMediaItem(image);

var image2 = {
		        type: 'image',
		        src: 'http://graphics8.nytimes.com/images/2006/01/02/science/03cute.large1.jpg',
		        href: 'http://graphics8.nytimes.com'
		      }

act.addMediaItem(image2)

The 'Flash' Media Type

A media object with the type attribute set to 'flash' includes the following additional attributes:

• src - the URL of the Flash object to be rendered.
• width - the width of the Flash object to be rendered.
• height - the height of the Flash object to be rendered.
• previewImageURL - the URL of a photo that will be displayed in place of the Flash object, until the user clicks it prompting the Flash object to play.
• previewImageWidth - the width of the preview image.
• previewImageHeight - the height of the preview image.

In the following example we added a Flash media item to the UserAction object:

var swf = {
		        type: 'flash',
		        src: 'http://widgets.funny4myspace.com/widgets/pickup/randompick.swf',
		        width: '800',
		        height: '400',
		        previewImageURL: 'http://funny4myspace.com/widgets/pickup/thumbnail.gif',
		        previewImageWidth: '200',
		        previewImageHeight: '90'
		 }

act.addMediaItem(swf);

The 'mp3' Media Type

A media object with the type attribute set to 'mp3' includes the following additional attributes:

• src - The URL of the MP3 file to be played.
• title, artist and album - Strings that describe the MP3 file.

In the following example, we added an MP3 media item to the UserAction object:

var mp3 = {
		        type: 'mp3',
		        src: 'http://www.looptvandfilm.com/blog/Radiohead%20-%20In%20Rainbows/01%20-%20Radiohead%20-%2015%20Step.MP3',
		        title: '15 Step',
		        artist: 'Radiohead',
		        album: 'In Rainbows'
		    }

act.addMediaItem(mp3);

For Video Files - use the 'Flash' Media Type

In the following example, we added a video media item to the UserAction object:

var video = {
		        type: 'flash',
		        src: 'http://www.youtube.com/v/fzzjgBAaWZw&hl=en&fs=1',
		        previewImageURL: 'http://graphics8.nytimes.com/images/2006/01/02/science/03cute.large2.jpg',
		    }
act.addMediaItem(video);

Customizing the List of Destinations

You may customize the list of publishing destinations, using the enabledProviders and disabledProviders parameters of the API method. The parameters receive a comma-separated list of providers to include/exclude.
For example:

• Assuming we would like to support publishing only to Facebook and Myspace, we will define our params object as follows:

  var params = { 
      userAction: act,
      enabledProviders: "facebook,myspace"
  };

• Assuming we would like to support publishing to all of the social networks except LinkedIn, we will define our params object as follows:
  

  var params = { 
      userAction: act,
      disabledProviders: "linkedin"
  };

Valid provider names: 'facebook', 'twitter', 'yahoo', 'messenger', 'linkedin', 'myspace', 'orkut'.