Pods：WordPress 自定义内容类型 字段 分类法

pods 是一款用在 WordPress 上的自定义内容类型的插件，但是 pods 拥有的功能却完全不限于此。pods 能够扩展现有的内容类型，比如为用户资料 （user）增加一个 “电话” 字段。此外，它还有权限管理功能，类似于 “members” 插件。此外，还有高级自定义内容类型，改变“标题”这个字段名称。再此外，它还有内容关系的功能。

这篇文章我们除了介绍 pods 的使用方法以外，还会介绍内容类型的列表页，内容页的制作，pods字段的前台模板调用，增加内容类型到菜单等等。

扩展已有

WordPress 默认有三大内容类型：文章 (posts)、页面 (page)、媒体 (attachment)，可能 “用户(user)” 也算一个内容类型，因为“用户”也可以扩展。默认的分类法有：分类目录 (category)、标签 (tag)。默认的内容类型和分类法在项目中字段经常不够用。

扩展文章字段

1、安装好 pods 后，点击 “pods管理 - 添加”，点击 “扩展已有”、选择 “内容类型 (文章、页面，等等) ”，下方选择 “文章”，点击 “下一步”。

2、点击 “添加字段”，比如添加一个 “文章来源” 的文本类型的字段，这里有几个选框。

代表的含义为：

• 标签：显示在发布时候的名称，可以为中文。
• 名称：内部使用，存在数据库里的名称，可用于模板调用，只能为字母、数字、下划线，不能以数字开头。
• 描述：发布时对字段的简要说明，选填。
• 字段类型：字段的类型，如，文本框、文本区域、文件等等。
• 选项：该字段是否为必填。

3、点击 “添加字段”，完成添加，点击 “Save Pod” 保存添加。

这个时候去发布文章看看，在下方就多了个文章来源字段了。快点去用同样的方法可以为页面、媒体、用户、评论添加自定义字段吧。

创建新的

创建新的内容类型

1. 进入到 pods 的添加界面，选择 “创建新的”，接下来选择 “自定义内容类型”。
2. 标签填写内容类型名称，可以为中文，比如填写个“电影”，点击下面的“高级”，在 pod name  填写内容类型的机读名称，点击 “下一步”，完成一个自定义内容类型的创建，你可以在左边栏找到 “电影” 这个内容类型。

为自定义内容类型添加字段。新创建的自定义内容类型，默认拥有 “文章” 这个内容类型的所有字段，比如标题、内容、日期等等，我们是在这些基础上添加新的需要的字段，比如现在添加一些字段：海报、地区、时长、年份等等。再去发布 “电影”，你会发现下方多了刚刚添加的这些字段。

创建好自定义内容类型后，你会发现还有很多标签页：“管理字段”、标签、管理界面、高级选项。

• 标签：在后台显示的标签，根据需要修改。
• 管理界面：管理内容类型在后台的显示，尝试把菜单位置改为更大的值试试看。
• 高级选项：对自定义内容类型的设置，请把 “拥有归档” 勾上。

创建自定义分类法

1. 打开 pods 的添加界面，选择 “创建新的”，接下来选择 “自定义分类法”。
2. 标签 填写分类法名称，可以中文，比如填写 “电影类型”，点击下面的 “高级”，在 pod name 填写分类法的机读名称，点击 “下一步”，完成一个自定义分类法的创建。

创建完成以后，有几个标签页，主要关注以下几个：

• 高级选项中，“层级”，表示该分类法是否有层级关系，打上勾相当于 “分类目录” 分类法，不打钩相当于“标签” 分类法，我建议打上勾。“相关内容类型”，为这个分类法应用到哪一个内容类型，比如我这里，勾上了“电影”。我在发布电影的时候，在右边栏就可以有电影类型选择了。
• 其他字段：这是为自定义分类法添加字段，这个按照需要开启，比如你想为电影类型中的科幻片分类添加一个略缩图字段等等。

创建自定义设置页面 — 制作主题选项

有没有觉得做主题的时候，为主题添加选项比较麻烦，pods有个超简单的方法，使用自定义设置页面轻松搞定。

