WordPress 主題建置 是做什麼的?
目標是建立一個設計鎖定在程式碼、內容可在編輯器中編輯的主題。樣板中的硬編碼文字是客戶回頭要求修改最常見的原因。
選擇方法
| 方法 | 何時選擇 |
|---|---|
區塊主題(theme.json、HTML 樣板) | 全新建置,客戶在網站編輯器中編輯,內容多為標準區塊 |
混合經典主題(PHP 樣板加上 theme.json 和區塊模式) | 需要精確 HTML 控制的複雜自訂標記或大量動畫 |
| 子主題 | 修改現有主題;切勿直接編輯父主題,因為更新會覆蓋它 |
對於以動畫、設計為主的行銷網站,混合方法通常是務實的選擇:在 PHP 中保留精確標記,透過模式、欄位和區塊編輯器提供可編輯內容。
最小結構
my-theme/
├── style.css # 主題標頭註解(必要)
├── functions.php # 設定、入隊、註冊
├── theme.json # 色板、字型比例、間距、佈局寬度
├── index.php # 備用樣板(經典/混合)
├── front-page.php # 首頁
├── header.php footer.php
├── template-parts/ # 每個區段一個檔案
├── patterns/ # 區塊模式(自動註冊)
├── assets/css assets/js assets/media
└── screenshot.png # 1200x900
style.css 標頭:
/*
Theme Name: My Theme
Author: Your Name
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: my-theme
*/
轉換工作流程
- 凍結靜態建置。 先完成 HTML、CSS 和 JS 並進行驗證。轉換移動中的目標會讓工作量加倍。
- 拆解成零件。 頁首和頁尾分別移至
header.php和footer.php,並加入wp_head()和wp_footer()。每個首頁區段變成template-parts/中的一個檔案,使用get_template_part()載入。 - 將 token 移入
theme.json(色板、字型大小、間距、內容寬度),讓編輯器顯示與前端相同的選項。保持與 CSS 自訂屬性相同的值;WordPress 會產生--wp--preset--*變數,您可以建立別名。如果webcraftCLI 可用,webcraft tokens "#brand" --format theme-json -o theme.json會從與tokens.css相同的值寫入版本 3 的檔案。 - 使用入隊,切勿硬編碼資產:
add_action('wp_enqueue_scripts', function () {
$v = wp_get_theme()->get('Version');
$uri = get_theme_file_uri('assets');
wp_enqueue_style('my-theme', "$uri/css/main.css", [], $v);
wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
wp_enqueue_script('my-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});
盡可能將函式庫打包到本地,而不是從 CDN 載入;這樣可以避免第三方請求與同意問題。 5. 讓內容可編輯。 每個區段選擇適當方式:
- 具有獨立頁面的重複項目(服務、作品集、推薦):使用自訂文章類型,並透過
WP_Query查詢。 - 一次性區段文字與圖片:使用客戶可插入並編輯的區塊模式,或自訂欄位。
- 全域項目(電話、社群連結、頁尾文字):使用自訂器或小型選項頁面。
- 導覽:
register_nav_menus()和wp_nav_menu()。
- 輸出時全部跳脫:
esc_html()、esc_attr()、esc_url()、wp_kses_post()(用於豐富文字)。使用__()或esc_html__()並帶上文字網域來包裹字串。 - 圖片: 使用
wp_get_attachment_image()以自動產生srcset、sizes、尺寸和延遲載入。使用add_image_size()註冊所需的圖片尺寸。 - 主題支援:
title-tag、post-thumbnails、editor-styles、responsive-embeds、html5、wp-block-styles。
WordPress 中的動畫
- 隱藏內容的指令碼不得在區塊編輯器中執行。僅在前端進行入隊(
wp_enqueue_scripts,非enqueue_block_assets)。 - 管理列會將固定頁首下推 32px(行動裝置 46px);請使用
body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }修正偏移。 - 會延遲或合併 JS 的快取與最佳化外掛可能破壞載入順序。請正確宣告相依性,並在啟用該外掛的情況下測試。
- 在編輯器中新增的內容不會有您的動畫屬性。請透過在 JS 中按區塊類別套用動畫,或提供包含這些屬性的模式。
切勿
- 編輯 WordPress 核心或父主題。
- 將會因主題切換而失效的功能(自訂文章類型、短代碼)放在主題中;當客戶可能更換主題時,小型外掛才是正確的位置。
- 未重置(
wp_reset_postdata())就在迴圈內進行查詢。 - 在
WP_DEBUG有通知的情況下出貨。請在開發時啟用WP_DEBUG。 - 捆綁付費外掛或授權不允許散佈的資產。
交機檢查清單
- 客戶可以在不碰觸程式碼的情況下更改所有可見的文字、圖片、選單項目和聯絡資訊。
- 在設定、閱讀中設定首頁;永久連結設為文章名稱。
- 網站圖示、404 樣板、搜尋樣板、隱私權頁面均已存在。
- 提供附有螢幕截圖的一頁編輯指南。
- 然後執行
launch-qa技能。