Файл single.php: как настроить вывод отдельной записи в WordPress

Расширенные примеры использования single.php

Пример 1. single.php для произвольного типа записи «portfolio» с таксономиями и ACF

В этом примере выводятся данные портфолио: изображение проекта, описание, клиент (поле ACF) и список технологий (таксономия).

<?php
/* single-portfolio.php */
get_header();
while ( have_posts() ) : the_post();
  $client = get_field( 'client' );
  $url    = get_field( 'project_url' );
?>
  <article id="post-<?php the_ID(); ?>" <?php post_class( 'portfolio-item' ); ?>>
    <?php the_post_thumbnail( 'portfolio-full' ); ?>
    <h2 class="portfolio-title"><?php the_title(); ?></h2>
    <div class="portfolio-meta">
      <?php if ( $client ) : ?>
        <span class="client">Клиент: <?php echo esc_html( $client ); ?></span>
      <?php endif; ?>
      <?php
      $techs = get_the_term_list( get_the_ID(), 'technology', 'Технологии: ', ', ' );
      if ( $techs ) : ?>
        <span class="technologies"><?php echo $techs; ?></span>
      <?php endif; ?>
    </div>
    <div class="portfolio-content"><?php the_content(); ?></div>
    <?php if ( $url ) : ?>
      <a href="<?php echo esc_url( $url ); ?>" class="btn" target="_blank">Открыть проект</a>
    <?php endif; ?>
  </article>
<?php endwhile;
get_footer();
?>

Результат: страница отдельного проекта портфолио с изображением, описанием, клиентом, технологиями и ссылкой. Файл single-portfolio.php автоматически используется для записей типа «portfolio» благодаря иерархии шаблонов.

Пример 2. Пагинация для записей, разбитых на части (nextpage)

Если запись содержит тег <!--nextpage-->, WordPress делит её на несколько страниц. Для корректной навигации используйте wp_link_pages() внутри цикла.

<?php the_content(); ?>
<?php
wp_link_pages( array(
  'before'      => '<div class="page-links">' . esc_html__( 'Страницы:', 'textdomain' ),
  'after'       => '</div>',
  'link_before' => '<span class="page-number">',
  'link_after'  => '</span>',
  'pagelink'    => '%',
) );
?>

Результат: под контентом появляются ссылки вида «Страницы: 1 2 3». По умолчанию wp_link_pages() выводит только номера страниц. Для более сложной навигации (предыдущая/следующая) добавьте аргумент 'next_or_number' => 'both'.

Пример 3. Динамическая подгрузка похожих записей через WP_Query

После основного цикла можно вывести блок «Похожие записи», выбрав записи из тех же рубрик.

<?php
$categories = wp_get_post_categories( get_the_ID() );
if ( $categories ) {
  $args = array(
    'category__in'   => $categories,
    'post__not_in'   => array( get_the_ID() ),
    'posts_per_page' => 3,
    'orderby'        => 'rand',
  );
  $related = new WP_Query( $args );
  if ( $related->have_posts() ) : ?>
    <h3>Похожие записи</h3>
    <ul>
      <?php while ( $related->have_posts() ) : $related->the_post(); ?>
        <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
      <?php endwhile; ?>
    </ul>
  <?php endif;
  wp_reset_postdata();
}
?>

Результат: внизу страницы отображается блок из трёх случайных записей из тех же категорий. Важно: вызов wp_reset_postdata() восстанавливает глобальный объект $post, иначе последующий код может работать неправильно.

Пример 4. Создание собственного шаблона через фильтр template_include

Иногда нужно подменить файл single.php на лету, например, для записей с определённым ID или значением произвольного поля.

// functions.php
add_filter( 'template_include', 'my_custom_single_template' );
function my_custom_single_template( $template ) {
  if ( is_single() && get_post_meta( get_the_ID(), '_featured', true ) == 'yes' ) {
    $new_template = locate_template( array( 'single-featured.php' ) );
    if ( $new_template ) {
      return $new_template;
    }
  }
  return $template;
}

Теперь для записей с мета-полем _featured = yes будет использоваться файл single-featured.php. Это даёт гибкость без изменения иерархии шаблонов.

Пример 5. Интеграция Schema.org разметки в single.php

Для SEO можно добавить микроразметку Article. Обёртка с атрибутами itemscope и itemtype.

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?> itemscope itemtype="http://schema.org/Article">
  <meta itemprop="mainEntityOfPage" content="<?php the_permalink(); ?>" />
  <span itemprop="author" itemscope itemtype="http://schema.org/Person">
    <meta itemprop="name" content="<?php echo esc_attr( get_the_author() ); ?>" />
  </span>
  <meta itemprop="datePublished" content="<?php echo get_the_date( 'c' ); ?>" />
  <meta itemprop="dateModified" content="<?php echo get_the_modified_date( 'c' ); ?>" />
  <div itemprop="image" itemscope itemtype="http://schema.org/ImageObject">
    <?php the_post_thumbnail( 'large', array( 'itemprop' => 'url' ) ); ?>
  </div>
  <div itemprop="articleBody"><?php the_content(); ?></div>
</article>

Результат: страница записи содержит структурированные данные, которые помогают поисковым системам лучше понимать контент. Проверить разметку можно через тестер Google Rich Results.