michelmelo/laravel-share

Optional package for Laravel to generate social share links.

dev-master 2021-03-27 12:38 UTC

This package is not auto-updated.

Last update: 2022-06-18 13:44:45 UTC


README

Share links exist on almost every page in every project, creating the code for these share links over and over again can be a pain in the ass. With Laravel Share you can generate these links in just seconds in a way tailored for Laravel.

Available services

  • Facebook
  • Twitter
  • Linkedin
  • WhatsApp
  • Reddit
  • Telegram

Installation

You can install the package via composer:

composer require michelmelo/laravel-share

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php

// config/app.php
'providers' => [
    MichelMelo\Share\Providers\ShareServiceProvider::class,
];

And optionally add the facade in config/app.php

// config/app.php
'aliases' => [
    'Share' => MichelMelo\Share\ShareFacade::class,
];

Publish the package config & resource files.

php artisan vendor:publish --provider="MichelMelo\Share\Providers\ShareServiceProvider"

You might need to republish the config file when updating to a newer version of Laravel Share

This will publish the laravel-share.php config file to your config folder, share.js in public/js/ and laravel-share.php in your resources/lang/vendor/en/ folder.

Fontawesome

Since this package relies on Fontawesome, you will have to require it's css, js & fonts in your app. You can do that by requesting a embed code via their website or by installing it locally in your project.

Javascript

Load jquery.min.js & share.js by adding the following lines to your template files.

<script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script>
<script src="{{ asset('js/share.js') }}"></script>

Usage

Creating one share link

Facebook

Share::page('http://michelmelo.pt')->facebook();

Twitter

Share::page('http://michelmelo.pt', 'Your share text can be placed here')->twitter();

Reddit

Share::page('http://michelmelo.pt', 'Your share text can be placed here')->reddit();

Linkedin

Share::page('http://michelmelo.pt', 'Share title')->linkedin('Extra linkedin summary can be passed here')

Whatsapp

Share::page('http://michelmelo.pt')->whatsapp()

Telegram

Share::page('http://michelmelo.pt', 'Your share text can be placed here')->telegram();

Sharing the current url

Instead of manually passing an url, you can opt to use the currentPage function.

Share::currentPage()->facebook();