Gigya Job Openings

Implementing the Social Plugins

Skip to end of metadata
Go to start of metadata

The connector module includes Sitecore Sublayouts (web forms) and View Renderings (MVC) for several Gigya social plugins.

Configuring Plugin Properties

Comments

The Comments plugin enables site visitors to add comments to a page. For more information, see Comments.

Click to enlarge

Comments Plugin Properties:

PropertyDescription

Category ID

Enter a name for the comments/reviews category.
Stream IDEnter a name for the comments/reviews stream.
Version of the comments category

Enter "2" to use version 2 of the Comments/Rating & Reviews plugin (see more information).

The Category ID and Stream ID fields are required. If you leave one of them empty, Sitecore will allow you to save the properties, but the plugin will not load.

 

Rating & Reviews

The Rating & Reviews plugin enables site visitors to rate your content and add their reviews. For more information, see Rating & Reviews.

Click to enlarge

Rating & Reviews Plugin Properties:

PropertyDescription

Category ID

Enter a name for the comments/reviews category.
Stream IDEnter a name for the comments/reviews stream.
Version of the comments category

Enter "2" to use version 2 of the Comments/Rating & Reviews plugin (see more information).

The Category ID and Stream ID fields are required. If you leave one of them empty, Sitecore will allow you to save the properties, but the plugin will not load.

Reactions

The Reactions plugin displays a row of reaction buttons, such as "Funny", "Geeky" and "Inspiring", which site visitors can use to express their opinion of the content and then share that opinion through their social networks. For more information, see Reactions.

Click to enlarge

Reactions Plugin Properties:

PropertyDescription
Button Style

Select from the drop-down list:

SelectionSample Output
Button+Icon+Text
Button+Text
Button+Icon
Icon+Text
Icon Only
Button setThe details of the buttons to display, formatted as an array of JavaScript objects. See the Reactions Setup page in the Gigya Console for more information and a button building wizard.
Counter Style

How to display the number of clicks on each reaction. Select from the drop-down list:

SelectionSample Output
Vertical
Horizontal
None

Share Bar

The Share Bar plugin displays a row of sharing buttons to help your visitors share your content to their various social networks. For more information, see Share Bar.

Click to enlarge

Share Bar Plugin Properties:

PropertyDescription
Display Style

Select from the drop-down list:

SelectionSample Output
Icons Only
Icons + Text
Share + Icons Only
Share icon

Select an icon for general sharing:

SelectionIcon
Style 1
Style 2
ProvidersSelect the provider buttons you want to include in the Share Bar.
Counter Style

Select from the drop-down list:

SelectionSample Output
Horizontal
Vertical
None

Share

The Share plugin enables you to display a sharing pop-up whenever site visitors perform a share-worthy action, e.g. submitting a comment. For more information, see Share.

Share Plugin Properties:

PropertyDescription
Show Email Button

Select whether you want to display the "Email" and "More" buttons in the Share popup:

Show More Button

Adding the Plugins to Your Site

To enable these plugins on your site, you will need to update placeholder settings and include these sublayouts/renderings as allowed controls. For more details, see the Sitecore Client Configuration Cookbook.

Click to enlarge

Once you have configured the placeholder, you will be able to add these plugins in page edit mode (see instructions below).

The plugins are extensible and customizable. They use Sitecore’s parameter templates to define sublayout/rendering parameters. The modules includes a basic set of options for each plugin, to extend or limit the options available for each plugin, navigate to /sitecore/system/Modules/Gigya Connector and update the options. 

To add a Gigya plugin to a page:

  • In the Sitecore Content Editor, navigate to Sitecore > Content and select your site.
  • Select Presentation > Details.
  • In the Layout Details window, select the Final Layout tab and click the Edit link for the Default layout.
  • In the Device Editor window, select the Controls tab and click the Add button.
  • In the Select a Rendering window, Select the desired plugin in the Gigya Connector > Plugins folder.
  • Enter the name of the placeholder you want to add the plugin to, check the "Open the Properties" checkbox and click Select.
    Click to enlarge
  • Select or enter the appropriate properties (see details for each plugin above) and save.
  • In the Publish tab select Publish > Publish Item.
  • In the Publish Item window, make sure the Publish subitems and Publish related items options are not checked, and click the Publish button.

The plugins are extensible and customizable. They use Sitecore’s parameter templates to define sublayout/rendering parameters. The modules includes a basic set of options for each plugin, to extend or limit the options available for each plugin, navigate to
“/sitecore/system/Modules/Gigya Connector” and update the options.

 

 

  • No labels