WordPress網(wǎng)站建設(shè)者或開發(fā)者經(jīng)常會(huì)用到元框(Meta Boxes)。本文將深入探討元框與自定義文章類型的關(guān)聯(lián)和集成，以及如何在WordPress前端使用元框中保存的數(shù)據(jù)。

核心要點(diǎn)

• 使用add_meta_box()函數(shù)（掛載到add_meta_boxes動(dòng)作）可以將元框添加到任何文章類型的編輯界面。此函數(shù)可用於將元框添加到多個(gè)文章類型（如文章、頁面和自定義文章類型“書籍”），或添加到所有現(xiàn)有及未來創(chuàng)建的文章類型。
• 通過將文章類型名稱附加到add_meta_boxes動(dòng)作鉤子，可以將元框限制在特定文章類型。 register_post_type()函數(shù)用於自定義文章類型，其參數(shù)數(shù)組包含register_meta_box_cb，其值為在設(shè)置元框時(shí)調(diào)用的回調(diào)函數(shù)。
• global_notice_meta_box_callback函數(shù)包含元框的表單字段。 save_post動(dòng)作鉤子處理在將文章保存為草稿或發(fā)佈時(shí)保存到文本區(qū)域的數(shù)據(jù)。通過在保存對(duì)應(yīng)文章內(nèi)容之前顯示元框輸入的數(shù)據(jù)，可以將這些數(shù)據(jù)有效利用。

將元框添加到文章類型屏幕

Narayan Prusty已涵蓋了創(chuàng)建元框的大多數(shù)（如果不是全部）PHP函數(shù)、參數(shù)和動(dòng)作鉤子。

要將元框添加到任何文章類型的編輯屏幕，可以使用add_meta_box()函數(shù)並將其掛接到add_meta_boxes動(dòng)作。

以下代碼將元框添加到文章編輯屏幕。請(qǐng)注意global_notice_meta_box_callback函數(shù)，該函數(shù)用於顯示元框中的表單字段。稍後我們將詳細(xì)介紹。

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback',
        'post'
    );
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

要將元框添加到多個(gè)文章類型屏幕（文章、頁面和自定義文章類型“書籍”），請(qǐng)創(chuàng)建一個(gè)文章類型數(shù)組，遍歷該數(shù)組，並使用add_meta_box()將其添加到這些文章類型中。

function global_notice_meta_box() {
    $screens = array( 'post', 'page', 'book' );
    foreach ( $screens as $screen ) {
        add_meta_box(
            'global-notice',
            __( '全局公告', 'sitepoint' ),
            'global_notice_meta_box_callback',
            $screen
        );
    }
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

要將元框添加到所有現(xiàn)有及未來創(chuàng)建的文章類型，請(qǐng)使用get_post_types()獲取文章類型數(shù)組，然後用它替換上面的$screen值。

function global_notice_meta_box() {
    $screens = get_post_types();
    foreach ( $screens as $screen ) {
        add_meta_box(
            'global-notice',
            __( '全局公告', 'sitepoint' ),
            'global_notice_meta_box_callback',
            $screen
        );
    }
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

也可以通過省略第三個(gè)（$screen）參數(shù)來將元框添加到所有現(xiàn)有和新的文章類型：

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback'
    );
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

還可以通過將文章類型名稱（本例中為“book”）附加到add_meta_boxes動(dòng)作鉤子來限制元框到特定文章類型：

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback'
    );
}
add_action( 'add_meta_boxes_book', 'global_notice_meta_box' );

register_post_type()函數(shù)用於自定義文章類型，其參數(shù)數(shù)組中包含register_meta_box_cb，其值為在設(shè)置元框時(shí)調(diào)用的回調(diào)函數(shù)。

假設(shè)我們使用以下代碼創(chuàng)建了一個(gè)名為“book”的自定義文章類型：

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback',
        'post'
    );
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

在global_notice_meta_box PHP 函數(shù)（上面register_meta_box_cb的值）中添加add_meta_box()函數(shù)定義將把元框添加到“book”自定義文章類型的編輯屏幕。

再次強(qiáng)調(diào)，這是我們的示例global_notice_meta_box函數(shù)。

function global_notice_meta_box() {
    $screens = array( 'post', 'page', 'book' );
    foreach ( $screens as $screen ) {
        add_meta_box(
            'global-notice',
            __( '全局公告', 'sitepoint' ),
            'global_notice_meta_box_callback',
            $screen
        );
    }
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

到目前為止，我們已經(jīng)學(xué)習(xí)了在WordPress中註冊(cè)或添加元框的各種方法。我們還需要?jiǎng)?chuàng)建global_notice_meta_box_callback函數(shù)，該函數(shù)將包含我們?cè)虻谋韱巫侄巍?

以下是global_notice_meta_box_callback函數(shù)的代碼，該函數(shù)將在元框中包含一個(gè)文本區(qū)域字段。

