eman-elroukh/socialite-links

This Package for generate Socialite Links

1.0.3 2025-02-19 08:52 UTC

Requires

• php: ^8.2
• illuminate/support: ^6.3|^7.0|^8.0|^9.0|^10.0|^11.0
• laravel/socialite: ^5.18

MIT

• Eman Mahmoud Elroukh

• php
• laravel
• socialite
• lumen

README

This package provides ready-to-use social login buttons for Laravel projects using Laravel Socialite. It supports Facebook, Google, and Twitter authentication with customizable Blade components.

Features

• Easy integration with Laravel Socialite.
• Pre-designed social login buttons.
• Configurable via config/services.php.
• Supports Facebook, Google, and Twitter.

Installation

Install the package via Composer:

   composer require eman-elroukh/socialite-links

Publish the configuration file:

   php artisan vendor:publish --provider="EmanElroukh\SocialiteLinks\SocialiteLinksServiceProvider" --tag=config

Publish the assets (CSS and JS files):

   php artisan vendor:publish --provider="EmanElroukh\SocialiteLinks\SocialiteLinksServiceProvider" --tag=public

Run the migrations to create the required tables:

   php artisan migrate

Clear cache and optimize the application:

   php artisan optimize:clear

Configuration

• Add the following environment variables to your .env file:

    FACEBOOK_CLIENT_ID=
    FACEBOOK_CLIENT_SECRET=
    FACEBOOK_REDIRECT_URL=
    
    GOOGLE_CLIENT_ID=
    GOOGLE_CLIENT_SECRET=
    GOOGLE_REDIRECT_URL=
    
    TWITTER_CLIENT_ID=
    TWITTER_CLIENT_SECRET=
    TWITTER_REDIRECT_URI=

• Add this to your config/services.php file:

    'facebook' => [
        'client_id' => env('FACEBOOK_CLIENT_ID'),
        'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
        'redirect' => env('FACEBOOK_REDIRECT_URL'),
    ],
    'google' => [
        'client_id' => env('GOOGLE_CLIENT_ID'),
        'client_secret' => env('GOOGLE_CLIENT_SECRET'),
        'redirect' => env('GOOGLE_REDIRECT_URL'),
    ],
    'twitter' => [
        'client_id' => env('TWITTER_CLIENT_ID'),
        'client_secret' => env('TWITTER_CLIENT_SECRET'),
        'redirect' => env('TWITTER_REDIRECT_URI'),
    ],
    'instagram' => [
        'client_id' => env('INSTAGRAM_CLIENT_ID'),
        'client_secret' => env('INSTAGRAM_CLIENT_SECRET'),
        'redirect' => env('INSTAGRAM_REDIRECT_URI'),
    ],
    'github' => [
        'client_id' => env('GITHUB_CLIENT_ID'),
        'client_secret' => env('GITHUB_CLIENT_SECRET'),
        'redirect' => env('GITHUB_REDIRECT_URI'),
    ],
    'linkedin' => [
        'client_id' => env('LINKEDIN_CLIENT_ID'),
        'client_secret' => env('LINKEDIN_CLIENT_SECRET'),
        'redirect' => env('LINKEDIN_REDIRECT_URI'),
    ],

How To Use

• Add social login buttons to your blade file.
• "you can change url if you have custom routes"

    <x-socialite-button provider="facebook" url=""/>
    <x-socialite-button provider="google" url=""/>
    <x-socialite-button provider="twitter" url=""/>
    <x-socialite-button provider="instagram" url=""/>
    <x-socialite-button provider="github" url=""/>
    <x-socialite-button provider="linkedin" url=""/>