Share links with Laravel

6.1.0 2022-03-31 03:29 UTC


Share links with Laravel

This is a fork of John's share for Laravel 4.

Services available

  • Blogger : blogger
  • Digg : digg
  • Email : email
  • Evernote : evernote
  • Facebook : facebook
  • Gmail : gmail
  • LinkedIn : linkedin
  • Pinterest : pinterest
  • Reddit : reddit
  • : scoopit
  • : telegramMe
  • Tumblr : tumblr
  • Twitter : twitter
  • : vk


Install Composer dependency into your project

composer require chencha/share


Get a link (example with Twitter)

Route::get('/', function()
	return Share::load('', 'My example')->twitter();

Returns a string :

Get many links

Route::get('/', function()
	return Share::load('', 'Link description')->services('facebook', 'twitter');

Returns an array :

    "twitter" : "",
    "facebook" : ""

Get ALL the links

Route::get('/', function()
	return Share::load('', 'Link description')->services();

Returns an array of results for all defined services.


Publish the package config:

php artisan vendor:publish --provider='Chencha\Share\ShareServiceProvider'

Add a new service in config/social-share.php:

'mynewservice' => [ 'view' => 'share.mynewservice' ]

Add Blade templating code in share.mynewservice view file to generate a URL for mynewservice. You have access to:

  • service - the service definition (shown above).
  • sep - separator used between parameters, defaults to '&'. Configurable as social-share.separator.
  • url - the URL being shared.
  • title - the title being shared.
  • media - media link being shared.

Example:{{ rawurlencode($url) }}<?php echo $sep; ?>title={{ rawurlencode("Check this out! $title. See it here: $url") }}

Another example for the email service. Change the service config to be [ 'view' => 'whatever' ] and put this in the view file:

mailto:?subject={{ rawurlencode("Wow, check this: $title") }}<?php echo $sep; ?>body={{ rawurlencode("Check this out! $title. See it here: $url") }}

Localizing? Easy, use Laravel's trans() call:

mailto:?subject={{ rawurlencode(trans('', compact('url', 'title', 'media'))) }}<?php echo $sep ?>body={{ rawurlencode(trans('', compact('url', 'title', 'media'))) }}

Create a file at resources/lang/en/share.php with your choice of subject and body. URLs arguably have a maximum length of 2000 characters.

Notice the use of . It's the only way to print out an unencoded ampersand (if configured that way).


When the package is upgraded, changes to the config and views should be republished into your project:

php artisan vendor:publish --provider='Chencha\Share\ShareServiceProvider'

Use source control to work out what has changed if you have customized the files.