节日主题特效能让网站在假期焕然一新,而无需改动核心源代码。对于使用 CMSNT 源代码的网站,你可以直接在后台开启越南南方解放日(4 月 30 日)的纪念特效。
下面的教程侧重于快速部署、在多种设备上检查显示效果,以及活动结束后及时移除,让网站保持轻量与稳定。
安装特效前的准备
你需要一个能访问 Admin Panel 中「设置」的账号。在添加新代码之前,请先备份 Script Header 字段里现有的内容,以便随时还原。
- 登录到需要配置的那个网站的后台。
- 确认网站运行正常、界面没有报错。
- 把当前 Script Header 的内容另存为一个文件。
插入 4·30 特效的步骤
-
01
打开 Script Header 区域
在 Admin Panel 中进入「设置」,找到 Script Header 字段。不同源代码版本的菜单名称可能略有差异。
-
02
粘贴特效代码
把下面两行放在现有内容之后。如果不确定其他标签或脚本的作用,请不要删除它们。
-
03
保存并刷新网站
点击保存,在隐身窗口打开首页并重新加载,确认 CSS 与 JavaScript 文件已经载入。
<link rel="stylesheet" href="https://api.cmsnt.co/cdn/3041975/style.css">
<script src="https://api.cmsnt.co/cdn/3041975/script.js" defer></script>
注意: defer 属性会让 JavaScript 在 HTML 解析完成后再执行,减少对主内容显示速度的影响。
安装后的检查
请同时在电脑和手机上检查,因为全屏特效可能在小屏幕上遮挡导航按钮或重要内容。如果使用了缓存系统,可能需要清除应用、CDN 或浏览器缓存才能看到变化。
- 页面仍可滚动、按钮可点击、菜单可正常打开。
- 没有出现横向滚动条,也没有元素遮住购买按钮。
- 浏览器控制台没有 style.css 或 script.js 的加载错误。
- 页面加载速度没有明显变化。
节日之后如何关闭或移除特效
回到 Script Header 字段,精确删除你添加的那两行并保存。随后清除缓存并再次检查首页。及时移除能让界面保持专业,也避免加载不再需要的资源。
关于性能与安全的提醒
任何外部 JavaScript 文件都能影响页面。请只使用你信任来源的地址,在特效启用期间关注网站状态,并始终保留此前配置的副本。如果网站启用了严格的 CSP,需要在相应指令中允许 api.cmsnt.co 域名。
机器人可以批量注册账号、提交垃圾表单并消耗服务器资源。Google reCAPTCHA 增加了一层评估,用来区分正常用户行为和可疑的自动访问。
要接入 CMSNT 源代码,你需要注册正确的域名、选择源代码支持的 reCAPTCHA 版本,并准确填入所发放的密钥对。
reCAPTCHA 是什么?
reCAPTCHA 是 Google 提供的表单保护服务。视版本不同,它可能显示验证挑战、复选框,或基于访问行为在后台进行风险评分。
reCAPTCHA 能减少垃圾提交,但不能完全取代其他安全措施。网站仍需要限制请求频率、校验输入数据,并在服务端监控异常行为。
创建 Site Key 与 Secret Key 的步骤
-
01
登录 Google reCAPTCHA
用 Google 账号打开 reCAPTCHA 介绍页,然后进入 Admin Console。
-
02
新建一项配置
点击新建图标,填写易识别的标签,并选择与当前 CMSNT 源代码版本相符的 reCAPTCHA 类型。
-
03
填写域名
输入不带 https:// 也不带路径的域名。如果网站运行在子域上,也要一并添加。
-
04
获取密钥对
完成注册后复制 Site Key 与 Secret Key。两者作用不同,不能填反。
在 CMSNT Admin Panel 中填入密钥
登录后台,打开安全设置或 reCAPTCHA 配置部分,把 Site Key 与 Secret Key 粘贴到对应字段。启用功能、保存配置,如果该版本会缓存设置,还需清除缓存。
注意: Secret Key 只能在服务端使用。不要把它放进教程截图、公开代码仓库,或发到人多的群聊里。
如何检查 reCAPTCHA 是否生效
- 在隐身窗口打开注册页或需要保护的表单。
- 提交一次有效表单,确认流程仍能正常完成。
- 尝试连续提交,检查频率限制机制。
- 当网站报验证错误或不显示挑战时,检查日志。
常见错误与处理方式
- Invalid domain for site key:当前域名尚未添加到 Google 的配置中。
- Invalid key type:Google 上的 reCAPTCHA 类型与源代码支持的类型不一致。
- 验证始终失败:Secret Key 填错、服务器无法访问验证服务,或系统时间偏差。
- 挂件不显示:JavaScript 文件被 CSP、浏览器扩展或缓存系统拦截。