如何仅在特定页面模板上显示元数据框？

2024-03-29 17:38:33

针对特定模板页面显示元数据框的终极指南

介绍

元数据框是 WordPress 中强大的工具，可让你添加自定义字段，以增强内容创建功能。然而，有时你可能需要限制元数据框在特定页面模板上的显示。本文将深入探讨如何在 WordPress 中实现这一目标，包括代码示例、步骤和常见问题解答。

第 1 部分：使用 functions.php 文件

要仅在特定模板页面上显示元数据框，我们需要使用 WordPress 的函数 add_filter() 来修改现有元数据框数组。以下是在 functions.php 文件中添加的代码示例：

add_filter( 'rwmb_meta_boxes', 'my_register_meta_boxes' );

function my_register_meta_boxes( $meta_boxes ) {
    $prefix = '';

    $meta_boxes[] = array(
        'title' => esc_html__( 'Header', 'Header' ),
        'id' => 'header_section_1',
        'post_types' => array( 'page' ),
        'context' => 'normal',
        'include' => array(
            'template' => array( 'content-mainPage.php' ),
        ),
        'fields' => array(
            array(
                'type' => 'text',
                'name' => esc_html__( 'Title', 'title' ),
                'id' => $prefix . 'title',
            ),
            array(
                'type' => 'wysiwyg',
                'name' => esc_html__( 'Description', 'Description' ),
                'id' => $prefix . 'description',
            ),
        ),
    );

    return $meta_boxes;
}

理解代码

add_filter( 'rwmb_meta_boxes', 'my_register_meta_boxes' );：此行代码将你的自定义元数据框注册到 WordPress。
$prefix = '';：创建一个变量来存储元数据框字段 ID 的前缀。
$meta_boxes[] = ...;：创建一个元数据框数组，其中包含元数据框的标题、ID、帖子类型、上下文和字段。
`'include' => array('template' => array( 'content-mainPage.php' ),)**：此行代码指定仅当编辑带有 'content-mainPage.php' 模板的页面时才显示元数据框。

第 2 部分：使用页面模板

确保你的页面模板文件（在本例中为 'content-mainPage.php'）位于你的主题目录中。

第 3 部分：保存更改

保存对 functions.php 文件的更改，然后转到 WordPress 仪表板。

第 4 部分：测试元数据框

编辑一个使用 'content-mainPage.php' 模板的页面。你应该会看到新的元数据框仅显示在此页面上。

常见问题解答

问：如何知道我的主题是否支持自定义字段？

答：转到 WordPress 仪表板中的“外观”>“主题编辑器”。如果你的主题支持自定义字段，你应该会看到一个名为“自定义字段”的部分。

问：如果元数据框仍然显示在所有页面上，我该怎么办？

答：检查你的代码是否存在错误或冲突。确保你正确添加了 'include' 参数，并且你的页面模板文件位于正确的位置。

问：我可以使用条件函数进一步控制元数据框的显示吗？