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

У WordPress є ще дуже багато тегів шаблонів, які ми можемо використовувати для різних цілей.

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

У цій статті ми збираємося розповісти про це не надто складному процесі. Давайте почнемо з засад.

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

Якщо ми заглянемо у джерела з ядра WordPress, то зрозуміємо, що тег шаблону — це, як правило, функція PHP, яка запускає набір кодів з певними параметрами.

Щоб створити свій власний тег шаблону, ви можете записати функцію PHP у файлі functions.php вашої теми.

Наприклад:

function my_template_tag() {
echo ‘Це мій шаблон’;
}

Тоді в інших файлах вашої теми, скажімо, single.php або page.phpви можете додати цю функцію наступним чином:

Цей код виводить текст «Це мій шаблон«, який повторюється всередині функції 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’];
}

Ось і все, наш новий тег шаблону для відображення кількості переглядів сторінки готовий. Ви можете вивести його через page.php або single.php.

Наприклад:

Як створювати власні теги шаблонів WordPress

Якщо у вас залишилися якісь питання, будь ласка, задайте їх у коментарях.

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