Как создавать собственные теги шаблонов WordPress

Создавать тему WordPress с тегами шаблонов так просто. Вы можете использовать the_title() для вывода заголовков записей или страниц, вы можете использовать the_content() для вывода контента поста или страницы.

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

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

В этой статье мы собираемся рассказать об этом не слишком сложном процессе. Давайте начнем с основ.

Основные теги шаблонов

Если мы заглянем в источники по ядру WordPress, то поймем, что тэг шаблона — это, как правило, функция PHP, которая запускает набор кодов с определенными параметрами.

Чтобы создать свой собственный тег шаблона, вы можете записать функцию PHP в файле functions.php вашей темы.

Например:

function my_template_tag() {  
        echo 'Это мой шаблон';  
}

Тогда в других файлах вашей темы, скажем, single.php или page.php, вы можете добавить эту функцию следующим образом:

<?php my_template_tag() ;?>

Этот код выводит текст «Это мой шаблон«, который повторяется внутри функции my_template_tag():

Основные теги шаблонов

Действительно, создать шаблон тэга в WordPress так просто. Хорошо, давайте теперь рассмотрим пример немного сложнее.

Тег шаблона счетчика просмотров страницы

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

Во-первых, нужно установить и активировать WordPress.com Stat в Jetpack. И проверить, что вы подключили Jetpack к WordPress.com.

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

Создаем в нашем файле functions.php функцию под названием the_view().

Это делается следующим образом:

function the_view() {   
	  
}

После этого мы можем использовать эту функцию для получения от WordPress.com Stats числа просмотров, применяя stats_get_csv();. Эта функция принимает несколько параметров (полный их список вы можете найти здесь).

В данном случае, мы должны добавить параметр days, который определяет временной диапазон подсчета просмотров, и post_id:

function the_view() {  
	$id = get_the_ID();  
	$page_view = stats_get_csv('postviews', 'days=-1&post_id='.$id.'');  
}

Так как мы установили для параметра days значение -1, то приведенный выше код будет извлекать количество просмотров записи с данным ID с момента, когда плагин WordPress.com Stat был активирован.

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

function the_view() {  
      $id = get_the_ID();  
      $page_view = stats_get_csv('postviews', 'days=-1&post_id='.$id.'');  
      echo $page_view[0]['views'];  
}

Вот и все, наш новый тег шаблона для отображения количества просмотров страницы готов. Вы можете вывести его через <?php the_view() в любом месте page.php или single.php.

Например:

новый тег шаблона

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

Перевод статьи «How To Create Custom WordPress Template Tags» был подготовлен дружной командой проекта Сайтостроение от А до Я.