README

Yii2 社交链接分享

使用 Bootstrap Social 和 Font Awesome 构建，两个非常酷的项目！请注意，这是一个正在进行中的项目。

安装

推荐通过 composer 安装

    composer require --prefer-dist alkurn/yii2-socialshare "dev-master"

或添加到 composer.json

    "alkurn/yii2-socialshare": "dev-master"

示例使用

    use alkurn\socialshare\Share;

默认情况下，您可以在不配置参数的情况下运行小部件

    echo Share::widget();

这将生成一个无序列表 "ul" 标签，如下所示

    <ul>
        <li><a>....</a></li>
        <li><a>....</a></li>
        <li><a>....</a></li>
    </ul>

更改小部件布局

    echo Share::widget([
        'type' => 'small',
        'tag' => 'div',
        'template' => '<div>{button}</div>',
    ]);

输出结果将类似于以下内容

    <div>
        <div><a> .... </a></div>
        <div><a> .... </a></div>
        <div><a> .... </a></div>
    </div>

共享的 URL

默认情况下，小部件将 URL 设置为当前路由，您可以通过使用 "url" 属性根据需要更改它。

    echo Share::widget([
        'url' => 'http://www.domain.com',
    ]);

或者

    echo Share::widget([
        'url' => Url::to(['site/index'] , TRUE),
    ]);

别忘了要求辅助库 Url，并使用方法的第二个参数来使用页面的完整 URL。

    use yii\helpers\Url;

共享的数据

默认情况下，小部件仅传递给社交网络的 URL。某些网络（例如 Pinterest）允许传递标题、描述和图片。您可以根据需要使用 "title"、"description" 或 "image" 属性进行更改。

    echo Share::widget([
        'title' => 'Some title',
        'description' => 'Some description',
        'image' => '/path-to-some-image.jpg',
    ]);

主要容器的属性

您可以使用 htmlOptions 属性添加或更改主要容器的属性。默认情况下，主要容器有一个类似于 #w0 的 id 属性，如果您想更改它，可以这样做。

    echo Share::widget([
        'htmlOptions' => [
            'id' => 'new-id',
            'class' => 'my-class',
        ],
    ]);

小部件按钮类型

小部件提供两种类型的按钮：小（仅图标）和大（图标+文本）

    echo Share::widget([
        'type' => Share::TYPE_SMALL
    ]);

    echo Share::widget([
        'type' => Share::TYPE_LARGE
    ]);

大按钮的默认文本为 "在 NETWORK 上分享"，其中 NETWORK 是社交网络名称，例如：Facebook。您可以通过使用小部件的 "text" 属性来更改默认文本。

    echo Share::widget([
        'text' => 'Click to share on {network}',
    ]);

网络

目前小部件提供 6 个按钮：Facebook Google Plus Twitter Pinterest Linkedin Vk odnoklassniki

仅包括某些网络

由于某些原因，您可能只需要包括某些网络。为了做到这一点，您可以使用小部件的 "include" 属性。

    echo Share::widget([
        'include' => ['network1', 'network2']
    ]);

显示的社交网络将按照您放置它们的顺序显示。

排除某些网络

由于某些原因，您可能需要排除一个或多个网络。为此，您可以使用小部件的 "exclude" 属性。

    echo Share::widget([
        'exclude' => ['network1', 'network2']
    ]);

贡献

非常欢迎贡献，只需分支、修改和提交拉取请求即可。

alkurn / yii2-socialshare

维护者

详细信息