Installation

This plugin relies on RainLab.User, so make sure you have that installed.

Go to System - Updates and in the search field enter Flynsarmy.SocialLogin

Usage

• Fill in any required credentials in System - Social Login, making sure the Enabled? checkbox is ticked when you're done.
• Add User - Account and Social Login components to your login page
• Copy /plugins/rainlab/user/components/account/signin.htm to your themes partials/account folder
• Where you want your login links, add

  {% for name, link in social_login_links %}
  <a href="{{ link }}">{{ name }}</a>
  {% endfor %}

  Remember that you can format it any way you like.

Settings

Sometimes you'll want to decide which page to redirect to on login/error. For example perhaps you have a log in page before checkout in an ecommerce plugin and want to redirect to the cart on login. This can be done by appending the following query string values to your login links:

Example usage:

{% for name, link in social_login_links %}
    <a href="{{ link }}?s={{ 'home'|page }}&f={{ 'login'|page }}">{{ name }}</a>
{% endfor %}

Events

Developers can change the way logins are handled through several events detailed below.

Other Notes

Twitter doesn't return an email address, so when logging in with Twitter, a new user account is created and associated with the Twitter account.

Examples

To get your login page looking how mine is in the marketplace screenshot here's my /themes/travu/partials/account/signin.htm:

<form id="login" data-request="onSignin">
    <div class="form-group">
        <label for="userSigninEmail">Email</label>
        <input name="email" type="email" class="form-control" id="userSigninEmail" placeholder="Enter your email">
    </div>

    <div class="form-group">
        <label for="userSigninPassword">Password</label>
        <input name="password" type="password" class="form-control" id="userSigninPassword" placeholder="Enter your password">
    </div>

    <p align="right">
        or sign in with
        {% for name, link in social_login_links %}
            <a href="{{ link }}" class='login {{ name|lower }}'><i class="fa fa-2 fa-{{ name|lower }}"></i></a>
        {% endfor %}
    </p>

    <button type="submit" class="btn btn-default">Sign in</button>
</form>

Upgrade guide

Upgrading to 1.0.16

Version 1.0.16 of the Social Login plugin is a significant rewrite with a few breaking changes. We've moved from a much older login provider library to Laravel Socialite. This should provide reliability improvements when logging in solving many of the issues users were experiencing.

Before Updating

• In Admin go to Settings - Social Login and copy your login providers' settings. Some of these may need to be re-entered. You can just paste the same details back in again.

After Updating

• Paste your copied login provider settings back in the Settings - Social Login area of admin if they've disappeared.
• If you have any third party plugins extending Social Login by adding extra login providers, they may need to require in new dependencies if they were relying on the old packages Social Login used. Your developer will need to handle this one. If you only see Google, Facebook and Twitter in Settings - Social Login area of admin then you probably don't need to worry about this.

Other FAQ

• No changes are needed on the frontend of your site.
• Frontend users will not need to reassociate their social accounts with your site. Everything will keep working for them provided you follow the backend steps above.