nomaya/social-bundle

A bundle to easily add facebook, twitter, G+, Linkedin buttons to your templates

NomayaSocialButtonsBundle

This bundle provides a simple way to integrate a bar of social buttons to share your pages on Facebook, Twitter, Google Plus and Linkdein. You also have a social links bar to networks., _(*1)

Introduction

I have not found any Symfony2 bundle to respond to this common need: display "share", "like"... buttons with an easy integration into templates. It is intended to evolve : - manage more networks - use custom icons - compatibility with php templates - suggestions are welcome, _(*2)

Yann, _(*3)

Requirements

• Symfony 2.1 +

Installation

Add this line to require section of your composer.json

``` js { //... "require": { //... "nomaya/social-bundle": "dev-master" } }, <sub>(*4)</sub>

### Install the bundle

``` bash
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update nomaya/social-bundle

Composer will install the bundle to your project's vendor/nomaya directory., <sub>(*5)</sub>

Enable the bundle via the kernel

``` php <?php // app/AppKernel.php, <sub>(*6)</sub>

public function registerBundles() { $bundles = array( // ... new Nomaya\SocialBundle\NomayaSocialBundle(), ); }, <sub>(*7)</sub>

Get the options details : - https://developers.facebook.com/docs/plugins/like-button - https://developers.google.com/+/web/+1button/ - https://about.twitter.com/resources/buttons - https://developer.linkedin.com/plugins/share-plugin-generator - ..., <sub>(*8)</sub>

Twig extension

The bundle provides a Twig extension for quickly generating the buttons., <sub>(*9)</sub>

``` twig // buttons, <sub>(*10)</sub>

// Insert the whole bar "{{ socialButtons() }}", <sub>(*11)</sub>

// Insert only one button "{{ twitterButton() }}" // or "{{ socialButtons( {'googleplus':false, 'facebook':false, 'linkedin':false} ) }}", <sub>(*12)</sub>

// insert the google+ button with custom parameters "{{ googlePlusButton( {'locale':'fr', 'url':'http://google.fr' }) }}", <sub>(*13)</sub>

// insert the bar with specific values for Facebook "{{ socialButtons( { 'facebook': {'locale':'fr_FR', 'send':true}} ) }}", <sub>(*14)</sub>

// links, <sub>(*15)</sub>

// insert the whole links defined in config "{{ sociallinks() }}", <sub>(*16)</sub>

// insert one link, no option "{{ socialLink('facebook') }}", <sub>(*17)</sub>

// insert one link, specifying the url "{{ socialLink('linkedin',{'url': 'http://www.nomaya.net'}) }}", <sub>(*18)</sub>

// insert custom bar with 2 links, not showing googleplus "{{ socialLinks({'linkedin',{'url': 'http://www.nomaya.net'}, 'facebook':{'url': 'http://www.facebook.com'}, 'googleplus': false}) }}" ```, <sub>(*19)</sub>

Notes

Pull requests a very welcome to integrate more buttons to this extension., <sub>(*20)</sub>

Thanks to Gregquat for his article: http://obtao.com/blog/2012/11/social-buttons-bar-for-facebook-twitter-google-with-symfony/ which did most of the work., <sub>(*21)</sub>

License

This bundle is under the MIT license. See the complete license in the bundle:, <sub>(*22)</sub>

Resources/meta/LICENSE