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 參考文件。