嵌入活動報名你的活動,
放到任何網站。

兩行 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 個」、「額滿」,或在你開啟候補名單後顯示候補。
  • 報名日期 — 開放前顯示「報名於 … 開始」,截止後顯示「報名已截止」。
  • 你的表格 — 姓名、電郵及你自訂的問題,遺漏時有清晰提示。每個活動每個電郵只可報名一次(重複活動則以每個日期計)。
  • 確認訊息在畫面及電郵顯示,並附上 QR code 門票連結。
  • 隨時保持最新 — 訪客回到分頁時及每分鐘列表都會自動更新,但在有人填寫表格時絕不會更新。
  • 無障礙而寧靜 — 支援鍵盤操作,偏好減少動態效果的訪客會看到沒有動畫的版本。

疑難排解

你看到的情況原因及解決方法
甚麼都沒有出現部分編輯器會把一般文字中的 <script> 標籤移除。請使用建構工具的 HTML 或程式碼區塊(見貼到哪裡)。
「暫時無法載入活動」data-key 不正確或已被更換。請從管理後台的 API 金鑰分頁複製現時的公開金鑰。
某個活動不見了它尚未發佈、不在「發佈由/至」期間內,或金鑰屬於另一個帳戶。
列表被截斷你的建構工具把程式碼顯示在固定高度的方框內。把方框拉高即可。
活動文字仍是英文在管理後台為該活動加入該語言的翻譯;小工具本身的按鈕會自動翻譯。
提交時顯示「已不再接受報名」頁面載入後活動已截止或額滿。列表隨即會自動更新。

想用自己的設計?

小工具的所有功能都可透過 API 使用:用同一個公開金鑰列出活動及接受報名,或在專業版及商業版方案用秘密金鑰在你自己的系統管理活動。詳見 API 參考文件。