Изучаем теги шаблонов: введение

WordPress – это многофункциональная система управления контентом, обладающая гибкостью и расширяемостью. Если продукт расширяем, то люди смогут сделать вклад в его развитие, что приводит к рождению целого сообщества, готового помочь развитию проекта.

Это как замкнутый круг, в котором хороший продукт создает вокруг себя сообщество энтузиастов, желающих сделать этот продукт ещё лучше, и так платформа WordPress стала самой популярной CMS в мире.

Сегодня мы открываем новую серию статей, посвященных одному из основополагающих компонентов WordPress: тегам шаблонов.

Что такое теги шаблонов(template tags)?

Два основных свойства, отражающих гибкость платформы WordPress – это функция создавать «плагины»(для расширения функционала) и «темы оформления»(для изменения внешнего вида). Данные свойства являются результатом успешной реализации ключевых концепций WordPress: API и подсистем. Теги шаблонов являются одной из основ построения всей системы CMS.

Теги шаблонов появились ещё задолго до самого WordPress. Он был представлен в b2 — платформе для ведения блогов, которую Мэтт Мулленвег и Майк Литтл слегка модернизировали при создании WordPress. Можно сказать, что это одна из первых возможностей, реализованная ещё до поддержки в W P тем и плагинов.

В Кодексе WordPress, теги шаблонов описаны следующим образом: «Теги шаблонов используются в шаблонах блога для динамического вывода информации или параметра веб-сайта, предоставляя для этого инструменты и позволяя сделать его более индивидуальным и интересным».

Теги шаблонов – это PHP -функции, которые поручают WordPress «сделать» или «приобрести» что-нибудь. И поверьте, в этом нет ничего сложного, если вы знакомы с основами PHP и HTML.

Где находятся теги шаблонов?

Файлы, в которых хранятся возможности для всех тегов шаблонов, находятся в папке wp-includes.

Всего существует 9 разных файлов с окончанием template:

  • wp-includes/author-template.php — содержит теги шаблонов, связанные с автором;
  • wp-includes/bookmark-template.php — содержит теги шаблонов, связанные с закладками;
  • wp-includes/category-template.php — содержит теги шаблонов, связанные с таксономией и терминами, включая рубрики и теги;
  • wp-includes/comment-template.php — содержит теги шаблонов, связанные с комментариями;
  • wp-includes/link-template.php — содержит теги шаблонов, связанные со ссылками(постоянные ссылки, ссылки на прикрепленные файлы, ссылки на архивы и т.д.);
  • wp-includes/nav-menu-template.php — содержит теги шаблонов, связанные с меню навигации;
  • wp-includes/post-template.php — содержит теги шаблонов, связанные с записями/публикациями;
  • wp-includes/post-thumbnail-template.php — содержит теги шаблонов, связанные с миниатюрами записей;
  • wp-includes/general-template.php — содержит все остальные теги шаблонов.

Как можно использовать теги шаблонов?

Вам будет несложно понять принцип работы шаблонных тегов, если вы знакомы с основами PHP, HTML и CSS. Поскольку теги шаблонов представляют собой не что другое, как PHP -функции, то вполне понятно, как ими пользоваться. Но вам следует знать о них кое-что ещё.

Возможности шаблонных тегов

Кроме тегов вставки( Include Tags) и условных тэгов( Conditional Tags), возможности тегов шаблона можно без проблем разделить на две группы: те, что «отображают», и те, что «возвращают». Данные два типа возможностей формируют основу тегов шаблона и могут создавать новые темы оформления.

Выявить «возвращающие» теги можно легко по их названиям – в них перед именем возможности используется приставка get_. Хоть они и выглядят как производное от обычных возможностей, но все же несут в себе уникальный программный код и возвращают результат. Теги шаблонов, которые отображают информацию, обычно привязываются к get_ возможностям. Давайте взглянем на исходный код возможности the_ID():

<?phpfunction the_ID() { echo get_the_ID();}?>

Существуют возможности, которым можно задавать логический $echo -параметр. Например, функцию будет отображать информацию при установленном настройке TRUE, и возвращать значение при настройке FALSE. Не беспокойтесь, если запутались, поскольку мы познакомиться с настройками всех шаблонных тегов.

Настройки возможностей шаблонных тегов

Настройки – это типы данных, которые способны изменять поведение тегов шаблона. При помощи настроек вы можете добавлять к выводимым данным префиксы и суффиксы, ограничивать объем получаемых данных, исключать определенные пункты из списков и так далее. Без знаний о доступных настройках для каждого тега шаблона, вы ограничиваетесь лишь его поведением по умолчанию.

Объявление настроек

Есть три метода объявления параметры возможности:

С помощью регулярных настроек: большинство тегов шаблона принимают регулярные PHP -параметры, которые можно без труда разделять запятыми:

<?php$my_post_meta = get_post_meta( $post->ID, 'my_post_meta', true);?>

С помощью строки запроса(Query-string): некоторые возможности принимают настройки в форме строки запроса, как показано в примере ниже:

<?phpwp_link_pages( 'before=<p class="page-links">'. __( 'Pages:'). ' &after=</p>&seperator=<span class="sep"> &middot; </span>');?>

С помощью массивов(array): лучший и более «опрятный» метод объявления настроек, чем строка запроса:

<?php$args = array( 'menu_class' => 'my-primary-menu', 'theme_location' => 'primary', 'after' => '<hr class="menu-bottom" />');wp_nav_menu( $args);?>

Помните, что вы можете использовать массивы вместо настроек запросов и наоборот, но нельзя заменять регулярные настройки настройками Query-string или же массивами. Если шаблонный тег принимает регулярные настройки, значит использовать можно легко только их. Если тег принимает настройки строки запроса или массив, можно без проблем использовать и то, и иное.

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

В завершение

Сейчас, когда мы познакомились с основами использования тегов шаблона в WordPress , можно продолжить наше обучение. В следующих руководствах из данной серии мы изучим каждый из шаблонных тегов (описанных в Кодексе ), и представим их небольшое описание, объясним настройки, и приведем примеры использования каждого тега.

Это будет довольно долгое путешествие по миру шаблонных тегов, но мы постараемся сделать его как можно увлекательнее.

Может быть, вы хотели бы рассказать нам и иным читателям что-нибудь о тегах шаблона? Для этого воспользуйтесь размещенной ниже формой для комментариев. И если вам понравилась эта статья, не забудьте поделиться ей с друзьями!

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

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