README

用于在社交媒体上发布链接的小部件。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令：

$ composer require "webulla/yii2-sharelinks":"*"

用法

首先，您需要连接小部件

use webulla\sharelinks\ShareLinks;

然后，您可以使用默认配置的小部件通过 Facebook、Twitter、Vkontakte 和电子邮件进行分享

echo ShareLinks::widget([
	'links' => [
		'facebook' => [],
		'twitter' => [],
		'vkontakte' => [],
		'email' => [],
	]
]);

或者，您可以覆盖任何默认设置

echo ShareLinks::widget([
	// page url (default: Yii::$app->request->absoluteUrl)
	'url' => 'http://yoursite.com/page',

	// page title (default: Yii::$app->view->title)
	'title' => 'Page title',

	// page description
	'body' => 'Page description',

	// links collection
	'links' => [
        // default service
		'facebook' => ['label' => 'Facebook'],

		// custom service in popup window
		'service' => ['label' => 'Share via Service',
		    'url' => 'http://service.com/share?title={title}&body={body}&url={url}'
        ],

		// custom service in new tab
		'service-manual' => ['label' => 'Share via Service',
		    'url' => 'http://service.com/share?title={title}&body={body}&url={url}',
            'options' => [
                'class' => 'share-link-manual',  // disable on click event listening
                'target' => '_blank', // open link in new tab
            ]
        ],
	]
]);

预定义服务

$services = [
	'twitter' => ['label' => 'Share via twitter'],
	'facebook' => ['label' => 'Share via Facebook'],
	'vkontakte' => ['label' => 'Share via Vkontakte'],
	'gplus' => ['label' => 'Share via Google Plus'],
	'linkedin' => ['label' => 'Share via Linkedin'],
	'kindle' => ['label' => 'Share via Kindle'],
	'email' => ['label' => 'Share via E-mail'],
];