主題使用文章格式以特定格式和風格展示帖子。郵政格式功能提供了可用于支持該功能的所有主題的標準格式列表。主題可能不支持列表中的每種格式;在這種情況下,使用戶知道這是很好的形式。
主題不能引入不在標準化列表中的格式,即使是通過插件。這種標準化確保主題之間的兼容性和外部工具以一致的方式使用該功能的方式。
簡而言之,通過支持郵政格式的主題,博客可以通過選擇郵政格式來更改郵局的外觀。
使用Asides作為示例,過去已創建一個名為Asides的類別,并將帖子分配給該類別,然后根據post_class()或in_category('asides')中的樣式規則顯示不同的內容。
使用Post格式,新方法允許主題添加對Post格式的支持(例如,add_theme_support('post-formats',array('aside'))),然后可以在Publish meta框中選擇Post格式保存帖子。可以使用get_post_format($ post-> ID)的函數調用來確定格式,并且post_class() 也將為pure-css樣式創建“format-asides”類。
## 支持的格式
如果主題支持,則可以使用以下Post格式。
>[warning] 請注意,雖然實際的帖子內容不會更改,但主題可以根據所選格式顯示不同的帖子。 顯示職位的方式完全取決于主題,但以下是對不同Post格式的典型用法的一般指導。
- aside – 通常風格沒有標題。 類似于Facebook筆記更新。
- gallery – 圖像庫。 帖子可能包含一個圖庫的短碼,并將附有圖像附件。
- link – 指向另一個網站的鏈接。 主題可能希望在帖子內容中使用第一個`<a href="">`標簽作為該帖子的外部鏈接。 一個替代方法可能是,如果帖子只包含一個URL,那么這將是URL,標題(post_title)將是附加到錨點的名稱。
- image – 單一圖像。 帖子中的第一個`<img />`標簽可以被認為是圖像。 或者,如果帖子只包含一個URL,那將是圖像URL,并且該帖子的標題(post_title)將是該圖像的標題屬性。
- quote – 引用。 可能會包含一個包含報價內容的blockquote。 或者,引用可能只是內容,源/作者是標題。
- status – 一個簡短的狀態更新,類似于Twitter狀態更新。
- video – 一個視頻。 第一個`<video />`標簽或對象/嵌入到帖子內容可以被視為視頻。 或者,如果帖子只包含一個URL,那將是視頻URL。 如果在博客上啟用視頻支持(如通過插件),也可以將該視頻作為帖子的附件。
- audio – 一個音頻文件。 可用于播客。
- chat – 聊天記錄如下:
```
John: foo
Mary: bar
John: foo 2
```
>[warning] 注意:寫入或編輯帖子時,“標準”表示沒有指定后期格式。 另外如果指定了無效的格式,默認情況下會應用“標準”(無格式)。
# 功能參考
## 主要功能
- set_post_format()
- get_post_format()
- has_post_format()
## 其他功能
- get_post_format_link()
- get_post_format_string()
## 添加主題支持
主題需要在functions.php文件中使用add_theme_support()來通過傳遞如下格式的數組來告訴WordPress支持的格式:
```
function themename_post_formats_setup() {
add_theme_support( 'post-formats', array( 'aside', 'gallery' ) );
}
add_action( 'after_setup_theme', 'themename_post_formats_setup' );
```
使用after_setup_theme鉤子,以便在主題加載后注冊后期格式支持。
## 添加帖子類型支持
Post Types需要在functions.php文件中使用add_post_type_support()來告訴WordPress支持哪些格式:
```
function themename_custom_post_formats_setup() {
// add post-formats to post_type 'page'
add_post_type_support( 'page', 'post-formats' );
// add post-formats to post_type 'my_custom_post_type'
add_post_type_support( 'my_custom_post_type', 'post-formats' );
}
add_action( 'init', 'themename_custom_post_formats_setup' );
```
或者在函數register_post_type()中,添加'post-formats',在'supports'參數數組中:
```
$args = array(
...
'supports' => array('title', 'editor', 'author', 'post-formats')
);
register_post_type('book', $args);
```
add_post_type_support應該掛鉤到init鉤子,因為自定義帖子類型可能沒有在after_setup_theme上注冊。
## 使用格式
在主題中,使用get_post_format()檢查帖子的格式,并相應地更改其演示文稿。 請注意,默認格式的帖子將返回值為FALSE。 或者,使用has_post_format()條件標簽:
```
if ( has_post_format( 'video' )) {
echo 'this is the video format';
}
```
## 建議造型
格式的另一種方法是通過樣式規則。 主題應該使用post_class()函數在包圍該文章的包裝器代碼添加動態樣式類。 Post格式會導致使用“format-foo”名稱以這種方式添加額外的類。
例如,可以通過將其放在主題的樣式表中來隱藏狀態格式帖子的帖子:
```
.format-status .post-title {
display:none;
}
```
每種格式都適用于某種類型的“風格”,如現代用法所規定。在應用樣式時,請牢記每種格式的預期用法。
例如,旁邊,鏈接和狀態格式是簡單,簡短和次要的。這些將通常顯示沒有標題或作者信息。旁邊可能包含一段或兩段,而鏈接將只是一個連接到其中的URL的句子。鏈接和旁邊可能都有一個鏈接到單個帖子頁面(使用the_permalink()),因此將允許評論,但狀態格式很可能沒有這樣的鏈接。
另一方面,圖像柱通常只包含單個圖像,具有或不具有標題/文本以與之一起。音頻/視頻文章將是相同的,但添加了音頻/視頻。這三個中的任何一個可以使用插件或標準嵌入來顯示其內容。標題和作者可能不會顯示給他們,因為內容可能是不言自明的。
報價格式特別適合發布一個沒有額外信息的人的簡單報價。如果你把報價單放在帖子內容中,并把引用的人的名字放在帖子的標題中,那么你可以對帖子進行風格化,以便自己顯示the_content(),然后重新設置為blockquote格式,并使用the_title()顯示被引用的人的名稱作為旁路。
在許多情況下,特別的聊天可能會趨向于等寬型顯示。使用.format-chat上的一些樣式,您可以使用等寬字體顯示帖子的內容,也許在灰色背景div或類似內容中,從而將其視為聊天會話。
## 子主題格式
子主題繼承由父主題定義的帖子格式。 在子主題中為post格式調用add_theme_support()必須比父主題的優先級更高,并覆蓋現有的列表,而不是添加它。
```
add_action( 'after_setup_theme', 'childtheme_formats', 11 );
function childtheme_formats(){
add_theme_support( 'post-formats', array( 'aside', 'gallery', 'link' ) );
}
```
調用remove_theme_support('post-formats')將一起刪除它。
- 簡介
- 主題開發
- 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
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類