'More Networks' Screen

Skip to end of metadata
Go to start of metadata

 

Gigya offers dozens of additional destinations for social sharing. The additional destinations are provided through a "More" button on the Share add-on (see screenshot below). When the user clicks the "More" button, the Share add-on presents a list of destination icons. If the user clicks on one of the destination icons, Gigya publishes the user action to the selected destination, and the dialog automatically closes.

 

Note: The "More" button is shown by default, but you may hide this button by setting the showMoreButton parameter of the showShareUI API method to "false".

 

Defining the List of "More" Destinations

The moreEnabledProviders, moreDisabledProviders pair of parameters of the showShareUI API method allow you to set which destination site buttons are displayed on the "More" screen, and also determine the order. Each parameter is set with a comma-separated string of destination names. This pair of parameters has a similar logic to the enabledProviders and disabledProviders pair of parameters.

Note: the enabledProviders and disabledProviders pair of parameters define the destination buttons shown on the main Share add-on screen (see Customizing the List of Destinations) while the moreEnabledProviders, moreDisabledProviders pair of parameters define the destination buttons shown on the "More" screen.


Valid destinations for the "More" screen include:
amazon, aolmail, baidu, bitly, blinklist, boxnet, currenttv, delicious, diigo, douban, dropjack, evernote, facebook, fark, faves, formspring, friendfeed, gmail, googlebookmarks, googleplus, hatena, kaboodle, linkagogo, linkedin, microsoft, mixi, mixx, myaol, netlog, newsvine, nkpl, odnoklassniki, pinterest, plaxo, qq, reddit, renren, segnalo, sina, skimbit, spiceworks, stumbleupon, technorati, tuenti, tumblr, twitter, viadeo, vkontakte, whatsapp, xing, yardbarker (Note: messenger has been replaced by microsoft, however, for backward compatibility, either can be used). 

Note: In addition to the above automatic destinations, Gigya supports 150 more destinations. These destinations should be explicitly requested. Please contact us by filling in a support form on our site. You can also access the support page by clicking "Support" on the upper menu of Gigya's site. See the list of destination at the #150 More Explicit Destinations.3a of this page.

 

 
For example:
  • Assuming we would like to support publishing only to Digg, Twitter, Linkedin and Technorati, we will define our params object as follows:

    var params = { 
        userAction: act, 
        moreEnabledProviders: "digg,twitter,linkedin,technorati"
    };
    
  • Assuming we would like to support publishing to all of the destinations except Digg and Technorati, we will define our params object as follows:

    var params = { 
        userAction: act, 
        moreDisabledProviders: "digg, technorati"
    };

Note - The icon next to the "More" button shows the first destination in the "More" screen, in other words, the first provider in the moreEnabledProviders list. The default is delicious.

Running Example

Here is a running example of the Share add-on with enabled "More" button and with customized list of "More" destinations:

 

 

The Example Code

