inspiredminds / contao-facebook-login
Contao 4 的 Facebook 登录插件。
Requires
- php: >=7.1
- contao/core-bundle: ^4.6
- facebook/graph-sdk: ^5.6.2
- fritzmg/contao-facebook-js-sdk: ^3.1
- symfony/routing: ^3.0 || ^4.0 || ^5.0
Requires (Dev)
- contao/manager-plugin: ^2.0
- friendsofphp/php-cs-fixer: ^2.19 || ^3.0
README
Contao Facebook Login
Contao 4 的 Facebook 登录插件。
安装
通过 composer 安装包
composer require inspiredminds/contao-facebook-login
如果您使用的是 Contao 标准版,您需要在 AppKernel.php 中添加
new FacebookLoginBundle\FacebookLoginBundle()
。您还需要将包的路由添加到 app/config/routing.yml
FacebookLoginBundle: resource: "@FacebookLoginBundle/Resources/config/routing.yml"
然后执行 Contao 安装工具(无论您使用哪个版本)。
使用说明
Facebook 应用
在能够使用 Facebook 登录之前,您需要在 developers.facebook.com/apps 下为您的网站创建一个 Facebook 应用。请确保至少填写以下字段
- 设置 » 基本 » 添加平台 » 网站:输入您站点的基本 URL,例如
http://example.org。 - 设置 » 基本 » 应用域:填写您站点的域名,例如
example.org。
然后您需要在左侧的 产品 下配置 Facebook 登录。如果该产品不存在,您需要先通过 + 添加产品 手动添加。请确保填写 有效的 OAuth URI 为您站点的以下 URL:http://example.org/fblogincallback。如果您使用 https,请使用该协议(或两者都使用)。其余设置如截图所示
可以启用 对重定向 URI 使用严格模式(新 Facebook 应用默认启用此选项)。然后在 应用审核 下使您的应用公开。
Contao 配置
创建 Facebook 应用后,您需要设置 Facebook App ID 和 Facebook App Secret。您可以在网站根目录或系统设置中定义这些值。如果您使用多域名配置,请使用前者。
Facebook 登录模块
只需在您的主题中创建一个 Facebook 登录模块并包含它。它的工作方式和行为与 Contao 的常规登录模块相同,并提供相同的设置,以及定义新注册用户所属的成员组和决定从 Facebook 存储哪些个人数据的能力。
您还可以定义额外的 Facebook 登录权限。这些将被添加到默认权限中。模块还会在会话中保存用户访问令牌,变量为 facebook_login_access_token,供以后使用。
授权
此包使用由 Kamil Kuzminski 提供并最初使用的代码。
