innoweb / silverstripe-social-share
Adds sharing links and buttons for Facebook, X (Twitter), Instagram, Pinterest and Google+ as well as AddThis to the site.
Installs: 5 294
Dependents: 1
Suggesters: 3
Security: 0
Stars: 1
Watchers: 5
Forks: 2
Open Issues: 0
Type:silverstripe-vendormodule
Requires
Suggests
- innoweb/silverstripe-social-metadata: Adds social metadata like OpenGraph, X (Twitter) and JSON-LD to all pages.
- innoweb/silverstripe-social-profiles: Adds social profile links to the site.
README
Overview
Adds sharing links and buttons for Facebook, X (Twitter), Instagram, Pinterest as well as AddThis to the site.
Requirements
- SilverStripe CMS 5.x
Note: this version is compatible with SilverStripe 5. For SilverStripe 4, please see the 3.x release line. For SilverStripe 3, please see the 2.x release line.
Installation
Install the module using composer:
composer require innoweb/silverstripe-social-share dev-master
Then run dev/build.
Configuration
The module adds a new tab to the SiteConfig in the CMS where the sharing options can be managed.
To add the sharing links to your site, add the following include to your Page.ss
template:
<% include PageShareLinks %>
This will activate sharing for the current page.
You can also activate sharing of the base URL of the site for all pages. For that, activate the following setting in your config.yml
:
Innoweb\SocialShare\Extensions\ConfigExtension:
enable_base_share: true
You also have to add the following include to your Page.ss
file:
<% include BaseShareLinks %>
MultiSites support
The module supports multisites and configured-multisites and by default adds the config options to the Sites.
If you want to manage the social links globally, please add the following settings in your config.yml
:
Innoweb\SocialShare\Extensions\ConfigExtension:
multisites_enable_global_settings: true
This will add the fields to your SiteConfig instead of Site.
License
BSD 3-Clause License, see License