Package Data | |
---|---|
Maintainer Username: | cedricziel |
Maintainer Contact: | cedric@cedric-ziel.com (Cedric Ziel) |
Package Create Date: | 2016-01-08 |
Package Last Update: | 2016-01-30 |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-24 15:04:46 |
Package Statistics | |
---|---|
Total Downloads: | 57 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 2 |
Total Watchers: | 3 |
Total Forks: | 1 |
Total Open Issues: | 0 |
This package allows privacy-enabled share buttons on your site. With most sharing button solutions, the user pays with its privacy to be able to share or even view the share buttons.
With the Heise Shariff, the application backend acts on the users behalf.
Note: This package is a backend to the original frontend package and doesn't contain any frontend code.
As of today, Shariff supports the following services:
Please see the up-to-date list on the Shariff Page.
This add-on also plugs into the standard laravel cache, so you dont have to worry too much about load.
Install the package:
composer require cedricziel/l5-shariff
Add the service provider to your application configuration in config/app.php
:
CedricZiel\L5Shariff\ShariffServiceProvider::class
The ServiceProvider registers a default shariff
route, so you can use it without any additional modifications.
Per default, the route to the shariff service is /_shariff
. You override it, by simply overriding the route
definition given in src/routes.php
in your own routes.php
.
Shariff is available via NPM.
Installation:
npm install shariff --save
Include the css from the npm package into your SCSS stylesheet:
@import "node_modules/shariff/build/shariff.complete";
Include the JavaScript to your JavaScript file resources/assets/scripts/app.js
with browserify:
var Shariff = require('shariff/src/js/shariff');
jQuery(document).ready(function ($) {
App.init();
var buttonsContainer = $('.shariff-init');
new Shariff(buttonsContainer);
});
To override config options, you can put them in an object hash as second constructor argument:
new Shariff(buttonsContainer, {
orientation: 'vertical'
});
For an overview of the available options, please have a look at the original reference.
If you use different asset files than the standard ones mentioned, you probably know what to do :)
You can easily display the buttons by including a blade template and pass some options.
Allowed options are:
grey
horizontal
["whatsapp","facebook","twitter","googleplus","mail"]
Here is something I wanted to share with you!
@include('shariff', ['shariff_opts' => ['url' => 'http://..', 'layout' => 'horizontal', 'title' => 'Cool title!']])
Or:
@include('shariff::buttons', ['shariff_opts' => ['theme' => 'color']])
TODO: Add helper
You can publish the the config and the templates and customize / override them when needed.
# To publish the config (`config_path('shariff.php')`)
php artisan vendor:publish --provider="CedricZiel\L5Shariff\ShariffServiceProvider" --tag="config"
# To publish the views for you to customize (`resource_path('views/vendor/shariff')`)
php artisan vendor:publish --provider="CedricZiel\L5Shariff\ShariffServiceProvider" --tag="views"
The MIT License. Cedric Ziel cedric@cedric-ziel.com