max13 / telegram-socialite
Telegram provider for Laravel Socialite
Requires
- illuminate/support: ~5.7.0|~5.8.0|^6.0|^7.0
- laravel/socialite: ^4.0
This package is auto-updated.
Last update: 2024-04-19 22:11:14 UTC
README
TelegramSocialite
Telegram provider for Laravel Socialite
Install
composer require max13/telegram-socialite
Configuration
First of all, you must create a bot by contacting @BotFather (https://core.telegram.org/bots#6-botfather)
Don't forget to set your website URL using
/setdomain
Then, as required by Laravel Socialite, you need to add your bot's configuration to config/services.php. The bot username is required, client_id must be null. The provider will also ask permission for the bot to write to the user.
'telegram' => [ 'client_id' => null, 'client_secret' => env('TELEGRAM_TOKEN'), 'redirect' => '/login/telegram/callback', ]
Usage
Now, Telegram is technically using OAuth, but not the usual workflow.
First or all, you must add a javascript to your page, anywhere you want (in the <head> or bottom of page) with this snippet:
{!! Socialite::driver('telegram')->getScript() !!}
You also must call _TWidgetLogin.auth() on click on your login button, which will open a popup showing the Telegram OAuth access request. Because of browser's security, you can't automatically call this, it must be called as a result of a user's action.
If the user accept the access request, the browser is redirected to your services.telegram.redirect config key and you will have access to the logged-in user data the classic Socialite way:
Socialite::driver('telegram')->user();
If the user declines, an InvalidArgumentException exception will be thrown.
Using Socialite::driver('telegram')->redirect() will abort the connection with a 404 error.
If you want to see the Telegram Widget configuration page: https://core.telegram.org/widgets/login