WordPress使用多個模板文件來顯示Post post類型。 處理博客或其帖子的任何內容都屬于Post Post類型。
## Index.php
如果沒有其他模板文件,index.php將顯示Post post類型。 如許多地方所述,每個主題都必須有一個index.php文件才能生效。 許多基本的主題可以通過使用index.php來顯示他們的Post post類型,但上面給出的用例可以證明創建其他模板文件。
通常,您將需要獨特的內容結構或布局,具體取決于顯示的內容。 您可以使用許多模板來根據站點內的上下文自定義內容結構。 兩個最引人注目的帖子模板文件是home.php和single.php,分別顯示帖子和單個帖子。
## Home.php
當使用靜態首頁并且站點具有為博客列表定義的頁面時,home.php文件用于指定的博客列表頁面。 鼓勵使用此模板創建自定義頁面模板,因為自定義頁面模板上的博客分頁將無法正常工作。 如果在主題index.php中沒有home.php將被替代使用。
## Single.php
在您的模板結構中盡可能簡單地構建是不錯的選擇,除非您真正需要它們,否則不要制作更多模板。 因此,大多數主題開發人員不會創建一個single-post.php文件,因為single.php足夠具體。 在大多數情況下,所有主題都應該有一個single.php。 下面是一個來自主題Twenty Fifteen的single.php文件的例子。
```
<?php
/**
* The template for displaying all single posts and attachments
*
* @package WordPress
* @subpackage Twenty_Fifteen
* @since Twenty Fifteen 1.0
*/
get_header(); ?>
<div id="primary" class="content-area">
<main id="main" class="site-main" role="main">
<?php
// Start the loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
// If comments are open or we have at least one comment, load up the comment template.
if ( comments_open() || get_comments_number() ) :
comments_template();
endif;
// Previous/next post navigation.
the_post_navigation( array(
'next_text' => '<span class="meta-nav" aria-hidden="true">' . __( 'Next', 'twentyfifteen' ) . '</span> ' .
'<span class="screen-reader-text">' . __( 'Next post:', 'twentyfifteen' ) . '</span> ' .
'<span class="post-title">%title</span>',
'prev_text' => '<span class="meta-nav" aria-hidden="true">' . __( 'Previous', 'twentyfifteen' ) . '</span> ' .
'<span class="screen-reader-text">' . __( 'Previous post:', 'twentyfifteen' ) . '</span> ' .
'<span class="post-title">%title</span>',
) );
// End the loop.
endwhile;
?>
</main><!-- .site-main -->
</div><!-- .content-area -->
<?php get_footer(); ?>
```
在上面的代碼示例中,您可以看到標題被拉入與get_header()然后有兩個html標簽。 接下來循環開始,模板標簽get_template_part('content',get_post_format()); 通過使用get_post_format()確定帖子類型來拉取適當的內容。 接下來,使用模板標簽comments_template()引入注釋。 然后有一些分頁。 最后,內容div被關閉,然后用get_footer()拉入頁腳。
## Singular.php
WordPress版本4.3添加了singular.php,在層次結構中,single.php為帖子,page.php為頁面,以及各自的變體。 此模板遵循is_singular()的規則,并且用于單個帖子,而不管后置類型。 對于這兩個文件使用相同代碼的主題(或另一個包含一個)現在可以簡化為一個模板。
## Archive.php
除非開發人員在其模板中包含帶有永久鏈接的元數據,否則archive.php將不會被使用。元數據是與帖子相關的信息。例如,發布的日期,作者以及用于帖子的任何類別,標簽或分類法都是元數據的示例。當網站的訪問者點擊元數據時,archive.php將渲染與該元數據相關聯的任何帖子。例如,如果訪問者點擊作者的名稱,則archive.php將顯示該作者的所有帖子。
通常,archive.php顯示的頁面的標題將是用戶點擊的元數據的名稱。因此,如果用戶點擊作者的名字,顯示所有其他作者的帖子的頁面名稱將是作者的名稱,并且經常可能會有關于元數據的其他說明。這是一個代碼示例,來自Twenty Fifteen,他們的achive.php文件。這個代碼片段是使archive.php文件與home.php或index.php文件不同的唯一代碼片段。
```
<header class="page-header">
<?php
the_archive_title( '
<h1 class="page-title">', '</h1>
' );
the_archive_description( '
<div class="taxonomy-description">', '</div>
' );
?>
</header>
<!-- .page-header -->
```
## Author.php 和 Date.php
Author.php和date.php是更具體的存檔類型文件。 如果您需要一個復習,請查看他們在模板范圍內適合的位置。 通常,archive.php將滿足大多數主題的需求,您不需要創建這些模板。
## Author.php
如果你正在為多個作者設計一個主題,那么構建一個author.php模板可能是有意義的。 在author.php模板中,您可以提供有關作者,他們的圖形,拉入他們的社交媒體網站以及他們寫的所有帖子的更多信息。 這將是依賴于archive.php文件的一個步驟。
此外,您可以使用其作者ID或nicename為個別作者構建特定的author.php文件。 例如,說John Doe是有許多客座作者的網站的頭號作者。 您可能希望所有訪客作者的信息與author.php一起顯示,但如果作者ID為3,則可以通過創建author-johndoe.php或author-3.php來構建具有John Doe更多信息的特定作者頁面。
## Date.php
同樣,如果您正在構建一個專門針對雜志或新聞網站的主題,那么date.php文件可能會有所修改,因為這些網站經常按日期或問題組織文章和帖子。 另外,如果你找到了足夠的理由,你可以建立一個day.php,month.php或者year.php。
## Category.php, Tag.php 和 Taxonomy.php
如果您需要重新分析哪些類別,標簽和分類法,您可以查看他們的頁面。 通常,您不需要構建這些模板文件。 然而,在為食品博客撰寫主題的例子中,有一些用例來構建這些特定的模板。 在食品博客網站上,類別可能是美食,美食,民族美食和食譜。
您可能希望大部分的博文都以相同的方式顯示,除了任何分類為食譜的博客,因為所有食譜都有成分和分析部分。 因此,您可能需要構建一個category-recipe.php文件,以在網格視圖中顯示您的食譜博客文章,其中包含有關配方可見的一些重要詳細信息。
此外,也許巧克力是您正在建立的主題的一個非常重要的標簽。 構建tag-chocolate.php文件可能是有意義的,以便您可以顯示巧克力的專門橫幅圖像。
## Search.php
大多數主題都有一個search.php文件,所以用戶清楚他們的查詢是通過的。 通常有一些標題查詢結果的標題,例如這個二十五分之二的主題的代碼段。
```
<header class="page-header">
<h1 class="page-title"><?php printf( __( 'Search Results for: %s', 'twentyfifteen' ), get_search_query() ); ?></h1>
</header>
<!-- .page-header -->
```
此代碼段將拉入使用get_search_query()搜索的查詢。 通常,search.php只會提取摘錄而不是完整內容,因為用戶嘗試確定文章或頁面是否適合其搜索。
- 簡介
- 主題開發
- WordPress許可證
- 什么是主題
- 開發環境
- 主題開發示例
- 主題基礎
- 模板文件
- 主樣式表(style.css)
- 文章類型
- 規劃主題文件
- 模板層級
- 模板標簽
- 循環
- 主題函數
- 連接主題文件和目錄
- 使用CSS和JavaScript
- 條件標簽
- 類別,標簽和自定義分類
- 模板文件
- 內容模板文件
- 頁面模板文件
- 附件模板文件
- 自定義內容類型
- 部分和其他模板文件
- 評論模板
- 分類模板
- 404頁面
- 主題功能
- 核心支持的功能
- 管理菜單
- 自定義Headers
- 自定義Logo
- 文章格式
- 置頂文章
- Sidebars
- Widgets
- 導航菜單
- 分頁
- 媒體
- Audio
- Images
- Galleries
- Video
- 精選圖片和縮略圖
- 國際化
- 本地化
- 輔助功能
- 主題選項 – 自定義API
- 定制對象
- 改進用戶體驗的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定義控件
- 高級用法
- 主題安全
- 數據消毒/逃避
- 數據驗證
- 使用隨機數
- 常見漏洞
- 高級主題
- 子主題
- UI最佳實踐
- JavaScript最佳做法
- 主題單元測試
- 驗證你的主題
- Plugin API Hooks
- 發布你的主題
- 所需的主題文件
- 測試
- 主題評論指南
- 寫文檔
- 提交你的主題到WordPress.org
- 參考文獻
- 模板標簽列表
- 條件標簽列表
- 編碼標準
- HTML編碼標準
- CSS編碼標準
- JavaScript編碼標準
- PHP編碼標準
- 插件開發
- 插件開發簡介
- 什么是插件
- 插件基礎
- 頭部要求
- 包括軟件許可證
- 啟用 / 停用 Hooks
- 卸載方法
- 最佳做法
- 插件安全
- 檢查用戶功能
- 數據驗證
- 保護輸入
- 保護輸出
- 隨機數
- Hooks
- Actions
- Filters
- 自定義Hooks
- 高級主題
- 管理菜單
- 頂級菜單
- 子菜單
- 短代碼
- 基本短碼
- 封閉短碼
- 帶參數的短代碼
- TinyMCE增強型短碼
- 設置
- 設置API
- 使用設置API
- 選項API
- 自定義設置頁面
- 元數據
- 管理帖子元數據
- 自定義元數據
- 渲染元數據
- 自定義文章類型
- 注冊自定義文章類型
- 使用自定義文章類型
- 分類
- 使用自定義分類
- 在WP 4.2+中使用“split術語”
- 用戶
- 創建和管理用戶
- 使用用戶元數據
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服務器端PHP和入隊
- Heartbeat API
- 概要
- 計劃任務
- 了解WP-Cron計劃
- 安排WP-Cron 事件
- 將WP-Cron掛接到系統任務計劃程序中
- WP-Cron簡單測試
- 國際化
- 本地化
- 如何國際化您的插件
- 國際化安全
- WordPress.org
- 詳細插件指南
- 規劃您的插件
- 如何使用Subversion
- 插件開發者常見問題
- 開發工具
- Debug Bar 和附加組件
- 輔助插件
- REST API手冊
- 資源
- 文章
- 文章修訂
- 文章類型
- 文章狀態
- 類別
- 標簽
- 頁面
- 評論
- 分類
- 媒體
- 用戶
- 設置
- 使用REST API
- 全局參數
- 分頁
- 鏈接和嵌入
- 發現
- 認證
- 經常問的問題
- 骨干JavaScript客戶端
- 客戶端庫
- 擴展REST API
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類