pixelshelsinki/social-share

Social Share component for WordPress

v1.1.0 2021-03-17 13:33 UTC

Requires (Dev)

• giacocorsiglia/wordpress-stubs: ^5.1
• phpunit/phpunit: ^9
• squizlabs/php_codesniffer: ^3.5
• vimeo/psalm: ^4.4

MIT

• Silvanus / Sampo Silvennoinen

README

Social Share component for WordPress.

• Generate share url for most common social media platforms
• Either share current url, or given url

Install

composer require pixelshelsinki/social-share

Usage

Pixels Social Share exposes a main "Share" class with methods for each social media platform. Either call them directly in PHP, or hook them up as Twig functions when working with Timber.

Using with PHP

<?php
use Pixels\Components\SocialShare\Share;

// Current url
$facebook_share = Share::facebook();
$twitter_share  = Share::twitter();
$linkedin_share = Share::linkedin();
$whatsapp_share  = Share:: whatsapp();

// Given url.
$facebook_share = Share::facebook('https://www.pixels.fi/');
$twitter_share  = Share::twitter('https://www.pixels.fi/');
$linkedin_share = Share::linkedin('https://www.pixels.fi/');
$whatsapp_share = Share::whatsapp('https://www.pixels.fi/');

Using with Twig / Timber.

Easiest way is to register the factory functions as Twig helper functions.

<?php
use \Timber\Twig_Function;

add_filter( 'get_twig', array( 'add_share_functions' ) );

function add_share_functions( $twig ) {
    // Social share functions.
    $twig->addFunction( new Twig_Function( 'facebook_share', '\\Pixels\\Components\\SocialShare\\Share::facebook' ) );
    $twig->addFunction( new Twig_Function( 'twitter_share', '\\Pixels\\Components\\SocialShare\\Share::twitter' ) );
    $twig->addFunction( new Twig_Function( 'linkedin_share', '\\Pixels\\Components\\SocialShare\\Share::linkedin' ) );
    $twig->addFunction( new Twig_Function( 'whatsapp_share', '\\Pixels\\Components\\SocialShare\\Share::whatsapp' ) );

    return $twig;
}