Was this article helpful?

WordPress Plugin

Last modified 09:09, 31 Mar 2014

wordpress

http://wordpress.org/extend/plugins/gigya-socialize-for-wordpress/

Gigya's WordPress plugin is a powerful addition to any WordPress site, enabling a wide range of features that are fully configurable using the WordPress Administration Panels. Prominent features supported by the plugin include:

  • Social Login - allows users to register/login to your WordPress blog or site using their social identity, such as Facebook, Twitter, Google, Yahoo, LinkedIn and more. We offer a simple and trusted external login service and follow all the guidelines that are required by the various platforms. The plugin integrates fully with WordPress's user management system and keeps both WordPress and Gigya synced at all times.

  • Fully configurable user interface design that can be controlled via WordPress's back-office.

  • Share - users can easily share posts with their social networks friends.

  • Comments - enables site users to post comments and have discussions about published content on your site.

  • Gamification - a social loyalty and rewards platform that can be easily embedded in your website, increasing site engagement and making your users' experience more enjoyable.

  • Reactions - allows users to react to content in your site and share their reaction to social networks.

  • Activity Feed - allows users to see the latest actions on a site, according to who performed the actions.

Versions

Gigya's latest module version is 4.0 and it is compatible with WordPress version 3.x.

PHP versions compatibility:
WordPress 3.5, PHP 5.2+
WordPress 3.6+, PHP 5.3+

Installing the Socialize WordPress Plugin

Installing the Socialize WordPress plugin is quick and easy and does not require any programming skills. Everything works out-of-the-box and the plugin is fully configurable through WordPress's Administration Panels.

Please follow the installation steps bellow:

  1. Create an account in Gigya's website.
  2. Access the Gigya Site Settings page and follow the steps described in the Setup Wiki page.
    Make sure you enable status updates in Facebook, by checking the "Enable publishing user actions" checkbox at the "Permissions" page (please see the Permissions page for a detailed explanation).
  3. Download the Gigya WordPress plugin from here.

  4. Access your site’s server through an FTP application.

  5. Upload (copy) the plugin's unzipped folder to the /wp-content/plugins folder.

  6. In your WordPress Administration Panels, click Plugins, on the top menu.

  7. You should see your new plugin listed:

    wp1.gif

    Note - If you don't see Gigya's plugin listed try the following: check the "plugins" folder with your FTP program and see whether "gigya" is located there. If not, upload the files again. If it is located there, delete the files and upload them again.

  8. Click the Activate link below the "Make Your Site Social" plugin name. The page should now show the Gigya plugin as active.

  9. On your WordPress Administration left sidebar you should now see a "Gigya" item. Go to Gigya>Global Settings and enter your Gigya API Key and Gigya Secret Key (Base64-encoded), which can be found on the Gigya's website Dashboard page:

    WP-GigyaBasicSettings.png
     

    Note: Use different Gigya API keys for development and production sites. Before going live change your Gigya API key.

 

Configuration & Customization

This section deals with configuration of the Gigya Plugin through your Wordpress Admin Panel.

Note: alternatively you may configure through direct modifications of the website files or configuration files, and the usage of hooks (read more in the Advanced Customization section below).

To configure the Gigya Plugin through your Wordpress Admin Panel, login as Site Administrator. On the sidebar under 'Gigya', you'll find the following configuration options:

  1. Global Settings
  2. Social Login Settings
  3. Share Settings
  4. Comments Settings
  5. Reactions Settings
  6. Gamification Settings

In Addition, under Appearance>Widgets you will find the following Gigya widgets that you can add to your site:

 

Global Settings

The settings in this section specify the following:

  • Basic configurations for initializing Gigya integration on your site.
  • Advanced configurations (optional) 

 