1. 打开 pods 的添加界面，选择 “创建新的”，接下来选择 “自定义设置页面”，标签填写页面名称，可以使用中文，比如填写 “主题选项”，菜单位置由自己选：在设置菜单、外观菜单下，新菜单，我这里选择添加到外观菜单。点击下面的 “高级”，在 pod name 填写自定义设置页面的机读名称，点击 “下一步”，这样就完成了一个自定义页面的创建。
2. 创建完成以后，可以去添加一些字段，比如我添加了：网站 logo、网站标题、网站关键字、网站描述、统计代码、网站备案号字段，要注意字段类型。
3. 接下来保存后看看你的左边栏对应的菜单位置吧。

好了，pods的基础功能就这么一些，这些功能网上很多插件都能实现，其实更重要的内容，还在于他的组件，pods 的组件给 pods 扩充了非常多的功能，这才是 pods真正的强大之处。

pods组件

高级自定义内容类型

1. 进入 “pods 管理-组件”，启用 “Advance Content Type”。
2. 这个时候，到 pods 的添加页面，多了一项 “高级内容类型”，选择它，这里我重新建立一个电影内容类型。点击 “下一步” 完成创建。
3. 创建完成之后，会发现默认有了一些字段，这就是 WordPress 默认的字段，你可以修改或者删除它。
4. 编辑好字段以后，再去看看其他标签页。下面主要介绍重要的设置：

• “管理界面” 的 “管理界面样式”，可以自己写个 WordPress 管理后台页面。
• “高级选项” 的 “标题字段”，如果修改了标题字段，或者想要改变标题字段，请在这里选择。

高级内容关系

进入“pods 管理-组件”，启用 “Advance Relationships”，这个时候在添加内容关系字段以后，你可以看到多了几行，这些高级的内容关系，可以创建更加复杂的内容关系。

权限与角色管理

进入“pods 管理-组件”，启用 “Roles and Capabilities”，如果你用过 members 插件，你会发现这功能和 members 功能很相似，一样的强大。可以对所有的权限分角色的管理，可以添加、编辑、删除用户角色。

更多组件

pods 管理后台还有其他实用的组件，更多的组件功能，不一一介绍，看组件名字大概能清楚他的功能。pods 官方有提供其他组件，一些是单独的插件，一些是配合 pods工作的组件。

前端调用

模板命名

我发现，虽然很多人都会用自定义内容类型，但是内容类型的列表页不好做，即使做好，又该怎么放到菜单上显示出来，比如将 “电影” 列表页放在菜单中，自定义内容类型绑定了一个自定义分类法，又该怎么去显示分类法中某个分类下的文章，比如 “科幻片” 这个电影分类。

模板命名规则：

• 自定义内容类型 模板命名规则：archive-{post_type_name}.php 如 archive-movies.php
• 自定义分类法 模板命名规则：taxonomy-{taxonomy_name}.php 如 taxonomy-movie_type.php
• 自定义内容类型内容页 模板命名规则：single-{post_type_name}.php 如 single-movies.php

将内容类型加入到菜单，需要安装一个插件 “Custom Post Type's Archive in WP Nav Menu”，安装好之后，没有任何设置界面，进入到 “外观-菜单”，你可以发现菜单编辑区域的左边有了一个custom post type archives ，现在内容类型就在这里了，如果你发现内容类型不在这，那就请到 pods 的内容类型管理界面的高级选项中确认你的 “拥有存档” 这个选项已经打上勾了。

注：可能由于缓存问题，如果发现添加了内容类型到菜单后，前台点击内容类型的菜单出现404页面，请到 “设置-固定链接”，点击一下保存即可。

数据调用

后台配置好，其实最主要的，还是要能够显示出来才是最重要的，pods 的显示方法有三种：

1. 短代码方式显示，短代码请参考 pods 短代码文档，配合 pods 官方提供的 magic tags。
2. 利用 pods 的 “page” 和 “template” 组件，这两个组件可在 pods 组件中开启，请参考文章。
3. 利用模板函数，即将重点介绍。

这里只介绍模板函数方式调用 pods 数据，因为这才是做主题开发时能使用的东西。

输出函数

Pods 显示数据函数

