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

本文由清尘发表于2019-04-26 13:33属于WordPress分类

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

扩展已有

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

扩展文章字段

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

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

代表的含义为:

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

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

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

创建新的

创建新的内容类型

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

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

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

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

创建自定义分类法

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

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

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

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

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

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

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

进入 “pods 管理-组件”,启用 “Advance Content Type”。
这个时候,到 pods 的添加页面,多了一项 “高级内容类型”,选择它,这里我重新建立一个电影内容类型。点击 “下一步” 完成创建。
创建完成之后,会发现默认有了一些字段,这就是 WordPress 默认的字段,你可以修改或者删除它。
编辑好字段以后,再去看看其他标签页。下面主要介绍重要的设置:
“管理界面” 的 “管理界面样式”,可以自己写个 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 的显示方法有三种:

短代码方式显示,短代码请参考 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 添加字段查看。如果字段是多张图片,那么会返回一个数组,所以,输出图像字段的代码为:

单张图片字段示例代码:

<?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="">
        <?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="">
        <?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'); ?>