Social Login Documentation

Overview

The Universal Bookshelf platform supports social login through OAuth 2.0 for Google and Facebook. This allows users to authenticate using their existing social media accounts, providing a seamless login experience.

Supported Providers

• Google OAuth 2.0 - Most popular and widely used
• Facebook OAuth 2.0 - Large user base integration

Google OAuth Setup

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/google/callback

composer require laravel/socialite

Facebook OAuth Setup

FACEBOOK_CLIENT_ID=your_facebook_app_id
FACEBOOK_CLIENT_SECRET=your_facebook_app_secret
FACEBOOK_REDIRECT_URI=http://localhost:8000/auth/facebook/callback

Configuration Files

config/services.php

Add the following configuration to your services config file:

'google' => [
    'client_id' => env('GOOGLE_CLIENT_ID'),
    'client_secret' => env('GOOGLE_CLIENT_SECRET'),
    'redirect' => env('GOOGLE_REDIRECT_URI'),
],

'facebook' => [
    'client_id' => env('FACEBOOK_CLIENT_ID'),
    'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
    'redirect' => env('FACEBOOK_REDIRECT_URI'),
],

API Endpoints

Implementation Example

SocialAuthController

Here's an example of how to implement the social login controller:

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Laravel\Socialite\Facades\Socialite;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Str;

class SocialAuthController extends Controller
{
    public function redirectToGoogle()
    {
        return Socialite::driver('google')->redirect();
    }

    public function handleGoogleCallback()
    {
        try {
            $user = Socialite::driver('google')->user();
            
            $finduser = User::where('google_id', $user->id)->first();
            
            if ($finduser) {
                Auth::login($finduser);
                return redirect('/dashboard');
            } else {
                $newUser = User::create([
                    'name' => $user->name,
                    'email' => $user->email,
                    'google_id' => $user->id,
                    'password' => Hash::make(Str::random(24)),
                    'email_verified_at' => now(),
                ]);
                
                Auth::login($newUser);
                return redirect('/dashboard');
            }
        } catch (\Exception $e) {
            return redirect('/auth/google')->with('error', 'Google login failed');
        }
    }

    public function redirectToFacebook()
    {
        return Socialite::driver('facebook')->redirect();
    }

    public function handleFacebookCallback()
    {
        try {
            $user = Socialite::driver('facebook')->user();
            
            $finduser = User::where('facebook_id', $user->id)->first();
            
            if ($finduser) {
                Auth::login($finduser);
                return redirect('/dashboard');
            } else {
                $newUser = User::create([
                    'name' => $user->name,
                    'email' => $user->email,
                    'facebook_id' => $user->id,
                    'password' => Hash::make(Str::random(24)),
                    'email_verified_at' => now(),
                ]);
                
                Auth::login($newUser);
                return redirect('/dashboard');
            }
        } catch (\Exception $e) {
            return redirect('/auth/facebook')->with('error', 'Facebook login failed');
        }
    }
}

Database Schema

You'll need to add social login fields to your users table:

Migration Example

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('google_id')->nullable()->unique();
            $table->string('facebook_id')->nullable()->unique();
            $table->string('avatar')->nullable();
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn(['google_id', 'facebook_id', 'avatar']);
        });
    }
};

Frontend Integration

Login Buttons

Add social login buttons to your login form:

<div class="social-login-buttons">
    <a href="/auth/google" class="btn btn-danger">
        <i class="fab fa-google me-2"></i>Login with Google
    </a>
    
    <a href="/auth/facebook" class="btn btn-primary">
        <i class="fab fa-facebook me-2"></i>Login with Facebook
    </a>
</div>

Security Considerations

Troubleshooting

Common Issues

• Invalid redirect URI - Ensure redirect URIs in OAuth apps match exactly
• Missing scopes - Configure required OAuth scopes in your app settings
• HTTPS requirement - Facebook requires HTTPS in production
• Rate limiting - OAuth providers may limit requests