什么是 WordPress get_post_meta 函数？

WordPress 的 get_post_meta 函数允许你从文章的元数据中提取信息，并在网站前端展示这些额外的内容详情。这个功能可以通过向主题的配置文件添加代码实现，或者使用像 WPCode 这样的插件来方便地操作。这样做可以让你的文章显示各种扩展信息，例如作者、发布日期等，从而增强文章的信息丰富性和互动性。

WordPress get_post_meta 函数参数

在WordPress中，get_post_meta 函数用于获取文章（post）或页面（page）的元数据（meta）。这个函数接受三个参数，具体用法如下：

$value = get_post_meta($post_id, $key, $single);

1. $post_id (必需) – 这是文章或页面的ID。它指定你想从哪个文章或页面获取元数据。
2. $key (可选) – 这是你想要获取的特定元数据键的名称。如果指定了键名，函数将只返回与这个键关联的值。如果省略此参数或设置为空字符串，函数将返回与指定文章ID关联的所有元数据。
3. $single (可选) – 这是一个布尔值，用来指定返回值的格式。如果设置为true，函数只返回与指定键关联的第一个值（即使有多个值也是如此）。如果设置为false或省略，函数将返回一个数组，包含所有与指定键关联的值。

注意：如果$single参数为TRUE并且 post 元字段包含多个数据值，则该函数仅检索第一个值。同时，使用空字符串将返回当前帖子中同一键的所有元数据。

还可以将该函数用于其他目的，例如检查给定帖子 ID 中是否存在特定元字段：

$custom_field = get_post_meta( get_the_id() );
if (!empty($custom_field)){
   echo“此帖子中存在元字段”
} 
别的
{
   echo "这篇文章不包含自定义字段"
}

如何使用 get_post_meta 函数显示自定义字段

手动将 get_post_meta 函数添加到WordPress帖子模板中，你可以遵循以下步骤来确保正确和安全地进行更改。使用子主题确实是一种安全的做法，因为它保护你的更改免受主题更新的影响。下面是详细步骤：

1、登录WordPress 管理仪表板。从侧边栏导航至外观→主题文件编辑器。

2、在主题文件菜单下，找到single.php文件。

3、在文件末尾的<?php结束标记之前添加以下代码片段。记住根据你的需要更改值：

echo get_post_meta(Post ID, 'key', true );

4、在该函数之后，添加WordPress 循环以允许代码拉取并显示检索到的数据。以下是在帖子底部显示帖子元值的示例：

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<?php endwhile; else: ?>
<?php endif; ?>

5、单击更新文件以保存更改。

在WordPress中处理从自定义字段检索的数组数据时，使用WordPress循环是一种有效的方法，特别是当你需要处理多个值或多个自定义字段时。这里有一个示例，展示如何在WordPress模板中循环多个自定义字段值：

foreach ($your_function_variable as $value){ 
   //这里是命令
}

如果你无法直接编辑 single.php 文件，可以通过安装和使用 WPCode 插件来向你的WordPress网站添加自定义代码。以下是具体操作步骤：

1. 下载并安装WPCode插件：
   • 在WordPress管理仪表板中，转到“插件”部分并选择“添加新插件”。
   • 在搜索框中输入“WPCode”，找到插件并点击“立即安装”，然后激活它。
2. 添加自定义代码片段：
   • 安装并激活插件后，刷新页面，从管理仪表板中导航到代码片段 → 添加片段。。
   • 你将看到一个选项叫做“添加您的自定义代码”，请点击“使用代码片段”。

3. 从代码类型下拉菜单中，选择PHP 片段。
4. 在代码预览字段中输入你的代码。它应该包括函数和循环。
5. 向下滚动到插入部分并根据你的需要更改设置。例如，我们将选择“自动插入”和“在内容之后插入”作为位置。

6. 单击右上角的保存片段。
7. 选择激活开关以应用代码。

WordPress get_post_meta 函数示例

以下解释几个get_post_meta用法示例，以供参考。

访问已发布的帖子对象和元键

$published_posts = get_posts(array('post_status' => '发布')); 
foreach ($published_posts as $post) { 
    $post_id = $post->ID; 
    $meta_keys = get_post_meta($post_id);}

在WordPress中，你可以用 get_posts 函数快速获取所有已发布的帖子。然后，使用 foreach 循环逐一查看每个帖子的内容。如果你需要在帖子中显示图像，可以通过这种方式获取并显示图像的HTML代码。

$attachment_id = get_post_meta($post_id,'_thumbnail_id', true);
if ($attachment_id) {
   $image_html = wp_get_attachment_image($attachment_id, 'large');
   echo $image_html;
}
else { echo 'No images!'; }

此代码从帖子中的自定义字段检索图像的附件 ID，并将获得的值传递给wp_get_attachment_image函数。使用 ID，它获取图像的img元素。

还可以使用代码通过更改wp_get_attachment_image函数的$size参数来检索帖子缩略图。

访问与帖子元字段相关的动态数据

$dynamic_suffix = '示例'; 
$custom_field_name = 'custom_field_' 。 $动态后缀；
$dynamic_data = get_post_meta(get_the_id(), $custom_field_name, true); 
if ($dynamic_data) { 
    echo '动态数据：' . esc_html($dynamic_data); 
} else { 
    echo '未找到动态数据。'; 
}

可以使用动态后缀引入动态生成的字段。例如，在代码中使用example后缀创建custom_field_example 。

此代码从当前帖子的动态自定义字段中检索并显示数据。如果该值存在，则该函数将数据标记为动态。如果该值不存在，则会输出错误消息。

根据元数据获取帖子状态

$post_status = get_post_meta(post_ID, 'custom_field_post_status', true); 
if ($post_status) { 
    echo '自定义状态：' . esc_html($post_status); 
} else { 
    echo '自定义状态未找到或不可用。'; 
}

该代码从自定义字段中获取帖子状态。如果状态存在，则显示该值。否则，该函数将返回错误消息。

结论：

WordPress的 get_post_meta 函数是一个非常有用的工具，它允许你从帖子的自定义字段中提取元数据，并将这些信息展示给网站访问者。这个函数主要有三个参数：帖子ID、你想获取的元数据的键名，以及一个决定是获取单个值还是返回所有值的布尔值参数。