yiimaker / yii2-social-share
Extension for sharing on social networks
Installs: 97 455
Dependents: 4
Suggesters: 0
Security: 0
Stars: 48
Watchers: 10
Forks: 13
Open Issues: 1
Type:yii2-extension
Requires
- php: >=5.6.0
- yiisoft/yii2: ^2.0.13
Requires (Dev)
- codeception/codeception: ~4.1
- codeception/module-asserts: ^1.3
- codeception/module-yii2: ^1.1
- friendsofphp/php-cs-fixer: ^2.18
README
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' => [ 'facebook' => [ 'class' => \ymaker\social\share\drivers\Facebook::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 tests
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-2021, Volodymyr Kupriienko