Difference between revisions of "X-Cart:X-Social Login (ex Janrain Engage) module"

From X-Cart 4 Classic
Jump to: navigation, search
m (Replaced content with "#REDIRECT X-Cart:Social_Login_(former_Janrain_Engage)_module")
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
#REDIRECT [[X-Cart:Social_Login_(former_Janrain_Engage)_module]]
The [http://www.x-cart.com/janrain-engage.html Social Login module] is an add-on for integrating your X-Cart with Janrain’s services. The services allow your visitors with existing accounts with social networks – including Facebook, Twitter, Google, Yahoo! and LinkedIn and over a dozen of others – to quickly sign-in to your online store via their existing social network accounts. The solution lets users bypass your traditional registration process and sign-in with one click, resulting in an accelerated sign-up process for new users and a simple login experience for returning visitors.
===Why Social Login===
According to [http://www.janrain.com/consumer-research-social-signin&campaign=xcart?utm_source=xcart&utm_medium=partner&utm_campaign=xcartreferral  Consumer research study] conducted by Blue Research in October 2011
'''Resistance to Traditional Registration Processes'''
* Four in five (86%) people are bothered by the need to create new accounts when registering on a website and will change their behavior as a result; this represents an increase of more than 10% over the 2010 findings
* 54% may leave the site or not return
* 26% go to a different site, if possible
* 6% leave/avoid the site
* 14% say they will complete the registration
* 88% admit to having given incorrect information or left forms incomplete when creating a new account at a website, up from 76% in 2010.
* 9 in 10 people (90% versus 45% in 2010) admit they have left a website if they forgot their password or log-in info, instead of answering security questions or re-setting their password.
'''Irrelevant Targeting by Brands'''
* 100% of respondents reported receiving information or promotions from companies that are not relevant to them
* Almost 3 in 4 (74%) have received conflicting messages across different marketing channels
* Two-thirds (66%) have received an offer that clearly shows a company does not know who they are
* Over half have received offers targeted to the wrong name, gender or age
'''Increased Brand Affinity in Fans of Social Login'''
* 77% believe social login is a good solution that should be offered, an increase of over 10% from the year prior (66% in 2010). Among that population…
* 78% of social login fans have posted a comment or message to their social networks about a product or service they liked or thought others should know about or purchase
* 4 in 5 people (83%) say they are influenced to consider buying new products or services based on positive comments or messages from people in their social network
* 69% say positive reviews may increase their likelihood to purchase a product or service
* 82% seek out or avoid companies based on reviews from friends in their social graph
===Key benefits of using X-Social Login module in X-Cart===
* Converts anonymous visitors into your registered customers.
* Fast customer sign-in.
* Fast personnel sign-in (admin/provider/affiliates).
* Linking multiple external profiles with a single profile at your store.
* Social Sharing – lets your users share comments, purchases or other activities from your site to their friends on multiple social networks.
On top of that, Janrain Engage allows your visitors to '''share''' their comments, purchases, reviews or other activities directly from your online store to their friends on multiple social networks, all without leaving your store. Social sharing with Janrain Engage lets you trigger sharing based on any number of user's actions, including purchases, posting comments, user-generated content or clicking a share button, enabling the word of mouth marketing for your business and transforming your users into brand advocates.
For more information on Janrain Engage, please visit [http://www.janrain.com/products/engage?campaign=xcart&utm_source=xcart&utm_medium=partner&utm_campaign=xcartreferral Janrain Engage Online Home].
: [[Image:XC_JR-01.png]]
== System requirements and installation ==
X-Social Login is available as a built-in module in X-Cart GOLD PLUS and PLATINUM editions v4.5.3 and later. In the said editions, it does not require installation and can be enabled in the <u>Modules</u> section of X-Cart Admin area.
For X-Cart GOLD and PRO editions v4.1.12, 4.2.3, 4.3.2, 4.4.х and 4.5.х, this module can be purchased and installed separately. The following instructions will guide you through the process of installing the X-Social Login module in your store.
=== System requirements ===
To be able to successfully install and use the X-Social Login integration module, you need a working copy of X-Cart GOLD or PRO v4.1.12, 4.2.3, 4.3.2, 4.4.х or 4.5.х installed on your server. Make sure that the version of the X-Social Login integration module matches the version of your copy of X-Cart.
{{Note1|Note: If you do not remember the version of your copy of X-Cart, you can find it in the <u>Environment info</u> section of the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area.}}
=== Installation and removal ===
'''To install the X-Social Login module:'''
1. Obtain a distribution package for the X-Social Login integration module by downloading it from the File Area section of your {{QA}} account. The distribution package is archived in the file <u>xauth-x.y.z.tgz</u>, where <u>x</u>, <u>y</u> and <u>z</u> indicate the version of the module. Make sure the version of the module matches the version of your copy of X-Cart.
2. Copy the distribution package to the X-Cart root directory on your server or hosting account.
* If you use a Windows-based server or a UNIX-based server without terminal access:
: a) Extract the contents of the archive with the X-Social Login module files to a directory on your system using your favorite compression program (WinZIP or any other archiver that supports  TAR files).
: b) Use an FTP client to upload all the files extracted from the archive (retaining the directory structure) to the X-Cart root directory on your server or hosting account.
* If you use a UNIX-based server with terminal access:
: a) Use an FTP client to upload the archive with the X-Social Login module distribution package to the X-Cart root directory on your server or  hosting account.
: b) Decompress the package by typing the following command:
<pre>tar -xzvf xauth-x.y.z.tgz</pre>
{{Note1|Important: Make sure that you maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten! }}
3. In a web browser, run the installation script at httр://www.example.com/install-xauth.php, replacing the variable www.example.com with the real domain name, where your X-Cart is installed.
4. Enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]], accept the License Agreement and click the '''Next''' button.
5. The installation script copies the files and activates the module. Click the '''Next '''button to continue.
6. The installation script generates a new system fingerprint. Click the '''Next''' button to complete the installation.
7. Use the <u>ADMINISTRATOR AREA</u> link to log in to the Admin area.
'''To uninstall the X-Social Login module:'''
1. In a web browser, run the installation script at http://www.example.com/install-xauth.php, replacing the "www.example.com" with the real domain name, where your X-Cart is installed.
2. Choose the <u>Uninstall the module</u> option, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]], accept the License Agreement and click the '''Next''' button.
3. Once the installation script has removed the X-Social Login module files and deactivated the module, click the '''Next''' button to complete the uninstallation.
4. On the ''Uninstallation complete'' screen, click '''Next''' to leave the Wizard.
{{Note1|Important: After you have uninstalled the X-Social Login integration module, make sure to remove the module's distribution package from your web directory as well.}}
==Enabling X-Social Login Module in X-Cart==
Once you have installed the X-Janrain Engage integration module, enable it in the X-Cart Admin area. Otherwise, you will be unable to use the module for launching the affiliate system at your store.
'''To enable the X-Social Login module:'''
# Log in to the X-Cart Admin area and go to the <u>Modules</u> section (select <u>Settings</u> -> <u>Modules</u> on the administration menu).
# On the list of modules, find the "X-Social Login" item and select the check box by the item's name.
# Scroll down to the bottom of the page and click the '''Apply changes''' button to apply the changes.
: [[Image:XC-JR-04.png]]
Now you can leave alone your X-Cart for a few moments and switch to Janrain.
==Setting up Janrain==
To be able to use the X-Social Login module, you must first get an account with Janrain. If you already have an account, just skip to 'Creating application'.
===Getting Janrain account===
'''To get a free Janrain account:'''
1. Visit [http://www.janrain.com/products/engage?campaign=xcart&utm_source=xcart&utm_medium=partner&utm_campaign=xcartreferral Janrain Engage Online Home] and click on the [http://www.janrain.com/products/engage?campaign=xcart&utm_source=xcart&utm_medium=partner&utm_campaign=xcartreferral Sign In] link.
2. Click on the logo of the social network you would like to use with your store.
3. On the sign-in page, enter your credentials for that social network and then click 'Sign In'.
4. On the profile linking confirmation prompt, click 'Allow'.
That's it; welcome aboard!
===Entering missing data===
If this is your first time at Janrain, you will be prompted to complete your profile by entering the missing data, such as your name, company name and e-mail address.
: [[Image:XC_JR-03.png]]
===Creating application===
Clicking the '''Next''' button brings you to the ''Create Application'' screen, where you enter your application name (a recognizable name of your store). If the ID is available (indicated by the green light), click the '''Create Application''' button.
{{Note|If you already have an account with Janrain and just logged in to it, select 'Create Application' on the drop-down list below the Janrain logo on your Dashboard.}}
: [[Image:XC_JR-04.png|300px]]
When the application is created, the server e-mails you a confirmation link. Clicking on that link enables your Janrain application and brings you to the Janrain Dashboard, where you can continue setting up your application.
===Configuring providers===
Once your application is activated at Janrain, configure the identity providers you are going to use with your store.
'''To configure an identity provider:'''
1. On the Janrain Dashboard page, select <u>Deployment</u> -> <u>Provider Configuration</u> on the menu.
: [[Image:XC_JR-05.png]]
2. On the Configure Providers page, click on the provider to be configured and then click the '''Configure''' button.
3. Follow the configuration wizard's instructions and complete the configuraton.
Repeat these steps for every identity provider you want to enable for your store and then move on to the next section.
==Configuring X-Social Login Module in X-Cart==
Now, tell your X-Cart what it should do with all the stuff you have just set up -- configure the Social Login module that you installed a few steps earlier.
'''To configure the X-Social Login module in your X-Cart Admin area:'''
1. Log in to the X-Cart Admin area.
2. Select <u>Settings</u> -> <u>Modules</u> on the menu.
3. Scroll down until you see the X-Social Login module item and then click on the <u>Configure</u> link by the item.
This opens a box with options and settings for the X-Social Login module.
: [[Image:XC_JR-07.png|640px]]
4. In the Janrain Engage (RPX) Options section, enter your API key and Application name and then click the '''Apply changes''' button.
==Administrator sign-in over identity providers==
'''To enable signing in as administrator over an external identity provider:'''
1. Sign in to your X-Cart store using your regular credentials.
2. In the X-Cart Admin area, click on the administrator profile link at the top of the page.
3. On the Account details page, click on the '<u>Add an identifier</u>' link.
4. Sign-in using your preferred identity provider.
==Adding Social Sharing to your online store==
'''To add the Social Sharing widget to your online store:'''
1. On the Janrain Dashboard page, select <u>Deployment</u> -> <u>Social Sharing for Web</u> on the menu.
2. Follow the instructions provided on the Social Widget Setup page for adding the social widget to your online store.
For more information on creating and using activity objects, please refer to [https://rpxnow.com/docs/social_publish_activity Janrain's          social sharing documentation].
===Error: Whoops, you've been directed here by mistake.===
The 'Application name' specified in X-Cart admin back end on the module configuration page is incorrect.
Janrain replaces dots with dashes, thus to fix the issue you should do the same, e.g.:
<pre>yourappname.domain -> yourappname-domain</pre>
[[Category:X-Cart video tutorials]]
[[Category:X-Cart user manual]]
[[Category:X-Cart video tutorials]]
[[Category:X-Cart user manual]]
[[Category:X-Cart video tutorials]]
[[Category:X-Cart user manual]]
[[Category:X-Cart video tutorials]]
[[Category:X-Cart user manual]]

Latest revision as of 13:44, 24 September 2015