PHPackages acacha/laravel-social - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. acacha/laravel-social ActiveLibrary[Authentication & Authorization](/categories/authentication) acacha/laravel-social ===================== Social Login/Register implementation using Laravel Socialite and AdminLTE Laravel package 0.2(8y ago)425.8k7[5 issues](https://github.com/acacha/laravel-social/issues)1MITPHPPHP ~5.6|~7.0CI failing Since Feb 20Pushed 8y ago1 watchersCompare [ Source](https://github.com/acacha/laravel-social)[ Packagist](https://packagist.org/packages/acacha/laravel-social)[ Docs](https://github.com/acacha/laravel-social)[ RSS](/packages/acacha-laravel-social/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (6)Versions (19)Used By (1) laravel-social ============== [](#laravel-social) [![Latest Version on Packagist](https://camo.githubusercontent.com/be80c56dd4555356ce297bcc892737a1cac9dcd5dd808d0f046083537b08bc95/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6163616368612f6c61726176656c2d736f6369616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/acacha/laravel-social)[![Total Downloads](https://camo.githubusercontent.com/0de998876988ee09ef9e2dddf2f536c09f3c00616a79735a0c1bf630817bfdb2/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c61726176656c2d736f6369616c2f646f776e6c6f6164732e706e67)](https://packagist.org/packages/acacha/laravel-social)[![Monthly Downloads](https://camo.githubusercontent.com/b1037a6cdb9d087d81d85fed93db1c5853fb4e39b179a1f153f4124e9fceb57d/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c61726176656c2d736f6369616c2f642f6d6f6e74686c79)](https://packagist.org/packages/acacha/laravel-social)[![Daily Downloads](https://camo.githubusercontent.com/c3b6ed662cf2b90a4885abd06ef17d9ed10dffb6fe36d8d25ff8475bb07854c4/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c61726176656c2d736f6369616c2f642f6461696c79)](https://packagist.org/packages/acacha/laravel-social)[![Latest Stable Version](https://camo.githubusercontent.com/2435771b15908f75cb4666821940b50b9f36e4692897ff2d1453cc81a604a93c/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c61726176656c2d736f6369616c2f762f737461626c652e706e67)](https://packagist.org/packages/acacha/laravel-social)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/d6d63fc7f413c65e17d432280f543560d74d316c999a08e715f5eff66e223fd7/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6163616368612f6c61726176656c2d736f6369616c2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/acacha/laravel-social)[![Quality Score](https://camo.githubusercontent.com/482d4b40bfb1a29b29d6e6bf7a8dac98acffa14865a574266d285360e3e4da23/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6163616368612f6c61726176656c2d736f6369616c2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/acacha/laravel-social)[![StyleCI](https://camo.githubusercontent.com/be18ce1d2a533266f4e4f446e59e690907524f7f9773318356de5389f21d51b9/68747470733a2f2f7374796c6563692e696f2f7265706f732f38323239303339342f736869656c64)](https://styleci.io/repos/82290394) A Laravel 5 package for **OAuth Social Login/Register** implementation using [Laravel socialite](https://github.com/laravel/socialite) and (optionally) [AdminLTE Laravel package](https://github.com/acacha/adminlte-laravel). Installation ------------ [](#installation) Using adminlte laravel (recommended option) ------------------------------------------- [](#using-adminlte-laravel-recommended-option) Install [AdminLTE Laravel package](https://github.com/acacha/adminlte-laravel): ``` composer global require "acacha/adminlte-laravel-installer" laravel new awesome cd awesome adminlte-laravel install adminlte-laravel social ``` Then optionally you can boostrap you project in your favourite browser using: ``` llum boot ``` Using composer -------------- [](#using-composer) Use Composer, in you Laravel project: ``` $ composer require acacha/laravel-social ``` Add service provider to providers array in your **config/app.php** file: ``` Acacha\LaravelSocial\Providers\LaravelSocialServiceProvider::class ``` And run command: ``` php artisan make:social ``` To configure social network providers. Finally modify your app views to add links to Social Login using link: ``` http://yourappurl.com/auth/{socialnetwork} ``` Examples: ``` http://yourappurl.com/auth/github http://yourappurl.com/auth/facebook http://yourappurl.com/auth/google http://yourappurl.com/auth/twitter http://yourappurl.com/auth/linkedin ``` I recommend you to use [AdminLTE Laravel Package](https://github.com/acacha/adminlte-laravel) for a full working Auth scaffolding with Adminlte bootstrap template. See previous section. You can also use Laravel default Auth scaffolding running command: ``` php artisan make:auth ``` And manually add button/links to social Login/Register. Usage ----- [](#usage) You can configure Social Providers with command: ``` php artisan acacha:social Which social network you wish to configure? [Github]: [0] Github [1] Facebook [2] Google [3] Twitter [4] Linkedin > 0 Configuring social network Github... Please register a new OAuth app for Github. Go to URL https://github.com/settings/applications/new Then ask the following questions: OAuth client id?: > 3a1fg6ac5437f9f4cebd OAuth client secret?: > 5919185e3fb7024e5b10cedce5cce408893224d OAuth client redirect URL? [http://localhost:8080/auth/github/callback]: > File /home/sergi/Code/socialAdminLTEtest/config/services.php updated. Github added to config/services.php file Do you wish to configure other social networks? (yes/no) [yes]: ``` This wizard will adapt your `.env` and `config/services.php` files to add your social networks OAuth data. At this moment command `php artisan acacha:social` will not check if you have already configured your social network so be carefull when executing this command in already configured projects (no errors will be thrown but you will have repeated data in your config files). Requirements ------------ [](#requirements) Please install [AdminLTE Laravel](https://github.com/acacha/adminlte-laravel): ``` composer global require "acacha/adminlte-laravel-installer" ``` This package also requires (all installed using composer): - [Laravel framework](https://github.com/laravel/frameworks) - [Laravel socialite](https://github.com/laravel/socialite) - [Doctrine dbal](https://github.com/doctrine/dbal) - [Acacha filesystem](https://github.com/acacha/filesystem) See also related projects: - [AdminLTE Laravel](https://github.com/acacha/adminlte-laravel) - [Acacha llum](https://github.com/acacha/llum) - [AdminLTE](https://github.com/almasaeed2010/AdminLTE) Social networks --------------- [](#social-networks) Laravel social package support by default the following social networks: - Github - Facebook - Google - Twitter - Linkedin Laravel social use [Illuminate\\Support\\Manager](https://laravel.com/api/5.4/Illuminate/Support/Manager.html) so you can create your own driver and register the driver in LaravelSocialServiceProvider. Please, if you create a new driver feel free to create a Pull Request. You can enable/disable social providers easily. See following section. ### Enable/disable social providers [](#enabledisable-social-providers) At class `LaravelSocialServiceProvider` you can modify `$enabled` field to change enabled social providers. Also remember to changes your views to add/remove action/links to social auth. Also you have to change static variable `$socialNetworks` in file ConfigureSocialServicesManager to add your extra social providers. ### Github [](#github) The cli wizard will propose you to go to page: to register new OAuth Application. ### Facebook [](#facebook) The cli wizard will propose you to go to page: to register new OAuth Application ### Google [](#google) The cli wizard will propose you to go to page: to register new OAuth Application. Please remember to active Google+ API!. More info at . ### Twitter [](#twitter) The cli wizard will propose you to go to page: to register new OAuth Application. Retrieve your api keys at tab `Keys and Access Tokens`and remember to check `Request email addresses from users` checkbox active in `Permissions` tab. ### Linkedin [](#linkedin) The cli wizard will propose you to go to page: to register new OAuth Application. Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Testing ------- [](#testing) In your Laravel project execute: ``` $ phpunit tests/AcachaLaravelSocial.php ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Sergi Tur Badenas](https://github.com/acacha) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 33 — LowBetter than 75% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity32 Limited adoption so far Community15 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 95.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~29 days Recently: every ~7 days Total 14 Last Release 2982d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c2d6b3764878ff9fcb0b42e2f6e3a6680b8ea9f7ea4f73028559df7d60f1be78?d=identicon)[acacha](/maintainers/acacha) --- Top Contributors [![acacha](https://avatars.githubusercontent.com/u/4015406?v=4)](https://github.com/acacha "acacha (40 commits)")[![alexeydemin](https://avatars.githubusercontent.com/u/6114701?v=4)](https://github.com/alexeydemin "alexeydemin (2 commits)") --- Tags acachaadminlteadminlte-templateauthenticationlaravellaravel-packagelaravel5-packagellumoauthsocialiteacachalaravel-social ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/acacha-laravel-social/health.svg) ``` [![Health](https://phpackages.com/badges/acacha-laravel-social/health.svg)](https://phpackages.com/packages/acacha-laravel-social) ``` ### Alternatives [acacha/user A boosted User for Laravel 26249.8k1](/packages/acacha-user)[eveseat/web SeAT Web Interface 2723.2k135](/packages/eveseat-web)[regulus/identify A Laravel 5 authentication/authorization package that adds roles, permissions, access levels, and user states. Allows simple or complex user access control implementation. 174.7k1](/packages/regulus-identify) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)