Salla Ecommerce OAuth2 Provider for Laravel Socialite

dev-master 2024-09-11 23:32 UTC

This package is auto-updated.

Last update: 2024-09-12 08:20:49 UTC


README

composer require socialiteproviders/salla

在Salla合作伙伴上创建账户和应用

首先您需要在Salla合作伙伴门户上注册账户并创建您的应用以获取凭据 client_id & client_secret。有关更多信息,请参阅文档 Salla API 文档

安装与基本用法

请参阅基本安装指南,然后按照以下特定提供者的说明进行操作。

config/services.php中添加配置

'salla' => [    
    'client_id' => env('SALLA_CLIENT_ID'),
    'client_secret' => env('SALLA_CLIENT_SECRET'),
    'redirect' => env('SALLA_REDIRECT_URI'),
],

添加提供者事件监听器

Laravel 11+

在Laravel 11中,默认的EventServiceProvider提供者已被移除。取而代之,您可以在AppServiceProviderboot方法中使用Event外观的listen方法添加监听器。

  • 注意:除非您用自己的提供者覆盖它们,否则您不需要为内置的Socialite提供者添加任何内容。
Event::listen(function (\SocialiteProviders\Manager\SocialiteWasCalled $event) {
    $event->extendSocialite('salla', \SocialiteProviders\Salla\Provider::class);
});
Laravel 10或以下配置包的监听器以监听`SocialiteWasCalled`事件。

将事件添加到app/Providers/EventServiceProvider中的listen[]数组中。有关详细说明,请参阅基本安装指南

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... other providers
        \SocialiteProviders\Salla\SallaExtendSocialite::class.'@handle',
    ],
];

用法

现在您应该可以使用提供者,就像您通常使用Socialite一样(假设您已安装外观)

return Socialite::driver('salla')->redirect();

在重定向后,您可能返回用户实例

return Socialite::driver('salla')->user();

返回的用户字段

  • id
  • name
  • email
  • mobile
  • role
  • merchant
    • id
    • username
    • name
    • avatar
    • plan
    • status
    • domain
    • tax_number
    • commercial_number