Как создать собственные теги шаблона в 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() {   
  
}  

Мы поместим функцию (тег шаблона) в запись или на страницу, поэтому нам необходимо получить ID страницы или записи. Это можно сделать с помощью get_the_ID();.

function the_view() {   
    $id = get_the_ID();  
} 

Мы можем использовать функцию для получения количества просмотров от 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 or single.php. Например:

Надеемся, что эта статья помогла вам научиться создать собственные теги шаблона в WordPress.

По всем вопросам и отзывам просьба писать в комментарии ниже.

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