[GP]247
Plugin LoginSocial cho phép người dùng đăng nhập vào hệ thống GP247 bằng các tài khoản mạng xã hội như Facebook, Google, GitHub và nhiều providers khác. Plugin hỗ trợ đa guards (admin, customer, vendor, pmo...) cho phép linh hoạt trong việc quản lý xác thực người dùng.
composer require laravel/socialite
app/GP247/Plugins/LoginSocialLưu ý: Plugin LoginSocial chỉ sử dụng cấu hình từ database, không sử dụng ENV variables.
https://your-domain.com/auth/social/facebook/callbackhttps://your-domain.com/auth/social/google/callbackhttps://your-domain.comhttps://your-domain.com/auth/social/github/callbackQuan trọng: Tất cả cấu hình được lưu trong database, không cần thiết lập ENV variables.
Vì lý do bảo mật, mặc định chỉ guard customer được bật. Điều này ngăn chặn việc truy cập trái phép vào các khu vực quản trị hoặc nhạy cảm của hệ thống thông qua đăng nhập social.
Giao diện admin hiển thị trạng thái của mỗi guard:
Nếu bạn cần bật đăng nhập social cho các guard khác (admin, vendor, pmo), bạn phải cấu hình thủ công trong file config:
File: app/GP247/Plugins/LoginSocial/config.php
'guards' => [
'admin' => [
'model' => 'GP247\Core\Models\AdminUser',
'redirect_after_login' => 'admin.home',
'enabled' => 1, // Đổi từ 0 sang 1 để bật
'status_default' => 0, // Trạng thái mặc định cho user mới (0=chưa kích hoạt, 1=đã kích hoạt)
],
'customer' => [
'model' => 'GP247\Shop\Models\ShopCustomer',
'redirect_after_login' => 'front.home',
'enabled' => 1, // Đã được bật mặc định
'status_default' => 1, // Customer mới được kích hoạt ngay
],
'vendor' => [
'model' => 'App\GP247\Plugins\MultiVendorPro\Models\VendorUser',
'redirect_after_login' => 'vendor_admin.home',
'enabled' => 0, // Tắt mặc định
'status_default' => 0, // Vendor mới cần được duyệt
],
// ... các guards khác
],
enabled: 1 = Cho phép đăng nhập social cho guard này, 0 = Tắt đăng nhập socialstatus_default: Trạng thái mặc định cho user mới tạo (0 = chưa kích hoạt/cần duyệt, 1 = kích hoạt ngay)model: Class model của user cho guard nàyredirect_after_login: Tên route để chuyển hướng sau khi đăng nhập thành công⚠️ Cảnh Báo Bảo Mật: Việc bật đăng nhập social cho admin, vendor hoặc các guard có quyền cao khác có thể gây rủi ro bảo mật. Chỉ bật khi bạn hiểu rõ hậu quả và đã có các biện pháp bảo mật phù hợp.
status_default là 0 cho các guard có quyền cao (yêu cầu duyệt thủ công)
Đăng nhập bằng Facebook
Đăng nhập bằng Google
Đăng nhập bằng GitHub
Admin Login với Google
Vendor Login với Facebook
| Tham số | Kiểu | Mặc định | Mô tả |
|---------|------|----------|-------|
| guard | string | 'customer' | Guard xác thực (admin, customer, vendor, pmo) |
| providers | array | ['facebook', 'google', 'github'] | Danh sách providers hiển thị |
| buttonClass | string | 'btn btn-block mb-2' | CSS class cho các nút |
| title | boolean | false | Hiển thị tiêu đề "Đăng nhập mạng xã hội" |
| description | boolean | false | Hiển thị mô tả "Đăng nhập nhanh bằng tài khoản mạng xã hội" |
| forceShow | boolean | false | Hiển thị ngay cả khi user đã đăng nhập |
Lưu ý: Mặc định, nút đăng nhập mạng xã hội chỉ hiển thị khi user chưa đăng nhập cho guard được chỉ định. Sử dụng forceShow=true để luôn hiển thị.
@include('Plugins/LoginSocial::render')
@include('Plugins/LoginSocial::render', ['guard' => 'customer'])
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'providers' => ['facebook', 'google', 'github']
])
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'providers' => ['facebook', 'google'],
'buttonClass' => 'btn btn-outline-primary btn-block'
])
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'title' => true,
'description' => true
])
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'forceShow' => true
])
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'customer',
'title' => true,
'description' => true
])
@endif
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'admin',
'providers' => ['google', 'github'],
'title' => true
])
@endif
@if(gp247_extension_check_active('Plugins', 'LoginSocial'))
@include('Plugins/LoginSocial::render', [
'guard' => 'vendor',
'providers' => ['facebook', 'google'],
'title' => true,
'description' => true
])
@endif
Plugin hỗ trợ các guards sau:
Nguyên nhân: Provider chưa được bật hoặc chưa cấu hình
Giải pháp:
Nguyên nhân: Guard không tồn tại trong cấu hình
Giải pháp:
config.php của pluginNguyên nhân: Cấu hình OAuth không đúng
Giải pháp:
MIT License
Controllers/FrontController.php, Views/Front.blade.php, Views/script.blade.php) chưa từng được route nào trỏ tới
Plugin
Plugin
Plugin
Plugin