插件
会员交易中心
会员、余额、优惠券、卡密与支付入账。规则保存在插件内，任意主题通过 hp_opt() 与 hp_* API 调用。
↓
20
下载
◉
200
浏览
✉
0
反馈
应用介绍
水印大师（Watermark Master）
HopeCMS 水印插件，提供两大能力：
- 前台页面水印：在全站前台页面叠加半透明水印图层，不影响页面交互与点击；
- 上传图片自动水印：后台上传图片时，由服务端 GD 库把水印直接写入图片文件。
功能特性
- 文字、图片两种水印形态，前后台可独立配置。
- 前台水印支持透明度、倾斜角度（-90° ~ 90°）、字号、间距、文字颜色，可指定只在某个 CSS 选择器区域显示。
- 上传水印支持 平铺全图 与 九宫格定位（左上 / 中上 / 右上 / 左中 / 正中 / 右中 / 左下 / 中下 / 右下）。
- 上传水印支持 JPEG、PNG、GIF、WebP；文字带角度时使用真实文字边界框计算定位，不会超出图片边缘。
- 水印图片可在后台直接上传（PNG / JPG，≤2MB），也可直接填写已有图片 URL。
- 配置保存在 HopeCMS 插件存储中，卸载插件时自动清理。
安装与启用
- 将
watermark目录放入content/plugin/； - 后台「插件 → 插件管理」开启「水印大师」；
- 点击「设置」进入配置页。
环境依赖
- PHP GD 扩展（图片合成必需）；
imagettftext（文字水印必需）；- TTF 字体：优先读取
content/plugin/watermark/assets/font.ttf，未提供时自动回退系统中文字体（Windows 微软雅黑C:/Windows/Fonts/msyh.ttc、Linux DejaVu Sans）；若需固定字体效果，把任意.ttf中文字体放到assets/font.ttf即可。
使用说明
前台页面水印
| 配置项 | 说明 |
|---|---|
| 水印类型 | 文字 / 图片 |
| 文字内容 / 水印图片 | 按类型生效 |
| CSS 选择器 | 留空为全屏；填写如 .article-content 则只在匹配元素区域显示 |
| 透明度 | 0 ~ 1，建议 0.05 ~ 0.2 |
| 倾斜角度 | -90° ~ 90° |
| 字号 / 间距 / 颜色 | 控制文字水印排版 |
上传图片自动水印
| 配置项 | 说明 |
|---|---|
| 水印类型 | 文字 / 图片 |
| 水印位置 | 平铺全图 + 九宫格 10 种位置 |
| 文字内容 / 水印图片 | 按类型生效 |
| 透明度 | 1 ~ 100（服务端合成百分比） |
| 倾斜角度 | -90° ~ 90° |
| 字号 / 颜色 | 文字水印样式 |
上传水印只对开启之后新上传的图片生效，不会改写历史图片。系统生成的缩略图在水印钩子之前生成，如需缩略图同样带水印，请在系统设置中关闭缩略图或后续版本补充钩子。
实现原理
- 前台水印：通过
index_footer钩子注入配置与assets/watermark.js，用 Canvas 生成水印 Tile，叠加绝对定位的重复背景层，pointer-events: none不抢占交互。 - 上传水印：通过
attach_upload钩子拦截上传临时文件，使用 GD 绘制文字（TTF）或合成水印图片（按透明度混合、可旋转），再按原格式写回。
文件结构
watermark/
├── watermark.php 插件入口（钩子注册）
├── watermark_lib.php 配置、前台注入、GD 打水印核心
├── watermark_callback.php 启用 / 更新 / 卸载回调
├── watermark_setting.php 后台设置页（含图片上传）
├── assets/watermark.js 前台水印渲染脚本
├── preview.png 插件预览图
└── README.md 本文档更新日志
- 1.0.0：首个版本，支持前台页面水印与上传图片自动水印。
