vpominchuk/laravel-easy-share

Laravel EasyShare:完全定制的社交分享按钮。

v1.0 2022-12-08 21:55 UTC

This package is auto-updated.

Last update: 2024-09-09 22:38:45 UTC


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;
}

然后就可以使用了!

可用的社交网络

  • Facebook
  • Twitter
  • LinkedIn
  • WhatsApp
  • 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)。有关更多信息,请参阅许可证文件