drmonkeyninja/cakephp-social-share

CakePHP helper for creating social share/bookmark links

CakePHP Social Share

, _(*1)

This plugin provides a CakePHP View helper for creating links to share content on numerous social networks and bookmarking sites., _(*2)

The aim of the plugin is to keep things simple. It doesn't come packaged with any JavaScript and I leave design decisions up to you. You can choose whether you want to use text, images, sprites or an icon font for your links., _(*3)

Social Share currently supports Delicious, Digg, Evernote, Facebook, Friend Feed, Google Bookmarks, Google+, LinkedIn, Newsvine, Pinterest, Pocket, Reddit Slashdot, simple email, StumbleUpon, Technorati, Tumblr, Twitter and WhatsApp., _(*4)

Note: This branch is for CakePHP 4.x., _(*5)

Installation

Install using composer: composer require drmonkeyninja/cakephp-social-share:4.*, _(*6)

Then add the following line to your Application.php file to load the plugin., _(*7)

$this->addPlugin(\SocialShare\Plugin::class);

Also don't forget to add the helper in your AppView:-, _(*8)

$this->loadHelper('SocialShare.SocialShare');

Usage

SocialShareHelper::link()

SocialShareHelper::link(string $service, string $title, mixed $url = null, array $options = [])

Returns an HTML link to share the current page for the supplied service. For example to create a link for Facebook:-, _(*9)

echo $this->SocialShare->link(
    'facebook',
    __('Share on Facebook')
);

You can easily produce a list of links to share to different social networks:-, _(*10)

$services = [
    'facebook' => __('Share on Facebook'),
    'gplus' => __('Share on Google+'),
    'linkedin' => __('Share on LinkedIn'),
    'twitter' => __('Share on Twitter')
];

echo '

'; foreach ($services as $service => $linkText) { echo '
• ' . $this->SocialShare->link( $service, $linkText ) . '
'; } echo '

Supported services:-, _(*11)

• delicious
• digg
• email
• evernote
• facebook
• friendfeed
• google (Google Bookmarks)
• gplus (Google+)
• linkedin
• newsvine
• pinterest
• pocket
• reddit
• slashdot
• stumbleupon
• technorati
• tumblr
• twitter
• whatsapp

You can pass a URL or a routing array as the third parameter for the URL you want to share., _(*12)

$options supports the same options as HtmlHelper::link() as well as a 'text' option for a page title you want to include when sharing the URL. For Pinterest there is an additional 'image' option for a URL to an image to share., _(*13)

SocialShareHelper::href()

SocialShareHelper::href(string $service, mixed $url = null, array $options = [])

Returns an URL for sharing to the supplied service., _(*14)

SocialShareHelper::fa()

SocialShareHelper::fa(string $service, mixed $url = null, array $options = [])

Returns an HTML link just like SocialShare::link() except the link text will be a relevant Font Awesome icon for the service., _(*15)

For example:-, _(*16)

echo $this->SocialShare->fa(
    'facebook',
    'http://example.com'
);

Will output:-, _(*17)

<a href="https://www.facebook.com/sharer/sharer.php?u=http%3A%2F%2Fexample.com">
    <i class="fa fa-facebook"></i>
</a>

If you need to change the icon markup output by fa() you can override the icon class using icon_class:-, _(*18)

echo $this->SocialShare->fa(
    'facebook',
    null,
    ['icon_class' => 'fa fa-facebook-square']
);