Skip to content

Latest commit

 

History

History
247 lines (154 loc) · 8.41 KB

README.md

File metadata and controls

247 lines (154 loc) · 8.41 KB

Shopware HybridAuth

Latest Stable Version Total Downloads License

  • Social Auth/ Login for Shopware
    • Required minimum Shopware version: 5.2
    • Required PHP version: 7.0

Product information

Make it easy for your customers to log onto the Shopware shop with the help of the social log-in!

Social login is a very useful feature used by many applications to get the user logged in easily via Facebook, Google, etc.

Give your customers the option to sign in via any social account with the help of the "SocialLogin" to your shop easily and conveniently with just one click.

Screenshot

New customer process

If the customer is not yet registered in your shop, he or she will be logged in after successful authentication against one of the social providers.

If the master data is no completed the user can fullfil them as usual in his account. In the case that the user wants to checkout without all master data shopware will prompt him to enter his data.

We have refrained from doing a seperate registration after social login, to prevent that the user leaves your shop due the complexity of the registration form.

Existing customer process

Users who are already a customer in your shop, as long as the social login cookie is still valid are automatically logged into the shop. If the cookie is not available, the customer can sign in to the shop through the social log-in. A new registration is not needed here.

Special Case "equal email addresses"

If the user logs in via Google and wants to log in later via Facebook an he has the same email address on both social providers we connect the identity from Facebook to the already existing Google customer account on the shopware system.

Special Case "passwort"

The password will be during the login process, because shopware needs a password for each user. Unfortunatly the user not know this password. The only way he can reset this is to click "Password Forgot?" and reset the passwort via email.

Logout process

If the user presses the "Logout button", we logout him from all social providers so that he should reauthenticate when visiting the shop againt. Logout from all providers does not mean logging him out from Facebook or Google - that is not possible ;-)

Installation

Zip Installation package for the Shopware Plugin Manager

  • Download the latest plugin version (e.g. Port1HybridAuth-1.3.0.zip)
  • Upload and install/ activate the plugin using the Plugin Manager

Git Version

  • Checkout Plugin in /custom/plugins/Port1HybridAuth
  • Change to directory and run composer install to install the dependencies
  • Install/ activate the plugin using the Plugin Manager

Install with composer

  • Change to your root installation of Shopware
  • Run command composer require --update-no-dev portrino/shopware-hybrid-auth and install/ activate the plugin using the Plugin Manager

Configuration

  • configuration takes completely place in shopware backend plugin config via plugin manager

General

Include FontAwesome

Include FontAwesome 4.7.0 (http://fontawesome.io/) from CDN to display nice icons for the social login buttons. Disable it if you already have included FontAweseome or want to override default styling.

Country Fallback

Select the country which should be used if the plugin cannout determine a country for the customer during social login. A country is mandatory for the customer so you should select a country here.

...we will optimize this process soon

Hybrid Auth

Debug Mode

You can choose one of the debug modes. The are the same as hybridauth library uses. You can read more about this here http://hybridauth.sourceforge.net/userguide/Debugging_and_Logging.html

Debug File

Enter the path where the debug file is located here.

Facebook

At first go to https://developers.facebook.com/ and register a new application.

  • Add new Application
  • Enter your information
  • Add Facebook Login
  • activate Client-OAuth-Anmeldung and Web-OAuth-Anmeldung
  • activate Browser Control Redirect
  • enter Valid OAuth Redirect URIs
    • this URL should look like:
  http://www.shopware-portrino.de/hybridauth?hauth_done=Facebook

Enabled

Set Facebook :: Enabled to Yes.

App-ID

Enter your App-ID, which you can find on your application dashboard into the field: "Facebook :: App-ID".

App-Secret

Enter your App-Secret, which you can find on your application dashboard into the field: "Facebook :: App-Secret".

Scope

Enter your custom scope in this textarea. More information can be found here: https://developers.facebook.com/docs/facebook-login/permissions .

! Clear the cache after you have made configuration changes

Google

At first go to https://console.developers.google.com/ and create a new application

  • Create Project
  • Wait until the project is created
  • Go to Credentials
  • Create Credentials
  • Create OAuth client ID
  • Enter OAuth consent screen data
  • Create client ID
    • Enter the Name you wish to use
    • Enter the Authorised redirect URIs
    • this URL MUST look like this:
  http://www.shopware-portrino.de/hybridauth?hauth_done=Google
  • store the client ID and client secret or copy it directly into your plugin configuration

  • Enable Google+ API in your API console

Enabled

Set Google :: Enabled to Yes.

Client-ID

Enter your Client-ID, which you can find on your application credentials section into the field: "Google :: Client-ID".

Clientkey

Enter your Clientkey, which you can find on your application credentials section into the field: "Google :: Clientkey".

Scope

Enter custom scopes to retrieve more or less information from google by adding them here. More information can be found here: https://developers.google.com/identity/protocols/googlescopes .

! Clear the cache after you have made configuration changes

Amazon

  • first of all you have to use SSL to get amazon social login working

At first go to https://sellercentral.amazon.com/gp/homepage.html and register a new application

  • Register new application
  • Enter your data
  • Go to "Web Settings"
  • Get the Client ID and the Client Secret
  • Enter the Allowed Return URLs
    • this URL MUST look like this:
  https://www.shopware-portrino.de/hybridauth?hauth.done=Amazon
  • store the client ID and client secret or copy it directly into your plugin configuration

Enabled

Set Amazon :: Enabled to Yes.

Client-ID

Enter your Client-ID, which you can find on your Web Settings section into the field: "Amazon :: Client-ID".

Client Secret

Enter your Client Secret, which you can find on your Web Settings section into the field: "Amazon :: Client Secret".

! Clear the cache after you have made configuration changes

LinkedIn

Enabled

Set LinkedIn :: Enabled to Yes.

At first go to https://www.linkedin.com/developer/apps/ and create a new application

  • Enter your data
  • Go to "Authentication"
  • Enter the Allowed Return URLs
    • this URL MUST look like this:
  https://www.shopware-portrino.de/hybridauth?hauth.done=LinkedIn
  • store the client ID and client secret or copy it directly into your plugin configuration

Client-ID

Enter your Client-ID, which you can find on your Web Settings section into the field: "Amazon :: Client-ID".

Client Secret

Enter your Client Secret, which you can find on your Web Settings section into the field: "Amazon :: Client Secret".

! Clear the cache after you have made configuration changes

Authors

  • André Wuttig - Initial work - aWuttig
  • Axel Böswetter - Bugfixes, Features - EvilBMP
  • Andreas Haubold - Documentation - ahaubold

See also the list of contributors who participated in this project.