WordPress投稿ページ（single.php）の作り方とカスタマイズ：最新の記述ルールとテンプレート階層

<?php
/**
 * The template for displaying all single posts
 *
 * @package WordPress
 * @subpackage Your_Theme_Name
 * @since 1.0.0
 */

// ヘッダーの読み込み
get_header(); ?>

<main id="primary" class="site-main">

    <?php
    /* 
     * WordPressループの開始
     * 投稿データが存在するかを確認し、存在する間は繰り返し処理を行う
     */
    if ( have_posts() ) :
        while ( have_posts() ) :
            the_post();

            // テンプレートパーツの読み込み（content-single.phpなど）
            get_template_part( 'template-parts/content', get_post_type() );

            // 投稿ナビゲーション（前後の記事へのリンク）
            the_post_navigation(
                array(
                    'prev_text' => '<span class="nav-subtitle">' . esc_html__( 'Previous:', 'textdomain' ) . '</span> <span class="nav-title">%title</span>',
                    'next_text' => '<span class="nav-subtitle">' . esc_html__( 'Next:', 'textdomain' ) . '</span> <span class="nav-title">%title</span>',
                )
            );

            // コメントテンプレートの読み込み
            if ( comments_open() || get_comments_number() ) :
                comments_template();
            endif;

        endwhile;
    endif;
    ?>

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

<?php
// サイドバーとフッターの読み込み
get_sidebar();
get_footer();

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
    <header class="entry-header">
        <?php
        // タイトルの表示。エスケープ処理を含んだ関数を使用
        if ( is_singular() ) :
            the_title( '<h1 class="entry-title">', '</h1>' );
        else :
            the_title( '<h2 class="entry-title"><a href="' . esc_url( get_permalink() ) . '">', '</a></h2>' );
        endif;
        ?>

        <div class="entry-meta">
            <span class="posted-on">
                <time datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>">
                    <?php echo esc_html( get_the_date() ); ?>
                </time>
            </span>
            <span class="byline">
                <?php echo esc_html( get_the_author() ); ?>
            </span>
        </div>
    </header>

    <div class="entry-content">
        <?php
        // コンテンツの表示。the_contentは内部で安全に処理されるため直接呼び出し可能
        the_content();
        ?>
    </div>
</article>

// single.php内での呼び出し例
get_template_part( 'template-parts/content', 'single' );

<div class="post-categories">
    <?php
    $categories = get_the_category();
    if ( ! empty( $categories ) ) {
        echo '<ul class="cat-list">';
        foreach ( $categories as $category ) {
            echo '<li><a href="' . esc_url( get_category_link( $category->term_id ) ) . '" class="cat-link">' . esc_html( $category->name ) . '</a></li>';
        }
        echo '</ul>';
    }
    ?>
</div>

<div class="post-categories">
    <ul class="cat-list">
        <li><a href="https://example.com/category/news/" class="cat-link">ニュース</a></li>
        <li><a href="https://example.com/category/tech/" class="cat-link">テクノロジー</a></li>
    </ul>
</div>

<?php
// カスタムフィールド 'sub_title' を取得
$sub_title = get_post_meta( get_the_ID(), 'sub_title', true );

if ( ! empty( $sub_title ) ) : ?>
    <p class="sub-title"><?php echo esc_html( $sub_title ); ?></p>
<?php endif; ?>

<?php
$current_post_id = get_the_ID();
$categories = get_the_category();

if ( $categories ) {
    $cat_ids = array();
    foreach ( $categories as $category ) {
        $cat_ids[] = $category->term_id;
    }

    $args = array(
        'category__in'   => $cat_ids,
        'post__not_in'   => array( $current_post_id ),
        'posts_per_page' => 3,
        'orderby'        => 'rand', // ランダムに取得
    );

    $related_query = new WP_Query( $args );

    if ( $related_query->have_posts() ) : ?>
        <section class="related-posts">
            <h2>関連記事</h2>
            <div class="related-grid">
                <?php while ( $related_query->have_posts() ) : $related_query->the_post(); ?>
                    <div class="related-item">
                        <a href="<?php the_permalink(); ?>">
                            <?php if ( has_post_thumbnail() ) : ?>
                                <?php the_post_thumbnail( 'medium' ); ?>
                            <?php endif; ?>
                            <h3><?php the_title(); ?></h3>
                        </a>
                    </div>
                <?php endwhile; ?>
            </div>
        </section>
    <?php
    endif;
    wp_reset_postdata(); // 投稿データをリセット
}

<?php
// PHPテンプレート内で特定のブロックパターンを呼び出す例
if ( function_exists( 'register_block_pattern' ) ) {
    echo do_blocks( '<!-- wp:pattern {"slug":"my-theme/post-footer-cta"} /-->' );
}
?>

<?php
// アイキャッチ画像の表示（LCP対策としてfetchpriority属性を検討）
if ( has_post_thumbnail() ) {
    the_post_thumbnail( 'full', array(
        'fetchpriority' => 'high',
        'loading'       => 'eager',
        'alt'           => the_title_attribute( array( 'echo' => false ) ),
    ) );
}
?>

// functions.phpなどでの記述例
function my_theme_enqueue_post_scripts() {
    if ( is_single() ) {
        wp_enqueue_script( 'post-specific-script', get_template_directory_uri() . '/js/post.js', array(), '1.0', true );
    }
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_post_scripts' );