socialize.addEventHandlers

Description

Gigya Socialize generates several global application events for various situations which are driven by user interactions.

Global application events are fired whenever the event they refer to occurs, regardless of what was the action that triggered the event.

This is in contrast to Widget events, which are only fired by the specific Widget they were configured on.

This method allows setting event handlers for each of the supported global events.

To learn more about how to handle events generated by Gigya socialize, please refer to the Events page in the Developer's Guide.

The following is a list of available global application events:

• onLogin - Fired whenever a user is authenticated using either a call to login() or to showLoginUI().
• onLogout - Fired whenever a user logs out using the logout() call.
• onConnect - Fired whenever a user is connected to a provider^?. This might be, for example, as a result of a call to connect() or the user editing his connections, etc.
• onDisconnect - Fired whenever a user is disconnected from a provider. As above, this event will be fired regardless of what was the action that triggered it.

An Event Handler is a JavaScript function with the following signature:

functionName(eventObj)

The single argument - eventObj, contains information about the event and has different data fields for different events. In "Event Handlers - eventObj event data" below, you will find specification of the fields available in the eventObj for each event.

Syntax

gigya.services.socialize.addEventHandlers(conf,params)

Method parameters

conf object

Please refer to the Conf object page for full specifications.

params object members

Response object Data Members

var confObj= {   
     APIKey:'2_fA4cZD0cEmxKUjDdNai8hyK4fZ-Jq7w4qm1x-pkS-7E6NDm90gAmrdcugVoaewUS'  
};  

function DisplayEventMessage(eventObj) {
    alert(eventObj.context.str+' '+eventObj.eventName);
}
 
gigya.services.socialize.addEventHandlers(confObj, { 
    context:{str:'congrats on your'}, 
    onLogin:DisplayEventMessage,
    onConnect:DisplayEventMessage
   }
);

gigya.services.socialize.addEventHandlers(confObj, { 
    context:{str:'sorry to see you'}, 
    onDisconnect:DisplayEventMessage
   }
);

function DisplayEventMessage(eventObj:Object):void {
    trace(eventObj.context.str+' '+eventObj.eventName);
}

function addEventHandlers():void {
	var confObj:Object = {   
		mcRoot:this.root,
		 APIKey:'2_fA4cZD0cEmxKUjDdNai8hyK4fZ-Jq7w4qm1x-pkS-7E6NDm90gAmrdcugVoaewUS'  
	}; 
 
	gigya.services.socialize.addEventHandlers(confObj, { 
		context:{str:'congrats on your'}, 
		onLogin:DisplayEventMessage,
		onConnect:DisplayEventMessage
	   }
	);

	gigya.services.socialize.addEventHandlers(confObj, { 
		context:{str:'sorry to see you'}, 
		onDisconnect:DisplayEventMessage
	   }
	);
}