Руководство по условным тегам WordPress: Вступление

Одной из самых важных особенностей WordPress будет расширяемость ядра. При помощи плагинов и тем посетители WordPress почти десять лет создают собственные уникальные веб-сайты.(WordPress впервые был представлен в 2003 году, но плагины были введены в 2004 году, а темы появились в 2005).

И для создания надежной инфраструктуры WordPress содержит несколько вспомогательных подсистем(возможностей, классов или целых API). Одной из них являются «Условные теги«, которые определяют разное действие кода в зависимости от конкретной ситуации.

В данной серии статей мы рассмотрим условные теги. И начнем с их определения и рассмотрения того, почему они настолько важны. А в следующих частях мы рассмотрим сами условные теги с описаниями и конкретными примерами.

Давайте приступим!

Что такое Условные теги?

В Кодексе WordPress дается следующее определение условных тегов:

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

Это дает нам общее представление: чтобы код добавлял или изменял контент, используются условные теги, чтобы указать для кода тип, состояние и место размещения содержимого.

Представьте себе, что программный код ведет такую беседу с WordPress: Программный код: Эй, дружище, мне нужна помощь. WordPress: Конечно, я весь во внимании. Что тебе необходимо? Код: Я хочу обернуть данные заголовки записей в определенные DIV, но мне необходимо знать, отображаются ли они в данный момент на странице архива категории или нет. Они отображаются на странице архива категории? WordPress: TRUE Код: Э… Чего? WordPress: Я имею в виду, да. Код: Здорово! Спасибо! WordPress: Всего наилучшего!

Как-то так, в целом. Условные теги — это логические операторы, которые направляют код в нужное русло, когда данные теги встречаются внутри оператора if/else. Они возвращают только значения TRUE или FALSE, и коду нужны только данные два логических значения.

Как использовать условные теги

Хотя условные теги — это довольно важная часть системы WordPress, они удивительно просты в использовании. Поскольку они возвращают только TRUE или FALSE, вы без лишних проблем можете легко использовать их внутри оператора if(Фактически, существуют три отдельных условных тега, которые возвращают FALSE или определенное значение. Мы вернемся к ним в следующих частях, но их вы тоже можете легко использовать в операторе if.)

Давайте рассмотрим простой пример того, как работает условный тег:

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

Мы использовали условный тег в операторе if и указали WordPress, что, если это домашняя страница, то должен отображаться текст приветствия.

Давайте рассмотрим ещё один пример, с «более чистым» кодом:

<?php// $author_check это TRUE или 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 разных условных тегов: с описаниями, примерами использования некоторых из них.

Продолжение в следующей части!

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *