WordPress主題開發基礎與架構
構建一個專業嘅WordPress主題，首先要了解佢嘅基礎結構同核心檔案。一個標準主題嘅根目錄下至少包含兩個檔案：style.css同埋index.php。其中，style.css唔單止係樣式表，更加係主題嘅「身份證」，佢頂部嘅註釋區塊包含咗主題名稱、作者、描述、版本等關鍵元數據，呢啲資訊會喺WordPress後台嘅主題列表中顯示。
主題核心檔案詳解
style.css文件頂頭嘅註釋係必需嘅。一個基本嘅註釋區塊示例如下：
/*
Theme Name: My SEO Theme
Theme URI: https://example.com/my-seo-theme
Author: Your Name
Author URI: https://example.com
Description: 一个为速度和搜索引擎优化而生的现代WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-seo-theme
*/Text Domain用於國際化，務必同主題文件夾名稱保持一致。除咗核心文件，一個結構良好嘅主題仲應該包含模板文件，例如header.php、footer.php、sidebar.php以及用喺唔同頁面類型嘅模板，例如single.php（文章頁）、page.php（頁面）同埋archive.php（歸檔頁）。使用get_template_part()函數可以模組化地調用呢啲模板片段，提高代碼重用性。
推薦閱讀 WordPress主題開發從入門到精通：打造個人化網站嘅核心指南。
functions.php文件嘅作用
functions.php係主題嘅功能中樞。佢唔係一個插件，而係主題不可或缺嘅一部分，用嚟添加功能、註冊菜單、小工具區域以及整合WordPress核心功能。所有自訂嘅PHP代碼都應該喺呢個檔案入面或者透過佢引入嘅其他檔案入面編寫。例如，透過add_theme_support()函數可以為主題啟用文章縮略圖、自訂Logo、HTML5標記支援等特性，呢啲係構建現代網站嘅基礎。
實現語義化HTML5結構同核心模板
語義化HTML5結構唔單止對輔助技術友好，更加係搜尋引擎理解頁面內容嘅基礎。WordPress提供咗一系列模板標籤來生成語義化標記。
構建標準嘅header同footer
在header.php當中，應該用<header>、<nav>等語義化標籤。關鍵步驟包括使用wp_head()函數，佢容許WordPress核心、插件同主題喺頁面部分插入必要嘅代碼（例如CSS、JS同元標籤），必須確保佢喺</head>標籤之前被調用。
在footer.php中，同樣需要使用wp_footer()函數，佢通常喺</body>標籤之前，用嚟載入頁尾腳本同代碼。
主循環同內容輸出
WordPress嘅內容輸出依賴於「主循環」。喺index.php、single.php喺模板文件入面，用典型嘅循環結構嚟輸出文章：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1003>
<header class="entry-header">
<h1 class="entry-title"><?php the_title(); ?></h1>
</header>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; endif; ?>post_class()個函數會自動為文章容器輸出一系列CSS類，好似文章類型、分類咁，好方便樣式設計。the_content()個函數用嚟輸出文章嘅主要內容。對於列表頁面（好似首頁、分類頁），應該用the_excerpt()嚟輸出摘要，同埋配合<!--more-->標籤或自訂摘要長度，以提升列表頁嘅加載速度同用戶體驗。
推薦閱讀 深入理解SEO優化：從基礎到進階嘅完整策略指南。
深度整合SEO最佳實踐
一個優秀嘅主題應該喺代碼層面為SEO打下堅實基礎，而唔係單單依賴插件。
優化標題標籤同元描述
雖然好多SEO插件會處理標題同元描述，但喺主題層面可以設定智能嘅預設值。例如，喺header.php中間，可以最佳化標題嘅輸出邏輯，確保網站有副標題嗰陣能夠正確顯示。同時，可以為主題加入基本嘅元描述模板，對於冇自訂元描述嘅文章，自動用文章摘要或者前160個字元做描述。
使用add_theme_support( 'title-tag' )呢個係WordPress官方推薦嘅方法，佢容許WordPress核心智能噉管理頁面標題，開發者應該避免喺主題度硬編碼標題。
結構化數據同Schema標記
為內容加入Schema.org結構化數據可以幫搜尋引擎更加好噉理解頁面內容，有可能獲得更加豐富嘅搜尋結果展示。可以喺主題嘅模板檔案度，為目標內容（例如文章、組織資訊）嵌入JSON-LD格式嘅結構化數據。例如，喺single.php嘅文章循環入面，可以輸出關於「文章」嘅Schema標記，包含標題、發佈時間、修改時間、作者同摘要等資訊。WordPress函數如get_the_date('c')可以輸出ISO 8601格式嘅時間，呢個係結構化數據要求嘅格式。
優化連結同圖片屬性
確保所有連結嘅標籤包含清晰嘅錨文本。對於圖片，必須永遠為
標籤添加alt屬性。WordPress嘅the_post_thumbnail()函數容許你直接輸出帶有正確alt文字嘅圖片，默認會用文章標題做替代文字。至於內嵌喺文章內容入面嘅圖片，應該引導用戶去媒體庫度填寫替代文字。
另外，為網站圖示（Favicon）同埋流動裝置圖示提供支援，可以透過add_theme_support( 'custom-logo' )同WordPress自訂器上傳，並且使用wp_head()自動輸出相關連結。
提升主題效能同可訪問性
速度同可訪問性係現代網站嘅核心指標，直接影響用戶體驗同搜尋排名。
推薦閱讀 建立成功嘅網上業務：由零開始到精通嘅網站建設終極指南。
腳本同樣件嘅優化管理
正確註冊同排隊加載腳本、樣式係性能優化嘅關鍵。千祈唔好喺模板檔案直接使用或標籤引入資源，而應該用wp_enqueue_script()同埋wp_enqueue_style()函數。咁樣可以畀WordPress管理依賴關係、避免重複加載，同方便插件進行優化。
在functions.php入面註冊腳本嗰陣，應該將第三方庫（例如jQuery）設定為依賴項，同埋將腳本指定喺頁尾加載（透過將最後一個參數設定為true），防止渲染阻塞。至於樣式，可以指定媒體類型，例如為打印樣式用‘print’。
實現響應式設計同移動優先
現代主題一定要係響應式嘅。喺style.css喺度用媒體查詢（Media Queries）嚟適應唔同嘅屏幕尺寸。建議採用「移動優先」嘅策略，即係先寫移動端嘅基礎樣式，然後用min-width媒體查詢逐步增強更大屏幕嘅樣式。確保視口元標籤設定正確：<meta name="viewport" content="width=device-width, initial-scale=1">，呢個標籤通常由add_theme_support( 'responsive-embeds' )同標籤支援功能自動加落去。
關注Web無障礙標準
無障礙（A11y）令網站能夠被所有用戶（包括殘障人士）訪問。主題應該跟從WCAG指引。呢個包括：確保有足夠嘅顏色對比度；為所有互動元素（例如表單控件）提供清晰嘅焦點樣式；使用ARIA屬性增強語義，例如為導航選單加入role="navigation"同埋aria-label；確保可以只靠鍵盤完成所有操作。WordPress本身喺輸出啲模板標籤時已經考慮咗無障礙，好似the_posts_pagination()函數會生成帶有ARIA標籤嘅分頁連結。
摘要
從頭構建一個SEO友好嘅WordPress主題係一個系統性工程，佢遠遠唔止於視覺設計。佢要求開發者深入理解WordPress嘅核心架構，包括模板層次結構、主循環同掛鉤函數。喺代碼層面，必須堅持語義化HTML5、遵循性能最佳實踐（例如優化資源加載），並深度集成SEO基礎，例如智能標題、結構化數據同內容優化。同時，響應式設計同可訪問性唔再係可選項，而係構建專業、包容嘅現代網站嘅必備要素。通過將呢啲原則內化到主題開發嘅每一個環節，你所創造嘅主題唔單止能提供出色嘅用戶體驗，亦會喺搜索引擎中佔據有利地位，為網站嘅長遠成功奠定堅實嘅技術基礎。
常見問題
唔使用SEO插件，單靠主題能做好SEO嗎？
雖然一個編碼良好嘅主題可以為SEO提供優秀嘅基礎框架（例如速度、語義化標記、結構化數據），但完全替代功能全面嘅SEO插件（例如Yoast SEO或Rank Math）係困難嘅。呢啲插件提供咗更精細嘅頁面級SEO控制，例如每個頁面獨立嘅標題、元描述、規範連結、社交元標籤以及內容分析工具。最佳實踐係開發一個SEO友好嘅主題作為基礎，然後同一款優秀嘅SEO插件配合使用，以達到最佳效果。
如何讓我嘅WordPress主題通過官方審核並上架？
要將主題上架到WordPress.org官方主題目錄，必須嚴格遵守其主題審核要求。呢啲包括：代碼必須遵循WordPress編碼標準同PHP最佳實踐；確保冇硬編碼嘅連結或推廣內容；完全支援無障礙標準；正確實現所有WordPress核心功能（例如小工具、選單、自訂商標）；提供完整嘅翻譯支援；而且主題選項必須使用WordPress自訂器（Customizer）進行設定，而唔係自己創建選項面板。審核過程非常嚴格，旨在保證主題嘅安全性、質素同一致性。
開發商業主題需要特別注意邊啲法律問題？
開發商業主題需要特別注意許可證合規性。由於WordPress核心代碼遵循GPL v2或更高版本許可證，基於佢開發嘅主題亦必須繼承GPL許可證。呢個意味住你出售嘅主題代碼本身必須係GPL兼容嘅，你可以對主題嘅視覺設計、CSS、圖片等資產設定自己嘅許可證，但PHP代碼部分必須係GPL。此外，主題中使用嘅任何第三方資源（例如圖示字型、JavaScript函式庫）都必須確保其許可證允許喺商業產品中分發同使用。
主題嘅functions.php檔案應該包含邊啲安全措施？
在functions.php首先，最重要嘅安全措施係對所有用戶輸入嘅數據進行轉義、驗證同清理之後先輸出。使用WordPress提供嘅函數，例如esc_html()、esc_url()同埋sanitize_text_field()嚟處理同輸出數據。其次，直接同數據庫交互嗰陣（應該盡量避免），必須使用$wpdb類並準備SQL語句以防止SQL注入。另外，應該為自定義嘅管理界面或者AJAX端點加入權限檢查（capability check）同非驗證，例如使用current_user_can()同埋check_ajax_referer()函數。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。