Умовні теги у WordPress

У цій статті я постараюся зрозуміло пояснити що таке «умовні теги в WordPress» (Conditional Tags). Повний список умовних тегів дивіться на цій сторінці .

Умовні теги так називаються, тому що, сюрприз-сюрприз, перевіряють чи виконується якась умова. Насправді умовні теги — це допоміжні PHP функції WordPress. А називають їх «тегами», щоб виділити з-поміж інших PHP функцій.

Здебільшого умовні теги створені для зручного виконання перевірок різних умов, наприклад: чи ми знаходимося на головній сторінці сайту, чи авторизований користувач і т.д.

Характеристики умовних тегів у WordPress:

• Кожен із тегів створений для перевірки певної умови . Грубо кажучи будь-яку функцію, що починається з is_можна назвати умовним тегом.

• Деякі умовні теги можуть приймати параметри . Наприклад, is_page( 20 ) – перевіряє ID поточної сторінки. Якщо ID дорівнює 20, то умова виконується (тег спрацьовує).

• Будь-який умовний тег повертає логічне значення : true чи false (правда чи брехня). На основі цієї відповіді можна щось робити чи не робити.

Приклад використання Умовних тегів

Припустимо, нам потрібно вивести посилання в підвалі і зробити це потрібно тільки на головній сторінці сайту. Для цього в WordPress є умовний тег is_home() . Ці функції повернуть true, лише в тому випадку, якщо сторінка, на якій знаходиться відвідувач, – це головна сторінка. У коді це виглядає так:

<?php
if( is_front_page() ){
	echo '<a href="http://example.com">Текст посилання</a>';
}
?>

Список Умовних тегів WordPress

• is_home() (основна сторінка)
  
  
  
• is_front_page() (головна сторінка)
  
  
  
• is_single() (Сторінка окремого запису (поста))
  
  
  
• is_page() (сторінка Постійної сторінки)
  
  
  
• is_page_template() (шаблон сторінки)
  
  
  
• is_singular() (будь-яка одиночна сторінка)
  
  
  
• is_year() (архів за рік)
  
  
  
• is_month() (архів за місяць)
  
  
  
• is_day() (архів за день)
  
  
  
• is_time() (архів за часом)
  
  
  
• is_date() (сторінка будь-якого типу дати)
  
  
  
• is_author() (сторінка автора)
  
  
  
• is_archive() (будь-яка сторінка архіву)
  
  
  
• is_post_type_archive() (сторінка архіву типу запису)
  
  
  
• is_paged() (сторінки пагінації)
  
  
  
• is_category() (сторінка категорії)
  
  
  
• cat_is_ancestor_of() (чи є одна рубрика дочірньої до іншої)
  
  
  
• is_tag() (сторінка мітки)
  
  
  
• is_tax() (сторінка будь-якої таксономії)
  
  
  
• is_search() (сторінка пошуку)
  
  
  
• is_404() (сторінка 404)
  
  
  
• is_attachment() (сторінка вкладення)
  
  
  
• is_admin() (сторінка адмінки)
  
  
  
• is_user_logged_in() (користувач авторизований)
  
  
  
• current_user_can(‘право’) (перевіряє право користувача)
  
  
  
• have_posts() (є записи для виведення)
  
  
  
• has_tag() (у поста є мітки)
  
  
  
• in_category( 10 ) (запис знаходиться в категорії 10)
  
  
  
• have_comments() (у поста є коментарі)
  
  
  
• pings_open() (відкриті повідомлення)
  
  
  
• $wp_query->query_vars[cpage] (сторінка пагінації коментарів)
  
  
• $post->post_excerpt (у поста є “Цитата”)
  
  
• $post->post_parent == 20 (ID батьківської сторінки дорівнює 20)