Після файлу style.css наступний обов'язковий файл теми WordPress – index.php. Колись я писав про нього, коли робив свою першу тему, і код тоді був відповідний: заголовки h1 для кожного запису, текст українською прямо у функціях перекладу і все в одному файлі. Відтоді я переробив не одну тему, тож розповім, як сьогодні виглядає нормальний index.php: що в ньому має бути, як працює цикл записів і навіщо розбивати шаблон на частини.
Навіщо потрібен index.php
Коли відвідувач відкриває будь-яку сторінку, WordPress шукає для неї найбільш відповідний шаблон: для окремого запису – single.php, для категорії – category.php або archive.php, для пошуку – search.php і так далі. Це називається ієрархією шаблонів. А якщо потрібного файлу в темі немає, WordPress бере index.php.
Тобто index.php – це запасний шаблон теми WordPress для всього. Тема з двох файлів, style.css і index.php, уже працює, просто всі сторінки виглядатимуть однаково. Тому index.php має вміти показати і стрічку записів, і один запис, і повідомлення, що нічого не знайдено. Які ще файли бувають у темі, я розбирав у статті як створити тему WordPress з нуля.
Мінімальний index.php
<?php get_header(); ?>
<main id="main" class="site-main">
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<?php get_template_part( 'template-parts/content' ); ?>
<?php endwhile; ?>
<?php the_posts_pagination(); ?>
<?php else : ?>
<?php get_template_part( 'template-parts/content', 'none' ); ?>
<?php endif; ?>
</main>
<?php get_footer(); ?>
Ось і весь файл. Розберімо його по шматочках.
Шапка і підвал
get_header() підключає файл header.php з початком сторінки, стилями й меню, а get_footer() – файл footer.php з підвалом. Якщо цих файлів у темі немає, сайт не впаде: WordPress підставить свою застарілу заглушку і покаже попередження. Але робити так не варто – через заглушку не працюватимуть хуки wp_head() і wp_footer(), на які покладаються плагіни.
Цикл записів
Серце файлу – цикл WordPress (The Loop). Ще до того, як WordPress відкриє шаблон, він уже знає, які записи показати на цій сторінці: останні на головній, записи категорії в категорії, результати пошуку в пошуку. Цикл просто проходить по них:
have_posts()перевіряє, чи залишилися ще записи;the_post()бере наступний запис і робить його «поточним», тож функції на кшталтthe_title()чиthe_content()всередині циклу знають, з яким записом працювати.
Скільки записів на сторінці, задається в адмінці: Налаштування → Читання → На сторінках блогу показувати не більше. Сам шаблон про це навіть не думає.
Посторінкова навігація
the_posts_pagination() після циклу виводить номери сторінок: «1 2 3 … Далі». Якщо записів менше, ніж поміщається на одну сторінку, вона просто нічого не покаже. Підписи можна змінити:
<?php
the_posts_pagination( array(
'prev_text' => __( 'Previous', 'mytheme' ),
'next_text' => __( 'Next', 'mytheme' ),
) );
?>
Частини шаблону
get_template_part( 'template-parts/content' ) підключає файл template-parts/content.php. Можна було б написати розмітку запису прямо в циклі, як я колись і робив. Але та сама картка запису знадобиться і в archive.php, і в search.php, і копіювати її в кожен файл – найкращий спосіб потім щось забути виправити. Тож розмітку запису я тримаю в окремому файлі, а шаблони сторінок лише його підключають.
Другий параметр шукає файл з дефісом: get_template_part( 'template-parts/content', 'none' ) підключить template-parts/content-none.php.
Файл template-parts/content.php
Тут розмітка одного запису. Вона однаково підходить і для стрічки, і для окремого запису:
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<?php if ( has_post_thumbnail() ) : ?>
<a class="post-thumbnail" href="<?php the_permalink(); ?>">
<?php the_post_thumbnail( 'medium_large' ); ?>
</a>
<?php endif; ?>
<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>' );
}
?>
<div class="entry-meta">
<time datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>"><?php echo esc_html( get_the_date() ); ?></time>
<?php the_category( ', ' ); ?>
<?php comments_popup_link(); ?>
</div>
</header>
<div class="entry-content">
<?php
if ( is_singular() ) {
the_content();
wp_link_pages();
} else {
the_excerpt();
}
?>
</div>
<?php edit_post_link( __( 'Edit', 'mytheme' ), '<p class="edit-link">', '</p>' ); ?>
</article>
Що тут варто знати:
- post_class() додає до запису купу корисних класів: тип запису, категорії, позначки, наявність мініатюри. Їх зручно використовувати в CSS.
- the_post_thumbnail() виводить головне зображення запису разом з атрибутами
srcsetіloading="lazy", тож браузер сам вибере потрібний розмір. Щоб у редакторі з'явилося поле для мініатюри, тема має оголосити її підтримку – про це трохи нижче. - Заголовок. На сторінці має бути лише один
h1. У стрічці записів це назва сайту чи розділу, а заголовки записів –h2з посиланням. На сторінці самого запису його назва стаєh1. Перевірку робитьis_singular(), яка повертаєtrueдля окремого запису чи сторінки. - Дата загорнута в
<time>з машинним форматом уdatetime– пошуковикам так зрозуміліше. - comments_popup_link() виводить посилання на коментарі з їхньою кількістю. Якщо коментарі для запису вимкнені, нічого не покаже.
- the_excerpt() у стрічці показує короткий уривок: або той, що ти вписав/ла в поле «Уривок», або перші 55 слів тексту. Якщо тобі більше подобається ділити текст вручну блоком «Більше», заміни його на
the_content( __( 'Continue reading', 'mytheme' ) ). - wp_link_pages() виводить номери сторінок, якщо довгий запис розбитий на кілька частин блоком «Розрив сторінки».
- edit_post_link() показує посилання «Редагувати» лише тим, хто має право редагувати запис.
Зверни увагу на esc_url(), esc_attr() і esc_html(). Це екранування: усе, що потрапляє в HTML з бази даних, варто пропускати через них, щоб випадковий символ у даних не зламав розмітку, а зловмисник не вставив свій скрипт.
І ще про тексти. Підписи на кшталт __( 'Edit', 'mytheme' ) я пишу англійською з назвою теми другим параметром, а українською їх робить файл перекладу. Колись я вписував українські слова прямо в код, і тему потім неможливо було перекласти. Як зробити правильно, я розписав у статті як підготувати шаблон WordPress для перекладу.
Файл template-parts/content-none.php
Цей файл показується, коли записів немає: сайт щойно створений або пошук нічого не знайшов.
<section class="no-results">
<h1 class="page-title"><?php esc_html_e( 'Nothing found', 'mytheme' ); ?></h1>
<?php if ( is_home() && current_user_can( 'publish_posts' ) ) : ?>
<p>
<a href="<?php echo esc_url( admin_url( 'post-new.php' ) ); ?>">
<?php esc_html_e( 'Publish your first post', 'mytheme' ); ?>
</a>
</p>
<?php else : ?>
<p><?php esc_html_e( 'Nothing matched your request. Try searching.', 'mytheme' ); ?></p>
<?php get_search_form(); ?>
<?php endif; ?>
</section>
Автор сайту на порожній головній побачить посилання на створення першого запису, а відвідувач – повідомлення і форму пошуку. esc_html_e() – це переклад і екранування одразу з виведенням на екран. Як налаштувати саму форму пошуку і сторінку результатів, читай у статті форма та результати пошуку.
Що додати у functions.php
Щоб мініатюри запрацювали, а заголовок вкладки браузера WordPress формував сам, тема має про це сказати:
function mytheme_setup() {
add_theme_support( 'title-tag' );
add_theme_support( 'post-thumbnails' );
}
add_action( 'after_setup_theme', 'mytheme_setup' );
Що ще варто покласти в цей файл, я детально розібрав у статті про файл functions.php.
А як же блокові теми?
У блокових темах замість index.php є templates/index.html, і зібраний він не з PHP, а з блоків, які можна редагувати прямо в редакторі сайту. Ідея та сама: це запасний шаблон, коли немає точнішого. Але класичні теми нікуди не зникли, а для своєї теми з повним контролем над кодом PHP-шаблони, як на мене, досі найзручніші.
Що далі
Коли index.php готовий, можна додавати окремі шаблони для різних сторінок. Почни з категорій – ось як зробити вигляд категорій у темі WordPress. А якщо твоя тема ще не вміє працювати з блоковим редактором, глянь, як підготувати класичну тему WordPress до Gutenberg.
А ти робиш теми з нуля чи береш готову стартову тему і переробляєш під себе? Пиши в коментарях 🙂


Прокоментувати
На сайті відображається лише твоє ім'я та коментар. Електронна пошта зберігається виключно для зв'язку з тобою за потреби та в жодному разі не передається стороннім особам.