toko

網站、自有網域與寄件網域

管理官網的內容與網址。綁定自己的網域後,行程頁、結帳、付款、會員中心與客人收到的信件連結都改用你的網域。

網站頁

在後台 →「內容與行銷」→「網站」操作。

最上方的「目前網站」顯示生效模式、官網網址、報名/會員網址,以及公司名稱、Logo 與聯絡資料。公司資料沿用公司設定,這裡只顯示目前值,按「修改公司資料」去改。

下方的分頁:

分頁內容
內容選模板、預覽、編輯各內容區塊
首頁輪播首頁最上方的輪播圖,平台模板與自建前台共用
分類入口首頁的行程分類,訪客點分類會看到帶這個標籤的行程
常見問題首頁的常見問題,平台模板與自建前台共用
關於頁長文平台模板「關於我們」頁的長文
SEO搜尋摘要與社群分享的預設內容
開發者自建前台用的前台金鑰,見自建前台 API
  • 模板預覽只影響你自己的瀏覽器,用的是已儲存的內容。
  • 套用模板不會切換網站模式。
  • 預覽、套用模板、儲存網址與啟用模式是分開的操作。

權限

權限能做什麼
查看網站查看所有分頁
編輯網站改模板、內容、關於頁與 SEO
管理網站改網站模式、官網網址,綁定與解除網域

這些權限不包含公司資料或財務設定。前台金鑰另有獨立權限。一次修改裡有你沒權限的欄位時,整筆不儲存。

網站模式

「網址與網域」卡片在所有分頁上方。先選網站模式,卡片再依模式顯示欄位。

  • 使用平台官網: 用平台的模板當官網。可以填一個「網站網域」,例 www.example.com。官網、行程頁、結帳與會員中心都在這個網域上。
  • 使用自建前台: 官網由你自己架設,透過自建前台 API 讀行程資料。報名、結帳、付款與會員中心仍由平台提供。

自建前台依序完成三步:

  1. 官網網址: 你自己部署的官網,例 https://www.example.com。它的 DNS 由你設定。
  2. 報名與結帳網域(選填): 平台提供報名與結帳的網域,卡片建議用 shop.<官網根網域>。儲存官網網址後才能綁定。不能填官網的網域或官網的根網域。
  3. 啟用自建前台: 有綁報名與結帳網域時,要等它顯示「已連線」才能啟用。沒綁就沿用平台網址,可以直接啟用。

要回到平台官網,在卡片選「使用平台官網」。切回會恢復平台模板與搜尋索引,保留官網網址、內容與金鑰。

綁定自有網域

綁定後,前台就開在你的網域上。這個網域負責行程頁、結帳、付款、會員中心與信件連結,不是只有結帳。

綁定的條件:

  • 方案有開通「自有網域」。
  • 有管理網站權限,並重新驗證身分。

檢查與解除也要管理網站權限,但不需要開通「自有網域」。所以停用後仍可解除既有綁定。解除另需重新驗證身分。

步驟

  1. 按「綁定網域」,填完整網域名稱,例 shop.example.com。不要填 https://、路徑、連接埠或萬用字元。網域已被別的公司使用時,畫面會說明。
  2. 把面板列出的 DNS 記錄交給管理 DNS 的人加入:
類型名稱值何時加
CNAMEshop.example.comcustomers.tokocloud.tw一定要加,而且要一直保留
TXT_cf-custom-hostname.shop.example.com面板上顯示的值只在要預先驗證時加,生效後可刪
  1. 加好後按「重新檢查」。進入頁面時也會自動檢查一次。
  • CNAME 不能刪。 憑證續約靠它;刪掉後,憑證會在下次續約時失效。
  • 根網域(例 example.com)要 DNS 服務支援 CNAME flattening 或 ALIAS。不支援時請改用子網域。
  • 平台不需要你委派整個 DNS 區域,也不提供固定 IP。

狀態

