[GP]247
The LoginSocial plugin allows users to log into the GP247 system using social media accounts such as Facebook, Google, GitHub, and other providers. The plugin supports multiple guards (admin, customer, vendor, pmo...) for flexible user authentication management.
composer require laravel/socialite
app/GP247/Plugins/LoginSocialThis is an alternative to the 4 actions above. Since gp247 3.x you can download LoginSocial from the GP247 library and install it straight from the command line, without opening the admin. Step 1 must be done first (composer require laravel/socialite), otherwise the command stops because the package is missing. Open a terminal in the website's root folder and run:
# 1) Once per website: register the (free) API License that connects the site to the GP247 library
php artisan gp247:ext-register-license
# 2) Download the plugin from the library and install it
php artisan gp247:ext-install --type=plugin --key=LoginSocial
APP_URL in .env is the website's real domain (not http://localhost) — the license is bound to that domain.gp247.json (core version, composer packages, required plugins) and stops with a clear message if something is missing (e.g. laravel/socialite is not installed).app/GP247/Plugins/LoginSocial is already on the server (copied manually or shipped with the installer), the command installs it in place instead of downloading it again.php artisan gp247:ext-update --type=plugin --key=LoginSocial.--json to get machine-readable output (for scripts/CI).https://your-domain.com/auth/social/facebook/callbackhttps://your-domain.com/auth/social/google/callbackhttps://your-domain.comhttps://your-domain.com/auth/social/github/callbackFor security reasons, only the customer guard is enabled by default. This prevents unauthorized social login access to administrative or sensitive areas of your system.
The admin interface shows the status of each guard:
If you need to enable social login for other guards (admin, vendor, pmo), you must manually configure them in the config file:
File: app/GP247/Plugins/LoginSocial/config.php
'guards' => [
'admin' => [
'model' => 'GP247\Core\Models\AdminUser',
'redirect_after_login' => 'admin.home',
'enabled' => 1, // Change from 0 to 1 to enable
'status_default' => 0, // Default status for new users (0=inactive, 1=active)
],
'customer' => [
'model' => 'GP247\Shop\Models\ShopCustomer',
'redirect_after_login' => 'front.home',
'enabled' => 1, // Already enabled by default
'status_default' => 1, // New customers are active by default
],
'vendor' => [
'model' => 'App\GP247\Plugins\MultiVendorPro\Models\VendorUser',
'redirect_after_login' => 'vendor_admin.home',
'enabled' => 0, // Disabled by default
'status_default' => 0, // New vendors require approval
],
// ... other guards
],
enabled: 1 = Allow social login for this guard, 0 = Disable social loginstatus_default: Default status for newly created users (0 = inactive/requires approval, 1 = active immediately)model: User model class for this guardredirect_after_login: Route name to redirect after successful login⚠️ Security Warning: Enabling social login for admin, vendor, or other privileged guards poses security risks. Only enable if you understand the implications and have proper security measures in place.
status_default to 0 for privileged guards (require manual approval)<a href="{{ route('social.redirect', ['provider' => 'facebook']) }}" class="btn btn-primary">
<i class="fab fa-facebook"></i> Login with Facebook
</a>
<a href="{{ route('social.redirect', ['provider' => 'google']) }}" class="btn btn-danger">
<i class="fab fa-google"></i> Login with Google
</a>
<a href="{{ route('social.redirect', ['provider' => 'github']) }}" class="btn btn-dark">
<i class="fab fa-github"></i> Login with GitHub
</a>
<a href="{{ route('social.redirect', ['provider' => 'google', 'guard' => 'admin']) }}" class="btn btn-primary">
<i class="fab fa-google"></i> Admin Login with Google
</a>
<a href="{{ route('social.redirect', ['provider' => 'facebook', 'guard' => 'vendor']) }}" class="btn btn-primary">
<i class="fab fa-facebook"></i> Vendor Login with Facebook
</a>
| Parameter | Type | Default | Description |
|---|---|---|---|
guard |
string | 'customer' |
Authentication guard (admin, customer, vendor, pmo) |
providers |
array | ['facebook', 'google', 'github'] |
List of providers to display |
buttonClass |
string | 'btn btn-block mb-2' |
CSS class for buttons |
title |
boolean | false |
Show title "Social Login" |
description |
boolean | false |
Show description "Quick login with your social media accounts" |
forceShow |
boolean | false |
Show even if user is already logged in |
Note: By default, social login buttons only show when user is NOT logged in for the specified guard. Use forceShow=true to always show the buttons.
<!-- Simplest way -->
@include('Plugins/LoginSocial::render')
<!-- With custom guard -->
@include('Plugins/LoginSocial::render', ['guard' => 'customer'])
<!-- With custom providers -->
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'providers' => ['facebook', 'google', 'github']
])
<!-- With custom button class -->
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'providers' => ['facebook', 'google'],
'buttonClass' => 'btn btn-outline-primary btn-block'
])
<!-- With title and description -->
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'title' => true,
'description' => true
])
<!-- Always show (even if logged in) -->
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'forceShow' => true
])
<!-- Regular login form -->
<form method="POST" action="{{ route('login') }}">
@csrf
<div class="form-group">
<input type="email" name="email" class="form-control" placeholder="Email" required>
</div>
<div class="form-group">
<input type="password" name="password" class="form-control" placeholder="Password" required>
</div>
<button type="submit" class="btn btn-primary btn-block">Login</button>
</form>
<!-- Social login section -->
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'title' => true,
'description' => true
])
@endif
<!-- Admin login form -->
<form method="POST" action="{{ route('admin.login') }}">
@csrf
<div class="form-group">
<input type="email" name="email" class="form-control" placeholder="Admin Email" required>
</div>
<div class="form-group">
<input type="password" name="password" class="form-control" placeholder="Password" required>
</div>
<button type="submit" class="btn btn-primary btn-block">Admin Login</button>
</form>
<!-- Social login for admin -->
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'admin',
'providers' => ['google', 'github'],
'title' => true
])
@endif
<!-- Vendor login form -->
<form method="POST" action="{{ route('vendor.login') }}">
@csrf
<div class="form-group">
<input type="email" name="email" class="form-control" placeholder="Vendor Email" required>
</div>
<div class="form-group">
<input type="password" name="password" class="form-control" placeholder="Password" required>
</div>
<button type="submit" class="btn btn-success btn-block">Vendor Login</button>
</form>
<!-- Social login for vendor -->
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'vendor',
'providers' => ['facebook', 'google'],
'title' => true,
'description' => true
])
@endif
<div class="social-login-buttons">
<h4>Or login with</h4>
<div class="btn-group">
@if(gp247_config('facebook_enabled', GP247_STORE_ID_GLOBAL, '0'))
<a href="{{ route('social.redirect', ['provider' => 'facebook', 'guard' => 'customer']) }}"
class="btn btn-facebook">
<i class="fab fa-facebook-f"></i> Facebook
</a>
@endif
@if(gp247_config('google_enabled', GP247_STORE_ID_GLOBAL, '0'))
<a href="{{ route('social.redirect', ['provider' => 'google', 'guard' => 'customer']) }}"
class="btn btn-google">
<i class="fab fa-google"></i> Google
</a>
@endif
@if(gp247_config('github_enabled', GP247_STORE_ID_GLOBAL, '0'))
<a href="{{ route('social.redirect', ['provider' => 'github', 'guard' => 'customer']) }}"
class="btn btn-github">
<i class="fab fa-github"></i> GitHub
</a>
@endif
</div>
</div>
The plugin supports the following guards:
Cause: Provider not enabled or not configured
Solution:
Cause: Guard does not exist in configuration
Solution:
config.php fileCause: OAuth configuration incorrect
Solution:
MIT License
Controllers/FrontController.php, Views/Front.blade.php, Views/script.blade.php) that were never wired to any routePlease sign in to write a review.
LoginNo reviews yet. Be the first to review this product.
![[InOut] Purchase, Return, Cash Flow Management Plugin](https://static.gp247.net/product/in-out.png)
