Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lartie/attachsocialaccount
Laravel Package for SocialNetworks
https://github.com/lartie/attachsocialaccount
account auth composer laravel laravel-package social social-networks socialite
Last synced: 14 days ago
JSON representation
Laravel Package for SocialNetworks
- Host: GitHub
- URL: https://github.com/lartie/attachsocialaccount
- Owner: lartie
- License: mit
- Created: 2016-04-11T22:37:22.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-08-04T06:49:30.000Z (over 8 years ago)
- Last Synced: 2024-04-23T02:54:48.933Z (7 months ago)
- Topics: account, auth, composer, laravel, laravel-package, social, social-networks, socialite
- Language: PHP
- Homepage:
- Size: 12.7 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Attach Social Account For Laravel 5.2
[](https://packagist.org/packages/lartie/attach-social-account)
[](https://packagist.org/packages/lartie/attach-social-account)
[](https://packagist.org/packages/lartie/attach-social-account)
[](https://packagist.org/packages/lartie/attach-social-account)
[](https://packagist.org/packages/lartie/attach-social-account)
- [Installation](#installation)
- [Composer](#composer)
- [Service Provider](#service-provider)
- [Config File And Migrations](#config-file-and-migrations)
- [HasSocialAccount Trait And Contract](#hassocialaccount-trait-and-contract)
- [Usage](#usage)
- [Creating Social Network](#creating-social-network)
- [Attach Social Account](#attach-social-account)
- [Detach Social Account](#detach-social-account)
- [Checking](#checking)
- [Blade Extensions](#blade-extensions)
- [License](#license)
## Installation
### Composer
composer require lartie/attach-social-account
### Service Provider
Add the package to your application service providers in `config/app.php` file.
```php
'providers' => [
/*
* Application Service Providers..
*/
App\Providers\AppServiceProvider::class,
App\Providers\AuthServiceProvider::class,
App\Providers\EventServiceProvider::class,
App\Providers\RouteServiceProvider::class,
...
/*
* Extensions
*/
LArtie\AttachSocialAccount\ServiceProvider::class,
],
```
### Config File And Migrations
Publish the package config file and migrations to your application. Run these commands inside your terminal.
php artisan vendor:publish
And also run migrations.
php artisan migrate
> This uses the default users table which is in Laravel. You should already have the migration file for the users table available and migrated.
### HasSocialAccount Trait And Contract
Include `HasSocialAccount` trait and also implement `HasSocialAccount` contract inside your `User` model.
```php
use LArtie\AttachSocialAccount\Core\Traits\HasSocialAccount;
use LArtie\AttachSocialAccount\Core\Contracts\HasSocialAccount as HasSocialAccountContract;
class User extends Authenticatable implements HasSocialAccountContract
{
use HasSocialAccount;
```
And that's it!
## Usage
```php
$user = User::first();
$vkData = [
'token' => 'token',
'uid' => 'user_id',
'nickname' => 'username',
'name' => 'first name and last name',
'email' => '[email protected]',
'avatar' => 'link_to',
];
```
### Creating Social Network
```php
$socialNetwork = SocialNetworks::create([
'provider' => 'vkontakte',
'short_name' => 'vk'
]);
```
### Attach Social Account
```php
$user->attachSocialAccountById($socialNetwork->id, $vkData);
```
or
```php
$user->attachSocialAccountByShortName('vk', $vkData);
```
or
```php
$user->attachSocialAccountByProvider('vkontakte', $vkData);
```
### Detach Social Account
```php
$user->detachSocialAccountById($socialNetwork->id);
```
or
```php
$user->detachSocialAccountByShortName('vk');
```
or
```php
$user->detachSocialAccountByProvider('vkontakte');
```
### Checking
```php
$user->hasSocialAccountById($socialNetwork->id);
```
or
```php
$user->hasSocialAccountByShortName('vk');
```
or
```php
$user->hasSocialAccountByProvider('vkontakte');
```
### Blade Extensions
```php
@providerExists('vkontakte') {
// see detach button, etc..
}
@providerNotExists('vkontakte') {
// see attach button, etc..
}
```
> For more information visit trait `HasSocialAccount` or contract `HasSocialAccount`
## License
This package is free software distributed under the terms of the MIT license.