Створювати тему 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.
Наприклад:
Якщо у вас залишилися якісь питання, будь ласка, задайте їх у коментарях.
Переклад статті «How To Create Custom WordPress Template Tags» був підготовлений дружною командою проекту Сайтостроение від А до Я.