Package Data | |
---|---|
Maintainer Username: | Kolovious |
Maintainer Contact: | cololeo@gmail.com (Leonardo Garcia) |
Package Create Date: | 2016-04-07 |
Package Last Update: | 2020-07-07 |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-19 03:15:44 |
Package Statistics | |
---|---|
Total Downloads: | 1,132 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 6 |
Total Watchers: | 2 |
Total Forks: | 15 |
Total Open Issues: | 3 |
Mercadolibre Laravel Socialite is open-sourced software licensed under the MIT license
composer require kolovious/melisocialite
After installing the Socialite library, register the Kolovious\MeliSocialite\MeliSocialiteServiceProvider
in your config/app.php
configuration file after the Socialite Service Provider:
'providers' => [
// Other service providers...
Laravel\Socialite\SocialiteServiceProvider::class,
Kolovious\MeliSocialite\MeliSocialiteServiceProvider::class,
],
Also the Meli Facade is available for actions with the API
'alias' => [
// Other alias...
'Meli' => Kolovious\MeliSocialite\Facade\Meli::class,
],
You will also need to add credentials for the OAuth services your application utilizes. These credentials should be placed in your config/services.php
configuration file:
'meli' => [
'client_id' => 'your-meli-app-id',
'client_secret' => 'your-meli-secret-code',
'redirect' => 'http://your-callback-url',
],
Next, you are ready to authenticate users! You will need two routes: one for redirecting the user to the OAuth provider, and another for receiving the callback from the provider after authentication. We will access Socialite using the Socialite
facade:
<?php
namespace App\Http\Controllers;
use Socialite;
class AuthController extends Controller
{
/**
* Redirect the user to the Meli authentication page.
*
* @return Response
*/
public function redirectToProvider()
{
return Socialite::driver('meli')->redirect();
}
/**
* Obtain the user information from Meli.
*
* @return Response
*/
public function handleProviderCallback()
{
$user = Socialite::driver('meli')->user();
// $user->token;
}
}
The redirect
method takes care of sending the user to the OAuth provider, while the user
method will read the incoming request and retrieve the user's information from the provider.
Of course, you will need to define routes to your controller methods:
Route::get('auth/meli', 'Auth\AuthController@redirectToProvider');
Route::get('auth/meli/callback', 'Auth\AuthController@handleProviderCallback');
Once you have a user instance, you can grab a few more details about the user:
$user = Socialite::driver('meli')->user();
// Tokens & Expire time
$token = $user->token;
$refresh_token = $user->refresh_token;
$expires_at = $user->expires_at; // UNIX TIMESTAMP
// Methods from Socialite User
$user->getId();
$user->getNickname();
$user->getName();
$user->getEmail();
// Raw Data
$user->user // Provided by Meli
// Items from User ( ALL )
$offset = 0;
$call= "/users/".$user_id."/items/search";
$result = Meli::get($call, ["offset"=>$offset, 'access_token'=>$access_token]);
// Update Item Description
// Will use the saved access_token in the MeliManager object.
$result = Meli::withToken()->put('/items/'.$item_id.'/description', [ 'text' => $this->description ]);
or
// Will save this token for future uses. Same as above.
$result = Meli::withToken($token)->put('/items/'.$item_id.'/description', [ 'text' => $this->description ]);
or
// Will use the Access Token in the Auth user, and save it for future uses. You can call withToken() the next time and it will work as espected
$result = Meli::withAuthToken()->put('/items/'.$item_id.'/description', [ 'text' => $this->description ]);