HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Optimizely Social Reach

This topic describes Optimizely Social Reach that lets you use a single interface to share tailored and personalized content across social channels, including Twitter, Facebook and LinkedIn.

649649

Requirements

  • No additional license fee.
  • An Optimizely CMS or Commerce installation.
  • Accounts for the social channels to be used.
  • See Platform integration compatibility for package and version information. 

Installing Social Reach

These instructions apply to Social Reach for Optimizely CMS version 7.5 and higher. To install Social Reach, you need a working site with Optimizely CMS 7.5 or higher, with a valid license installed.

Social Reach contains the following:

  • Files. The installed files are located under Modules/Social.
  • Virtual roles. The virtual roles SocialEditors and SocialAdmins are included in the default configuration. You can change the access rights as described in Changing Default Access Rights.
  • Providers. The social channels are created based on a provider model. Available example providers are Twitter, LinkedIn and Facebook. The shortening service is also based on a provider model. The available shortening service provider is bit.ly. Providers are registered in web.config with a default configuration to use Optimizely's accounts as follows:
<social>
      <providers>
        <provider name="Twitter" 
                  consumerKey="" 
                  consumerSecret="" 
                  type="EPiServer.Social.Providers.TwitterProvider, EPiServer.Social.Providers" />
        <provider name="LinkedIn" 
                  consumerKey="" 
                  consumerSecret="" 
                  type="EPiServer.Social.Providers.LinkedInProvider, EPiServer.Social.Providers" />
        <provider name="Facebook" 
                  consumerKey="" 
                  consumerSecret="" 
                  type="EPiServer.Social.Providers.FacebookProvider, EPiServer.Social.Providers" />
        <provider name="Bitly" 
                  providerType="UrlShortener" 
                  consumerKey="" 
                  consumerSecret="" 
                  type="EPiServer.Social.Providers.Bitly, EPiServer.Social.Providers" />
      </providers>
</social>

Changing default access rights

You can change which roles that have access to the different views in Optimizely Social Reach by using the virtual roles SocialEditors and SocialAdmins through the  section in episerverframework.config and web.config for the following elements:

and

How the Social Reach Add-on gadget constructs the auto-input message

This topic explains how the Social Reach Add-on gadget constructs the auto-input message. The message is created when a Social Reach user is posting a message and selects a link. Social Reach then populates the message's Name and Message fields by extracting information from the link per the following logic. The user can accept the values or edit them before sending the message.

  1. The widget gets the contentlink from EditView and sends it to the OutReach panel.
  2. In the OutReach panel, the widget extracts contentData from the contentLink.
  3. Using the following components, the widget populates the OutReach UI components.
  • message.Name = contentData.Name
  • message.MessageBody = contentData["MetaDescription"] or "MainBody" or "Info_Description" (in priority order).

Additional explanation of MessageBody

OutReach uses the contentData Meta Description property if it exists.
If that property has no value, OutReach uses the MainBody property.
If that property has no value, OutReach uses the Info_Description property.

See also: Social Reach Add-on


Did this page help you?