FAQ

How do I change the Provider icons?

This is changed with the providerIcons setting. The default providers icons are approved by the Identity Provider, and changing the images may be a Terms of Service violation. Check with the provider before using this setting.

How do I show the share count?

The share count is displayed by default. It can be removed using a JavaScript setting, or made to appear after a minimum threshold is reached by using the ShareCountMode setting.

Why is the share count so big?

This is explained in the Sharing Count topic.

How are characters counted for languages besides English?

The number of characters in a share message is determined by the URL encoding for those characters.

Why does the Twitter character count differ from displayed characters?

The Twitter count displayed when typing in the message text box takes into account the shortened URL that is being shared. This remains constant no matter what URL shortening service is used, as Twitter uses the same processing for each.

A preview of the formatted message will display just below the textbox.

Why isn’t Authenticated Sharing method available for all providers?

Only some providers have APIs for sharing on their networks. Janrain has developed Sharing for those that support it.

I am seeing the error message “The token URL or xdReceiver has not been whitelisted.”

This message indicates that the domain sending the token URL has not been approved by your application. The domain *.janrain.com is required for share. Social Sharing is integrated with Social Login functionality, and this setting must be added to the Social Login dashboard. Additionally, if testing on a local machine, the domain localhost must be whitelisted as well.

To add a domain to the whitelist, visit the dashboard and navigate to Home > Manage Engage App > Manage Settings. For more information, see Implementing Social Login.

Can I have multiple instances of Social Sharing on the same page, but configured differently?

Yes. The janrain.settings.social settings in the configuration script block can also be set individually in the DIV janrainSocialPlaceholder class. A configuration script block setting (HTML attribute) uses dash notation (data-janrain-my-setting-name), and the corresponding DIV janrainSocialPlaceholder class definition setting uses camelCase notation (mySettingName). See the Definitions Settings for a complete list of attributes that can be configured per instance.