Field Default  Description
Gigya Socialize API key (no default)
Paste the API key for your site domain that was generated for you at the Gigya site (please refer to Installing the Socialize WordPress Plugin).
Gigya Secret key (no default) Paste the Gigya Secret key for your site domain that was generated for you at the Gigya site (please refer to Installing the Socialize WordPress Plugin).
Data Center US Data Center If you are using an alternative data center (e.g. Europe), please change it here.
List of Providers * The default * setting specifies all available networks. Otherwise type a comma-separated list of networks that you want to include. For the full list of available providers, refer to the global configuration object page. The list of providers will be displayed in the Gigya Social Login plugin.
Language English
The plugin supports localization. In the list, select a supported language for display on your website.
NOTE: If your desired language is not in the list, please refer to the language support section. You then add the relevant string to the Additional Parameters below.
shortURL Always Using this parameter you may determine whether to use Gigya's URL shortening service for URLs, which you publish to social networks using Gigay's API. The optional values for this parameter are:
  • Always (default): always shorten URLs.
  • When Required: shorten URLs when needed - when posting to Twitter, LinkedIn, and Yahoo where the status update is limited to 140 char.
  • 'Never - never shorten URLs.
Additional Parameters (advanced) (no default)
This box enables you to specify configuration options beyond those available in the fields above. For details, please refer to the Additional Parameters (advanced) section below.
For the list of available configuration options, please refer to the Global Conf page.
Technical note: the Global Configuration automatically fulfills the Gigya requirement to insert a Global Conf block of code in the header section of any page of your website that has a Gigya block in the page body (the block calls the main Gigya JavaScript library and initializes the Gigya API. The configuration is passed as an object to the script call).
Enable Google Social Analytics Unchecked Check this checkbox to enable the Google Social Analytics plugin.
For details, please refer to the 3rd-party Analytics Integration page.
Enable Gigya debug log Unchecked Check this checkbox to enable the Gigya Plugin debug log. When checked, the plugin logs all Gigya's requests and responses into Wordpress's logging system. Learn more about configuring the logging system in Wordpress.

 

Additional Parameters (advanced)

Most of the Gigya settings tabs include an "Additional Parameters (advanced)" box. These boxes enable you to specify configuration options beyond those available in the other fields for that tab. The required format is key1=value1|key2=value2...keyi=valuei
For example:

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380560631798.png

Note: The Additional Parameters in all sections override existing configurations, and must be used very carefully.

 
 

Social Login Settings

Gigya's Social Login widget enables customers to log into your site through a social network.
 

 clipboard_1370194908444.png

You can include the Social Login widget on any site page. By default, it is included in the Login and in the Create Account pages. See below how to add the Social Login widget to additional locations in your site.
For more information on the Login plugin, you can refer to the Login plugin page and to the socialize.showLoginUI API method.

 

Field Default  Description
Enable Gigya Social Login Checked Check this checkbox to include Gigya's Social Login in your site.
Button style Standard Specify how Social Login buttons are displayed. The default option is Standard and the other options are Full logos, Sign In With.
Connect Without Login Behavior Login existing user
For users not logged into the site, this field determines login requirements for performing a Gigya social action (for example, sharing, reacting, or commenting).
  • Always login – before proceeding with the Gigya social action, users are first directed to site login.
  • Temp User - adding connection operation will create a new temporary user.
  • Login existing user – social actions are allowed with no requirement to log into the site. Behind the scenes, the following happens when such users successfully access one or more social networks:
    • Registered site users are automatically logged into the site.
    • Other users are logged into the site as temporary users.
Width 210 Specify the display width of the plugin in pixels.
Height 110 Specify the display height of the plugin in pixels.
Post Login Redirect (no default) You can choose to what page your users will be redirected after logging in. To redirect to your blog's home page, please enter http://localhost/wordpress. For your blog admin page, enter http://localhost/wordpress/wp-admin/.
Login Providers   A comma delimited list of providers that should be displayed on this plugin. Valid provider names include: facebook, twitter, yahoo, messenger, google, googleplus, linkedin, aol, foursquare, orkut, instagramrenren, qq, sina, kaixin, vkontakte, blogger, wordpress, typepad, paypal, amazon, livejournal, hyves, verisign, openid, netlog, signon, orangefrance, mixi, yahoojapan, odnoklassniki, spiceworks, livedoor, skyrock, vznet, xing. 
For example, if you would like this plugin to show only the icons of Facebook and Twitter, define: facebook,twitter.
Show terms link unchecked Check this checkbox to display a link to a Gigya terms of use agreement.
Show Complete Registration Form  unchecked Check this checkbox if you have defined required fields in your site registration form. When checked a 'Complete Registration' form will pop up during user social registration, to let the user enter the missing required fields.
Additional Parameters (advanced) LoginUI (no default)
This box enables you to specify configuration options beyond those available in the fields above. For details, please refer to the Additional Parameters (advanced) section.
For the list of available configuration options, please refer to parameters table in the socialize.showLoginUI API page.
Additional Parameters (advanced) AddConnectionsUI (no default)
This box enables you to specify configuration options beyond those available in the fields above. For details, please refer to the Additional Parameters (advanced) section.
For the list of available configuration options, please refer to parameters table in the showAddConnectionsUI API page.
Custom Code (deprecated) (no default) This section enables you to customize the look-n-feel of the Gigya Login plugin on your site. Learn more in the section below.

 

