WordPress functions.php

お知らせ・スタッフ紹介・制作実績・キャンペーンなど、ふつうの「投稿」とは分けて記事を管理したいときに、カスタム投稿を使います。

下のコードは「フォトギャラリー」という投稿の種類と、その専用のカテゴリーを足します。使っているテーマの functions.php（子テーマがあれば子テーマのほう）のいちばん下に足します。

/**
 * カスタム投稿「フォトギャラリー」と、その専用のカテゴリーを足す
 */
function fs_register_photo_post_type() {
	register_post_type( 'photo', array(
		'labels'        => array(
			'name'          => 'フォトギャラリー',
			'singular_name' => 'フォト',
			'add_new_item'  => 'フォトを追加',
			'edit_item'     => 'フォトを編集',
		),
		'public'        => true,
		'show_in_rest'  => true,   // ブロックエディターを使う・REST API に出す
		'menu_position' => 5,      // 管理画面のメニューで「投稿」の下
		'menu_icon'     => 'dashicons-format-gallery',
		'has_archive'   => true,   // 一覧のページ（/photo/）を作る
		'rewrite'       => array( 'slug' => 'photo', 'with_front' => false ),
		'supports'      => array( 'title', 'editor', 'thumbnail', 'revisions' ),
	) );

	register_taxonomy( 'photo_cat', 'photo', array(
		'labels'            => array(
			'name'          => 'フォトのカテゴリー',
			'singular_name' => 'カテゴリー',
		),
		'hierarchical'      => true,   // 「カテゴリー」と同じ親子のある形
		'show_in_rest'      => true,   // ブロックエディターの横に出す
		'show_admin_column' => true,   // 一覧の表にカテゴリーの列を出す
		'rewrite'           => array( 'slug' => 'photo-cat', 'with_front' => false ),
	) );
}
add_action( 'init', 'fs_register_photo_post_type' );

前の書き方との違い

管理画面のメニューに「フォトギャラリー」が出て、記事を書けるようになれば、管理画面の側はできあがりです。

パーマリンクの更新を忘れない

コードを足しただけでは、/photo/ などの URL が「ページが見つかりません」（404）になります。WordPress は URL の決まり（リライトルール）を DB に覚えていて、新しい投稿の種類の分が、まだ入っていないからです。

管理画面の「設定」→「パーマリンク」を開くと、決まりが作り直されます（「変更を保存」を押さなくても、開くだけでよい）。コードの中で flush_rewrite_rules() を毎回呼ぶと重くなるので、書かないでください。

確かめた結果

このサイトの作業環境（WordPress 7.1.3・PHP 8.3）で、コードをメモリの中だけで登録して確かめました。下書きの試しの記事とカテゴリーを作り、確かめたあと消しました。サイトのパーマリンクの決まりは作り直していません。

このサイトは Classic Editor のプラグインを使っているので、show_in_rest を true にしても、古いエディターのままでした。ブロックエディターを使っているサイトなら、ブロックエディターで書けます。

WordPress は、表示する記事の種類に合わせて、テーマの中のファイルを決まった順に探します。single-photo.php がなければ、ふつうの投稿と同じ single.php で表示されます。

レイアウトをそのまま使いたいなら、テーマの single.php をコピーして single-photo.php という名前にするのがおすすめです。子テーマがあれば子テーマに置きます

<?php get_header(); ?>

<?php while ( have_posts() ) : the_post(); ?>
<article <?php post_class( 'photo-single' ); ?>>
	<?php if ( has_post_thumbnail() ) : ?>
		<div class="photo-image"><?php the_post_thumbnail( 'full' ); ?></div>
	<?php endif; ?>

	<h1 class="photo-title"><?php the_title(); ?></h1>
	<time class="photo-date" datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>"><?php echo esc_html( get_the_date( 'Y.m.d' ) ); ?></time>

	<?php // カテゴリー（いくつあっても全部・一覧へのリンクつき） ?>
	<?php the_terms( get_the_ID(), 'photo_cat', '<div class="photo-cat">', '、', '</div>' ); ?>

	<div class="photo-content"><?php the_content(); ?></div>
</article>
<?php endwhile; ?>

<?php get_footer(); ?>

前のコードは、カテゴリーの 1 つ目の名前を、そのまま（esc_html() を通さずに）出していました。the_terms() を使うと、名前のエスケープもリンクも WordPress がしてくれます。

新しくページを作るときは、上の形をもとにして、テーマのレイアウト（ヘッダー・サイドバーなどの枠）に合わせてください。

一覧のページは、has_archive => true のときだけ作られます。探す順は 1 件ずつのページと同じ考え方です。

テーマに archive.php などの一覧のファイルがあれば、コピーして archive-photo.php を作るのがおすすめです

<?php get_header(); ?>

<h1 class="photo-archive-title"><?php post_type_archive_title(); ?></h1>

<?php if ( have_posts() ) : ?>
<ul class="photo-list">
	<?php while ( have_posts() ) : the_post(); ?>
	<li>
		<a href="<?php the_permalink(); ?>">
			<?php the_post_thumbnail( 'thumbnail' ); ?>
			<?php
			// カテゴリーは名前だけ（a の中に a を入れない）
			$terms = get_the_terms( get_the_ID(), 'photo_cat' );
			if ( $terms && ! is_wp_error( $terms ) ) {
				echo '<span class="photo-cat">' . esc_html( $terms[0]->name ) . '</span>';
			}
			?>
			<span class="photo-title"><?php echo esc_html( wp_trim_words( get_the_title(), 30, '…' ) ); ?></span>
			<time datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>"><?php echo esc_html( get_the_date( 'Y.m.d' ) ); ?></time>
			<span class="photo-excerpt"><?php echo esc_html( wp_trim_words( get_the_excerpt(), 60, '…' ) ); ?></span>
		</a>
	</li>
	<?php endwhile; ?>
</ul>

<?php
the_posts_pagination( array(
	'mid_size'  => 2,
	'prev_text' => '前へ',
	'next_text' => '次へ',
) );
?>

<?php else : ?>
<p>まだ記事がありません。</p>
<?php endif; ?>

<?php get_footer(); ?>

前の書き方との違い

一覧の件数を変える

1 ページに出す件数は「設定」→「表示設定」の値（このサイトでは 10 件）になります。フォトの一覧だけ変えたいときは、テンプレートではなく functions.php で変えます。

/**
 * フォトの一覧だけ、1 ページに 12 件ずつ出す
 */
function fs_photo_archive_per_page( $query ) {
	if ( is_admin() || ! $query->is_main_query() ) {
		return;
	}
	if ( $query->is_post_type_archive( 'photo' ) || $query->is_tax( 'photo_cat' ) ) {
		$query->set( 'posts_per_page', 12 );
	}
}
add_action( 'pre_get_posts', 'fs_photo_archive_per_page' );