# <stl:share> 页面分享

<stl:share
  title="标题"
  image="图片"
  description="描述"
  url="分享网址"
  source="来源"
  sites="分享目的站点"
  disabled="禁用分享的站点"
  wechatQrcodeTitle="微信二维码提示文字"
  wechatQrcodeHelper="微信二维码下方说明">
</stl:share>

版本要求

<stl:share> 标签需要使用 SSCMS 7.1.1 及以上版本。

# 说明

通过 <stl:share> 实现前台页面分享功能。

<stl:share> 标签所有属性均为可选设置,可以不设置直接使用 <stl:share></stl:share>,分享插件将获取当前栏目/内容的信息作为标题、图片及描述,如果当前栏目/内容未获取到信息,分享标签使用后台分享设置中设置的默认值。

# 解析

根据分享目的站点设置的不同,分享标签将显示不同的分享 ICON,默认分享目的地为微信、微博、QQ、QQ 空间以及豆瓣:

# 属性

属性 说明
title 标题
image 图片
description 描述
url 分享网址
source 来源
sites 分享目的站点
disabled 禁用分享的站点
wechatQrcodeTitle 微信二维码提示文字
wechatQrcodeHelper 微信二维码下方说明

# title - 标题

如果当前页面为栏目页,默认读取栏目名称作为标题。

如果当前页面为内容页,默认读取内容标题作为标题。

如果设置标题属性,分享标签将使用属性中的值作为标题。

<!-- 指定标题 -->
<stl:share title="标题"></stl:share>

# image - 图片

如果当前页面为栏目页,默认读取栏目图片作为图片。

如果当前页面为内容页,默认读取内容图片作为图片。

如果设置图片属性,分享标签将使用属性中的值作为图片。

<!-- 指定站点图片作为图片 -->
<stl:share image="{stl:site type=imageUrl}"></stl:share>

# description - 描述

如果当前页面为栏目页,默认读取栏目简介作为描述。

如果当前页面为内容页,默认读取内容概述作为描述。

如果设置描述属性,分享标签将使用属性中的值作为描述。

<!-- 指定站点描述作为描述 -->
<stl:share image="{stl:site type=description}"></stl:share>

# url 分享网址

分享网址,默认使用当前页面的地址(window.location.href)。

<!-- 指定分享网址 -->
<stl:share url="https://sscms.com"></stl:share>

# source - 来源

来源(QQ空间会用到), 默认读取head标签:<meta name="site" content="https://sscms.com" />

# sites - 分享目的站点

如果不设置此属性,默认为值为 wechat,weibo,qq,qzone,douban

以下是所有可选值:

  • "wechat" 微信。
  • "weibo" 新浪微博。
  • "qq" QQ
  • "qzone" QQ 空间。
  • "douban" 豆瓣。
  • "facebook" FACEBOOK
  • "twitter" TWITTER。
  • "google" GOOGLE。

# disabled - 禁用分享的站点

如果不设置此属性,默认为值为 facebook,twitter,google

以下是所有可选值:

  • "wechat" 微信。
  • "weibo" 新浪微博。
  • "qq" QQ
  • "qzone" QQ 空间。
  • "douban" 豆瓣。
  • "facebook" FACEBOOK
  • "twitter" TWITTER。
  • "google" GOOGLE。

# wechatQrcodeTitle - 微信二维码提示文字

微信二维码提示文字,默认为:微信扫一扫:分享

# wechatQrcodeHelper - 微信二维码下方说明

微信二维码下方说明文字,默认为:<p>微信里点“发现”,扫一下</p><p>二维码便可将本文分享至朋友圈。</p>

# 示例

# 设置描述

<stl:share description="分享插件"></stl:share>

# 设置微信二维码标题

<stl:share wechatQrcodeTitle="请打开微信扫一扫"></stl:share>
上次更新: 2022/3/13 下午4:15:12