pk_ 开头的密钥。pk_…。<div id="events"></div> <script src="https://events-app.vicosys.com.hk/widget.js" data-key="pk_…" data-target="#events" defer></script>
pk_)。它专为显示在网页而设。切勿把私密密钥(sk_)粘贴到网站 — 它只应放在你自己的服务器。任何可添加 HTML 的地方都可以使用。请以代码而非一般文字粘贴 — 大部分网站建站工具都有专用的区块。
在区块编辑器添加 Custom HTML 区块并粘贴代码。WordPress.com 的方案需支持自定义代码才可执行 script。
添加 Embed Code → Embed HTML 并粘贴代码。Wix 会把它显示在一个方框内 — 把方框拉高到足以容纳你的列表。
添加 Code 区块并粘贴代码。代码区块内的 script 需要支持自定义代码的 Squarespace 方案。
在主题编辑器为页面添加 Custom Liquid 区块并粘贴代码。
拖入 Embed 元素并粘贴代码。自定义代码需要付费网站方案。
把它粘贴到页面 HTML 中列表应出现的位置。想放在多少个页面都可以。
用 data-layout 选择初始布局。访客可自行在列表与网格之间切换,选择会被记住。
精简行,附缩略图、日期及地点。点击一行即在原位展开完整详情及报名表。默认布局。
配合页面宽度的图片卡片。点击一张,详情从侧边滑入。
大卡片,所有内容一次性显示。最适合一两个重点活动。
<div id="events"></div> <script src="https://events-app.vicosys.com.hk/widget.js" data-key="pk_…" data-target="#events" data-layout="grid" data-page-size="6" defer></script>
以下任何属性都可加到 script 标签。只有 data-key 是必须的。
| 属性 | 必须 | 值 | 作用 |
|---|---|---|---|
data-key | 是 | pk_… | 你的公开密钥,来自管理后台的 API 密钥标签页。可安全显示在网页上 — 它只能列出你已发布的活动及接受报名。 |
data-target | — | CSS 选择器 | 列表出现的位置。省略的话,小工具会出现在 script 标签所在的位置。 |
data-layout | — | list · grid · full | 初始布局(默认 list)。 |
data-switcher | — | off | 隐藏列表/网格按钮并锁定布局。full 布局一律不显示按钮。 |
data-toolbar-target | — | CSS 选择器 | 把列表/网格按钮放到你自己的元素内,例如你的区块标题旁边。 |
data-page-size | — | 数字,例如 6 | 先显示该数目的活动,其余以“加载更多”按钮显示。默认:全部。 |
data-category-filter | — | off | 当你的活动横跨两个或以上分类时,会显示分类下拉菜单。off 可隐藏它。 |
data-lang | — | 语言代码,例如 en · zh-Hant · ja | 固定小工具的语言。通常无需设置:若省略,小工具会跟随页面的语言。详见语言。 |
data-permalink-base | — | 网址 | 分享链接指向的位置。如果小工具放在多个页面而你只想要一个活动页面,可使用此选项。 |
小工具本身的文字(按钮、表单字段、提示信息及日期)提供 11 种语言。
| 代码 | 语言 |
|---|---|
en | English |
zh-Hant | 繁體中文 |
zh-Hans | 简体中文 |
ja | 日本語 |
ko | 한국어 |
es | Español |
fr | Français |
de | Deutsch |
pt | Português |
th | ไทย |
vi | Tiếng Việt |
其他代码也可使用,例如 zh-TW 或 en-GB:小工具会采用列表中最接近的语言,如没有则使用英文。活动内容方面,请使用你在管理后台设置的“语言”中添加的相同代码。
需要列表以外的语言?告诉我们,我们会研究添加。
你的活动内容(标题、简介、地点、表单问题)如已在管理后台添加该语言的翻译,便会以小工具的语言显示,否则以你的主要语言显示。可使用的语言数量取决于你的方案。
小工具会跟随页面的语言,即页面 <html lang> 标签所标示的语言。多语言网站及内容管理系统(例如使用 Polylang 或 WPML 的 WordPress)已为每种语言设置此标签,因此无需额外设置。如你的页面没有设置,可改为在代码中加入 data-lang,例如在繁体中文页面使用 data-lang="zh-Hant"。
如页面两者皆未设置,而访客的浏览器语言是你提供的语言之一,小工具便会使用该语言,否则使用你的主要语言。这样按钮与活动内容总会以同一语言显示。
如你的网站切换语言时不会加载新页面,只要 <html lang> 一改变,小工具便会随之切换,并保留访客已选的筛选。如要在你自己的代码中切换,可调用 window.VicoEvents.setLang("zh-Hant")。
每个活动都有分享按钮:复制链接、WhatsApp、Facebook、X、LinkedIn、邮件,或手机自身的分享功能。分享的链接会打开你的页面并自动展开该活动。
在管理后台的“资料”设置你的公司网址,分享的链接在聊天软件及社交平台上也会显示完整的预览卡 — 活动标题、摘要及横幅,以分享者的语言显示。
小工具外观简洁中性,不会影响你页面的其他部分。如要修改,在你自己的样式表为它的 evw- 类添加规则 — 以你的为准。
/* your brand colour on the buttons */ .evw-btn { background: #14532d; } /* squarer cards */ .evw-card { border-radius: 4px; } /* the “spots left” badge */ .evw-badge { background: #ecfdf5; color: #047857; }
其他实用类:evw-title、evw-meta、evw-desc、evw-banner、evw-thumb、evw-gcard、evw-form、evw-input。
| 你看到的情况 | 原因及解决方法 |
|---|---|
| 什么都没有出现 | 部分编辑器会把一般文字中的 <script> 标签移除。请使用建站工具的 HTML 或代码区块(见粘贴到哪里)。 |
| “暂时无法加载活动” | data-key 不正确或已被更换。请从管理后台的 API 密钥标签页复制目前的公开密钥。 |
| 某个活动不见了 | 它尚未发布、不在“发布由/至”期间内,或密钥属于另一个账户。 |
| 列表被截断 | 你的建站工具把代码显示在固定高度的方框内。把方框拉高即可。 |
| 活动文字仍是英文 | 在管理后台为该活动添加该语言的翻译;小工具本身的按钮会自动翻译。 |
| 提交时显示“已不再接受报名” | 页面加载后活动已截止或额满。列表随即会自动更新。 |
小工具的所有功能都可通过 API 使用:用同一个公开密钥列出活动及接受报名,或在专业版及商业版方案用秘密密钥在你自己的系统管理活动。详见 API 参考文档。