README

此包允许在您的网站上启用隐私的分享按钮。大多数分享按钮解决方案都要求用户以隐私为代价来分享或甚至查看分享按钮。

使用Heise Shariff，应用程序后端代表用户操作。

注意：此包是原始前端包的后端，不包含任何前端代码。

功能

截至今天，Shariff支持以下服务

• AddThis
• Facebook
• Flattr
• GooglePlus
• LinkedIn
• Pinterest
• Reddit
• StumbleUpon
• Xing

请参阅Shariff页面上的最新列表。

此附加组件还连接到标准的laravel缓存，因此您不必太担心负载。

安装

安装包

composer require cedricziel/l5-shariff

将服务提供程序添加到您的应用程序配置config/app.php

    CedricZiel\L5Shariff\ShariffServiceProvider::class

配置

ServiceProvider注册了一个默认的shariff路由，因此您无需任何额外修改即可使用它。

默认情况下，shariff服务的路由为/_shariff。您可以通过简单地覆盖自己的routes.php文件中的路由定义来覆盖它。

前端资源

Shariff可通过NPM获取。

安装

npm install shariff --save

将npm包中的CSS包含到您的SCSS样式表中

@import "node_modules/shariff/build/shariff.complete";

使用browserify将JavaScript包含到您的JavaScript文件resources/assets/scripts/app.js中

var Shariff = require('shariff/src/js/shariff');
jQuery(document).ready(function ($) {
    App.init();
    var buttonsContainer = $('.shariff-init');
    new Shariff(buttonsContainer);
});

要覆盖配置选项，您可以将其作为对象散列的第二个构造函数参数放入

new Shariff(buttonsContainer, {
    orientation: 'vertical'
});

有关可用选项的概述，请参阅原始参考。

如果您使用不同的资源文件而不是标准文件，您可能知道该怎么做 :)

用法

您可以通过包含一个blade模板并传递一些选项来轻松显示按钮。

允许的选项有

• 主题（颜色|灰色）默认：灰色
• URL默认：当前URL
• 布局（水平|垂直）默认：水平
• 服务默认：["whatsapp","facebook","twitter","googleplus","mail"]
• 标题默认：这里有一些我想与您分享的东西！

@include('shariff', ['shariff_opts' => ['url' => 'http://..', 'layout' => 'horizontal', 'title' => 'Cool title!']])

或者

@include('shariff::buttons', ['shariff_opts' => ['theme' => 'color']])

TODO：添加助手

高级

您可以在需要时发布配置和模板，并对其进行自定义或覆盖。

# 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"

许可

MIT许可。Cedric Ziel cedric@cedric-ziel.com