goalgorilla / shariff
Open Social Drupal 分发的 npm-asset/shariff 的分支。不包括在 Open Social 以外使用时的维护
Replaces
- npm-asset/shariff: 3.2.2
This package is auto-updated.
Last update: 2024-08-29 05:50:45 UTC
README
我们为了内部使用而分叉了这个仓库,并且可能随时不提前通知就放弃。我们这样做是因为我们需要对不再积极维护的 Shariff 库进行更改。
Shariff – 为社交媒体按钮提供一些隐私 
Shariff 允许网站用户在不泄露隐私的情况下分享他们最喜欢的内 容。 演示
一些社交服务提供商,例如 Facebook,提供官方的共享代码片段,这些代码片段悄无声息地从所有页面访问者那里窃取个人信息。Shariff 允许访客查看您的页面在 Facebook 上的流行程度,并与他人共享内容,而无需泄露不必要的数据。
Shariff (/ˈʃɛɹɪf/)
是一个由德国电脑杂志 c't 和 heise online 维护的开源、低维护、高隐私解决方案。
Shariff 由两部分组成:一个简单的 JavaScript 客户端库和一个可选的服务器端组件。后者获取点赞或分享的数量。分享按钮和分享计数在没有连接到访客浏览器和 社交网络 的情况下工作(除非他们决定分享)。
入门
- 下载最新发布版本 [链接]
- 上传发布中包含的所有文件
- 在
<head>
中包含 CSSshariff.complete.css
使用发布文件中包含的依赖项- 如果您的网站中已经包含了 Font Awesome,请使用
build/shariff.min.css
- 在
</body>
之前包含 JavaScriptshariff.complete.js
使用发布文件中包含的依赖项- 如果您的网站中已经包含了 jQuery,请使用
build/shariff.min.js
- 插入一个或多个
<div class="shariff">
元素。 - 使用 data-* 属性自定义外观。
要启用按钮中的计数器,请参阅 后端 部分。
使用示例
<!DOCTYPE html> <html> <head> <link href="/path/to/shariff.min.css" rel="stylesheet"> </head> <body> <h1>My article</h1> <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit.</p> <h2>Minimum buttons:</h2> <div class="shariff"></div> <h2>More advanced buttons:</h2> <div class="shariff" data-backend-url="/path/to/backend" data-url="http://www.example.com/my-article.html" data-theme="grey" data-orientation="vertical"></div> <!-- immediately before </body> --> <script src="/path/to/shariff.min.js"></script> </body> </html>
使用 npm
入门
您还可以通过 npm
安装 Shariff 的节点包
$ cd my-project
$ npm install shariff --save
编辑您的 JS 主脚本,包含 Shariff 并在容器中初始化
// my-app.js var Shariff = require('shariff'); var $ = require('jquery'); var buttonsContainer = $('.some-selector'); new Shariff(buttonsContainer, { orientation: 'vertical' });
运行演示站点
下载 Shariff 后,通过运行 npm install
安装其依赖项。
$ git clone https://github.com/heiseonline/shariff.git
$ cd shariff
$ npm install
$ npm run dev
选项(数据属性)
构造函数参数
所有上述数据属性也可以作为 JavaScript 中的构造函数参数使用。但是,省略了前缀 data-
,名称采用驼峰式命名而不是短横线命名法。
var buttonsContainer = $('.some-selector'); new Shariff(buttonsContainer, { backendUrl: '/my/backend/url', orientation: 'vertical', mailUrl: 'mailto:me@example.com', });
支持的浏览器
Shariff 支持以下浏览器
- Firefox
- Google Chrome
- Internet Explorer/Edge
- Safari
Firefox、Google Chrome、Internet Explorer/Edge 和 Safari 的当前版本和上一主要版本都支持滚动更新。
支持的服务
Shariff 支持以下社交分享服务
- AddThis
- buffer
- diaspora*
- Flattr
- Qzone
- StumbleUpon
- Telegram
- 腾讯微博
- Threema
- Tumblr
- VK
- 微博
此外,服务Info
提供了一个按钮,用于显示关于社交分享按钮的信息页面。此页面的URL可以通过选项设置。默认值:http://ct.de/-2467514
,即介绍Shariff的c't文章。
后端
为了使用Shariff显示分享次数,您需要以下后端
第三方后端
一旦您安装并运行了其中之一,将其实际URL插入到data-backend-url
属性中。例如,如果后端在http://example.com/my-shariff-backend/
下运行,则data-backend-url
应该是/my-shariff-backend/
。脚本将处理其余部分。
第三方集成
这是第三方系统的集成列表
- Contao集成
- Drupal模块
- Joomla! 3 Shariff插件
- Kirby-CMS Shariff插件
- MediaWiki扩展
- Open Monograph Press插件
- Pagekit扩展
- Serendipity
- SilverStripe模块
- Symfony ShariffBundle
- TYPO3插件rx_shariff
- Wordpress插件shariff-sharing
- WordPress插件Shariff Wrapper
- Xenforo [ITM] ctSSB for Xenforo 1.5
- Xenforo [WMTech] 社交分享隐私插件
- Magento 2 Shariff社交分享