Уникальные шаблоны страниц в WordPress с Advanced Custom Fields

Стандартного редактора WordPress часто не хватает, когда у страниц сложная структура: портфолио с параметрами проектов, карточки товаров, страницы услуг с ценами и этапами. Здесь выручает Advanced Custom Fields (ACF), плагин для создания своих полей. Покажу, как с его помощью сделать уникальные шаблоны страниц.

Где пригодится ACF

  • Портфолио: клиент, год, стек, ссылка на проект.
  • Каталог: цена, характеристики, галерея.
  • Корпоративный сайт: блоки «Преимущества», «Команда», «Отзывы», которые редактор заполняет в форме, а не в HTML.
  • Блог с разными макетами для разных типов материалов.

Шаг 1. Установка

В админке откройте «Плагины», затем «Добавить новый», найдите Advanced Custom Fields, установите и активируйте. Бесплатной версии хватает для большинства задач. В Pro добавляются повторители, гибкое содержимое, галереи и блоки ACF.

Шаг 2. Группа полей

Откройте «ACF», затем «Группы полей» и создайте группу, например «Проект портфолио». Добавьте поля:

  • client (текст), заказчик;
  • year (число), год;
  • project_url (ссылка);
  • cover (изображение, формат возврата «Массив»).

В правилах расположения укажите, где показывать группу: например, «Тип записи равно Проект» или «Шаблон страницы равно Портфолио».

Шаг 3. Шаблон страницы

В дочерней теме создайте файл page-portfolio.php:

<?php
/* Template Name: Портфолио */
get_header();

while ( have_posts() ) : the_post(); ?>
  <article class="project">
    <h1><?php the_title(); ?></h1>

    <?php if ( $cover = get_field( 'cover' ) ) : ?>
      <img src="<?php echo esc_url( $cover['url'] ); ?>" alt="<?php echo esc_attr( $cover['alt'] ); ?>">
    <?php endif; ?>

    <ul class="project-meta">
      <li>Заказчик: <?php echo esc_html( get_field( 'client' ) ); ?></li>
      <li>Год: <?php echo esc_html( get_field( 'year' ) ); ?></li>
    </ul>

    <?php if ( $url = get_field( 'project_url' ) ) : ?>
      <a href="<?php echo esc_url( $url ); ?>">Посмотреть проект</a>
    <?php endif; ?>

    <?php the_content(); ?>
  </article>
<?php endwhile;

get_footer();

Теперь при редактировании страницы выберите шаблон «Портфолио», заполните поля, и страница соберётся по макету.

Обратите внимание на esc_html(), esc_url() и esc_attr(): выводить значения полей без экранирования нельзя. С версии ACF 6.2.5 экранирование включено даже в шорткоде, подробности в заметке об изменениях в ACF 6.2.5.

Шаг 4. Гибкие макеты

В ACF Pro есть поле «Гибкое содержимое» (Flexible Content): редактор сам собирает страницу из заранее подготовленных секций.

<?php if ( have_rows( 'sections' ) ) :
  while ( have_rows( 'sections' ) ) : the_row();
    get_template_part( 'sections/' . get_row_layout() );
  endwhile;
endif; ?>

Для каждой секции (hero, features, reviews) создайте свой файл в папке sections/. Код остаётся аккуратным, а редактор получает конструктор без лишних плагинов.

Советы

  • Делайте шаблоны в дочерней теме, чтобы обновления темы их не затёрли.
  • Храните настройки полей в JSON (папка acf-json в теме): так группы полей можно держать в git и переносить между сайтами.
  • Если поля нужны прямо в тексте, используйте шорткод, как показано в заметке о шорткодах ACF.
  • Для галерей пригодится пример динамической галереи ACF с лайтбоксом.

О конфликте Automattic и WP Engine вокруг ACF в 2024 году я писал отдельно: из-за него ставить плагин лучше с официального сайта ACF.

Источники и ссылки


Комментарии загружаются…