在我们的自定义元框模板教程系列的第 1 部分、第 2 部分和第 3 部分中,我们学习了如何制作可重用的元框,该元框从易于阅读、易于复制的数组中获取所有字段信息。许多数据很容易使用,只需回显模板中的元字段或通过函数即可,但某些字段更复杂,需要更多技巧才能正确使用。本教程将为您提供如何使用这些数据的基本概念,并可以通过无数种方式进行阐述。
WordPress 提供了多种获取帖子元数据的方法。
显示数据的最简单方法是使用 使用数据的可重用自定义元框盒子第四部分()
函数。您可以将其直接放入您的 single.php 模板中,但它不会为您提供您可能想要的结果。它是无序列表中数据的非常字面的输出,以每个字段的键为前缀,如图所示。
获取保存在帖子元字段中的数据的最常见方法是使用 get_post_meta()
函数。这是一种定位特定字段并将其存储在稍后可以使用的变量中的简单方法。
$custom_text = get_post_meta($post->ID, 'custom_text', true);
在单个后循环中使用此代码会将文本“基本文本输入中的某些文本”放入变量 $custom_text
中,然后可以回显或过滤该变量,或者您想要对字符串执行的任何操作。当您只处理几个字段时,这可能是正确的方法,但在我们的示例中,我们正在处理 11 个不同的字段。使用此函数单独调用它们会使您的代码不必要地膨胀,因为有一种方法可以立即获取所有数据。
当我处理这么多字段时,我最喜欢的方法是使用 get_post_custom()
函数。通过此函数,我们可以将所有自定义帖子元字段存储在一个数组中,然后使用数组键检索我们想要的数据。
$post_meta_data = get_post_custom($post->ID);
会给我们一个如下所示的数组:
Array ( [custom_text] => Array ( [0] => Some text in a basic text input ) [custom_textarea] => Array ( [0] => A paragraph or two from a textarea. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec tristique quam mi. Sed eget ligula sit amet ante dapibus tristique. Mauris vel enim mauris, vitae mattis tortor. Praesent at adipiscing massa. Fusce quis eros vel sem pharetra consequat imperdiet ut est. ) [custom_checkbox] => Array ( [0] => on ) [custom_select] => Array ( [0] => one ) [custom_radio] => Array ( [0] => two ) [custom_checkbox_group] => Array ( [0] => a:2:{i:0;s:3:"one";i:1;s:5:"three";} ) [custom_post_id] => Array ( [0] => 109 ) [custom_date] => Array ( [0] => 05/25/2012 ) [custom_slider] => Array ( [0] => 15 ) [custom_image] => Array ( [0] => 413 ) [custom_repeatable] => Array ( [0] => a:3:{i:0;s:22:"text from a repeatable";i:1;s:27:"more text from a repeatable";i:2;s:33:"repeatable text fields are great!";} ) )
正如您从该数组中看到的,WordPress 将每个字段存储为一个数组,因为同一字段可能有多个值。您可能还会注意到一些字段是序列化的。让我们更深入地了解如何处理每个字段的数据,并讨论如何解决这个问题。
文本和文本区域字段的处理非常简单。您可以使用以下示例之一来回应它们:
echo $post_meta_data['custom_text'][0]; echo apply_filters('the_content', $post_meta_data['custom_textarea'][0]); $custom_checkox = $post_meta_data['custom_checkbox'][0]; if ($custom_checkbox == 'on') { do_stuff(); }
第一行将简单地按原样输出字符串,第二行将使用 WordPress 的 the_content
过滤器将换行符转换为段落。您也可以对选择、单选、日期和滑块字段使用这些相同的方法。
最后一行显示了如何测试复选框是否已被选中。如果是,您可以执行各种功能或任意数量的事情。
我们的复选框组字段和可重复字段存储在数据库中序列化的数组。在输出这些数据之前,我们必须对其进行反序列化。
$custom_checkbox_group = unserialize($post_meta_data['custom_checkbox_group'][0]); $custom_repeatable = unserialize($post_meta_data['custom_repeatable'][0]);
unserialize()
函数是一个基本的PHP函数,它将我们的数据转换为更易于使用的数组。上面的代码会给我两个如下所示的数组:
Array ( [0] => one [1] => three ) Array ( [0] => text from a repeatable [1] => more text from a repeatable [2] => repeatable text fields are great! )
现在我可以循环遍历数组,但是我想在输出中使用它们。需要注意的是,在可重复字段中,如果您也像自定义元框模板教程第 3 部分中的示例那样使其可排序,则数组中的键将自动按 0、1、2、3 的顺序存储等,而不是按照它们在排序之前最初输入的顺序。
echo '<ul class="custom_repeatable">'; foreach ($custom_repeatable as $string) { echo '<li>'.$string.'</li>'; } echo '</ul>';
此示例将输出保存在 $custom_repeatable
数组中的每个字符串的无序列表。
对于我们的帖子列表和图像字段,我们保存了一个 ID。在极少数情况下,您可能只想输出 ID,但很可能您希望使用 ID 来获取更多信息。
$custom_post_id = $post_meta_data['custom_post_id'][0]; echo '<a href="'.get_permalink($custom_post_id).'">'.get_the_title($custom_post_id).'</a>'; $custom_image = $post_meta_data['custom_image'][0]; echo wp_get_attachment_image($custom_image, 'thumbnail');
本教程展示了使用我们通过可重复使用的自定义元框存储的数据的最基本方法。能够保存额外的数据并在主题和插件中使用它,为 WordPress 开辟了一个充满可能性的全新世界。你会用它做什么?
以上是使用数据的可重用自定义元框盒子第四部分的详细内容。更多信息请关注PHP中文网其他相关文章!