Customizing the Design of Gigya Login Plugin

You can configure the look-n-feel of the Gigya Login plugin displayed in the Wordpress Login and Register pages.

First step: Go to the Plugins' Configuration pages on the Gigya website, choose the Login plugin from the panel on the left-hand side, configure the plugin, and copy the generated code:

wp3.gif

After copying the code from Gigya's website, go to your WordPress Administration Panel (in Settings>Gigya ) and paste the copied code into the compatible text-area (see screenshot below) to apply your preferred configuration.

Note: you do not need to paste the entire code copied from Gigya's widget designers. Please follow these instructions:

You should enter the definition of the login_params object from the code you have obtained in Gigya's Login Plugin wizard. The code you paste into the "Sign in component" text-areas should look similar to the following example

var login_params=
{
    height:400,
    width:200,
    containerID:'componentDiv',
    UIConfig:'<config><body><captions background-color="#919148"></captions><texts color="#C876FF"></texts>
                  <background background-color="#FF6D6D" frame-color="#A4FFFF"></background></body></config>'
};

 

Adding The Social Login Widget to Additional Location in Your Site

To add the Gigya Login widget to additional locations in your WordPress site:

  1. Go to your Administration Panels, click Appearance>Widgets
  2. Drag the 'Gigya Social Optimization' widget to the area of your choice (e.g. to Main Sidebar).
  3. You may configure and edit the widget's texts and appearance according to your preferences. Note: this configuration overrides the global configuration in the Gigya>Social Login Settings page.
  4. Click the 'Save' button (at the bottom) when done.

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380624244138.png

 

Share Settings

The Gigya Share Bar plugin lets the user share stories to social networks.
You can easily integrate the Gigya Share Bar in your WordPress blog by enabling it in the Gigya>Share settings page. You can choose whether to place it at the top or bottom (or both) of each post, and select the share providers you would like to have by writing them in the 'Share Providers' field, separated by a comma. 

 

Field Default  Description
Enable Gigya Share Button Top Choose whether to place the Share Bar at the Top, Bottom or Both of each post. Or, you can choose to disable it by selecting None.
Show counts Right Specify if and where (right or top) to display the number of times a share button was clicked for this product.
Privacy Private The privacy level determines how the user action is presented in each of the Activity Feed plugin tabs. The optional values for this parameter are:
  • 'public' - Public items appear in all tabs with the publisher's identity (user name and image).
  • 'friends' - Friends items appear in the 'Friends' and 'Me' tabs with identity, and anonymously in the 'Everyone' tab.
  • 'private' (default) - Private actions appear in the 'Me' tab, and anonymously in the 'Friends' and 'Everyone' tabs. An exception to this rule: If the item has been shared to social networks, then it will be presented as "identified" (with user name and image) in the 'Friends' tab.
Providers share,facebook-like,twitter-tweet Type a comma-separated list of share buttons to display. For the full list of available providers, refer to the socialize.showShareBarUI API page.
Additional Parameters (advanced) (no default)
This box enables you to specify configuration options beyond those available in the fields above. For details, please refer to the Additional Parameters (advanced) section.
For the list of available configuration options, please refer to parameters table in the socialize.showShareBarUI API page.

 

Comments Settings

The Gigya Comments plugin enables site users to post comments and have discussions about published content on the site. 