<html>
<head>
    <style>
	 body {font-family:Arial;font-size: 12px; background-color:#fff; line-height:20px}
	</style>
	<SCRIPT type="text/javascript" lang="javascript" 
	   src="http://cdn.gigya.com/JS/gigya.js?apikey=2_Y82PzwJ_chSFImHXaIDJClnLyJzmk-VFOavSsaNTzl6m901s_NNxRAS0xJ3bd3_N">
	   {
		cid: "Share Example page"
	   }
	</SCRIPT>
	<script>
	 
    </script>

    <script type="text/javascript">

        // Create and Publish User's Action
        // This method is associated with the "btnPublishAction" click
        function showShareUI() {

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

		    // Setting the title and description 
		    // (will be presented in the preview on the Share UI)
		    act.setTitle("HOME movie (English with subtitles)");
		    act.setDescription("We are living in exceptional times."
		        + " Scientists tell us that we have 10 years to change the way we live," 
		        + " avert the depletion of natural resources and the catastrophic evolution"
		        + " of the Earth's climate. The stakes are high for us and our children."
		        + " Everyone should take part in the effort, and HOME has been conceived"
		        + " to take a message of mobilization out to every human being.");

            // Setting a link back to the publishing source
		    act.setLinkBack("http://www.youtube.com/watch?v=jqxENMKaeCU");

		    // Adding Action Link
		    act.addActionLink("Watch the movie", 
		        "http://www.youtube.com/watch?v=jqxENMKaeCU&feature=channel_page");

		    // Adding an image (will be presented in the preview on the Share UI)
	        var image = {
	            src: 'http://i3.ytimg.com/vi/jqxENMKaeCU/movieposter.jpg?v=734a3b',
	            href: 'http://youtu.be/jqxENMKaeCU',
	            type: 'image'
	        }
			act.addMediaItem(image);

			// Parameters for the showShareUI method, including the UserAction object
			var params = 
			{
			    userAction: act  // The UserAction object enfolding the newsfeed data.			                                  
			    ,onError: onError  // onError method will be summoned if an error occurs. 
			    ,onSendDone: onSendDone // onError method will be summoned after 
			                        // Gigya finishes the publishing process.

				// Enable the "More" button and screen:
				,showMoreButton: true 

				// Customize the list of destinations in the "More" screen:
				,moreEnabledProviders: "digg, friendfeed, googlebookmarks, technorati, linkedin"

				//  Remove digg and linkedin destinations from the main Share screen (Note - we added these destinations to the "More" screen):
				,disabledProviders: "digg, linkedin"
    			,useHTML: true  // Use the HTML implementation of the add-on (rather than Flash implementation)
			};

			// Show the "Share" dialog
			gigya.socialize.showShareUI(params);
		}

		// onError event handler
		function onError(event) {
		    alert('An error has occurred' + ': ' + event.errorCode + '; ' + event.errorMessage);
		}

		// onSendDone event handler. 
		// Displays in the status field, the list of providers to which the newsfeed has been 
		// successfully published.
		function onSendDone(event)
		{
		    document.getElementById('status').style.color = "green";
		    document.getElementById('status').innerHTML = 
                            'The newsfeed has been posted to: ' 
		            + event.providers;
		}
    </script>
</head>
<body>
    <h4>Please, click the button below to open the "Share" dialog...</h4>
    <input type=button id="btnShare" onclick="javascript:showShareUI()" value="Share" />
    <div id="status"></div>
</body>
</html>

In this example:

  • We alter the list of destinations in the "More" screen and the order in which the buttons appear (by setting the moreEnabledProviders parameter). Please note that "Digg" is the first destination in the list, thus the "Digg" icon appears on the "More" button, which is located on the Share main screen.
  • We remove yahoo and linkedin destinations from the Share main screen (by setting the disabledProviders parameter) and add these destinations to the "More" screen (by setting the moreEnabledProviders parameter).

Notes:

In order to make the above code work in your environment, please note:

  • The API key in the sample will only work on http://localhost/...
  • To load the page from your domain, modify the value of the "APIKey" field in the code to your own Gigya API Key. A Gigya API Key can be obtained from the Site Dashboard page on Gigya's website. Please make sure that the domain from which you are loading the page is the same domain name that you used for generating the API Key.
  • If you are using https, be sure to further adjust the js API url to: https://cdns.gigya.com/JS/gigya.js?apikey=<Your_API_Key>.

168 More Explicit Destinations

In addition to the above automatic destinations, Gigya supports the following 168 destinations: 

a1webmarksadifniaeroaim_shareamenmeAOLAOLBookmarksarto
AskComaviarycapturebizsugarblipblogMarksbobrdobrbonzoboxbordom
brainifybuddymarksBuzzupcamyoocare2ciripciteulikeclassicalplace
clickazoocoliviadeconnoteacosmiqCyworlddesignbumpdesignmoodiggita
diglogdipdivedomelhordoowerdostidotnetkicksdzoneedelight
ekudoselertgadgetembarkonseucliqueifabulously40FacebookSharefarkindafavable
favoritusFeedMeLinksfloss_profnewsfresquifunpfurlfwisp
gabbrgacetillagamesngluvsnapGooglegoogle_readergraveegrumper
habergentrhackernewshadashhothazarkorhedgehogsnethellotxthemidemihipstr
hitmarkshotbookmarkhotklixhtmlvalidatorHyvesidenticainstapaperinvestorlinks
jamespotjumptagskaevurkirtsykledykoornkkudoslaaikit
libreriolinkninjalinkujczlivefavorislunchcommagnoliamecchomeinvz
memorirumeneamemindbodygreenmylinkvaultn4gNetscapePropellernetvouznujij
oknotizieonehundred_zakladokoneviewOrkutosmosusoyylapdfonlinepimpthisblog
pingfmplanypusplurkpolladiumposterouspushaquantcastrawSugar
readitlaterscoopatsekomanshavehshetoldmesmaknewssodaheadsonico
speedtilespruzerspurlstartaidstartlapstrandsstudivzstuffpit
stumpediastylehivesurfpeoplesvejosymbalootagzatailranktellmypolitician
thisnexttipdtulinqtusulvyoomWanelowhoislookupWikio
windycitizenwinkwirefanworiowovrewykopYahooYahooBookmarks
YahooMyWebyammeryazzemyiggyoolinkyorumcuyumyoubookmarksyoumob

These destinations should be explicitly requested. Please contact us by filling in a support form on our site. You can also access the support page by clicking "Support" on the upper menu of Gigya's site.