社交分享组件 · 使用说明

作用说明

在微信内置浏览器中，为发送给朋友与分享到朋友圈提供自定义标题、摘要、链接与缩略图（依赖微信 JS-SDK）。

可选在页头输出 Open Graph 元标签，改善链接被微信抓取时的展示效果。

多站点

配置按站点 ID分别保存；后台切换到不同站点后进入本插件配置即可维护该站。旧版未分站点时的配置会自动视为站点 1。微信 access_token 缓存目录按站点隔离（cache/app/lingjiewechatshare/{站点ID}/）。

后台 · 微海报设置

可上传站点 Logo、设置海报默认头图（内容无缩略图与正文图时使用），并选择微海报样式（普通版 / 渐变框 / 商务蓝 / 清新绿）。与分享默认图相互独立。

详情页点击微海报会在弹层中加载由服务器生成的 PNG 图片（可长按保存或点「保存图片」下载）。生成依赖 PHP GD 与含中文的字体（.ttf / .ttc）。后台「微海报 PNG 字体」留空时，默认优先使用插件内 dayrui/App/Lingjiewechatshare/font/kaiti.ttf（楷体），其次 Assets/poster.ttf、Windows 微软雅黑、Linux 文泉驿 / Noto CJK 等；亦可用环境变量 LINGJIEWECHATSHARE_POSTER_FONT 指定路径。若中文仍为方框，请在后台填写本机字体绝对路径（如 C:\Windows\Fonts\msyh.ttc）。不会优先使用验证码用的 captcha.ttf（通常无中文）。头图 / Logo / 二维码仅拉取与本站域名一致的地址。弹层内「网页版海报」仍为可分享的 H5 页面。

后台 · 工具条设置

在插件配置页的工具条设置中可调整：工具条总开关、分享标题/描述字数上限、各圆形按钮是否显示、主题色（预设色块或自定义十六进制）、展示位置（随模板插入的「文章底部」或「左侧悬浮」）。保存后更新缓存；左侧悬浮可能被主题布局遮挡，需按需写 CSS 覆盖。手机端不会使用左侧悬浮，工具条始终在正文流中横向一排显示，且圆形按钮会缩小以适配窄屏。

配置步骤

登录微信公众平台，取得公众号的 AppID 与 AppSecret，填入本插件配置并保存。

在「设置与开发」→「公众号设置」→「功能设置」中，将 JS 接口安全域名设为当前站点根域名（与浏览器地址栏一致，不要带 http:// 与路径）。

服务器需能访问 api.weixin.qq.com（用于获取 access_token 与 jsapi_ticket）。

在后台开启「启用」，并更新系统缓存后访问前端页面；使用微信打开站点链接即可验证分享卡片。

扩展功能（详情页工具条）

在后台「扩展功能」中可分别开启：打赏（依赖系统支付系统插件，调用 dr_donation()，支付方式以支付插件配置为准）、点赞（汇总表 lingjiewechatshare_like 与按访问 IP 区分的 lingjiewechatshare_like_vote 首次使用时自动创建；同一 IP 可再次点击取消赞，计数相应减少）、微海报（弹层内生成可保存的 PNG，另提供网页版 H5）、社交分享（仅 PC 端显示微博 / QQ 空间 / QQ 好友；微信为当前页二维码）。另可单独关闭微信 JSSDK 分享，仅保留工具条其它能力。

点赞接口：POST 至 lingjiewechatshare/home/like，需携带系统 CSRF 字段与 mod、id。成功时返回 JSON 中 data.likes 为当前总数，data.liked 为是否已赞（true/false）。

【必做】详情页互动工具条需手动插入

变量 lingjiewechatshare_embed 仅包含打赏 / 点赞 / 微海报 / 社交分享等 HTML 工具条，不会自动出现在全站。必须在模块内容详情模板（如 show.html 或 xxx/show.html）中在希望展示的位置插入下方一行，推荐：正文 （或等价字段）之后、上一篇/相关阅读之前。

插入代码（PC / 移动各自详情模板按需添加）：

{if isset($lingjiewechatshare_embed) && $lingjiewechatshare_embed}{$lingjiewechatshare_embed}{/if}

说明：仅在已发布内容的详情页且后台开启对应扩展时，变量才有内容；列表页、首页一般为空，插入该行也不影响页面。修改模板后请更新系统缓存。

【自动】微信 JSSDK 启动脚本

在开启插件总开关、并勾选「微信 JSSDK 分享」且已填 AppID 时，系统会在每次前端模板输出结束（钩子 cms_view_end）自动追加 JSSDK 引导脚本，无需在 footer.html 或详情模板中再写微信脚本。脚本仅在微信内置浏览器内执行分享配置；其它浏览器忽略。

模块内容详情页 · 分享文案（自动计算）

在模块 内容详情（show）页，无需手写 wx_share 时，由插件参与计算的分享文案优先规则如下（与是否在模板中输出 lingjiewechatshare_embed 无关）：

标题：详情 title → 页面 SEO 标题 → 插件默认标题 → 站点名

描述：详情摘要字段 description → SEO 描述 → 从正文 content 纯文本截取 → 插件默认描述 → 站点名

图片：缩略图字段 thumb → 正文中首张 （支持常见 src / data-src / data-original）→ 插件默认图（支持后台上传或外链）→ 站点 LOGO

模板变量（可选）

在模块详情等页面可通过控制器向模板赋值 wx_share 数组，覆盖默认 SEO 标题与描述：

\Phpcmf\Service::V()->assign('wx_share', [

'title' => '自定义标题',

'desc' => '自定义摘要',

'link' => 'https://example.com/page',

'imgUrl' => 'https://example.com/share.jpg',

]);

非模块详情页（首页、栏目列表等）且未指定 wx_share 时：标题为 meta_title → 插件默认标题 → 站点名；描述为 meta_description → 插件默认描述 → 站点名；图为插件默认图（后台可上传或填外链）→ 站点 LOGO。链接为当前页（可用 wx_share.link 覆盖）。

主题集成 · 页头 Open Graph（可选）

若已开启「注入 Open Graph」，请在主题 header.html 的 前增加一行：

{if isset($lingjiewechatshare_head) && $lingjiewechatshare_head}{$lingjiewechatshare_head}{/if}

与详情页 lingjiewechatshare_embed 不同：og 标签随全站页头输出；互动工具条仍以详情模板手动插入为准（见上文红框）；微信 JSSDK 由系统自动追加（见上文绿框）。