如何利用WordPress的`Custom Post Types`和`Custom Taxonomies`构建复杂的数据模型？ - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

利用 WordPress Custom Post Types 和 Custom Taxonomies 构建复杂数据模型

大家好，今天我们来聊聊如何利用 WordPress 的 Custom Post Types (自定义文章类型) 和 Custom Taxonomies (自定义分类法) 构建复杂的数据模型。WordPress 虽然最初是一个博客平台，但凭借其强大的可扩展性，现在已经可以胜任各种内容管理系统的角色。而 Custom Post Types 和 Custom Taxonomies 正是实现这种扩展的关键。

1. 理解 Custom Post Types 和 Custom Taxonomies 的核心概念

在深入代码之前，我们需要明确 Custom Post Types 和 Custom Taxonomies 各自的职责：

Custom Post Types (CPTs): 类似于 WordPress 默认的 post (文章) 和 page (页面)，但你可以自定义它们来表示各种类型的内容，例如 product (产品)、event (活动)、book (书籍) 等。每个 CPT 都有自己的属性和字段。
Custom Taxonomies (CTs): 类似于 WordPress 默认的 category (分类目录) 和 tag (标签)，用于对 CPTs 进行分类和组织。你可以创建 genre (流派)、location (地点)、author (作者) 等分类法。 CTs 可以是 hierarchical (分层的，如分类目录) 或 non-hierarchical (非分层的，如标签)。

简单来说，CPTs 定义了内容类型，而 CTs 定义了如何组织这些内容。

2. 注册 Custom Post Type：创建一个“书籍”类型

假设我们要创建一个 book (书籍) 类型的 CPT。我们可以使用 register_post_type() 函数来实现。

function register_book_post_type() {
  $labels = array(
    'name'               => _x( 'Books', 'post type general name', 'textdomain' ),
    'singular_name'      => _x( 'Book', 'post type singular name', 'textdomain' ),
    'menu_name'          => _x( 'Books', 'admin menu', 'textdomain' ),
    'name_admin_bar'     => _x( 'Book', 'add new on admin bar', 'textdomain' ),
    'add_new'            => _x( 'Add New', 'book', 'textdomain' ),
    'add_new_item'       => __( 'Add New Book', 'textdomain' ),
    'new_item'           => __( 'New Book', 'textdomain' ),
    'edit_item'          => __( 'Edit Book', 'textdomain' ),
    'view_item'          => __( 'View Book', 'textdomain' ),
    'all_items'          => __( 'All Books', 'textdomain' ),
    'search_items'       => __( 'Search Books', 'textdomain' ),
    'parent_item_colon'  => __( 'Parent Books:', 'textdomain' ),
    'not_found'          => __( 'No books found.', 'textdomain' ),
    'not_found_in_trash' => __( 'No books 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' => 'book' ), // URL slug
    'capability_type'    => 'post',
    'has_archive'        => true,
    'hierarchical'       => false,
    'menu_position'      => null,
    'supports'           => array( 'title', 'editor', 'author', 'thumbnail', 'excerpt', 'comments' ), // 支持的功能
    'show_in_rest'       => true // 启用 Gutenberg 编辑器 (可选)
  );

  register_post_type( 'book', $args );
}
add_action( 'init', 'register_book_post_type' );

这段代码做了以下几件事：

定义了一个名为 register_book_post_type 的函数，用于注册 CPT。
创建了一个 $labels 数组，包含书籍 CPT 的各种标签，例如名称、单数名称、菜单名称等。这些标签会显示在 WordPress 后台界面中。
创建了一个 $args 数组，包含 CPT 的各种参数，例如是否公开、是否可查询、是否显示在管理菜单中、URL slug、支持的功能等。
调用 register_post_type() 函数，传入 CPT 的名称 (这里是 'book') 和参数 ($args)，完成注册。
使用 add_action() 函数，将 register_book_post_type 函数挂载到 init 钩子上。这样，当 WordPress 初始化时，就会自动注册书籍 CPT。

3. 注册 Custom Taxonomy：创建一个“书籍流派”分类法

接下来，我们为书籍 CPT 创建一个 genre (流派) 的 CT。我们可以使用 register_taxonomy() 函数来实现。

