AumCreate 是一套 WordPress 佈景主題。它本身即可渲染出一個完整的網站：帶有標誌與選單的 網站頁首、部落格索引、彙整頁、搜尋結果、單篇文章、頁面、作者資料頁，以及留言。 它同時能辨識 Aumframe 視覺化編輯器，並在您的某一份設計接管某個網址時自動退讓。
1. 佈景主題如何渲染一個頁面
WordPress 會為每一個網址挑選一個範本檔。AumCreate 為範本階層會詢問到的每一種情況 各提供一個，這些範本依據文章內容、佈景主題設定與色彩調色盤繪製頁面。
在這之上還有三件事：
- 網站頁首與頁尾由 AumCreate 繪製。當 Aumframe 已啟用且已發布一份 Site shell 時， Aumframe 的外框會取代兩者，佈景主題不再輸出自己的頁首頁尾。
- 當 Aumframe 已啟用、且其中某份設計符合目前的網址時，該設計會完全取代佈景主題 在這個網址上的範本輸出。佈景主題透過
aumframe_is_taking_over()偵測這件事， 並略過自家範本原本需要的樣式表與指令碼。 - WooCommerce、AumNexCart 與 AumReserva 各自在執行階段偵測。其中任何一個不存在時， 佈景主題照常渲染，而且佈景主題沒有任何一處預設它們已安裝。
佈景主題宣告支援 post-thumbnails、title-tag、automatic-feed-links、html5、 responsive-embeds、align-wide，並在 WooCommerce 啟用時支援其商品圖庫功能。 它註冊一個選單位置：Primary Menu。
2. 安裝
安裝佈景主題並啟用。不需要任何進一步設定即可得到一個可用的網站。
有兩項設定值得優先完成，因為網站頁首會讀取這兩者：
- Appearance → Menus —— 指派一個選單到 Primary Menu 位置。
- AumCreate → Theme Settings → General —— 上傳一個橫式標誌。
未設定標誌時，網站頁首改為顯示網站標題。未指派選單時，頁首只顯示標誌。
3. 佈景主題設定畫面
佈景主題新增一個頂層選單項目 AumCreate，底下只有一個子項目 Theme Settings。 佈景主題所有可設定的項目都在這一個畫面上，分成數個標籤：
| 標籤 | 涵蓋範圍 |
|---|---|
| General Settings | 標誌、佈景主題模式、前台日夜切換、可被搜尋的內容類型，以及預設文章縮圖 |
| Color Settings | 淺色調色盤、深色調色盤，以及您自訂的色彩變數 |
| Layout Settings | 內容寬度、圖片長寬比、回到頂端按鈕、社群側邊欄、文章側邊欄模組，以及字型 |
| User Settings | 註冊、全站社群功能總開關、預設頭像，以及登入頁輪播圖 |
| Performance | 八個開關，各自關閉一項會消耗位元組或請求的 WordPress 行為 |
| WooCommerce | 商店版面；此標籤只在 WooCommerce 啟用時出現 |
每個標籤各自獨立儲存。欄位的說明文字位於該欄位下方。
4. 網站識別與網站頁首
網站頁首由兩項設定與一個 WordPress 選單位置構成。
4.1 標誌
General Settings 提供四個標誌欄位：橫式標誌與方形標誌，各自另有一個深色模式版本。 網站頁首使用橫式那一組；方形那一組用於寬標誌放不下的位置。
兩個版本都會寫入頁面，並顯示與目前調色盤相符的那一個。只設定淺色版本是合理的： 該標誌會在兩種調色盤下都顯示，對於在深淺底色上都能辨識的標記而言，這正是正確的選擇。
4.2 Primary Menu
頁首渲染指派到 Primary Menu 位置的選單，只渲染一層。子選單項目不會畫在網站頁首中。
當該位置未指派任何選單時，頁首只渲染標誌，而不會退而列出所有頁面。
4.3 頁尾
佈景主題的頁尾帶有網站名稱與目前年份。它刻意保持簡短：需要一個經過設計的頁尾時， 由 Aumframe 的 Site shell 提供，並取代這個頁尾。
5. 色彩與日夜調色盤
5.1 兩套調色盤
Color Settings 有一套淺色模式調色盤與一套深色模式調色盤。每一套設定七個值： 品牌色、次要色、頁面背景、卡片背景、框線色、次要文字色，以及捲軸色。
5.2 自動計算的文字顏色
文字顏色不在那七個值之內。佈景主題依據每一種背景自身的相對亮度計算其上的文字色： 比較該背景與白色、以及與近黑色的對比度，取較高的那一個。因此改動一個背景色時， 它上面的文字會跟著移動；而一個深到需要白字的品牌色會自動得到白字， 不需要另一個設定去與它保持同步。
5.3 佈景主題模式
General Settings 中的 Theme Mode 有三種取值：
- Light Mode —— 網站一律渲染淺色調色盤。
- Dark Mode —— 網站一律渲染深色調色盤。
- Follow System —— 調色盤跟隨訪客作業系統的偏好設定。
5.4 前台切換控制項
Front-end theme toggle 會加上一個控制項，讓訪客自行切換調色盤。 這項設定與 Theme Mode 互相獨立：網站可以預設深色但仍提供切換， 也可以預設淺色而完全不提供切換。
5.5 自訂色彩變數
Custom Global Colors 接受具名色彩，每一個都有一個淺色值與一個深色值。 每一個都會成為一個以其代稱命名的 CSS 自訂屬性，可供任何自訂 CSS 以及 在 Aumframe 中建立的設計使用。
6. 字型
字型設定位於 Layout Settings 標籤，設定三種字體：標題字型、內文字型與等寬字型。 每一種都可以是系統字型堆疊或 Google 字型。
第四個控制項 Fallback Stack 決定在 CSS 字型堆疊中接在所選字族之後的是什麼， 使網頁字型載入期間、或載入失敗時，文字仍以相近的形狀呈現。
Custom Font CSS 接受 @font-face 或 @import 規則，用於託管在其他位置的字型。 佈景主題會把字型的 @import 放在它所產生樣式表中所有規則之前， 因為瀏覽器會捨棄出現在規則之後的 @import，而且捨棄時不會提出任何回報。
7. 版面、浮動控制項與文章側邊欄
7.1 內容寬度與圖片形狀
Content Width 設定內容欄的最大寬度。Image Orientation 在 4:3 與 3:4 之間 選擇列表中封面圖的長寬比，它以 CSS aspect-ratio 套用，而不是裁切檔案。
7.2 浮動欄
三個控制項共用視窗角落的同一條固定欄：回到頂端按鈕、日夜切換，以及社群側邊欄。 Back to Top Button 與 Social Sidebar 各自開關自己那一個成員。
這條欄掛在 wp_footer 上，而佈景主題的頁尾與 Aumframe 的畫布都會呼叫它， 因此它的成員會出現在每一個頁面上，包含被某份設計接管的那些。
7.3 社群連結
Social Links 接受任意數量的項目。每一項帶有一張圖示、一個背景色、一個滑過色， 以及三種行為之一：連結、滑過時顯示的文字彈出層，或滑過時顯示的圖片彈出層。 選擇圖片彈出層的常見理由是放一組 QR code。
7.4 文章側邊欄模組
Post Sidebar Modules 決定單篇文章旁邊出現哪些模組，以及它們的順序：
- Table of Contents —— 由文章中的標題產生。
- Post Navigation (Prev / Next) —— 連往前後兩篇文章。
- Related Posts —— 共用分類或標籤的文章。
- Tags —— 這篇文章的標籤。
每個模組有自己的開關，清單順序即渲染順序。
8. 文章範本
每一篇文章在編輯器側邊欄都有一個 Article Template 區塊，提供三個選項。
8.1 Text
預設值。文章渲染為一個主視覺區塊，特色圖片位於標題之後，接著是文章內容與側邊欄模組。
8.2 Gallery
該區塊會多出一個圖片選擇器。在那裡選擇的圖片會以圖庫形式渲染在文章內容上方； 當這篇文章出現在列表中而且未設定特色圖片時，其中第一張會成為它的封面。
8.3 Video
該區塊會多出一個影片選擇器，文章渲染時以影片取代主視覺圖片。
影片本身沒有縮圖，因此該區塊提供產生縮圖的功能：瀏覽器載入所選影片、跳到某一影格、 把該影格繪製到畫布上，再把結果上傳為這篇文章的特色圖片。整個過程在瀏覽器中完成， 不涉及任何伺服器端的影片工具。
8.4 列表中的封面
當一篇文章出現在列表中時，它的封面依此順序解析：特色圖片、第一張圖庫圖片、影片畫格、 General Settings 中的 Default Post Thumbnail。若四者皆無且未設定預設值， 它的卡片會渲染成沒有圖片的樣子，而不是一張破圖。
9. 列表
有三種範本渲染文章列表，三者使用同一種卡片：封面圖、標題、日期、留言數、 在有資料時顯示的瀏覽數與互動數，以及一段裁切過的摘要。
9.1 部落格索引
文章頁以網格渲染這些卡片，欄數依內容寬度所能容納的數量而定，在手機上縮到一欄。
9.2 彙整頁
分類、標籤、日期或文章類型的彙整頁，比部落格索引多出三樣東西：
- 一條篩選列，帶有排序方式（Newest、Recently updated、Most commented、 Title A–Z 與 Random）、排序方向，以及一個限定在該彙整範圍內的搜尋欄位。
- 一條側邊欄，帶有分類、近期文章與標籤雲，各自收在可摺疊的面板中。
- 不重新載入頁面的分頁：變更篩選或換頁時取得下一批資料，並就地替換卡片。
9.3 搜尋結果
搜尋結果以同樣的卡片、搭配同樣的側邊欄渲染。General Settings 中的 Search Types 決定除了文章與頁面之外，還要搜尋哪些內容類型。
10. 作者資料頁
每一個作者網址渲染的是一個資料頁，而不是該作者文章的純列表。頁面帶有作者的頭像、 個人簡介、加入日期、所在地與網站，以及一組標籤：
- Recent Posts —— 該作者已發布的文章。
- Liked Posts 與 Favorited Posts —— 該作者標記過的內容，在互動功能可用時顯示。
- Following 與 Followers —— 該作者與其他使用者的關聯。
- Orders 與 Downloads —— 在 WooCommerce 啟用時加入，且僅該資料頁的擁有者本人可見。
已登入的作者檢視自己的資料頁時，可以就地編輯個人簡介、所在地、網站與生日， 並可在同一畫面更換頭像。
11. 留言
留言支援巢狀，並以 AJAX 載入：第一頁隨文章一起送達，換頁時就地替換清單， 不重新載入頁面。回覆表單會在被回覆的那則留言下方展開。
留言清單與回覆表單從 <body> 上的 data-post-id 屬性讀取文章識別碼， 該屬性由佈景主題在每一個單篇檢視中寫入。
12. 會員與社群功能
12.1 註冊與登入頁
Anyone can register 對應 WordPress 中的同名設定並與之保持同步， 因此在這裡開啟它，Settings → General 中的那一項也會一併開啟。
佈景主題以自己的登入畫面取代 WordPress 的登入畫面，該畫面帶有您的標誌與一組輪播圖。 Login Page Carousel 存放這些圖片，Default Avatar 設定未上傳頭像之帳號的頭像。
12.2 社群功能總開關
Global Social Features Switch 控制全站的瀏覽、按讚與收藏：卡片上的計數、 單篇文章上的按鈕，以及作者資料頁上的 Liked 與 Favorited 標籤。
這些計數由 Aumframe 儲存與提供。開關開啟而 Aumframe 不存在時，佈景主題不渲染任何計數， 而不是渲染一排零，因為一個代表「沒有任何東西在計數」的零並不是一個計數。
13. 效能開關
Performance 標籤有八個開關，各自對應一項會消耗位元組或請求的 WordPress 行為。 八個預設全部關閉，每一個都說明它移除了什麼：
- Disable Emoji Scripts —— 移除 emoji 的 JavaScript 與 CSS，約 10 kB。 現代瀏覽器不需要它們也能渲染 emoji。
- Disable Embed Scripts —— 移除讓其他網站嵌入您網站的 oEmbed 主機指令碼。
- Limit Post Revisions —— 每篇文章最多保留五個修訂版本。
- Reduce Heartbeat Frequency —— 將後台 Heartbeat API 從每 15 秒放慢到每 60 秒。
- Lazy-Load Iframes —— 為 iframe 加上
loading="lazy"。 - Disable XML-RPC —— 封鎖 XML-RPC 端點。只有在您使用的所有工具都不透過 XML-RPC 連線時，才保持開啟。
- Defer Non-Critical JS —— 為不需要阻斷解析的指令碼加上
defer。 - Remove Version Query Strings —— 從本機 CSS 與 JS 網址中移除
?ver=， 使那些拒絕儲存帶查詢字串網址的快取願意儲存它們。
14. WooCommerce
WooCommerce 標籤只在 WooCommerce 啟用期間出現，包含七項設定：商店頁面的內容寬度、 桌機／平板／手機三種寬度下每列的商品數、每頁的商品數、載入方式（Pagination 或 Load More Button），以及商品頁上顯示的相關商品數量。
佈景主題同時宣告支援 WooCommerce 的商品圖庫縮放、燈箱與輪播，並在網站以深色模式渲染時 掛上 WooCommerce 自己的深色控制項樣式，使區塊結帳的輸入欄位跟隨調色盤。
15. 延伸佈景主題的外掛
這些外掛一個都沒安裝，佈景主題照常運作。每一個增加的是能力，而不是讓佈景主題得以運作， 而且佈景主題從不提及它們之中的任何一個。後台不存在任何提示、檢查清單或安裝器： 只啟用佈景主題的網站就是一個完成的網站，因此佈景主題沒有任何「缺少什麼」需要回報。
唯一真正帶有外掛需求的是範本套件，因為它的內容是用那些外掛做出來的。那些需求屬於套件本身， 由安裝它的套件管理器讀取，並由它說明網站還缺什麼。
- Aumframe —— 視覺設計：頁面版面、以 Site shell 繪製的網站頁首與頁尾， 以及與內容綁定的範本。瀏覽、按讚與收藏的計數，以及套件管理器讀取的範本套件格式， 也都歸它所有。
- AumViso —— 搜尋引擎中繼資料、結構化資料，以及 FAQ、指南與詞彙表三種內容類型。
- WooCommerce —— 商店。佈景主題的 WooCommerce 標籤，以及作者資料頁上的 Orders 與 Downloads 標籤，會隨它一起出現。
- AumNexCart —— 以詢價取代結帳的商品型錄。
- AumReserva —— 預約。
每一個都在執行階段偵測。佈景主題不對它們之中的任何一個宣告相依性， 移除其中一個會讓網站回到佈景主題自己渲染的樣子。
佈景主題確實會顯示一則訊息，而它不是一項建議。當 Aumframe 已安裝、但版本低於網站上 那些設計所需要的版本時，設定畫面會說明目前安裝的是哪一版、需要的是哪一版， 因為已經存在的設計會在更新之前停止渲染。
16. 設定對照表
佈景主題設定畫面上的每一個欄位，依標籤排列，並附上它寫入的選項鍵。 所有欄位都存放在同一個 WordPress 選項 aumcreate_settings 之中。
16.1 General Settings
| 欄位 | 鍵 | 值 |
|---|---|---|
| Front-end theme toggle | show_theme_toggle | 開或關 |
| Search Types | search_types | 除文章與頁面之外還要搜尋的內容類型 |
| Theme Mode | theme_mode | light、dark 或 system |
| Light Mode - Horizontal Logo (250x50) | logo_horizontal | 圖片 |
| Light Mode - Square Logo | logo_square | 圖片 |
| Dark Mode - Horizontal Logo | logo_horizontal_dark | 圖片 |
| Dark Mode - Square Logo | logo_square_dark | 圖片 |
| Default Post Thumbnail | default_post_thumbnail | 圖片 |
16.2 Color Settings
| 欄位 | 鍵 | 值 |
|---|---|---|
| Light Mode Colors | light_colors | 品牌色、次要色、頁面背景、卡片背景、框線、次要文字與捲軸 |
| Dark Mode Colors | dark_colors | 深色模式的同樣七個值 |
| Custom Global Colors | custom_colors | 具名色彩，每一個都有一個淺色值與一個深色值 |
16.3 Layout Settings
| 欄位 | 鍵 | 值 |
|---|---|---|
| Heading Font | font_display | 系統字型堆疊或 Google 字型 |
| Body Font | font_body | 系統字型堆疊或 Google 字型 |
| Mono Font | font_mono | 系統字型堆疊或 Google 字型 |
| Fallback Stack | font_fallback | sans、serif 或 mono |
| Custom Font CSS | font_custom_css | @font-face 或 @import 規則 |
| Content Width | container_width | CSS 長度 |
| Image Orientation | image_aspect_ratio | 4x3 或 3x4 |
| Back to Top Button | backtop_button | 開或關 |
| Social Sidebar | social_sidebar_enabled | 開或關 |
| Social Links | social_sidebar_links | 多個項目，每一項包含圖示、顏色，以及一個連結或彈出層 |
| Post Sidebar Modules | post_sidebar_modules | 已排序的模組清單，每一個可開可關 |
16.4 User Settings
| 欄位 | 鍵 | 值 |
|---|---|---|
| Anyone can register | users_can_register | 開或關；與 WordPress 的設定同步 |
| Global Social Features Switch | social_features | 開或關 |
| Default Avatar | default_avatar | 圖片 |
| Login Page Carousel | login_carousel_images | 圖片 |
16.5 Performance
| 欄位 | 鍵 |
|---|---|
| Disable Emoji Scripts | perf_disable_emoji |
| Disable Embed Scripts | perf_disable_embeds |
| Limit Post Revisions (max 5) | perf_limit_revisions |
| Reduce Heartbeat Frequency | perf_slow_heartbeat |
| Lazy-Load Iframes | perf_lazy_iframes |
| Disable XML-RPC | perf_disable_xmlrpc |
| Defer Non-Critical JS | perf_defer_scripts |
| Remove Version Query Strings | perf_remove_query_strings |
16.6 WooCommerce
| 欄位 | 鍵 | 值 |
|---|---|---|
| WooCommerce Content Width | woo_container_width | CSS 長度 |
| Products per row (Desktop) | woo_columns_desktop | 數字 |
| Products per row (Tablet) | woo_columns_tablet | 數字 |
| Products per row (Mobile) | woo_columns_mobile | 數字 |
| Products per page | woo_per_page | 數字 |
| Loading mode | woo_load_mode | pagination 或 loadmore |
| Related products count | woo_related_count | 數字 |
17. 疑難排解
網站沒有頁首。 在 Appearance → Menus 底下指派一個選單到 Primary Menu 位置， 並在 General Settings 底下上傳一個橫式標誌。兩者皆無時，頁首只渲染網站標題。
某個頁面完全不像佈景主題的範本。 有一份 Aumframe 設計符合該網址，並已取代範本輸出。 由該設計的規則決定它接管哪些網址。
卡片上沒有瀏覽、按讚或收藏的計數。 這些計數來自 Aumframe。該外掛不存在時， 佈景主題不渲染計數，而不是渲染零。
已翻譯的網站上，日期與計數顯示為英文。 佈景主題只隨附一種翻譯：簡體中文。 WordPress 不會從一個地區設定回退到另一個，因此設定為其他任何地區的網站， 佈景主題自己的字串會以英文呈現。
在 Typography 中選的字型始終沒有出現。 Google 字型的請求可能因訪客所在位置而緩慢 或被阻擋。Fallback Stack 決定這段期間呈現什麼，而 Custom Font CSS 接受 指向託管在其他位置之字型的規則。