Pods插件:WordPress 自定义内容类型 字段 分类法

admin

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

扩展已有

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

扩展文章字段

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

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

代表的含义为：

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

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

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

创建新的

创建新的内容类型

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

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

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

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

admin

创建自定义分类法

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

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

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

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

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

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

admin

pods组件
高级自定义内容类型

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

高级内容关系

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

权限与角色管理

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

更多组件

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

admin

前端调用

模板命名

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

模板命名规则：

自定义内容类型 模板命名规则：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 的显示方法有三种：

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

这里只介绍模板函数方式调用 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 添加字段查看。如果字段是多张图片，那么会返回一个数组，所以，输出图像字段的代码为：

单张图片字段示例代码：

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

复制代码

多张图片字段：

1. <?php
   
2.     $images =get_post_meta( $post->ID, ’images’);
   
3.     foreach ( $images as $image )
   
4.     {
   
5.         echo pods_image( $image, ’original’ );
   
6.     }
   
7. ?>

复制代码

输出字段注意事项：

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()；

模板代码段示例

在主循环中

代码示例：

1. <?php if(have_posts()) :while(have_posts()) : the_post(); ?>
   
2. <h1>
   
3.     <a href="">
   
4.         <?php the_title(); ?>
   
5.     </a>
   
6. </h1>
   
7. <!--标题-->
   
8. <div>
   
9.     <div>
   
10.         <span>年份:</span>
    
11.         <?php echo pods_field_display( 'movie',$post->ID,'time');//显示（年份）time字段 ?>
    
12.     </div>
    
13.     <div>
    
14.         <span>区域:</span>
    
15.         <?php echo pods_field_display( 'movie',$post->ID,'zone');//显示（区域）zone字段?>
    
16.     </div>
    
17.     <div>
    
18.         <span>时长:</span>
    
19.         <?php echo pods_field_display( 'movie',$post->ID,'how_long');//显示（时长）how_long字段 ?>
    
20.         <span>分钟</span>
    
21.     </div>
    
22.     <div>
    
23.         <span>海报:</span>
    
24.         <?php echo pods_image( get_post_meta( $post->ID, 'poster', true),'original'); //显示海报字段 ?>
    
25.     </div>
    
26. </div>
    
27. <!--显示自定义字段-->
    
28. <div>
    
29.     <?php the_excerpt(); ?>
    
30. </div>
    
31. <!-- 内容摘要 -->
    
32. <?php endwhile;endif; ?>

复制代码

万能循环示例代码

1. <?php query_posts( 'showposts=5&post_type=movie');while(have_posts()) : the_post(); ?>
   
2. <h1>
   
3.     <a href="">
   
4.         <?php the_title(); ?>
   
5.     </a>
   
6. </h1>
   
7. <!--标题-->
   
8. <div>
   
9.     <div>
   
10.         <span>年份:</span>
    
11.         <?php echo pods_field_display( 'movie',$post->ID,'time');//显示（年份）time字段 ?>
    
12.     </div>
    
13.     <div>
    
14.         <span>区域:</span>
    
15.         <?php echo pods_field_display( 'movie',$post->ID,'zone');//显示（区域）zone字段?>
    
16.     </div>
    
17.     <div>
    
18.         <span>时长:</span>
    
19.         <?php echo pods_field_display( 'movie',$post->ID,'how_long');//显示（时长）how_long字段 ?>
    
20.         <span>分钟</span>
    
21.     </div>
    
22.     <div>
    
23.         <span>海报:</span>
    
24.         <?php echo pods_image( get_post_meta( $post->ID, 'poster', true),'original'); //显示海报字段 ?>
    
25.     </div>
    
26. </div>
    
27. <!--显示自定义字段-->
    
28. <div>
    
29.     <?php the_excerpt(); ?>
    
30. </div>
    
31. <!-- 内容摘要 -->
    
32. <?php endwhile;wp_reset_query(); ?>

复制代码

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

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

1. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_logo'); ?>
   
2. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_title'); ?>
   
3. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_keyword'); ?>
   
4. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_description'); ?>
   
5. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_tongji'); ?>
   
6. <?php echo pods_field_display('theme_option','pods-settings-theme_option','site_beian'); ?>
   

复制代码