function register_book_genre_taxonomy() {
  $labels = array(
    'name'                       => _x( 'Genres', 'taxonomy general name', 'textdomain' ),
    'singular_name'              => _x( 'Genre', 'taxonomy singular name', 'textdomain' ),
    'search_items'               => __( 'Search Genres', 'textdomain' ),
    'popular_items'              => __( 'Popular Genres', 'textdomain' ),
    'all_items'                  => __( 'All Genres', 'textdomain' ),
    'parent_item'                => __( 'Parent Genre', 'textdomain' ),
    'parent_item_colon'          => __( 'Parent Genre:', 'textdomain' ),
    'edit_item'                  => __( 'Edit Genre', 'textdomain' ),
    'update_item'                => __( 'Update Genre', 'textdomain' ),
    'add_new_item'               => __( 'Add New Genre', 'textdomain' ),
    'new_item_name'              => __( 'New Genre Name', 'textdomain' ),
    'separate_items_with_commas' => __( 'Separate genres with commas', 'textdomain' ),
    'add_or_remove_items'        => __( 'Add or remove genres', 'textdomain' ),
    'choose_from_most_used'      => __( 'Choose from the most used genres', 'textdomain' ),
    'not_found'                  => __( 'No genres found.', 'textdomain' ),
    'menu_name'                  => __( 'Genres', 'textdomain' ),
  );

  $args = array(
    'hierarchical'          => true, // 是否分层 (类似分类目录)
    'labels'                => $labels,
    'show_ui'               => true,
    'show_admin_column'     => true,
    'query_var'             => true,
    'rewrite'               => array( 'slug' => 'genre' ), // URL slug
    'show_in_rest'          => true // 启用 Gutenberg 编辑器 (可选)
  );

  register_taxonomy( 'genre', 'book', $args ); // 'genre' 是分类法的名称, 'book' 是要关联的 CPT
}
add_action( 'init', 'register_book_genre_taxonomy' );

这段代码与注册 CPT 的代码类似，主要区别在于：

使用了 register_taxonomy() 函数，而不是 register_post_type() 函数。
$args 数组中包含一些与分类法相关的参数，例如 hierarchical (是否分层)。
register_taxonomy() 函数的第三个参数指定了要将此分类法关联到的 CPT (这里是 'book')。

4. 使用 Advanced Custom Fields (ACF) 添加自定义字段

虽然 WordPress 默认支持标题、内容、作者等字段，但通常我们需要添加更多自定义字段来存储书籍的特定信息，例如 ISBN、出版社、出版年份等。 Advanced Custom Fields (ACF) 是一个流行的 WordPress 插件，可以让我们轻松地添加和管理自定义字段。

安装并激活 ACF 插件后，你可以创建一个新的“字段组”，并将其关联到 book CPT。在字段组中，你可以添加各种类型的字段，例如：

字段名称	字段类型	说明
isbn	Text	国际标准书号
publisher	Text	出版社
pub_year	Number	出版年份
pages	Number	页数
price	Number	价格
author_bio	Text Area	作者简介
cover_image	Image	封面图片

创建好字段组后，当你编辑或创建书籍时，就会看到这些自定义字段。

5. 显示 Custom Post Type 和 Custom Taxonomy 的数据

注册了 CPT、CT，并添加了自定义字段后，我们需要在前端显示这些数据。 WordPress 提供了一些方法来实现这一点：

使用主题模板： 你可以创建自定义的主题模板文件，用于显示特定 CPT 的内容。例如，你可以创建一个 single-book.php 文件，用于显示书籍的详细信息。在这个文件中，你可以使用 WordPress 的函数来获取 CPT 的标题、内容、自定义字段等数据，并将其显示在页面上。

<?php
// single-book.php
get_header();
?>

<div id="primary" class="content-area">
  <main id="main" 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><!-- .entry-header -->

        <div class="entry-content">
          <?php the_content(); ?>

          <?php
          // 获取自定义字段的值
          $isbn = get_field( 'isbn' );
          $publisher = get_field( 'publisher' );
          $pub_year = get_field( 'pub_year' );
          $pages = get_field( 'pages' );
          $price = get_field( 'price' );
          $author_bio = get_field( 'author_bio' );
          $cover_image = get_field( 'cover_image' );

          // 显示自定义字段
          if ( $isbn ) {
            echo '<p>ISBN: ' . esc_html( $isbn ) . '</p>';
          }
          if ( $publisher ) {
            echo '<p>Publisher: ' . esc_html( $publisher ) . '</p>';
          }
          if ( $pub_year ) {
            echo '<p>Year: ' . esc_html( $pub_year ) . '</p>';
          }
          if ( $pages ) {
            echo '<p>Pages: ' . esc_html( $pages ) . '</p>';
          }
          if ( $price ) {
            echo '<p>Price: $' . esc_html( $price ) . '</p>';
          }
          if($author_bio) {
              echo '<p>Author Bio: '. esc_html($author_bio) .'</p>';
          }
          if($cover_image) {
              echo '<img src="'. esc_url($cover_image['url']) .'" alt="'. esc_attr($cover_image['alt']) .'">';
          }

          // 获取并显示分类法
          $terms = get_the_terms( get_the_ID(), 'genre' );
          if ( $terms && ! is_wp_error( $terms ) ) {
            echo '<p>Genres: ';
            $term_links = array();
            foreach ( $terms as $term ) {
              $term_links[] = '<a href="' . esc_url( get_term_link( $term ) ) . '">' . esc_html( $term->name ) . '</a>';
            }
            echo implode( ', ', $term_links );
            echo '</p>';
          }
          ?>
        </div><!-- .entry-content -->

      </article><!-- #post-<?php the_ID(); ?> -->

    <?php endwhile; // End of the loop. ?>

  </main><!-- #main -->
</div><!-- #primary -->

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

