目錄
基本用法
使用場景和好處
文件存放位置和命名規則
小細節要注意
首頁 CMS教程 &#&按 如何使用get_template_part

如何使用get_template_part

Jul 29, 2025 am 12:12 AM

get_template_part 是WordPress 主題開發中用於復用代碼塊的實用函數,通過加載指定模板文件減少重複代碼並提升可維護性。其基本用法為get_template_part( $slug, $name ),其中$slug 為必填參數表示基礎模板名,$name 為可選變體名,例如get_template_part( 'content' ) 加載content.php,而get_template_part( 'content', 'single' ) 優先加載content-single.php,若不存在則回退至content.php;常見使用場景包括文章列表、頁腳、導航條等公共部分的統一管理,支持子主題覆蓋,且可通過不同$name 參數實現樣式差異控制;模板文件通常放在主題根目錄或子目錄如/templates/ 中,路徑需相對於當前主題目錄;調試時需檢查文件是否存在、拼寫是否正確、緩存影響及子主題啟用情況,建議在模板中添加註釋以便排查加載問題。

get_template_part這個函數,其實就是在WordPress 主題開發中復用代碼塊的一個方法。它不是最複雜的功能,但確實挺實用的,特別是在組織主題結構、減少重複代碼方面。

基本用法

get_template_part的作用是加載指定路徑下的模板文件。它的基本寫法是:

 get_template_part( $slug, $name );
  • $slug是必填項,表示你要加載的模板文件的基礎名。
  • $name是可選參數,用於指定該基礎名下的某個變體。

比如你有文件叫content.php ,那直接寫:

 get_template_part( 'content' );

如果你還有個content-single.php ,可以這樣調用:

 get_template_part( 'content', 'single' );

WordPress 會先嘗試加載content-single.php ,如果找不到,就回退到content.php

使用場景和好處

這個函數最常見的用途就是把文章列表、頁腳、導航條等公共部分抽出來,統一管理。比如在首頁循環展示文章時,你可以把每篇文章的顯示結構放到content.php裡,然後在index.phparchive.php中循環調用。

好處有幾個:

  • 減少重複代碼
  • 提高可維護性
  • 方便子主題覆蓋

舉個例子:你在多個地方都要顯示文章摘要,但某一個頁面需要稍微改一點樣式。這時候就可以保留content.php作為通用模板,然後為那個特定頁面創建content-special.php ,通過傳入不同的$name參數來控制加載哪一個。

文件存放位置和命名規則

模板文件通常放在主題根目錄下,也可以放在子目錄中,比如/templates/ 。調用的時候要帶上路徑:

 get_template_part( 'templates/content', 'single' );

這會去加載templates/content-single.php

注意幾點:

  • 文件名不要帶.php後綴
  • 路徑是相對於當前主題目錄的(不是父主題)
  • 如果你做的是子主題,確保你要覆蓋的模板文件也正確命名並放在對應位置

小細節要注意

有時候你會發現明明寫了正確的參數,但文件沒加載進去。這時候檢查幾個點:

  • 文件是否存在?拼寫對不對?
  • 是否被緩存插件或服務器緩存影響了?
  • 子主題是否啟用了?有沒有把原模板文件複製過來?

還有一個小技巧是,在調試階段可以給每個模板加個小註釋,比如:

 <!-- Loaded content-single.php -->

這樣在頁面源碼裡一眼就能看出加載的是哪個文件,方便排查問題。

基本上就這些。用起來不難,但理解清楚機制之後,開發效率能提升不少。

以上是如何使用get_template_part的詳細內容。更多資訊請關注PHP中文網其他相關文章!

本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn

熱AI工具

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

熱門話題

PHP教程
1543
276
如何安全處理外部API調用 如何安全處理外部API調用 Jul 24, 2025 am 12:07 AM

要安全調用外部API,需從訪問控制、數據保護和響應驗證三方面入手。 ①使用APIKey、OAuthToken或JWT等認證機制,並將密鑰存儲在環境變量或密鑰管理服務中,定期輪換;避免前端暴露密鑰,選擇OAuth2.0並採用合適授權模式。 ②對接口返回的數據進行結構和內容校驗,確認Content-Type、字段類型,檢查狀態碼,過濾XSS內容,設置合理超時時間。 ③通過令牌桶或漏桶算法實現限流,記錄用戶API使用情況,結合緩存減少重複請求,防止觸發對方限流或被封禁IP。

