Одна из самых важных сильных сторон WordPress — расширяемость ядра. Благодаря плагинам и темам пользователи WordPress могут создавать свои веб-сайты в течение почти десятилетия. (WordPress был впервые выпущен в 2003 году, но плагины были введены в 2004 году, а темы были представлены в 2005 году.) И для создания такой надежной инфраструктуры WordPress включает в себя множество удобных подсистем (функций, классов или целых API). Одним из них являются «Условные теги», которые позволяют нашему коду функционировать по-разному в конкретных ситуациях.
В этой серии мы узнаем об этих условных тегах. Мы собираемся начать с определения и важности условных тегов в этом посте. В следующих частях мы рассмотрим условные теги с описанием и некоторыми примерами.
Давайте начнем!
Что такое условные теги?
В Кодексе условные теги описываются так:
Условные теги можно использовать в файлах шаблонов, чтобы изменить отображаемое содержимое и способ отображения этого содержимого на конкретной странице в зависимости от того, каким условиям соответствует эта страница.
Вы получаете идею: чтобы ваш код использовал и / или изменил содержимое, вы используете условные теги и сообщаете своему коду тип, состояние и место содержимого. Представьте, что ваш код и WordPress разговаривают:
- Ваш код: Эй, парень, мне нужна помощь.
- WordPress: Конечно, у меня все уши. Что вам нужно?
- Ваш код: я собираюсь обернуть эти заголовки постов некоторыми DIV, но мне нужно знать, находятся ли они на странице архива категории. Это на странице архива категории?
-
WordPress:
TRUE - Твой код: Хм … Что?
- WordPress: я имею в виду да.
- Ваш код: это здорово, спасибо!
- WordPress: Пока!
Короче говоря, условные теги — это логические операторы, которые управляют вашим кодом, чтобы понять, где он находится, когда он используется внутри оператора if/else . Они только возвращают TRUE или FALSE , и вашему коду нужны только эти два логических значения.
Как использовать условные теги
Хотя условные теги являются довольно важной частью разработки WordPress, их использование поразительно просто. Так как они возвращают только TRUE или FALSE , вы можете использовать их внутри операторов if без каких-либо хлопот. (На самом деле есть три исключительных условных тега, которые возвращают FALSE или значение, и мы перейдем к ним в следующих частях, но вы также можете использовать их в операторах if .)
Давайте кратко рассмотрим пример работы условного тега:
|
1
2
3
4
5
6
7
8
9
|
<?php
if ( is_home() ) {
_e( ‘Welcome to my humble blog!’, ‘translation-domain’ );
}
?>
|
Возьми? Мы использовали условный тег для оператора if и сказали WordPress, что если это домашняя страница, этот фрагмент кода будет повторять — довольно скучный — приветственный текст. Это действительно не так уж важно.
Давайте рассмотрим другой пример с более «чистым» кодом:
|
01
02
03
04
05
06
07
08
09
10
11
12
|
<?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 . Кусок пирога!
Примеры сценариев использования условных тегов
Поверьте мне, когда я говорю, что есть неограниченное количество случаев использования условных тегов Вдобавок ко всему, я могу дать вам пять сценариев, в которых вы можете использовать условные теги:
- Представьте, что вы разрабатываете плагин для обмена социальными сетями для WordPress и хотите, чтобы ваши пользователи могли показывать и скрывать виджет под постами и страницами. Используя комбинацию
is_single(),is_page()иis_singular(), вы можете создать функцию, которая проверяет настройки плагинов пользователя и, скажем, скрывает виджет на страницах, но показывает их под каждым сообщением. - Допустим, вы разрабатываете тему для небольшой компании. Вы работаете над страницей «Новости» (часть темы «блог») и создали гладкий список публикаций с миниатюрами … но вы знаете, что они забудут или решат не использовать миниатюру для некоторых сообщений. Вот где
has_post_thumbnail()пригодится: используйте его, и ваша тема проверит, нет ли в сообщении миниатюры, и покажет изображение по умолчанию. - Предположим, вы создаете дополнительный плагин для популярного плагина WordPress. Вы должны обнаружить, что основной плагин установлен и используется, потому что ваш плагин может вызвать проблемы, если начинающий пользователь устанавливает его без использования основного плагина. Решение простое: с помощью
is_plugin_active()вы можете отключить функциональность вашего плагина, а с помощьюis_plugin_inactive()вы можете отобразить предупреждение в админке. - Вы создали тему для другого клиента, и они хотят загружать изображения, документы PDF и ZIP-архивы в свои сообщения, но они также хотят отображать все изображения под каждым сообщением. Простое использование условного тега
wp_attachment_is_image()позволит вам выбрать изображения и показать их под сообщениями. - Допустим, вы создаете плагин для блогов с несколькими авторами и хотите определить, есть ли на сайте пользователя более одного автора. Условный тег
is_multi_author()дает вам ответ.
Вывод
Как вы можете видеть, условные теги — это одна из самых простых функций WordPress, но также и одна из самых важных частей разработки тем и плагинов.
Цель этой серии — представить условные теги, и мы только начинаем. В следующих пяти статьях мы рассмотрим 65 различных условных тегов с описаниями, случаями использования и примерами некоторых из них.
Увидимся в следующей части!