首页>建站相关>wordpress 自定义文章类型

wordpress 自定义文章类型

在 WordPress 中,Post Type(文章类型)是指不同类型的内容,例如文章(Post)、页面(Page)、自定义文章类型等。每种文章类型可以使用不同的模板来显示其内容。以下是关于 WordPress 文章类型模板的基本信息和操作方法:

默认文章类型

WordPress 默认有以下两种文章类型:
Post(文章):用于博客文章。
Page(页面):用于静态页面。

它们的模板文件通常位于主题文件夹中,例如:
single.php:用于显示单篇文章。
page.php:用于显示单个页面。

自定义文章类型

如果你通过代码或插件创建了自定义文章类型(Custom Post Type),可以通过创建特定的模板文件来控制其显示方式。

自定义文章类型模板命名规则
WordPress 会根据模板文件的名称自动匹配对应的文章类型。命名规则如下:
single-{posttype}.php:用于显示单个自定义文章类型的内容。
例如,如果你的自定义文章类型是 product,则模板文件命名为 single-product.php。
archive-{posttype}.php:用于显示自定义文章类型的归档页面。

例如,archive-product.php 用于显示所有产品的列表。
如果没有找到特定模板文件,WordPress 会默认使用 single.php 或 archive.php。

单个内容页模板示例 (single-product.php)

<?php
/**
 * The template for displaying all single posts of type 'product'.
 */
get_header(); ?>

<main id="primary" class="site-main">
    <?php
    while (have_posts()) :
        the_post();
        ?>
        <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
            <header class="entry-header">
                <?php the_title('<h1 class="entry-title">', '</h1>'); ?>
            </header>
            <div class="entry-content">
                <?php
                // 显示内容
                the_content();

                // 显示自定义字段(如果需要)
                if (get_field('price')) {
                    echo '<p>Price: ' . get_field('price') . '</p>';
                }
                ?>
            </div>
        </article>
    <?php
    endwhile;
    ?>
</main>

<?php get_sidebar(); ?>
<?php get_footer(); ?> 

注册一个自定义文章类型

function create_product_post_type() {
    // 定义标签
    $labels = array(
        'name'               => __('产品', 'textdomain'), // 文章类型名称
        'singular_name'      => __('产品', 'textdomain'), // 单篇文章类型名称
        'menu_name'          => __('产品', 'textdomain'), // 后台菜单名称
        'name_admin_bar'     => __('产品', 'textdomain'), // 后台工具栏名称
        'add_new'            => __('添加新产品', 'textdomain'), // 添加新文章
        'add_new_item'       => __('添加新产品', 'textdomain'), // 添加新文章页面标题
        'new_item'           => __('新产品', 'textdomain'), // 新文章
        'edit_item'          => __('编辑产品', 'textdomain'), // 编辑文章
        'view_item'          => __('查看产品', 'textdomain'), // 查看文章
        'all_items'          => __('所有产品', 'textdomain'), // 所有文章
        'search_items'       => __('搜索产品', 'textdomain'), // 搜索文章
        'parent_item_colon'  => __('父级产品:', 'textdomain'), // 父级文章
        'not_found'          => __('未找到产品', 'textdomain'), // 未找到文章
        'not_found_in_trash' => __('回收站中未找到产品', 'textdomain') // 回收站中未找到文章
    );

    // 定义参数
    $args = array(
        'labels'             => $labels, // 标签
        'public'             => true, // 是否公开
        'publicly_queryable' => true, // 是否可以通过前端查询
        'show_ui'            => true, // 是否显示后台管理界面
        'show_in_menu'       => true, // 是否显示在后台菜单中
        'query_var'          => true, // 是否允许通过查询变量查询
        'rewrite'            => array('slug' => 'product'), // 自定义 URL 别名
        'capability_type'    => 'post', // 权限类型
        'has_archive'        => true, // 是否有归档页面
        'hierarchical'       => false, // 是否支持层级结构
        'menu_position'      => 5, // 菜单位置(5 表示在“文章”下方)
        'supports'           => array('title', 'editor', 'thumbnail', 'excerpt', 'comments'), // 支持的功能
        'menu_icon'          => 'dashicons-cart', // 菜单图标(使用 Dashicons)
    );

    // 注册文章类型
    register_post_type('product', $args);
}
add_action('init', 'create_product_post_type');

