SSO workflow can be tailored to specifics of merchant's website. Check out the available customizations below.
Important
These customizations will work only when Ecwid is in SSO mode. That is, when the global variable ecwid_sso_profile is also defined at least as an empty string "".
Add log in link to the store in SSO mode
By default, when SSO is used on a web page, Ecwid hides Sign in and Sign out links in the storefront assuming that the user logs in by means of your site login form.
Alternatively, you can customize the Sign in / Sign out links in a store and link them to the site login form to make login process more convenient for your customers.
Ecwid.OnAPILoaded.add(function() {
Ecwid.setSignInUrls({
signInUrl: 'http://my.site.com/signin',
signOutUrl: 'http://my.site.com/signout' // signOutUrl is optional
});
});
This can be done by means of Ecwid.setSignInUrls() API extension, which accepts two parameters:
Parameters in bold are mandatory
| Field | Type | Description |
|---|---|---|
| signInUrl | string | URL where your customer will be redirected to log in to your site |
| signOutUrl | string | URL where your customer will be redirected, when they click the 'Log out' link in the store. This parameter is optional. If not specified, Ecwid will not show the ’sign out’ link. |
When you use setSignInUrls() extension, the customer will be redirected to the specified URL in the following situations:
- They click the 'Sign in' link in the product browser
- They open a secured page inside Product Browser (e.g. ’My account’ page)
- They go to checkout and your store settings require a user to be registered to place an order
Custom Sign in / Sign out handlers
Ecwid SSO API provides a tool for advanced customization of the login functionality in Single Sign-on mode – Ecwid.setSignInProvider() method.
Ecwid.OnAPILoaded.add(function() {
Ecwid.setSignInProvider({
addSignInLinkToPB: function() { return true; },
signIn: function () {
alert('User is logging in!');
// do something
},
canSignOut: function() { return true; },
signOut: function () {
alert('User is signing out');
}
});
});
| Field | Type | Description |
|---|---|---|
| addSignInLinkToPB | boolean | Set it to return true if you need to show 'Sign in' link inside your store |
| signIn | function | Specify function to be called when Ecwid is trying to authorize the customer, when either the 'Sign in' link is clicked or a secured page is opened inside Product Browser. This function does not accept any arguments nor should return any result. |
| canSignOut | function returning true or false | Set it to return true if you need to show 'Sign out' link inside your store |
| signOut | function | This function is called when canSignOut returns true and the customer clicks the 'Sign out' link inside the store widget |