function global_notice_meta_box() {
    $screens = get_post_types();
    foreach ( $screens as $screen ) {
        add_meta_box(
            'global-notice',
            __( '全局公告', 'sitepoint' ),
            'global_notice_meta_box_callback',
            $screen
        );
    }
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

save_post動(dòng)作鉤子處理在將文章保存為草稿或發(fā)佈時(shí)保存到文本區(qū)域的數(shù)據(jù)。

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback'
    );
}
add_action( 'add_meta_boxes', 'global_notice_meta_box' );

為了使用在元框文本區(qū)域中輸入的數(shù)據(jù)，我們將在顯示其保存對(duì)應(yīng)文章內(nèi)容之前顯示該數(shù)據(jù)。

function global_notice_meta_box() {
    add_meta_box(
        'global-notice',
        __( '全局公告', 'sitepoint' ),
        'global_notice_meta_box_callback'
    );
}
add_action( 'add_meta_boxes_book', 'global_notice_meta_box' );

代碼解釋

首先，我們創(chuàng)建了一個(gè)global_notice_before_post函數(shù)，並將其掛接到the_content過濾器，該過濾器帶有一個(gè)$content參數(shù)，其中包含文章內(nèi)容。

在函數(shù)內(nèi)部，我們包含了全局$post變量，該變量包含當(dāng)前正在查看的文章的WP_Post對(duì)象。

通過get_post_meta檢索針對(duì)給定文章保存的全局公告，並將其保存到$global_notice變量中。

然後將公告包裝在一個(gè)div中並保存到$notice變量中。

最後，將包含全局公告的$notice與包含實(shí)際文章內(nèi)容的$content連接起來。

以下是帶有文章內(nèi)容之前的全局公告的文章屏幕截圖。

總結(jié)

在本教程中，我們學(xué)習(xí)了在WordPress管理屏幕中註冊(cè)元框的多種方法，以及如何將它們限制在文章類型中。

我們還回顧瞭如何向元框添加表單字段，以及如何在保存或發(fā)布文章時(shí)保存輸入的數(shù)據(jù)。

最後，我們介紹瞭如何將輸入到元框中的數(shù)據(jù)付諸實(shí)踐。

在未來的文章中，我們將介紹如何向文章類型管理屏幕添加上下文幫助選項(xiàng)卡。

如果您有任何問題或建議，歡迎在評(píng)論中提出。

WordPress中向文章類型添加元框的常見問題

• 什麼是WordPress中的元框？ WordPress中的元框是在管理界面中顯示的可拖動(dòng)框。這些框用於顯示附加的輸入字段，允許用戶自定義不同類型文章的功能和佈局。它們可以添加到文章、頁面和自定義文章類型。元框可以包含各種類型的字段，包括文本、複選框、選擇選項(xiàng)等等。

• 如何在WordPress中向自定義文章類型添加元框？ 要向WordPress中的自定義文章類型添加元框，需要使用add_meta_box()函數(shù)。此函數(shù)允許您指定元框ID、標(biāo)題、回調(diào)函數(shù)、文章類型、上下文和優(yōu)先級(jí)?；卣{(diào)函數(shù)用於輸出元框的內(nèi)容。

• 我能否向單個(gè)文章類型添加多個(gè)元框？ 可以。每個(gè)元框都應(yīng)具有唯一的ID，以避免衝突。您可以多次使用add_meta_box()函數(shù)並使用不同的參數(shù)來添加多個(gè)元框。

• 如何保存輸入到元框字段中的數(shù)據(jù)？ 要保存輸入到元框字段中的數(shù)據(jù)，需要將一個(gè)函數(shù)掛接到save_post動(dòng)作。此函數(shù)應(yīng)檢查nonce，驗(yàn)證當(dāng)前用戶的權(quán)限，然後使用update_post_meta()或add_post_meta()函數(shù)將元框數(shù)據(jù)保存到數(shù)據(jù)庫。

• 如何在前端顯示元框數(shù)據(jù)？ 要在前端顯示元框數(shù)據(jù)，可以在循環(huán)中使用get_post_meta()函數(shù)。此函數(shù)從數(shù)據(jù)庫檢索元框數(shù)據(jù)並將其作為字符串返回，然後您可以在模板文件中將其輸出。

• 我能否將元框添加到頁面以及文章？ 可以。使用add_meta_box()函數(shù)時(shí)，可以將文章類型指定為“page”以向頁面添加元框。

• 如何從文章類型中刪除元框？ 可以使用remove_meta_box()函數(shù)。此函數(shù)需要元框ID和文章類型作為參數(shù)。

• 我能否自定義元框在文章編輯屏幕中的位置？ 可以。 add_meta_box()函數(shù)的context參數(shù)決定了元框的位置?？赡艿闹禐椤皀ormal”、“side”和“advanced”。

• 我能否將元框添加到插件創(chuàng)建的自定義文章類型？ 可以。您只需要知道自定義文章類型的slug，然後將其用作add_meta_box()函數(shù)中的post_type參數(shù)。

• 如何設(shè)置元框及其字段的樣式？ 可以使用CSS設(shè)置元框及其字段的樣式。元框?qū)⒕哂小皃ostbox”類，您可以向元框中的字段添加您自己的類。然後，您可以在CSS中定位這些類以應(yīng)用樣式。

以上是在WordPress中添加元框的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！