vpominchuk / laravel-easy-share
Laravel EasyShare:完全定制的社交分享按钮。
v1.0
2022-12-08 21:55 UTC
Requires
- php: ^7.4|^8.0
- illuminate/support: ^6.0|^7.0|^8.0|^9.0
README
laravel-easy-share
Laravel EasyShare是一个完全定制且易于使用的社交分享按钮组件。
就像数到四那么简单
1. 安装
$ composer require vpominchuk/laravel-easy-share
2. 发布示例配置文件
$ php artisan vendor:publish --tag=easy-share-config
3. 将组件添加到视图。
<x-easy-share />
4. 添加一些CSS样式
.easy-share { display: flex; } .easy-share li { margin-right: 1.5rem; }
然后就可以使用了!
可用的社交网络
- Viber
- Telegram
管理社交网络
您可以轻松地添加/删除/启用/禁用可用的社交网络。只需打开 config/easy-share.php 文件并添加您喜欢的任何社交网络。
配置选项
使用SVG图标
要使用自己的SVG图标,只需将SVG图标文件的內容放入配置文件中相应图标的 content 键。
使用Fontawesome或其他图标库
与SVG相同,只需将 <i class="fa-brands fa-twitter"></i> 放入配置文件的 content 键。
组件参数
默认情况下,您可以使用 <x-easy-share /> 而无需任何属性,它将检测当前页面的URL,但 不会 检测页面标题。
可以传递自定义属性到自定义模板。
使用自定义视图(模板)
要使用自定义模板,只需在 resources/views/ 下创建一个名为 easy-share 的文件夹,并将您的自定义模板放入其中。
<ul class="easy-share"> @foreach($services as $name => $service) <li class="easy-share-{{$name}} {{$service['class'] ?? ''}}"> <a href="{{$service['url'] ?? '#'}}" target="_blank" title="{{$service['title']}}">{!! $service['content'] ?? '' !!}</a> </li> @endforeach </ul>
<x-easy-share /> 组件中的自定义属性将被传递到您的自定义模板。
所有Kebab Cased和Snake Cased属性都将转换为驼峰式,例如
<x-easy-share my-first-attribute="1" my_second_attribute="2" />
将转换为 {{$myFirstAttribute}} 和 {{$mySecondAttribute}}。
获取分享链接作为PHP数组
您可以使用 EasyShare 门面获取分享链接的纯PHP数组。示例
use Illuminate\Support\Facades\URL; use \VPominchuk\EasyShare\Facades\EasyShare; $url = URL::current(); $easyShare = EasyShare::setUrl($url); $array = $easyShare ->setTitle($pageTitle) ->setSummary($summary) ->getServices();
有两种附加方法
安全
如果您发现任何与安全相关的问题,请使用问题跟踪器。
致谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件。