Social sharing JavaScript API global settings

📘

The content on this page deals with a legacy feature of the ​Akamai​ Identity Cloud (in this case, social sharing). If you are currently an Identity Cloud customer and are using social sharing, that feature is still supported. However, if you’re new to the Identity Cloud, social sharing is no longer available.


When the Social Sharing solution is initialized, it reads some or all of its settings from the janrain.settings object that you will include on each page where sharing is enabled. These settings are included in the JavaScript that is generated when you configure Social Sharing in the Social Login Dashboard.

You may modify these settings per instance of the sharing widget in order to customize the solution where needed. See the Social sharing JavaScript API instance settings section for details on how to override these settings.

Example:

<script type="text/javascript">
 janrain.settings.social = {
 orientation:"vertical",
 providers:[
 "facebook",
 "twitter",
 "email"
 ]
 };
 janrain.settings.appUrl = "https://my-app.rpxnow.com";
 janrain.settings.language = "es-ES";
</script>

appUrl

Required
string

The domain for this application. 


📘

If you are also using Social Login, janrain.settings.appUrl may already be defined on the page. If so, do not include it in the sharing configuration script.


language

Default: en-US
string

The language to use for the Social Sharing UI. Note that for languages other than English, the number of characters in a share message is determined by the URL encoding for those characters.

Available language values:

CodeLanguage
RArabic
bg-BGBulgarian
cs-CZCzech
da-DKDanish
de-DEGerman
el-GRGreek (Modern)
en-USEnglish
es-ESSpanish (Spain)
es-LASpanish (Latin America)
fi-FIFinnish
fr-FRFrench
he-ILHebrew
hr-HRCroatian
hu-HUHungarian
id-IDIndonesian
it-ITItalian
ja-JPJapanese
ko-KRKorean
lt-LTLithuanian
myBurmese
nb-NONorwegian
nl-BEDutch (Belgium)
nl-NLDutch (Netherlands)
pl-PLPolish
pt-BRPortuguese (Brazil)
pt-PTPortuguese (Portugal)
ro-RORomanian
ru-RURussian
sk-SKSlovak
sl-SISlovenian
srSerbian
sv-SESwedish
th-THThai
tr-TRTurkish
uk-UAUkranian
vi-VNVietnamese
zh-CHSChinese (Simplified)
zh-CHTChinese (Traditional)

social.cssUrl

string

The full URL path to a CSS resource to be used for styling the sharing widget.


social.formFactor

Default: bar
Overridden by: string

Available values are bar or drawer. Determines whether the widget’s provider buttons are displayed immediately or if they are hidden until a user clicks the Share button. This value may also be set on the social share HTML element (see the Social sharing JavaScript API instance settings for details).


social.orientation

Default: horizontal
Overridden by: string

Available values are horizontal or vertical. Determines whether the widget’s provider buttons are displayed as a row or column. Recommend using vertical when right-aligning the sharing widget, and horizontal when bottom-aligning the sharing widget. This value may also be set on the social share HTML element (see the Social sharing JavaScript API instance settings for details).


social.providers

Overridden by: array

List of comma-separated identity providers that may be used for sharing. This value may also be set on the social share HTML element (see the Social sharing JavaScript API instance settings for details).

Available provider values:

  • email-google (only for use with the Google OpenID provider)
  • email-mailto
  • email-yahoo
  • facebook
  • linkedin
  • mixi
  • native-facebook
  • native-linkedin
  • native-mixi
  • native-odnoklassniki
  • native-pinterest
  • native-reddit
  • native-sinaweibo
  • native-tumblr
  • native-twitter
  • native-vk
  • native-xing
  • qq
  • tencentweibo
  • twitter
  • xing

social.providerFormats

object

A nested JSON object with key/value pairs mapping a custom share messaging format to a named provider. The initial key is that of the provider (for example, facebook). The value is an object with nested key of a variable and a value of the custom message data.

Attributes that may be used as nested key variables are:

  • description
  • image
  • media
  • message
  • title
  • url

Example:

<script type="text/javascript">
 janrain.settings.social = {
 providerFormats:{
 twitter:{
 message:"{{ message }} - {{ url }}"
 },
 mixi:{
 message:"{{ message }} - {{ url }}"
 },
 }
 }
</script>

social.providerIcons

object

A JSON object with key/value pairs mapping a custom icon to a named provider. The key is that of the provider (for example, facebook). The value is the full URL to the image to use in place of Akamai's default.

<script type="text/javascript">
 janrain.settings.social.providerIcons = {
 "facebook":"https://example.com/facebook.png",
 "native-facebook":"https://example.com/facebook2.png"
 };
</script>

social.shareCountMin

Default: -1
Overridden by: integer

Minimum number of shares before the ShareCount element should be displayed. (Note: The share count does not include those performed via native share methods.) The default value -1 will cause the ShareCount element to be immediately displayed, regardless of sharing activity. This value may also be set on the social share HTML element (see the Social sharing JavaScript API instance settings for details).


social.shareCountMode

Default: none
Overridden by: string

Available values are none or combined. The share count will not be displayed by default. If set to combined, the share count combines Akamai shares with total provider shares. This value may also be set on the social share HTML element (see the Social sharing JavaScript API instance settings for details).