如何將插件選項存儲在WordPress中 如何將插件選項存儲在WordPress中 Jul 27, 2025 am 12:29 AM

在WordPress插件開發中,正確存儲插件選項的推薦方法是使用register_setting()結合get_option()和update_option()。首先,通過register_setting('section','option_name')註冊設置項;其次,在表單提交時使用update_option('option_name',$value)保存數據;再次,頁面加載時用get_option('option_name','default_value')獲取值;此外,建議將多個字段合併

如何將類別從循環中排除 如何將類別從循環中排除 Aug 07, 2025 am 08:45 AM

在WordPress中排除特定分類的方法有三種:使用query_posts()、利用pre_get_posts鉤子或借助插件。首先,使用query_posts()可在模板文件中直接修改主循環查詢,如query_posts(array('category__not_in'=>array(3,5))),適合臨時調整但可能影響分頁;其次,通過pre_get_posts鉤子在functions.php中添加函數更安全,如判斷首頁主循環時排除指定分類ID,不影響其他頁面邏輯;最後,可選用WPCate

如何使用Gutenberg的RichText組件 如何使用Gutenberg的RichText組件 Jul 22, 2025 am 12:40 AM

Gutenberg的RichText組件是創建可編輯文本區域的核心工具,適合標題、段落等內容的編輯。 1.基本用法是引入RichText並傳入value和onChange屬性實現內容保存;2.通過formattingControls開啟富文本格式如加粗、斜體、鏈接;3.多個文本區域可通過分別綁定不同屬性字段管理;4.注意事項包括明確tagName、加載CSS、避免嵌套及使用placeholder提升體驗。掌握這些要點有助於高效開發自定義區塊。

如何將WPDB類用於自定義查詢 如何將WPDB類用於自定義查詢 Jul 27, 2025 am 12:31 AM

要安全高效地在WordPress中運行自定義數據庫查詢,應使用內置的wpdb類。 1.使用全局變量$wpdb並理解其基本屬性如$wpdb->prefix;2.運行SELECT查詢時使用$wpdb->prepare()方法防止SQL注入,根據結果數量選擇get_results、get_row或get_var;3.插入、更新和刪除數據時使用insert()、update()和delete()方法,並確保格式正確;4.調試時檢查last_error和last_query以處理錯誤;5.注意性

如何手動清除WordPress緩存 如何手動清除WordPress緩存 Aug 03, 2025 am 01:01 AM

清除WordPress緩存需先確認緩存方式再操作。 1.使用緩存插件時,登錄後台找到插件提供的“清除緩存”按鈕(如“DeleteCache”或“PurgeAll”)點擊確認清除,部分插件支持按頁面單獨清除;2.無插件情況下,通過FTP或文件管理器進入wp-content下的cache目錄刪除緩存文件,注意路徑可能因主機環境不同而有所變化;3.控制瀏覽器緩存時,按Ctrl F5(Windows)或Cmd Shift R(Mac)強制刷新頁面,或清除瀏覽器歷史記錄和緩存數據,也可使用隱身模式查看最新內

如何更改WordPress登錄URL 如何更改WordPress登錄URL Jul 23, 2025 am 12:07 AM

修改WordPress登錄URL可提升網站安全性。 1.默認登錄地址如/wp-login.php易受自動化攻擊,更改後可減少風險;2.手動方法涉及重命名wp-login.php並創建重定向文件,但更新時可能被覆蓋;3.推薦使用WPSHideLogin、iThemesSecurity等插件更安全便捷;4.修改後需記錄新地址、清除緩存、檢查安全插件設置並測試登錄功能。此措施應與其他安全手段配合使用以達到最佳效果。

如何使用get_template_part 如何使用get_template_part Jul 29, 2025 am 12:12 AM

get_template_part是WordPress主題開發中用於復用代碼塊的實用函數,通過加載指定模板文件減少重複代碼並提升可維護性。其基本用法為get_template_part($slug,$name),其中$slug為必填參數表示基礎模板名,$name為可選變體名,例如get_template_part('content')加載content.php,而get_template_part('content','single')優先加載content-single.php,若不存在則回退

See all articles