This bundle adds social share buttons into Symfony applications (including eZ Publish 5.x & eZ Platform).
- Symfony v2.6 or later.
This package is available via Composer, so the instructions below are similar to how you install any other open source Symfony Bundle.
Run the following command in a terminal, from your Symfony installation root (pick most recent release):
php composer.phar require ezsystems/share-buttons-bundleEnable the bundle in app/AppKernel.php file (for regular Symfony application) or ezpublish\EzPublishKernel.php file (for eZ Publish / eZ Platform):
$bundles = array(
// existing bundles
new EzSystems\ShareButtonsBundle\EzSystemsShareButtonsBundle()
);Install additional assets (CSS) for default template (omit this step if you are planning to use custom stylesheets):
{% stylesheets
bundles/ezsystemssharebuttonsbundle/css/default.css
%}
<link rel="stylesheet" type="text/css" href="{{ asset_url }}"/>
{% endstylesheets %}The bundle's configuration depends on siteaccess. This is an example of settings (config.yml):
ez_share_buttons:
system:
default:
# enable only those providers you are interested
providers:
- facebook_like
- facebook_recommend
- twitter
- linkedin
- google_plus
- xing
template: default
facebook_like:
# available options are: standard, box_count, button_count, button
layout: button
width: ~
show_faces: true
# displays additional `share` button
share: false
facebook_recommend:
# available options are: standard, box_count, button_count, button
layout: button
width: ~
show_faces: true
# displays additional `share` button
share: false
twitter:
show_username: false
large_button: false
language: ~
linkedin:
# available options are: top, right, none
count_mode: none
language: en_US
google_plus:
# available options are: small, medium, standard, tall
size: medium
# available options are: inline, bubble, none
annotation: none
width: ~
language: en-GB
xing:
# available options are: square, none
shape: none
# available options are: right, top, none
counter: none
# available options are: de, none
language: none
ShareButtonsBundle is provider based. This means that it is open to any kind of social share services.
Render your social share buttons with a single line of code.
Currently, ShareButtonsBundle is working with the following social share services:
- Facebook like
- Facebook recommend
- Google Plus
- LinkedIn share
Insert the following Twig helper in the place where you want to display the share buttons bar:
{{ show_share_buttons() }}You can override existing siteaccess configuration for ShareButtonsBundle by adding additional arguments:
{{ show_share_buttons(
options = {
provider_label: {
key: 'value'
},
template: 'default'
},
providers = ['provider_label']
) }}More practical example of the usage:
{{ show_share_buttons(
options = {
facebook_like: {
layout: 'button_count',
show_faces: true
},
google_plus: {
size: 'small',
annotation: 'bubble'
}
template: 'default'
},
providers = ['facebook_like', 'google_plus']
) }} This bundle is under GPL v2.0 license.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent