旅誌與圖片庫
旅誌是你在官網發表的長文,例如行前分享、路線介紹。圖片庫集中存放後台各處用到的圖片。
什麼時候用
- 旅誌:要在官網放文章,吸引客人或幫助搜尋引擎找到你。文章可以掛一位嚮導當作者。
- 圖片庫:要整理行程照片、找某張圖的網址,或刪掉用不到的圖。在後台任何「選圖」欄位上傳的圖,也都會進圖片庫。
寫一篇旅誌
在後台 →「內容與行銷」→「旅誌」操作。列表可依狀態篩選,也可搜尋標題或網址代稱。
- 按「新增手記」。
- 填「標題」與「內文」。這兩欄必填。
- 在「列表與封面」放封面圖片與摘要。摘要建議 60 字內,會顯示在前台的文章卡片上。
- 選填「作者(嚮導)」。只列出在職的嚮導。
- 「狀態」選「草稿」先存起來,或選「發布」直接上線。
- 按「建立手記」。系統會帶你到編輯頁,你可以繼續修改。
內文用編輯器排版。要放圖,按工具列的「插入圖片」,再從圖庫選圖、現場上傳,或貼上圖片網址。
網址代稱
「URL slug」是文章網址的最後一段,例:/journal/spring-trail-notes。只能用小寫英數字與連字號。
- 不填時,系統依標題自動產生。標題全是中文時,系統會產生一組隨機代稱。
- 自動產生的代稱和既有文章重複時,系統會在後面加上
-2、-3。 - 文章發布後改代稱,舊網址會失效。已經分享出去的連結會找不到文章。
SEO 與分享
「SEO 與分享」區塊只在要覆寫時填。留空時系統依序退回:
| 欄位 | 留空時使用 |
|---|---|
| SEO 標題(覆寫) | 文章標題 |
| SEO 描述(覆寫) | 摘要,再退回站台預設 |
| 分享圖(覆寫) | 封面圖,再退回站台預設 |
狀態
| 狀態 | 前台 | 說明 |
|---|---|---|
| 草稿 | 不顯示 | 新文章的預設狀態。 |
| 發布 | 顯示 | 第一次發布時,系統記下發布時間。 |
| 封存 | 不顯示 | 文章下架,但保留內容。可以改回草稿或發布。 |
- 發布時間只在第一次發布時記錄。之後改回草稿再發布,發布時間不變,文章在列表上的位置也不變。
- 編輯頁的「封存此手記」是下架的捷徑,按下後回到列表。
前台怎麼顯示
- 旅誌列表:顯示已發布的文章,新的在前,最多 60 篇。卡片樣式依店面模板而定,會用到封面、標題、摘要與作者。
- 文章頁:網址是
/journal/<網址代稱>。未發布或已封存的文章,前台回「找不到頁面」。 - 列表頁的標題與介紹文字來自店面的內容設定。沒有設定時,標題是「專欄」。
- 儲存後,前台會顯示新內容。
自建前台用店面 API 讀旅誌,見自建前台 API。
管理圖片庫
在後台 →「內容與行銷」→「圖片庫」操作。這一頁列出所有圖片,新的在前,每頁 24 張。可依行程篩選,也可搜尋行程名稱、圖片說明或網址。
新增圖片
- 按「新增圖片」。
- 選「所屬行程」。
- 選圖片來源:「上傳檔案」或「貼上 URL」。
- 選填「說明」與「顯示順序」。
- 按「建立」。
| 來源 | 規則 |
|---|---|
| 上傳檔案 | 只收 JPEG、PNG、WebP,單張上限 8MB。系統檢查檔案內容,改副檔名騙不過。 |
| 貼上 URL | 只收 http 或 https 開頭的圖片直鏈。網址不像圖檔時會提醒,但仍可建立。 |
圖片在哪裡用到
- 行程相簿:掛在行程下的圖片會出現在該行程的前台相簿。「顯示順序」數字越小越前面。
- 行程編輯頁:「圖片」分頁可以上傳、刪除,也可把某張設為封面。
- 後台的「選圖」欄位:旅誌封面、分享圖、公司 logo、住宿封面等欄位旁都有「選圖」按鈕。按下後可從圖庫選、上傳或貼網址。
未歸屬的圖片
從「選圖」上傳時,所屬行程可以不選。這類圖片在圖庫卡片上標「未歸屬」。
- 未歸屬的圖片不會出現在任何行程的前台相簿。
- 未歸屬不代表沒人用。 logo、住宿封面、旅誌內文的圖,多半就是未歸屬圖片。刪除前請先確認。
- 新建行程時上傳的封面,行程建立後會自動掛到這個行程下。
刪除圖片
在圖片卡片上按刪除,再確認。
- 圖片會從圖片庫與行程相簿移除,無法復原。
- 已經貼在旅誌、封面或其他欄位的網址,不會跟著清掉。
注意
刪除不會檢查圖片是否還在別處使用。要換掉某張圖,先在用到它的欄位改選新圖,再刪舊圖。
權限
| 動作 | 需要的權限 |
|---|---|
| 看旅誌列表與編輯頁 | 旅誌檢視(journal.read) |
| 建立、修改、封存旅誌 | 旅誌管理(journal.manage) |
| 看圖片庫 | 圖片檢視(image.read) |
| 新增、上傳、刪除圖片 | 圖片管理(image.manage) |
| 在行程編輯頁設封面 | 另需行程管理(trip.manage) |
角色與權限的設定見權限與角色。
›API 與 CLI 對應
旅誌:
| 動作 | API | CLI | 權限 |
|---|---|---|---|
| 列表與搜尋 | GET /api/v1/journal | journal list | journal.read |
| 單篇內容 | GET /api/v1/journal/{id} | journal get | journal.read |
| 作者選項 | GET /api/v1/journal/authors | journal authors | journal.read |
| 建立 | POST /api/v1/journal | journal create | journal.manage |
| 更新 | PATCH /api/v1/journal/{id} | journal update | journal.manage |
| 封存 | POST /api/v1/journal/{id}/archive | journal archive | journal.manage |
- 建立與更新都送完整欄位:
title、contentMdx必填,其餘選填。更新會整篇覆寫:省略的選填欄位會被清空,只有slug省略時保持不變。 status是draft、published或archived。建立時預設draft;更新時省略則沿用目前狀態。slug只收小寫英數與連字號,2 到 63 字元。- 列表的
q比對標題與網址代稱。
圖片:
| 動作 | API | CLI | 權限 |
|---|---|---|---|
| 列表與搜尋 | GET /api/v1/images | images list | image.read |
| 可選的行程 | GET /api/v1/images/trips | images trips | image.read |
| 以網址掛到行程 | POST /api/v1/images | images create | image.manage |
| 上傳檔案 | POST /api/v1/images/upload | images upload | image.manage |
| 刪除 | DELETE /api/v1/images/{id} | images delete | image.manage |
- 以網址建立時
tripId必填;上傳時tripId選填,不帶就是未歸屬圖片。 - 上傳的檔案以 base64 放在 JSON 內,規則與後台相同。
displayOrder是 0 到 9999 的整數,預設 0。
完整欄位見 journal API、images API 與 CLI。