The Comments widget is not enabled for your site by default. To add the Comments widget you would need first to Set up a New Comment Category on Gigya's website
Then you would need to enable the Comments and configure it in the Wordpress admin so that it would appear on your site pages. Please go to Gigya>Comments Settings page, check the 'Enable Gigya Comments' checkbox and copy your 'Comments category name' from Gigya's website to the 'Category ID' field in the WordPress plugin configuration page:

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380562782105.png

The rest of the comments configuration fields are optional.

 

Field Default  Description
Enable Gigya Comments No Select Yes to enable the Comments plugin or No to disable it.
Category id (no default) Specify the category ID that you have set up in the Gigya admin site. To learn more please refer to the Setup a New Comment Category on Gigya's website.
Enable Share Providers   A comma delimited list of share providers that should be displayed on this plugin as share options. For the full list of available providers, refer to the socialize.showShareBarUI API page.
Enable Sharing to Activity Feed  External When a user submits a comment, by default the action is published to social networks ('External') only and will not appear on the site's Activity Feed plugin. To change this behavior, you must change the publish scope to 'Both'.
Additional Parameters (advanced) (no default)
This box enables you to specify configuration options beyond those available in the fields above. For details, please refer to the Additional Parameters (advanced) section.
For the list of available configuration options, please refer to parameters table in the comments.showCommentsUI API page.

 

Reactions Settings

The Gigya Reactions plugin enables users to share defined reactions to site products on user social networks. This plugin displays a set of buttons like the following in a webpage:

Reactions_counters.gif

The buttons are fully customizable through the admin configuration.
Note: in the default configuration reaction buttons are not defined. You would need to add them in the configuration so that they would appear on your product pages.

Please go to Gigya>Reactions Settings page, check the 'Enable Gigya Reactions' checkbox and define your 'Reaction Buttons'.

Reaction Buttons Definition

The reactions are defined by a comma separated list of JSON objects. Each object defines a single Reaction button to be displayed in the reactions bar. Please refer to the Reaction object for the specification of the object structure.

You may also use Gigya's Reactions wizard. Make sure you are logged-in to Gigya's website, you may access the wizard by clicking the "Plugins" tab, and then the "Reactions" on the side bar.
Note: If you copy Reactions from the Reactions wizard, please make sure that you paste only the Reactions buttons' objects and not the entire code.

Reactions Code Sample:

The following sample code displays these Reaction buttons  clipboard_1370267355109.png
{
    text: 'Amazing',
    ID: 'amazing',
    iconImgUp:'http://cdn.gigya.com/gs/i/reactions/icons/Amazing_Icon_Up.png',
    iconImgOver:'http://cdn.gigya.com/gs/i/reactions/icons/Amazing_Icon_Down.png',
    tooltip:'This item is amazing',
    feedMessage: 'This is amazing!',
    headerText:'Your reaction to this post is \'Amazing\''
}
,{
    text: 'Geeky',
    ID: 'geeky',
    iconImgUp:'http://cdn.gigya.com/gs/i/reactions/icons/Geeky_Icon_Up.png',
    iconImgOver:'http://cdn.gigya.com/gs/i/reactions/icons/Geeky_Icon_Down.png',
    tooltip:'This item is geeky',
    feedMessage: 'This is geeky!',
    headerText:'Your reaction to this post is \'Geeky\''
}

 

Gamification Settings

Gigya Gamification is a social loyalty and rewards platform that you can embed in your website, increasing site engagement and making your users' experience more enjoyable.

 gm.gif

 

Enabling and Configuring the Gamification

To add Gamification to your site, you'll need to follow the following steps:

1. Make sure that Gamification is part of your Gigya site package

Gamification is a premium platform that requires separate activation. If Gamification is not part of your site package please contact your Gigya account manager or contact us by filling in a support form on our site. You can also access the support page by clicking "Support" on the upper menu of Gigya's site.

2. Add Gamification Widgets to your Wordpress Site
  1. In the Wordpress Admin, please go to Appearance>Widgets
  2. Drag 'Gigya Gamification' widget to the area of your choice (e.g. to Main Sidebar).
  3. Within the 'Gigya Gamification', select the type of the widget. There are four types:
  4. Configure the widget.
     Note: you may add several 'Gigya Gamificationwidgets, each with different type. We recommend placing them one below the other.

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380623917941.png

