236

Product support

Get help in the plugin support forum.

Categories

The Social Connect plugin allows users to register and log in to your site with their social accounts.

Supports

  • Facebook
  • Google
  • Twitter
  • Microsoft Live
  • Discord
  • Twitch

More to come soon!

Backend login support. Check the 'Enabled on backend?' checkbox on a per-provider basis in Settings - Social Connect.

Have a suggestion? Found a bug or need support?

Please leave them on github!

Installation

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

Go to System - Updates and in the search field enter Tohur.SocialConnect

Usage

  • Fill in any required credentials in System - Social Connect, making sure the Enabled? checkbox is ticked when you're done.
  • Add User - Account and Social Connect 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_connect_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:

Query String Param Default Description
s / Success page redirect URL (relative)
f /login Error page redirect URL (relative)

Example usage:

{% for name, link in social_connect_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.

Event Parameters Description
tohur.socialconnect.handleBackendLogin array $provider_details, array $user_details, User $user Triggers before backend login. Return true to halt the login process
tohur.socialconnect.handleLogin array $provider_details, array $user_details, User $user Triggers before frontend login. Return true to halt the login process
tohur.socialconnect.registerUser array $provider_details, array $user_details Triggers before registering a new user for attaching to a social account. Optionally return a User object

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.

1.1.17

New Twitter class added to implement Posting images via twitter. Reworking of settings into new location under new Tohur cat

Aug 03, 2020

1.1.16

Twitch API Fixes and adding IGDB (Internet Games Database) for Bot plugin in Dev and for use in other plugins

Aug 01, 2020

1.1.15

More Updates to twitch API class for incoming Bot plugin in Dev

Jul 31, 2020

1.1.14

Updates to twitch API class for incoming Bot plugin in Dev and updated instructions for Twitch

Jul 21, 2020

1.1.13

more changes concerning https://github.com/TohurTV/oc-socialconnect-plugin/issues/7

Jul 18, 2020

1.1.12

Proper fix for https://github.com/TohurTV/oc-socialconnect-plugin/issues/7

Jul 17, 2020

1.1.11

Quick fix for https://github.com/TohurTV/oc-socialconnect-plugin/issues/7

Jul 17, 2020

1.1.10

Quite bit of fixes and changes for support of other plugins I work on

Jul 14, 2020

1.1.9

Few Fixes

Jul 09, 2020

1.1.8

Fixed User access token refreshing if they haven't logged in for a bit

Jul 08, 2020

1.1.7

Refactoring all provider classes

Jul 08, 2020

1.1.6

Adding Provider User ID for future access

Jul 07, 2020

1.1.5

Route Fix to store Refesh tokens

Jul 07, 2020

1.1.4

Adding Bit Leaderboard Support

Jul 07, 2020

1.1.3

Moving Access token refresh functions to Social Connect

Jul 07, 2020

1.1.2

Twitch API fix

Jul 07, 2020

1.1.1

composer fix

Jul 06, 2020

1.1.0

Moving all third party social apis in to social connect for all my plugins which use them

Jul 06, 2020

1.0.13

One Last update before 1.1

Jul 06, 2020

1.0.12

Quick Fixes. This should be Last update before 1.1

Jul 06, 2020

1.0.11

Fixing Facebook, Google, Twitter, Microsoft Providers with Proper User Mapping in OctoberCMS. This should be Last update before 1.1

Jul 06, 2020

1.0.10

Big Fix for Twitch Login. more small updates to come to fix other bugs before 1.1 comes

Jul 02, 2020

1.0.9

Deleting Mixer Due to shutdown, Updating Sociallite and all the included providers

Jul 01, 2020

1.0.8

Some clean up before some long overdue Updates

Jul 01, 2020

1.0.7

Changing Microsoft Provider

May 15, 2019

1.0.6

Added Microsoft Live provider and further updates for UserExtended

May 15, 2019

1.0.5

Quick fix for the case UserExtened is not installed

May 14, 2019

1.0.4

Integration with upcoming UserExtended plugin version and couple backend changes

May 13, 2019

1.0.3

Some backend fixes

May 10, 2019

1.0.2

Fixed Avatars for Providers and added Twitch and Mixer to providers

May 10, 2019

1.0.1

Moving default Facebook,Google, and Twitter providers over to socialiteproviders/manager and added Twitch and Mixer to deps. to be fully integrated soon

May 09, 2019

1.0.0

First version of SocialConnect

May 04, 2019

Important

Due to my previous inexperience making Octobercms plugins if you are upgrading from before 1.1.11 to 1.1.11 and get errors with missing fields please run php artisan plugin:refresh Tohur.SocialConnect to refresh the database and install the new fields. this will reset the tables for the plugin and install the new fields but if everyone's user info is the same it will still log them into the proper accounts. Do a backup before the refresh just to be sure. In the future I will be handling migrations better

Before Updating

  • In Admin go to Settings - Social Connect 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 Connect area of admin if they've disappeared.
  • If you have any third party plugins extending Social Connect by adding extra login providers, they may need to require in new dependencies if they were relying on the old packages Social Connect used. Your developer will need to handle this one. If you only see Google, Facebook and Twitter in Settings - Social Connect 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.