toko

旅誌與圖片庫

旅誌是你在官網發表的長文,例如行前分享、路線介紹。圖片庫集中存放後台各處用到的圖片。

什麼時候用

  • 旅誌:要在官網放文章,吸引客人或幫助搜尋引擎找到你。文章可以掛一位嚮導當作者。
  • 圖片庫:要整理行程照片、找某張圖的網址,或刪掉用不到的圖。在後台任何「選圖」欄位上傳的圖,也都會進圖片庫。

寫一篇旅誌

在後台 →「內容與行銷」→「旅誌」操作。列表可依狀態篩選,也可搜尋標題或網址代稱。

  1. 按「新增手記」。
  2. 填「標題」與「內文」。這兩欄必填。
  3. 在「列表與封面」放封面圖片與摘要。摘要建議 60 字內,會顯示在前台的文章卡片上。
  4. 選填「作者(嚮導)」。只列出在職的嚮導。
  5. 「狀態」選「草稿」先存起來,或選「發布」直接上線。
  6. 按「建立手記」。系統會帶你到編輯頁,你可以繼續修改。

內文用編輯器排版。要放圖,按工具列的「插入圖片」,再從圖庫選圖、現場上傳,或貼上圖片網址。

網址代稱

「URL slug」是文章網址的最後一段,例:/journal/spring-trail-notes。只能用小寫英數字與連字號。

  • 不填時,系統依標題自動產生。標題全是中文時,系統會產生一組隨機代稱。
  • 自動產生的代稱和既有文章重複時,系統會在後面加上 -2、-3。
  • 文章發布後改代稱,舊網址會失效。已經分享出去的連結會找不到文章。

SEO 與分享

「SEO 與分享」區塊只在要覆寫時填。留空時系統依序退回:

欄位留空時使用
SEO 標題(覆寫)文章標題
SEO 描述(覆寫)摘要,再退回站台預設
分享圖(覆寫)封面圖,再退回站台預設

狀態

狀態前台說明
草稿不顯示新文章的預設狀態。
發布顯示第一次發布時,系統記下發布時間。
封存不顯示文章下架,但保留內容。可以改回草稿或發布。
  • 發布時間只在第一次發布時記錄。之後改回草稿再發布,發布時間不變,文章在列表上的位置也不變。
  • 編輯頁的「封存此手記」是下架的捷徑,按下後回到列表。

前台怎麼顯示

  • 旅誌列表:顯示已發布的文章,新的在前,最多 60 篇。卡片樣式依店面模板而定,會用到封面、標題、摘要與作者。
  • 文章頁:網址是 /journal/<網址代稱>。未發布或已封存的文章,前台回「找不到頁面」。
  • 列表頁的標題與介紹文字來自店面的內容設定。沒有設定時,標題是「專欄」。
  • 儲存後,前台會顯示新內容。

自建前台用店面 API 讀旅誌,見自建前台 API。

管理圖片庫

在後台 →「內容與行銷」→「圖片庫」操作。這一頁列出所有圖片,新的在前,每頁 24 張。可依行程篩選,也可搜尋行程名稱、圖片說明或網址。

新增圖片

  1. 按「新增圖片」。
  2. 選「所屬行程」。
  3. 選圖片來源:「上傳檔案」或「貼上 URL」。
  4. 選填「說明」與「顯示順序」。
  5. 按「建立」。
來源規則
上傳檔案只收 JPEG、PNG、WebP,單張上限 8MB。系統檢查檔案內容,改副檔名騙不過。
貼上 URL只收 http 或 https 開頭的圖片直鏈。網址不像圖檔時會提醒,但仍可建立。

圖片在哪裡用到

  • 行程相簿:掛在行程下的圖片會出現在該行程的前台相簿。「顯示順序」數字越小越前面。
  • 行程編輯頁:「圖片」分頁可以上傳、刪除,也可把某張設為封面。
  • 後台的「選圖」欄位:旅誌封面、分享圖、公司 logo、住宿封面等欄位旁都有「選圖」按鈕。按下後可從圖庫選、上傳或貼網址。

未歸屬的圖片

從「選圖」上傳時,所屬行程可以不選。這類圖片在圖庫卡片上標「未歸屬」。

  • 未歸屬的圖片不會出現在任何行程的前台相簿。
  • 未歸屬不代表沒人用。 logo、住宿封面、旅誌內文的圖,多半就是未歸屬圖片。刪除前請先確認。
  • 新建行程時上傳的封面,行程建立後會自動掛到這個行程下。

刪除圖片

在圖片卡片上按刪除,再確認。

  • 圖片會從圖片庫與行程相簿移除,無法復原。
  • 已經貼在旅誌、封面或其他欄位的網址,不會跟著清掉。

權限

動作需要的權限
看旅誌列表與編輯頁旅誌檢視(journal.read)
建立、修改、封存旅誌旅誌管理(journal.manage)
看圖片庫圖片檢視(image.read)
新增、上傳、刪除圖片圖片管理(image.manage)
在行程編輯頁設封面另需行程管理(trip.manage)

角色與權限的設定見權限與角色。

›API 與 CLI 對應

旅誌:

動作APICLI權限
列表與搜尋GET /api/v1/journaljournal listjournal.read
單篇內容GET /api/v1/journal/{id}journal getjournal.read
作者選項GET /api/v1/journal/authorsjournal authorsjournal.read
建立POST /api/v1/journaljournal createjournal.manage
更新PATCH /api/v1/journal/{id}journal updatejournal.manage
封存POST /api/v1/journal/{id}/archivejournal archivejournal.manage
  • 建立與更新都送完整欄位:title、contentMdx 必填,其餘選填。更新會整篇覆寫:省略的選填欄位會被清空,只有 slug 省略時保持不變。
  • status 是 draft、published 或 archived。建立時預設 draft;更新時省略則沿用目前狀態。
  • slug 只收小寫英數與連字號,2 到 63 字元。
  • 列表的 q 比對標題與網址代稱。

圖片:

動作APICLI權限
列表與搜尋GET /api/v1/imagesimages listimage.read
可選的行程GET /api/v1/images/tripsimages tripsimage.read
以網址掛到行程POST /api/v1/imagesimages createimage.manage
上傳檔案POST /api/v1/images/uploadimages uploadimage.manage
刪除DELETE /api/v1/images/{id}images deleteimage.manage
  • 以網址建立時 tripId 必填;上傳時 tripId 選填,不帶就是未歸屬圖片。
  • 上傳的檔案以 base64 放在 JSON 內,規則與後台相同。
  • displayOrder 是 0 到 9999 的整數,預設 0。

完整欄位見 journal API、images API 與 CLI。

相關指南

Command Palette

Search for a command to run...