使用 WordPress 查询： 你可以使用 WP_Query 类来查询 CPT 的数据，并在任何页面或模板中显示它们。例如，你可以创建一个页面，显示所有书籍的列表。

<?php
// 获取所有书籍
$args = array(
  'post_type' => 'book',
  'posts_per_page' => -1 // 显示所有书籍
);

$query = new WP_Query( $args );

if ( $query->have_posts() ) {
  echo '<ul>';
  while ( $query->have_posts() ) {
    $query->the_post();
    echo '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
  }
  echo '</ul>';
  wp_reset_postdata(); // 恢复全局 post 数据
} else {
  echo 'No books found.';
}
?>

使用 REST API： WordPress REST API 允许你通过 HTTP 请求访问 CPT 的数据。你可以使用 JavaScript 或其他编程语言来获取数据，并在前端显示它们。

6. 构建更复杂的数据模型：关联多个 Custom Post Types

除了简单的 CPT 和 CT 组合外，你还可以构建更复杂的数据模型，例如：

一对多关系： 例如，一个作者可以写多本书。你可以创建一个 author (作者) 的 CPT，并使用 ACF 的“关系”字段将作者与书籍 CPT 关联起来。
多对多关系： 例如，一本书可以有多个作者，一个作者也可以写多本书。你可以创建一个中间 CPT (例如 book_author)，用于连接书籍和作者 CPT。

示例：书籍和作者的关联

创建 author CPT: 类似于创建 book CPT，但支持的字段可能包括作者姓名、头像、个人简介等。
在 book CPT 中添加“作者”字段： 使用 ACF 的“关系”字段，选择 author CPT 作为关联对象。设置允许选择多个作者。
显示书籍的作者： 在 single-book.php 模板中，使用 get_field() 函数获取关联的作者，并显示他们的姓名和链接。

<?php
$authors = get_field( 'authors' ); // 'authors' 是关系字段的名称

if ( $authors ) {
  echo '<p>Authors: ';
  $author_links = array();
  foreach ( $authors as $author ) {
    $author_links[] = '<a href="' . get_permalink( $author->ID ) . '">' . get_the_title( $author->ID ) . '</a>';
  }
  echo implode( ', ', $author_links );
  echo '</p>';
}
?>

7. 注意事项和最佳实践

选择合适的 CPT 和 CT 名称： 使用有意义的名称，并遵循 WordPress 的命名规范。
考虑 URL 结构： 使用 rewrite 参数来控制 CPT 和 CT 的 URL slug。
使用 ACF 或其他自定义字段插件： 添加和管理自定义字段，存储 CPT 的特定信息。
优化查询性能： 避免在循环中执行数据库查询。使用 WP_Query 的缓存功能。
编写清晰的代码： 使用注释和文档，方便维护和扩展。
考虑使用插件： 有很多插件可以帮助你管理 CPT 和 CT，例如 CPT UI, Pods, Toolset Types 等。选择适合你需求的插件。
备份你的数据： 定期备份你的 WordPress 数据库，以防止数据丢失。

总结

利用 WordPress 的 Custom Post Types 和 Custom Taxonomies，可以构建复杂的数据模型，满足各种内容管理需求。

代码示例：注册一个简单的 Event CPT

function register_event_post_type() {
    $labels = array(
        'name'          => __('Events', 'textdomain'),
        'singular_name' => __('Event', 'textdomain'),
    );

    $args = array(
        'labels'       => $labels,
        'public'       => true,
        'has_archive'  => true,
        'supports'     => array('title', 'editor', 'thumbnail')
    );

    register_post_type('event', $args);
}

add_action('init', 'register_event_post_type');

代码示例：注册一个 Location Taxonomy

function register_location_taxonomy() {
    $labels = array(
        'name'              => _x( 'Locations', 'taxonomy general name' ),
        'singular_name'     => _x( 'Location', 'taxonomy singular name' ),
        'search_items'      => __( 'Search Locations' ),
        'all_items'         => __( 'All Locations' ),
        'parent_item'       => __( 'Parent Location' ),
        'parent_item_colon' => __( 'Parent Location:' ),
        'edit_item'         => __( 'Edit Location' ),
        'update_item'       => __( 'Update Location' ),
        'add_new_item'      => __( 'Add New Location' ),
        'new_item_name'     => __( 'New Location Name' ),
        'menu_name'         => __( 'Locations' ),
    );
    $args = array(
        'hierarchical'      => true, // make it hierarchical like categories
        'labels'            => $labels,
        'show_ui'           => true,
        'show_admin_column' => true,
        'query_var'         => true,
        'rewrite'           => array( 'slug' => 'location' ),
    );
    register_taxonomy( 'location', array( 'event' ), $args );
}
add_action( 'init', 'register_location_taxonomy', 0 );

利用 CPT和CT可以有效组织和管理复杂数据。

通过组合这些技术，可以将WordPress从一个简单的博客平台转变为一个功能强大的CMS，满足各种业务需求。

利用 WordPress Custom Post Types 和 Custom Taxonomies 构建复杂数据模型

发表回复 取消回复

发表回复取消回复