is_post_type_archive() WP 3.1.0
Проверяет находится ли пользователь на архивной странице записей произвольного типа.
Страницей архива произвольного типа считается страница, на которой выводятся записи нового типа (/?post_type=custom). Если, например, новый тип записей называется 'book', то такая страница будет иметь URL: http://example.com/book/
(может отличаться, зависит от настроек ЧПУ).
Функция возвращает false
для страниц типа /category/uncategorized/?post_type=custom
. true возвращается только для страниц типа /?post_type=custom
. Другими словами функция не проверяет наличие параметра post_type в запросе, она проверяет архив ли это записей произвольного типа. Возможно в качестве альтернативы нужно использовать get_query_var('post_type').
Функция также срабатывает в адмнике на странице с таблицей записей.
Хуков нет.
Возвращает
true/false. Если это архивная страница на которой отображаются записи произвольного типа, то функция вернет true, иначе false.
Использование
if( is_post_type_archive( $post_types ) ){ // ... }
- $post_types(строка/массив)
- Название типа поста или массив из названий типов постов.
По умолчанию: ''
Примеры
#1 Страница архива нового типа поста
Этот пример показывает, как определить является ли текущая страница страницей архива произвольно типа поста. Выведем заголовок нового типа поста.
if ( is_post_type_archive() ) { ?> <h1><?php post_type_archive_title(); ?></h1> <?php }
Заметки
- Global. WP_Query. $wp_query WordPress Query object.
Список изменений
С версии 3.1.0 | Введена. |
Код is_post_type_archive() is post type archive WP 5.6
function is_post_type_archive( $post_types = '' ) {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
return false;
}
return $wp_query->is_post_type_archive( $post_types );
}Cвязанные функции
Из метки: archive (архивы записей)
Еще из метки: Условные теги (типов страниц и запросов)
- is_404()
- is_admin()
- is_attachment()
- is_author()
- is_blog_admin()
- is_category()
- is_comment_feed()
- is_customize_preview()
- is_date()
- is_day()
- is_embed()
Еще из метки: Условные теги (все)
- cat_is_ancestor_of()
- comments_open()
- email_exists()
- has_block()
- has_category()
- has_custom_header()
- has_excerpt()
- has_nav_menu()
- has_post_thumbnail()
- has_shortcode()
- has_tag()
- has_term()
- have_comments()
- have_posts()
- in_category()
- in_the_loop()
Еще из раздела: Типы записей
Еще из тегов шаблона: Основные
- bloginfo()
- calendar_week_mod()
- get_archives_link()
- get_bloginfo()
- get_calendar()
- get_current_blog_id()
- get_footer()
- get_header()
- get_search_form()
- get_sidebar()