The Social Connect plugin allows users to register and log in to your site with their social accounts.
Supports
- 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!
The following plugin is required
The following plugin extends or depends on the plugin
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 - AccountandSocial Connectcomponents 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.
-
Paolo M
Found the plugin useful on 6 Jul, 2019
This plugin works well. Thank you.
-
| 1.2 |
Updating Sociallite for Laravel 6 based Octobercms. if running older versios DO NOT UPDATE Jan 26, 2021 |
|---|---|
| 1.1.25 |
Twitter Fix Sep 04, 2020 |
| 1.1.24 |
Microsoft Fix Aug 26, 2020 |
| 1.1.23 |
Updating Microsoft provider Aug 26, 2020 |
| 1.1.22 |
More Work on Twitter should be fully working Aug 26, 2020 |
| 1.1.21 |
More Work on Twitter Aug 22, 2020 |
| 1.1.20 |
Database fix Aug 22, 2020 |
| 1.1.19 |
Changing Twitter Provider to new provider Aug 21, 2020 |
| 1.1.18 |
More updates to TwitchAPI class Aug 10, 2020 |
| 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.