Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/siberfx/share
"siberfx/share" package unofficial upgrading
https://github.com/siberfx/share
Last synced: 4 days ago
JSON representation
"siberfx/share" package unofficial upgrading
- Host: GitHub
- URL: https://github.com/siberfx/share
- Owner: siberfx
- Created: 2021-10-06T15:19:20.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-12T13:43:50.000Z (6 months ago)
- Last Synced: 2024-08-02T20:48:05.984Z (3 months ago)
- Language: PHP
- Homepage:
- Size: 22.5 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Share
Share links with Laravel 8, 9, 10
This is a fork to John's share for Laravel 4.
## Services available- Delicious : delicious
- Digg : digg
- Email : email
- Evernote : evernote
- Facebook : facebook
- Gmail : gmail
- LinkedIn : linkedin
- Pinterest : pinterest
- Reddit : reddit
- Scoop.it : scoopit
- Telegram.me : telegramMe
- Tumblr : tumblr
- Twitter : twitter
- Viadeo : viadeo
- vk.com : vk## Installation
Step 1 : Install Composer dependency
composer require siberfx/share
Step 2 : Register the Service Provider
Add *Siberfx\Share\ShareServiceProvider* to providers array in *config/app.php*
Step 3 : Register Alias
Add *Share* => *Siberfx\Share\ShareFacade* to aliases array in *config/app.php*
## Usage
Get a link (example with Twitter)
Route::get('/', function()
{
return Share::load('http://www.example.com', 'My example')->twitter();
});Returns a string :
https://twitter.com/intent/tweet?url=http%3A%2F%2Fwww.example.com&text=Link+description
Get many links
Route::get('/', function()
{
return Share::load('http://www.example.com', 'Link description')->services('facebook', 'gplus', 'twitter');
});Returns an array :
{
"gplus" : "https://plus.google.com/share?url=http%3A%2F%2Fwww.example.com",
"twitter" : "https://twitter.com/intent/tweet?url=http%3A%2F%2Fwww.example.com&text=Link+description",
"facebook" : "https://www.facebook.com/sharer/sharer.php?u=http%3A%2F%2Fwww.example.com&title=Link+description"
}Get ALL the links
Route::get('/', function()
{
return Share::load('http://www.example.com', 'Link description')->services();
});Returns an array of results for all defined services.
## Customization
Publish the package config:
php artisan vendor:publish --provider='Siberfx\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:
https://mynewservice.example.com?url={{ rawurlencode($url) }}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") }}body={{ rawurlencode("Check this out! $title. See it here: $url") }}
Localizing? Easy, use Laravel's trans() call:
mailto:?subject={{ rawurlencode(trans('share.email-subject', compact('url', 'title', 'media'))) }}body={{ rawurlencode(trans('share.email-body', 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).