README

THIS BUNDLE HAS BEEN REPLACED BY c975L/SocialBundle

Symfony bundle that provides a Twig function to embed share buttons for popular social networks, with SVG icons included and multiple display styles.

Features

• Single Twig function sharebuttons() to embed share buttons anywhere in a template
• Supports a configurable list of social networks
• main shorthand to display the most common networks
• Multiple display styles: distinct, ellipse, circle, toolbar
• Alignment options: left, center, right
• Icon-only or icon + text display
• Optional custom URL override
• SVG icons embedded — no external CSS or JS required
• Configuration managed via c975L/ConfigBundle

Requirements

• PHP >= 8.0
• c975L/ConfigBundle

Installation

Download

composer require c975l/sharebuttons-bundle

Enable routes

Add the following to config/routes.yaml:

c975_l_share_buttons:
    resource: "@c975LShareButtonsBundle/"
    type: attribute
    prefix: /
    # For multilingual websites:
    # prefix: /{_locale}
    # defaults: { _locale: '%locale%' }
    # requirements:
    #     _locale: en|fr|es

Load configuration values

php bin/console c975l:config:load-all

Then use the ConfigBundle dashboard to set the values for each key.

Usage

Use the sharebuttons() Twig function to render share buttons:

{# Full signature #}
{{ sharebuttons(shares, style, alignment, displayIcon, displayText, url) }}

{# Display the main social networks with default style #}
{{ sharebuttons('main') }}

{# Custom selection, ellipse style, centered, icon only #}
{{ sharebuttons(['facebook', 'linkedin', 'email'], 'ellipse', 'center', true, false) }}

{# Override the shared URL #}
{{ sharebuttons('main', 'distinct', 'center', true, false, 'https://example.com/my-page') }}

If this project helps you save development time, consider sponsoring via the Sponsor button at the top of the GitHub page. Thank you!