Configuring Sign In with Facebook
page last edited on 03 May 2017
The “Sign in with Facebook” feature set-up in an X-Cart store consists of the following steps:
Creating a Facebook App
To create an App for Facebook login:
Go to the Apps page of the developers section of Facebook and sign in with your Facebook username and password.
Click on the button + Add a new app:
A popup titled “Create a New App ID” will be displayed.
Enter a name for your App into the Display Name field (this will be the user-facing name of your App; using your store name is recommended).
In the Contact Email field, provide a valid email address (will be used for important communication about your app).
Click Create App ID.
On the App Products screen select Set Up for the Facebook Login product:
Choose the Website platform:
This will start a wizard that will help you to complete your app configuration.
On the first step of the wizard enter your site URL and click Save and Continue:
The next steps are already integrated in the Social Login addon, you can skip them.
Locate the Settings -> Basic section in the left menu and open to see the app details:
Fill in the form fields for your App and click Save changes.
Copy your App ID and App Secret to use later in the configuration of the Social Login addon.
Locate the Facebook Login -> Settings section in the left menu and specify the value of the Valid OAuth Redirect URIs field. It should be of the kind -
Click Save changes.
Make sure your store is configured to use HTTPS (X-Cart Admin -> System Tools -> HTTPS Settings). Otherwise the Facebook Login feature won’t work.
As your app is now in development mode you need to go live with it.
To do so, switch the In Development toggle to Live to make your app available to the general public:
Your app is now published:
That is all. Your Facebook App has been configured.
Configuring the Social Login Addon: Facebook
Once you have created and configured your Facebook App, you will need to obtain two pieces of information: your Facebook App ID and App Secret. These will need to be entered in X-Cart so the addon can connect to the App you created on Facebook and generate the Facebook login widget code correctly.
The Facebook App ID and App Secret can be found on the Settings -> Basic page for your App (You will need to click the Show button and enter your password to reveal the App Secret):
We recommend opening your X-Cart Admin interface in a separate browser tab or window so you can copy and paste the App ID and App Secret values from Facebook to X-Cart.
To configure the addon:
In the My Addons section of your X-Cart Service Screen, locate the entry for the Social Login module and click the Settings link below it:
This opens the “Social Login” addon settings page.
On the “Social Login” addon settings page, complete the Facebook App ID/API Key and Facebook App Secret fields with the Facebook App ID and App Secret values you obtained on Facebook.
The “Social Login” addon can also requests user location information, which requires additional approval from Facebook. This allows X-Cart to fill the address automatically upon user login (in case user has specified his location on the Facebook). You can disable this feature by using the Request user location checkbox.
After you’ve configured the Facebook section, click the Submit button near the bottom of the page to save the changes.
The “Login with Facebook” feature should now be enabled.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.