Функция is_single()
в WordPress используется для проверки того, находится ли пользователь на странице одного поста (одиночной записи). Это может быть полезно, когда вам нужно выполнить определенные действия только на страницах одиночных записей.
is_single($post = '')
$post
(необязательный) — это идентификатор поста, название или массив идентификаторов и названий, которые вы хотите проверить. Если аргумент не задан, функция проверяет, находится ли текущая страница на одиночной записи.
Пример: Проверка на одиночную запись
Самый простой пример использования is_single()
— это проверка, является ли текущая страница одиночной записью.
if ( is_single() ) {
// Ваш код для одиночных записей
echo 'Это страница одиночной записи.';
}
Пример 2: Проверка конкретного поста по его ID
Вы можете проверить, является ли текущая страница конкретной записью, указав её ID.
if ( is_single( 42 ) ) {
// Ваш код для поста с ID 42
echo 'Это страница поста с ID 42.';
}
Пример 3: Проверка конкретного поста по его названию (slug)
Аналогично можно использовать название (slug) поста для проверки.
if ( is_single( 'my-first-post' ) ) {
// Ваш код для поста с названием "my-first-post"
echo 'Это страница поста со слагом "my-first-post".';
}
Пример 4: Проверка нескольких постов по их ID или названию
Вы также можете проверить несколько постов, передав массив значений.
if ( is_single( array( 42, 'my-first-post', 'another-post' ) ) ) {
// Ваш код для постов с ID 42, названием "my-first-post" или "another-post"
echo 'Это страница одного из указанных постов.';
}
Пример 5: Использование в шаблонных файлах
Часто is_single()
используется в шаблонных файлах, чтобы выводить специфический контент для одиночных записей. (В WordPress для одиночной записи можно использовать персональный шаблон, создайте файл single.php
и он автоматически будет использован как основной для одиночной записи типа пост. Однако можно обойтись и без этого файла и в главном файле index.php
просто добавить проверку и выводить контент одиночного поста.
<?php get_header(); ?>
<?php if ( is_single() ) : ?>
<?php //Шаблон для одиночной записи ?>
<?php while ( have_posts() ) : the_post(); ?>
<h1><?php the_title(); ?></h1>
<div><?php the_content(); ?></div>
<?php endwhile; ?>
<?php else : ?>
<?php //Шаблон по умолчанию для листинга постов. ?>
<?php endif; ?>
<?php get_footer(); ?>
Заключение
Функция is_single()
является мощным инструментом в арсенале разработчика WordPress, позволяя легко управлять отображением контента на страницах одиночных записей. С помощью примеров, приведенных выше, вы сможете эффективно использовать эту функцию в своих проектах.