strangefate / socialrouter
此包将为Laravel Socialite包添加并处理路由,同时包含一些默认视图和Sass文件。
Requires
- php: ^7.2.5|^8.0
- laravel/framework: ^8.0|^9.0
- laravel/socialite: ^5.0
This package is auto-updated.
Last update: 2024-09-20 23:54:11 UTC
README
此包将安装Laravel Socialite并为您的项目添加路由,以便使用社交网络平台进行登录。您可以通过配置文件轻松配置可用的网络。此包包括用于项目的简单视图,以及包含社交平台品牌颜色的Sass文件。
此包包含检查以确保只有配置的网络可访问。用户可以将他们的账户升级到社交平台以方便访问。用户不能使用相同的电子邮件地址注册多个网络,以防止账户仿冒。
包安装
需要包
composer require strangefate/socialrouter
运行迁移以将平台变量添加到用户数据库
php artisan migrate
修改用户模型以便新字段可填写
//old
protected $fillable = [
'name', 'email', 'password',
];
//new - option 1
protected $fillable = [
'name', 'email', 'password','platform','platform_id','platform_image'
];
//new - option 2
protected $guarded = ['email_verified_at', 'remember_token'];
您可以通过检查项目中的路由列表来测试包是否正确安装。您应该看到两个新路由:用于 /auth/{provider} 和 /auth/logout 的路由
php artisan route:list
配置
社交路由包中提供了几个默认平台,请参阅Laravel Socialite文档和社交网络的平台,以获取有关支持的详细信息以及如何配置它们的说明。发布配置文件以配置应用程序要支持的平台。配置文件还包含将变量添加到您的服务配置和.env文件的代码片段。
php artisan vendor:publish --provider=StrangeFate\SocialRouter\SocialRouterServiceProvider --tag=config
从 socialrouter.php 文件中删除您不想要的提供者,在应用程序的 config\services.php 中配置访问令牌。只有配置文件中列出的提供者才会受到支持,配置文件中未列出的任何内容都会返回404错误。
资产
您可以将Sass和视图文件发布出来以自定义您的网站模板。
php artisan vendor:publish --provider=StrangeFate\SocialRouter\SocialRouterServiceProvider --tag=assets
Sass文件包含您项目标准社交平台品牌颜色集合。将此文件添加到您的Sass项目中,它将为平台创建锚标签类或具有该平台背景的按钮。
resources\sass\socialcolors.scss
socialcolors.scss 是一个Sass文件,其中包含您所有项目的品牌颜色。将其添加到您的Sass编译中,以将它们添加到样式表中。
@import "socialcolors";
<a class="twitter" href="#">Twitter</a>
<button class="button facebook">Facebook</button>
视图模板
社交路由包含预制的模板,您可以将它们包含到项目中。模板基于Zurb Foundation Sites库。自定义这些模板以适应您的平台。
@include('socialrouter::menu-list-default')
@include('socialrouter::inline-list')
@include('socialrouter::menu-list-vertical')
@include('socialrouter::button-list')