tomatophp/filament-social

Integration of social media platform actions and auth to your FilamentPHP panel

Fund package maintenance!
3x1io

v1.0.0 2024-10-07 18:31 UTC

This package is auto-updated.

Last update: 2024-10-07 18:33:08 UTC


README

Screenshot

Filament Social Media Manager

Latest Stable Version License Downloads

Integration of social media platform actions and auth to your FilamentPHP panel

Screenshots

Dark Register Login Share Buttons

Features

  • Social Media Login/Register Pages
  • Login With Facebook
  • Login With Twitter
  • Login With Discord
  • Login With GitHub
  • Login With Google
  • Login With Snapchat
  • Share Buttons Action
  • Share Buttons Component
  • Auto Share Posts To Twitter
  • Auto Share Posts To Facebook

Installation

composer require tomatophp/filament-social

after install your package please run this command

php artisan filament-social:install

finally register the plugin on /app/Providers/Filament/AdminPanelProvider.php

->plugin(
    \TomatoPHP\FilamentSocial\FilamentSocialPlugin::make()
        ->socialLogin()
        ->socialRegister()
)

on your User model add the TomatoPHP\FilamentSocial\Traits\InteractsWithSocials trait

use TomatoPHP\FilamentSocial\Traits\InteractsWithSocials;

class User extends Authenticatable
{
    use InteractsWithSocials;
}

now on your env you need to add the social media keys

TWITTER_CLIENT_ID=
TWITTER_CLIENT_SECRET=
TWITTER_CLIENT_TOKEN=
TWITTER_REDIRECT_URI=https://tomatophp.test/login/twitter-oauth-2/callback

FACEBOOK_CLIENT_ID=
FACEBOOK_CLIENT_SECRET=
FACEBOOK_REDIRECT_URI=https://tomatophp.test/login/facebook/callback

DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_URL=https://tomatophp.test/login/discord/callback

SNAPCHAT_CLIENT_ID=
SNAPCHAT_CLIENT_SECRET=
SNAPCHAT_CALLBACK=https://tomatophp.test/login/snapchat/callback

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_CALLBACK=https://tomatophp.test/login/google/callback

GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_URL=https://tomatophp.test/login/github/callback

and you need to allow services on your config/services.php

'twitter' => [
    'client_id' => env('TWITTER_CLIENT_ID'),
    'client_secret' => env('TWITTER_CLIENT_SECRET'),
    'client_token' => env('TWITTER_CLIENT_TOKEN'),
    'redirect' => env('TWITTER_REDIRECT_URI'),
],

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

'discord' => [
    'client_id' => env('DISCORD_CLIENT_ID'),
    'client_secret' => env('DISCORD_CLIENT_SECRET'),
    'redirect' => env('DISCORD_URL'),
],

'snapchat' => [
    'client_id' => env('SNAPCHAT_CLIENT_ID'),
    'client_secret' => env('SNAPCHAT_CLIENT_SECRET'),
    'redirect' => env('SNAPCHAT_CALLBACK'),
],

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

'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => env('GITHUB_URL'),
],

Use Social Share Component

if you like to use share buttons to your view it's very easy to use our blade component

<x-filament-social-share inline facebook twitter pinterest reddit telegram whatsapp linkedin copy print mail />

Use Social Share Action

you can use the share buttons actions like any action on the FilamentPHP and we have multi extend to support Table, Forms, and Pages

use TomatoPHP\FilamentSocial\Filament\Actions\SocialShareAction;

public function actions(): array
{
    return [
        SocialShareAction::make()
            ->inline()
            ->facebook()
            ->twitter()
            ->pinterest()
            ->reddit()
            ->telegram()
            ->whatsapp()
            ->linkedin()
            ->copy()
            ->print()
            ->mail()
    ];
}

you can use the button as a dropdown or you can use it as inline icons buttons using ->inline() method

Social Auth Events

we have 2 events that you can listen to

  • TomatoPHP\FilamentSocial\Events\SocialLogin
  • TomatoPHP\FilamentSocial\Events\SocialRegister

you can listen to these events and do your logic

Support Profile Picture And Username

some platforms will not gave you an access to email but it will give you the username to support that we add a migration to change on users table you can copy it and run it on your own table if you are using a custom table

$table->string('profile_photo_path', 2048)->nullable();
$table->string('email')->nullable()->change();
$table->string('username')->nullable()->unique();

Publish Assets

you can publish config file by use this command

php artisan vendor:publish --tag="filament-social-config"

you can publish views file by use this command

php artisan vendor:publish --tag="filament-social-views"

you can publish languages file by use this command

php artisan vendor:publish --tag="filament-social-lang"

you can publish migrations file by use this command

php artisan vendor:publish --tag="filament-social-migrations"

Other Filament Packages

Checkout our Awesome TomatoPHP