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

核心要點

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

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

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

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

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

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' );

要將元框添加到多個文章類型屏幕（文章、頁面和自定義文章類型“書籍”），請創(chuàng)建一個文章類型數(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)建的文章類型，請使用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' );

也可以通過省略第三個（$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動作鉤子來限制元框到特定文章類型：

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è)置元框時調(diào)用的回調(diào)函數(shù)。

假設(shè)我們使用以下代碼創(chuàng)建了一個名為“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”自定義文章類型的編輯屏幕。

再次強調(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中注冊或添加元框的各種方法。我們還需要創(chuàng)建global_notice_meta_box_callback函數(shù)，該函數(shù)將包含我們元框的表單字段。

以下是global_notice_meta_box_callback函數(shù)的代碼，該函數(shù)將在元框中包含一個文本區(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動作鉤子處理在將文章保存為草稿或發(fā)布時保存到文本區(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ù)，我們將在顯示其保存對應(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)建了一個global_notice_before_post函數(shù)，并將其掛接到the_content過濾器，該過濾器帶有一個$content參數(shù)，其中包含文章內(nèi)容。

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

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

然后將公告包裝在一個div中并保存到$notice變量中。

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

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

總結(jié)

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

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

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

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

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

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

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

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

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

• 如何保存輸入到元框字段中的數(shù)據(jù)？ 要保存輸入到元框字段中的數(shù)據(jù)，需要將一個函數(shù)掛接到save_post動作。此函數(shù)應(yīng)檢查nonce，驗證當前用戶的權(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ù)時，可以將文章類型指定為“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中添加元框的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！