liran-co / laravel-frontend-services
轻松将第三方服务添加到前端。
v0.1
2021-04-16 23:00 UTC
Requires
- php: ^7.4|^8.0
- laravel/framework: ^7.0|^8.0
README
⚠️ 注意:这是一个预发布版本,尚未准备好用于生产环境。
Laravel Frontend Services 提供了 Blade 组件,使得集成和包含第三方服务的脚本变得更加容易。
安装
要开始使用,请安装 liran-co/laravel-frontend-services 包
composer require liran-co/laravel-frontend-services
用法
首先,在 config/services.php 文件中添加您想使用的每个服务的相关配置值。
<?php
return [
// ...
'intercom' => [
'app_id' => env('INTERCOM_APP_ID'),
],
// ...
];
下面列出了所有受支持的服务及其相应的配置键的全列表。
接下来,使用 Blade 组件语法将服务包含到您的视图中
<x-services::intercom />
通常,您会在网站的 <head> 部分或 </body> 标签之前执行此操作。
高级用法
显示
如果您想根据某些条件包含一个服务,您可以在组件上使用 show 属性。例如,要仅在用户登录时包含 Intercom 服务,您可以这样做
<x-services::intercom show={Auth::check()} />
环境
由于通常只在生产环境中包含某些脚本,您可以在配置文件中定义一个 environments 键,如果当前环境与数组中的某个匹配,则自动包含该服务
'intercom' => [
'app_id' => env('INTERCOM_APP_ID'),
'environments' => ['production', 'staging'],
],