{"id":15021900,"url":"https://github.com/ezsystems/ezsystemssharebuttonsbundle","last_synced_at":"2025-07-13T04:37:02.493Z","repository":{"id":56980868,"uuid":"42646326","full_name":"ezsystems/EzSystemsShareButtonsBundle","owner":"ezsystems","description":"This bundle adds social share buttons into Symfony applications","archived":false,"fork":false,"pushed_at":"2018-09-04T13:13:37.000Z","size":44,"stargazers_count":5,"open_issues_count":0,"forks_count":10,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-04-10T02:58:18.683Z","etag":null,"topics":["ez-platform","facebook","php","symfony","symfony-bundle"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ezsystems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-17T09:05:45.000Z","updated_at":"2022-10-23T11:45:11.000Z","dependencies_parsed_at":"2022-08-21T08:40:47.956Z","dependency_job_id":null,"html_url":"https://github.com/ezsystems/EzSystemsShareButtonsBundle","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezsystems%2FEzSystemsShareButtonsBundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezsystems%2FEzSystemsShareButtonsBundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezsystems%2FEzSystemsShareButtonsBundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezsystems%2FEzSystemsShareButtonsBundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ezsystems","download_url":"https://codeload.github.com/ezsystems/EzSystemsShareButtonsBundle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290042,"owners_count":21078923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ez-platform","facebook","php","symfony","symfony-bundle"],"created_at":"2024-09-24T19:57:12.049Z","updated_at":"2025-04-10T20:33:21.447Z","avatar_url":"https://github.com/ezsystems.png","language":"PHP","readme":"# Share Buttons Bundle\n\n[![SensioLabsInsight](https://insight.sensiolabs.com/projects/8f309360-c70a-486f-9d7f-b50868fce663/big.png)](https://insight.sensiolabs.com/projects/8f309360-c70a-486f-9d7f-b50868fce663)\n\nThis bundle adds social share buttons into Symfony applications _(including eZ Publish 5.x \u0026 eZ Platform)_.\n\n## Requirements\n\n- Symfony v2.6 or later.\n\n## Installation\nThis package is available via Composer, so the instructions below are similar to how you install any other open source Symfony Bundle.\n\nRun the following command in a terminal, from your Symfony installation root (pick most recent release):\n\n```bash\nphp composer.phar require ezsystems/share-buttons-bundle\n```\n\nEnable the bundle in `app/AppKernel.php` file (for regular Symfony application) or `ezpublish\\EzPublishKernel.php` file (for eZ Publish / eZ Platform):\n\n```php\n$bundles = array(\n    // existing bundles\n    new EzSystems\\ShareButtonsBundle\\EzSystemsShareButtonsBundle()\n);\n```\n\nInstall additional assets (CSS) for default template (omit this step if you are planning to use custom stylesheets):\n\n```twig\n{% stylesheets\n    bundles/ezsystemssharebuttonsbundle/css/default.css\n%}\n    \u003clink rel=\"stylesheet\" type=\"text/css\" href=\"{{ asset_url }}\"/\u003e\n{% endstylesheets %}\n```\n\n## Configuration\n\nThe bundle's configuration depends on siteaccess. This is an example of settings (`config.yml`):\n\n```yaml\nez_share_buttons:\n    system:\n        default:\n            # enable only those providers you are interested\n            providers:\n                - facebook_like\n                - facebook_recommend\n                - twitter\n                - linkedin\n                - google_plus\n                - xing\n            template: default\n            \n            facebook_like:\n                # available options are: standard, box_count, button_count, button\n                layout: button\n                width: ~\n                show_faces: true\n                # displays additional `share` button\n                share: false\n            \n            facebook_recommend:\n                # available options are: standard, box_count, button_count, button\n                layout: button\n                width: ~\n                show_faces: true\n                # displays additional `share` button\n                share: false\n\n            twitter:\n                show_username: false\n                large_button: false\n                language: ~\n\n            linkedin:\n                # available options are: top, right, none\n                count_mode: none\n                language: en_US\n\n            google_plus:\n                # available options are: small, medium, standard, tall\n                size: medium\n                # available options are: inline, bubble, none\n                annotation: none\n                width: ~\n                language: en-GB\n\n            xing:\n                # available options are: square, none\n                shape: none\n                # available options are: right, top, none\n                counter: none\n                # available options are: de, none\n                language: none\n\n```\n\n## Features\n\n### Comments abstraction\n\n`ShareButtonsBundle` is **provider based**. This means that it is open to **any kind of social share services**.\n\n### Single entry point\n\nRender your social share buttons with a single line of code.\n\n## Available integration\n\nCurrently, `ShareButtonsBundle` is working with the following social share services:\n\n* Facebook like\n* Facebook recommend\n* Google Plus\n* LinkedIn share\n* Twitter\n* Xing\n\n## Usage\n\nInsert the following Twig helper in the place where you want to display the share buttons bar:\n\n```twig\n{{ show_share_buttons() }}\n```\n\nYou can override existing siteaccess configuration for `ShareButtonsBundle` by adding additional arguments:\n \n ```twig\n {{ show_share_buttons(\n    options = {\n        provider_label: {\n            key: 'value'\n        },\n        template: 'default'\n    },\n    providers = ['provider_label']\n ) }}\n ```\n \n More practical example of the usage:\n \n ```twig\n {{ show_share_buttons(\n     options = {\n         facebook_like: {\n             layout: 'button_count',\n             show_faces: true\n         },\n         google_plus: {\n             size: 'small',\n             annotation: 'bubble'\n         }\n         template: 'default'\n     },\n     providers = ['facebook_like', 'google_plus']\n  ) }}  \n ```\n\n## License\n\nThis bundle is under **[GPL v2.0 license](http://www.gnu.org/licenses/gpl-2.0.html)**.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezsystems%2Fezsystemssharebuttonsbundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezsystems%2Fezsystemssharebuttonsbundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezsystems%2Fezsystemssharebuttonsbundle/lists"}