Product support

Get help in the plugin support forum.

  • Added on May 8, 2019
  • Current version: 1.2
  • Compatibility
    October CMS v3.x not tested
    October CMS v2.x not tested
    October CMS v1.x use latest
  • Extensions: 1
  • Created by
  • Public repository


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


  • 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!


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


  • 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.


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 %}


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.


Updating Sociallite for Laravel 6 based Octobercms. if running older versios DO NOT UPDATE

Jan 26, 2021


Twitter Fix

Sep 04, 2020


Microsoft Fix

Aug 26, 2020


Updating Microsoft provider

Aug 26, 2020


More Work on Twitter should be fully working

Aug 26, 2020


More Work on Twitter

Aug 22, 2020


Database fix

Aug 22, 2020


Changing Twitter Provider to new provider

Aug 21, 2020


More updates to TwitchAPI class

Aug 10, 2020


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

Aug 03, 2020


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

Aug 01, 2020


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

Jul 31, 2020


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

Jul 21, 2020


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

Jul 18, 2020


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

Jul 17, 2020


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

Jul 17, 2020


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

Jul 14, 2020


Few Fixes

Jul 09, 2020


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

Jul 08, 2020


Refactoring all provider classes

Jul 08, 2020


Adding Provider User ID for future access

Jul 07, 2020


Route Fix to store Refesh tokens

Jul 07, 2020


Adding Bit Leaderboard Support

Jul 07, 2020


Moving Access token refresh functions to Social Connect

Jul 07, 2020


Twitch API fix

Jul 07, 2020


composer fix

Jul 06, 2020


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

Jul 06, 2020


One Last update before 1.1

Jul 06, 2020


Quick Fixes. This should be Last update before 1.1

Jul 06, 2020


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

Jul 06, 2020


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

Jul 02, 2020


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

Jul 01, 2020


Some clean up before some long overdue Updates

Jul 01, 2020


Changing Microsoft Provider

May 15, 2019


Added Microsoft Live provider and further updates for UserExtended

May 15, 2019


Quick fix for the case UserExtened is not installed

May 14, 2019


Integration with upcoming UserExtended plugin version and couple backend changes

May 13, 2019


Some backend fixes

May 10, 2019


Fixed Avatars for Providers and added Twitch and Mixer to providers

May 10, 2019


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


First version of SocialConnect

May 04, 2019


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.