goalgorilla/shariff

此包最新版本(3.2.2)没有可用的许可证信息。

Open Social Drupal 分发的 npm-asset/shariff 的分支。不包括在 Open Social 以外使用时的维护

维护者

详细信息

github.com/goalgorilla/shariff

源代码

安装: 38

依赖者: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 177

语言:JavaScript

类型:npm-asset

3.2.2 2022-05-16 11:57 UTC

This package is auto-updated.

Last update: 2024-08-29 05:50:45 UTC


README

我们为了内部使用而分叉了这个仓库,并且可能随时不提前通知就放弃。我们这样做是因为我们需要对不再积极维护的 Shariff 库进行更改。

Shariff – 为社交媒体按钮提供一些隐私 构建状态

Shariff 允许网站用户在不泄露隐私的情况下分享他们最喜欢的内 容。 演示

Shariff Logo © 2015 Heise Medien

一些社交服务提供商,例如 Facebook,提供官方的共享代码片段,这些代码片段悄无声息地从所有页面访问者那里窃取个人信息。Shariff 允许访客查看您的页面在 Facebook 上的流行程度,并与他人共享内容,而无需泄露不必要的数据。

Shariff (/ˈʃɛɹɪf/) 是一个由德国电脑杂志 c't 和 heise online 维护的开源、低维护、高隐私解决方案。

Shariff 由两部分组成:一个简单的 JavaScript 客户端库和一个可选的服务器端组件。后者获取点赞或分享的数量。分享按钮和分享计数在没有连接到访客浏览器和 社交网络 的情况下工作(除非他们决定分享)。

入门

  1. 下载最新发布版本 [链接]
  2. 上传发布中包含的所有文件
  3. <head> 中包含 CSS
    • shariff.complete.css 使用发布文件中包含的依赖项
    • 如果您的网站中已经包含了 Font Awesome,请使用 build/shariff.min.css
  4. </body> 之前包含 JavaScript
    • shariff.complete.js 使用发布文件中包含的依赖项
    • 如果您的网站中已经包含了 jQuery,请使用 build/shariff.min.js
  5. 插入一个或多个 <div class="shariff"> 元素。
  6. 使用 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*
  • facebook
  • Flattr
  • Flipboard
  • LinkedIn
  • Mail
  • Pinterest
  • Pocket
  • Print
  • Qzone
  • reddit
  • StumbleUpon
  • Telegram
  • 腾讯微博
  • Threema
  • Tumblr
  • Twitter
  • VK
  • 微博
  • WhatsApp
  • XING

此外,服务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/。脚本将处理其余部分。

第三方集成

这是第三方系统的集成列表