labels:定义了文章类型在后台的各种标签和文本。
args:定义了文章类型的行为和特性。
public:是否公开,设置为 true 表示可以在前台显示。
has_archive:是否启用归档页面。
supports:支持的功能,例如标题、编辑器、特色图片、摘要等。
menu_icon:后台菜单图标,可以使用 WordPress 自带的 Dashicons。
rewrite:自定义 URL 别名,例如 example.com/product/sample-product。

关于层级结构

hierarchical 参数的作用

hierarchical 设置为 true:
文章类型支持层级结构,类似于页面(Page)。可以为文章设置父级和子级关系。在编辑文章时,会显示“父级”选项,允许你选择父级文章。

hierarchical 设置为 false:文章类型不支持层级结构,类似于文章(Post)。无法为文章设置父级和子级关系。在编辑文章时,不会显示“父级”选项。

如果文章类型不需要层级结构,建议将 hierarchical 设置为 false,以避免不必要的复杂性。启用层级结构后,确保模板文件能够正确处理父子级关系。

标签: wordpress

移动端可扫我直达哦~

推荐阅读

wordpress 2025-04-07

wordpress主题目录穿越导致的bug

尝试从知乎的热榜api提取数据并保存到本地,隔几个小时刷新一次,前几天运行的好好的,这几天突然发现数据有几天没有更新了。手动刷新了一下数据获取页,一直提示无需更新,将文件下载到本地测试,功能又是完好的。开了wp的debug模式,修正了...

建站相关 wordpress

wordpress 2025-03-31

wordpress 重新生成缩略图

测试wp缩略图功能的时候不小心把所有的缩略图都删掉了,但保留了原图,不想一个个重新上传以生成缩略图,就使用了这段代码,注意生成成功之后,这段代码就可以删掉了。忽然想起之前钉钉宣传的某个功能,阅后即焚~~function regener...

建站相关 wordpress

wordpress 2025-03-29

WordPress的主循环与WP_Query

WordPress的主循环和WP_Query是主题开发中最重要的两个概念,它们负责从数据库获取内容并显示在页面上。主循环 (The Loop)主循环是WordPress用来显示文章的核心机制。它是一个PHP代码结构,用于遍历当前页面请...

建站相关 wordpress

wordpress 2025-03-22

在phpstudy中为wordpress开启伪静态

原文修改主题都是在服务器上一边在线修改一边调试,用上了phpstudy后才发现自己之前的方式有多没有效率。但测试设置固定链接的时候遇到了一个问题,就是设置前也无风雨也无晴,设置后统一返回404。这个问题之前尝试搭建站点的时候也遇到过,...

建站相关 wordpress

wordpress 2025-03-17

WordPress分页中遇到404错误:posts_per_page

这个问题可能更多为主题开发者所遇见,一款推向市场的主题一般都会几经测试,应该不容易到客户手中才发现这个问题。所以网络上的相关讨论不多,博主也是调试了几天才大致有了一些思路:后台的默认参数在wordpress的后台设置里,是可以设置归档...

建站相关 wordpress

wordpress 2025-03-14

WORDPRESS HEADER模块常用函数

在 WordPress 开发中,header.php 文件是主题的重要组成部分,用于定义网站的头部内容。以下是一些在 header.php 中常用的 WordPress 函数及其用途,如果嫌部分函数生成的默认模板不需要的元素过多,也可...

建站相关 wordpress

wordpress 2025-03-12

wordpress的前后台数据交换ajax

ajax是个耳熟能详的词儿,但因为有点儿复杂,博主一直是规避学习的,今天刚好碰到一个前台jquery向wp后台申请数据的问题。躲不过,那就慢慢调试吧。钩子wp的ajax还区分了用户,对于不同的用户(登录与否)采用不同的钩子,不过这里只...

建站相关 wordpress

wordpress 2025-03-07

WordPress中add_meta_box函数参数详解

add_meta_box 是 WordPress 中用于在后台编辑页面添加自定义元框(Meta Box)的函数。它允许开发者在文章、页面、自定义文章类型等编辑页面中添加自定义字段或内容。以下是 add_meta_box 函数的参数及其...

建站相关 wordpress

wordpress 2025-03-07

wordpress 手动添加自定义字段

自定义字段可以扩展文章的信息,也有很多相关的成熟的插件,比如Advanced Custom Fields (ACF) 插件,如果希望添加的字段不多,也不愿意为此安装过多的插件,我们也可以考虑手动来添加它。为post文章添加字段// 添...

建站相关 wordpress