嵌入活动报名你的活动,
放到任何网站。

两行 HTML,就把你的活动列表 — 连同报名功能 — 放到你自己的网站。粘贴一次,之后的一切都在管理后台完成。

快速开始

  1. 复制你的公开密钥。在管理后台打开 API 密钥,复制以 pk_ 开头的密钥。
  2. 把代码粘贴到活动应该出现的位置,并用你的密钥取代 pk_…。
  3. 在管理后台发布活动。活动便会出现在你的页面 — 日后无需再改动网站。
<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 的地方都可以使用。请以代码而非一般文字粘贴 — 大部分网站建站工具都有专用的区块。

WordPress

在区块编辑器添加 Custom HTML 区块并粘贴代码。WordPress.com 的方案需支持自定义代码才可执行 script。

Wix

添加 Embed Code → Embed HTML 并粘贴代码。Wix 会把它显示在一个方框内 — 把方框拉高到足以容纳你的列表。

Squarespace

添加 Code 区块并粘贴代码。代码区块内的 script 需要支持自定义代码的 Squarespace 方案。

Shopify

在主题编辑器为页面添加 Custom Liquid 区块并粘贴代码。

Webflow

拖入 Embed 元素并粘贴代码。自定义代码需要付费网站方案。

纯 HTML 或任何 CMS

把它粘贴到页面 HTML 中列表应出现的位置。想放在多少个页面都可以。

布局

用 data-layout 选择初始布局。访客可自行在列表与网格之间切换,选择会被记住。

list

列表

精简行,附缩略图、日期及地点。点击一行即在原位展开完整详情及报名表。默认布局。

grid

网格

配合页面宽度的图片卡片。点击一张,详情从侧边滑入。

full

完整

大卡片,所有内容一次性显示。最适合一两个重点活动。

<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 种语言。

其他代码也可使用,例如 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。

访客会看到什么

  • 只显示已发布的活动,最早举行的排在最前。草稿及已取消的活动不会出现;设有发布期间的活动只在期间内出现。
  • 实时名额 — “剩余 3 个”、“额满”,或在你开启候补名单后显示候补。
  • 报名日期 — 开放前显示“报名于 … 开始”,截止后显示“报名已截止”。
  • 你的表单 — 姓名、邮箱及你自定义的问题,遗漏时有清晰提示。每个活动每个邮箱只可报名一次(重复活动则以每个日期计)。
  • 确认消息在屏幕及邮件显示,并附上二维码门票链接。
  • 随时保持最新 — 访客回到标签页时及每分钟列表都会自动更新,但在有人填写表单时绝不会更新。
  • 无障碍而安静 — 支持键盘操作,偏好减少动态效果的访客会看到没有动画的版本。

故障排除

你看到的情况原因及解决方法
什么都没有出现部分编辑器会把一般文字中的 <script> 标签移除。请使用建站工具的 HTML 或代码区块(见粘贴到哪里)。
“暂时无法加载活动”data-key 不正确或已被更换。请从管理后台的 API 密钥标签页复制目前的公开密钥。
某个活动不见了它尚未发布、不在“发布由/至”期间内,或密钥属于另一个账户。
列表被截断你的建站工具把代码显示在固定高度的方框内。把方框拉高即可。
活动文字仍是英文在管理后台为该活动添加该语言的翻译;小工具本身的按钮会自动翻译。
提交时显示“已不再接受报名”页面加载后活动已截止或额满。列表随即会自动更新。

想用自己的设计?

小工具的所有功能都可通过 API 使用:用同一个公开密钥列出活动及接受报名,或在专业版及商业版方案用秘密密钥在你自己的系统管理活动。详见 API 参考文档。