Знайомство з умовними тегами (Conditional Tags) у WordPress

Одна із сильних відмінних сторін WordPress - це розширюваність його ядра. WordPress включає низку корисних підсистем (функції, класи, API), однією з яких є умовні теги (Conditional Tags). З їх допомогою код може функціонувати по-різному у різних ситуаціях.

І сьогодні ми познайомимося з тим, що таке умовні теги в WordPress і чому вони такі важливі.

Дивіться також:

• Знайомство з глобальними змінними у WordPress
• Використання глобальних змінних у WordPress на практиці
• Цикл WordPress — Що це таке та як його використовувати?
• Перевизначення функцій батьківської теми дочірньої на WordPress
• Куди вставляти цей код у WordPress? Загальна структура файлів теми

Отже...

Що є умовними тегами?

Згідно з WordPress Codex:

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

Простіше кажучи, щоб код використовував або змінив контент, потрібно використовувати умовні теги та сказати коду, про який тип контенту йдеться і де він має розміщуватися.

Уявіть розмову між WordPress та умовним кодом:

Код: Агов чувак! Мені потрібна допомога!
WordPress: Що там у тебе?
Код: Хочу обернути заголовки цих записів за допомогою тега DIV, але мені потрібно знати, вони знаходяться на архівній сторінці чи ні?
WordPress: TRUE
Код: Емм ... Що?
WordPress: Да кажу!
Код: Чудово дякую!

Як бачите, умовні теги є булевими операторами, які використовують ваш код для визначення, де він знаходиться під час використання оператора якщо / ще. Вони приймають тільки ІСТИНА и ПОМИЛКОВИЙтому вашому коду потрібні тільки ці два логічні значення.

Як використати умовні теги?

Умовні теги досить просто використовувати на WordPress і оскільки вони приймають лише TRUE та FALSE, їх можна використовувати в операторі if. Ось приклад того, як вони працюють:

<?php
 
if ( is_home() ) {
 
    _e( 'Welcome to my humble blog!', 'translation-domain' );
 
}
 
?>

Ми використовували умовний тег для оператора і сказали WordPress, що якщо він знаходиться на стартовій сторінці, ця частина коду відобразить вітальний текст. is_home() - Це умовний тег. Щоправда, просто?

А ось ще один приклад:

<?php
 
// $author_check is TRUE or FALSE
$author_check = is_author( 'baris-unver' );
 
if ( $author_check ) {
 
    _e( 'Barış has some really good tutorials, along with a few cheesy ones!', 'translation-domain' );
 
}
 
?>

Бачите, що ми зробили? Ми створили змінну та визначили у ній умовний тег. Таким чином, ми могли використовувати змінну для оператора if.

Сценарії для використання умовних тегів

Насправді прикладів для використання умовних тегів дуже багато. Відразу можна навести щонайменше п'ять варіантів:

1. Уявіть, що ви розробляєте плагін для соціального шарингу для WordPress і хочете зробити функцію, щоб приховати/показати віджет у записі та на сторінці. За допомогою комбінації is_single(), is_page() и is_singular() Ви створите функцію, яка перевіряє налаштування плагіна і, скажімо, приховує віджет на сторінках, але показує їх у кожному записі.
2. Допустимо, ви розробляєте тему для маленької компанії та працюєте над створенням сторінки «Новини», використовуючи мініатюри. Але ви знаєте, що в деяких записах вони не відображатимуться. В цьому випадку знадобляться has_post_thumbnail(). Якщо ви використовуєте їх, то тема, що створюється, перевірить, що в записі немає мініатюри, і виведе зображення за замовчуванням.
3. Припустимо, ви створюєте доповнення до вже існуючого популярного плагіна WordPress. Вам потрібно перевірити, що основний плагін встановлений та використовується. Тому що з вашим плагіном можуть виникнути проблеми, якщо його встановлюватиме новачок без основного плагіна. Рішення просте: за допомогою is_plugin_active() можна деактивувати функціональність вашого додаткового плагіна, а використовуючи is_plugin_inactive() - Відобразити попередження в адмінці.
4. Ви створили тему для іншого клієнта, який хоче завантажувати в записи зображення, PDF-документи, ZIP-архіви і при цьому відобразити все одразу в кожному записі. У цьому допоможе умовний тег wp_attachment_is_image().
5. Наприклад, ви розробляєте плагін для мультиавторських блогів і хочете дізнатися, що сайт більш одного автора. Це можна зробити за допомогою is_multi_author().

Висновок

Як бачите, умовні теги досить просто використовувати, при цьому вони грають практично основну роль у розробці тем і плагінів WordPress.

Джерело: code.tutsplus.com

Олексій Шевченко

редактор wpcafe

Вивчає сайтобудування з 2008 року. Практикуючий вебмайстер, який спеціалізується на створенні сайтів на WordPress. Задати питання Олексію можна на https://profiles.wordpress.org/wpthemeus/