pods_field_display ( $pod,$post->ID,'$field )

关于该函数的文档，请查看 pods 官方文档。

function pods_field_display ( $pod, $id = false, $name = null, $single = false )

参数	数据类型	备注
$pod	(string)	Pod name，即为 pods 机读名称
$id	(mixed)	(选填) 某篇文章ID或slug，以查询该篇文章数据
$name	(string|array)	字段名称，或者关联数组的参数
$single	(boolean)	(选填) 是否以数组的形式返回

图像字段输出函数

pods_field_display() 不会真正的显示出一张图片，而是显示出图片的 URL，pods 特地为图片显示定义了一个函数：

pods_image ( $image, $size = 'thumbnail', $default = 0, $attributes = '', $force = false )

关于该函数文档，请查看官方文档。

function pods_image ( $image, $size = 'thumbnail', $default = 0, $attributes = '', $force = false )

参数	数据类型	备注
$image	(array|int|string)	图片字段的数组，或ID，或guid
$size	(string|array)	图片大小样式
$default	(int)	如果图片不存在，则显示该图片$default
$attributes	(string|array)	图片属性 (内部通过 wp_get_attachment_image获取)
$force	(boolean)	强制规定大小

图片有单张图片和多张图片，如不清楚单张与多张，请到 pods 添加字段查看。如果字段是多张图片，那么会返回一个数组，所以，输出图像字段的代码为：

单张图片字段示例代码：

<?php 
	echo pods_image( get_post_meta( $post->ID, $image_field_name, true ), ’original’ );
?>

多张图片字段：

<?php
	$images =get_post_meta( $post->ID, ’images’);
	foreach ( $images as $image )
	{
		echo pods_image( $image, ’original’ );
	}
?>

输出字段注意事项：

• yes/no 字段：后台勾选 “是” 输出 1，不勾选输出空值。
• Code 字段：可执行 php 脚本代码，输出 php 代码执行结果。
• Website字段：本人无法输出该字段内容，请勿使用。

因为 pods 自定义字段也属于 WordPress 内部自定义字段，所以依然可以使用 WordPress 的 get_post_meta()输出，但是也并不是所有字段都能输出，经过测试，可直接使用 get_post_meta()函数输出的字段有：

• Phone
• Email
• Password
• Pptext
• Date time
• Pnumber
• Currency
• Color

对于其他字段，请使用 pods_field_display()；

模板代码段示例

在主循环中

代码示例：

<?php if(have_posts()) :while(have_posts()) : the_post(); ?>
<h1>
    <a href="https://ninghao.net/%3C?php_the_permalink%28%29%3B_%3F%3E">
        <?php the_title(); ?>
    </a>
</h1>
<!--标题-->
<div>
    <div>
        <span>年份:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'time');//显示（年份）time字段 ?>
    </div>
    <div>
        <span>区域:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'zone');//显示（区域）zone字段?>
    </div>
    <div>
        <span>时长:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'how_long');//显示（时长）how_long字段 ?>
        <span>分钟</span>
    </div>
    <div>
        <span>海报:</span>
        <?php echo pods_image( get_post_meta( $post->ID, 'poster', true),'original'); //显示海报字段 ?>
    </div>
</div>
<!--显示自定义字段-->
<div>
    <?php the_excerpt(); ?>
</div>
<!-- 内容摘要 -->
<?php endwhile;endif; ?>

万能循环示例代码

<?php query_posts( 'showposts=5&post_type=movie');while(have_posts()) : the_post(); ?>
<h1>
    <a href="https://ninghao.net/%3C?php_the_permalink%28%29%3B_%3F%3E">
        <?php the_title(); ?>
    </a>
</h1>
<!--标题-->
<div>
    <div>
        <span>年份:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'time');//显示（年份）time字段 ?>
    </div>
    <div>
        <span>区域:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'zone');//显示（区域）zone字段?>
    </div>
    <div>
        <span>时长:</span>
        <?php echo pods_field_display( 'movie',$post->ID,'how_long');//显示（时长）how_long字段 ?>
        <span>分钟</span>
    </div>
    <div>
        <span>海报:</span>
        <?php echo pods_image( get_post_meta( $post->ID, 'poster', true),'original'); //显示海报字段 ?>
    </div>
</div>
<!--显示自定义字段-->
<div>
    <?php the_excerpt(); ?>
</div>
<!-- 内容摘要 -->
<?php endwhile;wp_reset_query(); ?>

自定义设置页面（调用主题选项数据）

请注意 $id 参数为 pods-settings-{slug_name}，比如我的 pods name为 theme_option，那么 $id 的实参应该为 'pods-settings-theme_option'。

<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_logo'); ?>
<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_title'); ?>
<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_keyword'); ?>
<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_description'); ?>
<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_tongji'); ?>
<?php echo pods_field_display('theme_option','pods-settings-theme_option','site_beian'); ?>

pod-zh_cn.zip WordPress Pods