面板狀態意思下一步
等待 DNS平台還沒看到 CNAME確認 DNS 記錄,稍後按「重新檢查」
簽發中CNAME 已通過,憑證簽發中稍後按「重新檢查」
憑證就緒憑證已好,前台還沒切換按「重新檢查」;方案未開通時請聯繫平台窗口
已生效前台已切到你的網域無
失敗驗證失敗,面板顯示原因依原因修正 DNS 後按「重新檢查」,或取消綁定
解除尚未完成平台端的設定還沒刪掉按「重試解除」;一直失敗請聯繫平台窗口

在生效前的任何狀態都可以取消綁定。取消時平台端刪除失敗,面板顯示「取消尚未完成」,處理方式相同。

生效之後

  • 前台改用你的網域。訂單信、付款連結與客人的密碼重設信都改用它。
  • 後台仍在 https://<代號>.tokocloud.tw/admin,員工的密碼重設信也指向那裡。你的 DNS 出問題時,後台仍進得去。你的網域上打開後台路徑會顯示找不到頁面。
  • 生效前寄出的舊連結(付款頁、訂單頁)會轉到你網域的同一頁。生效前,信件一律用平台網址,客人不會收到打不開的連結。
  • 金流商的付款通知仍送到平台網址。你的 DNS 出問題時,付款仍會入帳。
  • 切換約一分鐘內全面生效。
  • 登入狀態不跨網域。已在平台網址登入的客人,要在新網域重新登入一次。
  • 已生效的網域之後出問題(例 CNAME 被刪),面板會顯示警示與「建議解除」。平台不會自動切回平台網址。

網域由平台代為設定時,面板顯示「平台代管」並唯讀。需要調整請聯繫平台窗口。

解除與更換

要換網域名稱,先解除,再綁新的。解除前請先刪掉 CNAME,再按確定。解除後:

  • 前台、訂單信與付款連結改回平台網址。
  • 已啟用的自有寄件網域一起停用,寄信改回平台寄件身分。
  • 約一分鐘內,舊的平台連結可能仍轉到已解除的網域而打不開。

完成後,面板提示要刪掉的 TXT 記錄。平台端設定沒刪成功時,面板顯示「解除尚未完成」,這個網域暫時不能重新綁定。請按「重試解除」。

寄件網域

訂單確認、付款成功、同意書提醒等信件由平台代寄,你不需要準備任何寄信帳號。你能調整的是寄件身分。在後台 →「公司設定」→「郵件設定」操作。

  • 預設: 從平台的網域寄出,寄件人名稱用你的公司名稱,客人回信寄到你設定的回覆信箱。不需要設定 DNS。
  • 自有寄件網域: 自有網域生效後,可以改用 info@<你的網域> 寄信。info 可以改成別的寄件人名稱。

啟用自有寄件網域:

  1. 按啟用。系統用你已綁定的網域,不必另填。
  2. 把畫面列出的 DNS 記錄交給管理 DNS 的人加入。
  3. 按重新檢查。通過後改用你的網域寄信。
›API 與 CLI 對應
動作端點權限
讀網站設定與內容GET /api/v1/settings/storefrontwebsite.read
改內容,或官網網址與模式PATCH /api/v1/settings/storefront內容 website.edit;網址與模式 website.manage
改 SEO 預設PATCH /api/v1/settings/seowebsite.edit
查寄件網域狀態與 DNSGET /api/v1/settings/sending-domainrole.manage
啟用寄件網域(不帶網域)POST /api/v1/settings/sending-domain/enablerole.manage
重新檢查POST /api/v1/settings/sending-domain/verifyrole.manage
停用POST /api/v1/settings/sending-domain/disablerole.manage
  • 網站權限字串:website.read、website.edit、website.manage。前台金鑰另用 api_key.manage。
  • PATCH /api/v1/settings/storefront 的模板、已知內容槽與 aboutContentMdx 在同一交易提交。
  • 寄件人名稱用 PATCH /api/v1/settings 的 senderLocalPart(預設 info),回覆信箱用 emailReplyTo。
  • 網域綁定只在後台操作,沒有對外 API。

相關指南

Command Palette

Search for a command to run...