3. Configure the Gamification in the Wordpress admin

In the Wordpress Admin, please go to Gigya>Gamification Settings page, choose whether or not to enable Notification and hit the 'Save Changes' button.

 

Follow Bar

The Follow Bar plugin allows you to easily place in your site a bar with different buttons for following news and keeping updated through different communications channels, such as a Facebook page, a Twitter account, a newsletter, a blog, etc. The Follow Bar plugin is built out of one or more buttons, arranged horizontally or vertically in a bar. Each button represents one of the supported providers:

follow_bar1.gif

Once a user clicks one of the buttons, a "follow" action takes place; taking the user to a new window, or redirecting the user, or opening a provider-specific dialog.

To add the Follow Bar to your Wordpress site:
  1. Please go to Appearance>Widgets 
  2. Drag the 'Gigya Follow Bar' widget to the area of your choice (e.g. to Main Sidebar).
  3. Within the widget, define Follow Bar ButtonsThe buttons are defined by a comma separated list of JSON objects. Each object defines a single Follow Button to be displayed in the reactions bar. Please refer to the FollowButton objects for the specification of the object structure.
  4. Optional - configure title, layout and icon size.
  5. ​Hit the Save button.

  File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380623744382.png

 

Activity Feed

The Gigya Activity Feed plugin enables users to see the latest actions on a site, according to who performed the actions. The Activity Feed plugin can display elements like the following in a webpage:

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/050_Magento/clipboard_1370273404186.png

The following plugins support Activity Feed:

This means that actions that are performed on the above plugins (e.g. user shared a product) may be reflected in the Activity Feed.
For Share, Reactions, and Comments, you may specify whether the actions are displayed in an Activity Feed plugin implemented for the site. By default the actions are only published to social networks and are not displayed on the site's Activity Feed plugin. You may change the default by choosing 'Both'" in the 'Enable Sharing to Activity Feed' field of the Share, Reactions, and Comments configuration.

To add the Activity Feed to your Wordpress site:
  1. Please go to Appearance>Widgets 
  2. Drag the 'Gigya Activity Feed' widget to the area of your choice (e.g. to Main Sidebar).
  3. Optional - configure title, Initial Tab, Site Name and width.
  4. ​Press the Save button.

 File:015_Partners/030_CMS_and_Ecommerce_Platforms/030_Wordpress_Plugin/clipboard_1380626378186.png

 

Advanced Customization

Hooks - Actions and Filters

If you would like to extend the Gigya functionality, you can use your own actions and filters for the plugin and place them in the 'functions.php' or 'gigya-custom.php' files.

The complete list of actions is:

  • notify_registration
  • setUID
  • notify_login
  • notify_logout
  • delete_account
  • gigya_add_comment

You can use the actions as shown in the example below:

function custom_gigya_add_comment($comment) {
    #comment (array)
    # $comment[] = comment_post_ID,comment_contentcomment_parent,user_id,comment_date,comment_approved (this is are the array keys)
}
add_action("gigya_add_comment","custom_gigya_add_comment");

The following list contains the filters you can use:

  • notify_login_user_info
  • login_params
  • share_plugin

For example:

function custom_notify_login_user_info($userInfo,$userId) {     #userInfo (object)     # ->nickname     # ->emai     # ->firstName    
 # ->lastName     # ->profileURL     # -> photoURL      return $userInfo; }  add_filters('notify_login_user_info','custom_notify_login_user_info');

Shortcode

If you would like to place the Gigya Login plugin in a different location on your site, please put the following code in the desired location in one of your theme's .php files:

render_login_plugin(array("header_text"=>"dddddd","width"=>"","height"=>"",button_size=>"",enabledProviders=>"",bgColor=>""));

Support

If you have any questions, please feel free to contact your Gigya account manager or contact us by filling in a support form on our site. You can also access the support page by clicking "Support" on the upper menu of Gigya's site.

 

  

Was this article helpful?
Pages that link here
Page statistics
10584 view(s) and 10 edit(s)
Social share
Share this page?

Tags

This page has no custom tags set.

Comments

You must to post a comment.

Attachments