innoweb/silverstripe-social-share

Adds sharing links and buttons for Facebook, X (Twitter), Instagram, Pinterest and Google+ as well as AddThis to the site.

4.3.0 2024-06-20 02:17 UTC

Requires

• silverstripe/cms: ^5
• silverstripe/vendor-plugin: ^2
• unclecheese/display-logic: ^3

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.

BSD-3-Clause

• Florian Thoma

• social
• silverstripe
• sharing

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