Extension for sharing on social networks
With this extension you can share data from your web pages to any social network! Features: SEO support, default icons for social networks, easy creation of custom drivers for other social networks and more!
Documentation is at docs/guide/README.md.
Extension supports from the box next social network drivers:
drivers for messengers:
and other drivers:
also you can create your driver, it's very simple!
Installation
The preferred way to install this extension is through composer.
Either run
$ composer require yiimaker/yii2-social-share
or add
"yiimaker/yii2-social-share": "~2.3"
to the require
section of your composer.json
.
Usage
Configure social networks in config file
'components' => [
// ...
'socialShare' => [
'class' => \ymaker\social\share\configurators\Configurator::class,
'socialNetworks' => [
'vkontakte' => [
'class' => \ymaker\social\share\drivers\Vkontakte::class,
],
'facebook' => [
'class' => \ymaker\social\share\drivers\Facebook::class,
],
'odnoklasniki' => [
'class' => \ymaker\social\share\drivers\Odnoklassniki::class,
],
],
],
],
and then call widget in view file
<?= \ymaker\social\share\widgets\SocialShare::widget([
'configurator' => 'socialShare',
'url' => \yii\helpers\Url::to('absolute/route/to/page', true),
'title' => 'Title of the page',
'description' => 'Description of the page...',
'imageUrl' => \yii\helpers\Url::to('absolute/route/to/image.png', true),
]); ?>
Tests
You can run tests with composer command
$ composer test
or using following command
$ ./vendor/bin/codecept build && ./vendor/bin/codecept run
Contributing
For information about contributing please read CONTRIBUTING.md.
Sponsoring
License
This project is released under the terms of the BSD-3-Clause license.
Copyright (c) 2017-2019, Yii Maker