Вивчаємо теги шаблонів: частина сьома

• $before (string, необов’язковий): Текст або HTML-код, який буде показаний перед посиланням. За замовчуванням: »;
• $after (string, необов’язковий): Текст або HTML-код після посилання. За замовчуванням: ».

Застосування

Отримуємо і виводимо посилання на архіви: wp_get_archives()

Тег отримує або виводить список посилань на архіви у різних форматах.

Параметри

Цей тег шаблону приймає лише один параметр:

• $args (array, необов’язковий): Масив включає в себе наступні аргументи:

— ‘type‘ (string): Тип архівів. Приймаються параметри ‘yearly‘, ‘monthly‘, ‘weekly‘, ‘daily‘, ‘postbypost‘ (сортування за датою публікації) або ‘alpha‘ (сортування по заголовкам). (За замовчуванням: ‘monthly‘);
— ‘limit‘ (string): Кількість елементів, які потрібно вивести. (За замовчуванням: порожньо, або необмежено);
— ‘format‘ (string): один з форматів виводу;
— ‘html‘ — тег створює усередині тега

• $before (string, необов’язковий): Текст або HTML-код, який буде показаний до заслання. За замовчуванням: »;
• $after (string, необов’язковий): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: »:

— ‘show_post_count‘ (bool): Показувати лічильник. За замовчуванням: FALSE;
— ‘echo‘ (integer): Вивести на екран (1) або отримати для обробки (0). За замовчуванням: 1;
— ‘order‘ (string): Сортувати за зростанням (‘ASC‘) або за спаданням (‘DESC‘). За замовчуванням: ‘DESC‘.

Застосування

‘yearly’,
// Тут нам потрібні просто теги , тому що…
‘format’ => ‘custom’,
// …ми збираємося використовувати ці посилання в елементі
‘before’ => “,
‘after’ => “,
// Виводимо лічильник.
‘show_post_count’ => true
);
wp_get_archives( $args );
?>

Отримуємо і виводимо назва типу записів на сторінці архіву: post_type_archive_title()

Тег отримує і виводить типи записів, які використовуються в заголовках на сторінці архіву.

Параметри

Цей тег шаблону приймає два параметри:

• $prefix (string, необов’язковий): Приставка до заголовка. За замовчуванням: »;
• $echo (bool, необов’язковий): Вивести на екран (TRUE) або отримати для обробки (FALSE). За замовчуванням: TRUE.

Застосування

Отримуємо і виводимо заголовок сторінки для щомісячного архіву: single_month_title()

Тег отримує і виводить назву місяця, яке буде використовуватися в якості заголовка сторінки.

Параметри

Цей тег шаблону приймає два параметри:

• $prefix (string, необов’язковий): Приставка до заголовка. За замовчуванням: ».
• $echo (bool, необов’язковий): Вивести на екран (TRUE) або отримати для обробки (FALSE). За замовчуванням: TRUE.

Застосування

Отримуємо і виводимо посилання “Такі записи”: get_next_posts_link() і next_posts_link()

Теги отримують або виводять посилання “Такі записи” на сторінці з записами.

Параметри

Обидва тега шаблонів приймають два значення:

• $label (string, необов’язковий): Текст, який буде відображатися в якості посилання. За замовчуванням: ‘наступна сторінка “‘;
• $max_page (integer, необов’язковий): Максимальний номер сторінки. За замовчуванням: 0.

Застосування

Отримуємо і виводимо посилання “Попередні записи”: get_previous_posts_link() і previous_posts_link()

Теги отримують або виводять посилання “Попередні записи” на сторінці з записами.

Параметри

Обидва тега шаблонів приймають один параметр:

• $label (string, необов’язковий): Текст, який буде відображатися в якості посилання. За замовчуванням: ‘попередня сторінка’.

Застосування

Отримуємо і виводимо посилання “Наступні і попередні записи”: get_posts_nav_link() і posts_nav_link()

Теги отримують і виводять навігаційні посилання «Такі записи» і «Попередні записи».

Параметри

get_posts_nav_link() приймає один параметр:

• $args (array, необов’язковий): Масив включає в себе наступні аргументи:

— ‘sep‘ (string): Текст роздільника. За замовчуванням: ‘;‘;
— ‘prelabel‘ (string): Текст посилання на попередні записи. За замовчуванням: ‘Попередня сторінка’;
— ‘nxtlabel‘ (string): Текст посилання на такі записи. За замовчуванням: ‘Наступна сторінка’.

posts_nav_link() приймає три параметри:

— ‘sep‘ (string): Текст роздільника. За замовчуванням: ‘;‘;
— ‘prelabel‘ (string): Текст посилання на попередні записи. За замовчуванням: ‘” Попередня сторінка’;
— ‘nxtlabel‘ (string): Текст посилання на такі записи. За замовчуванням: ‘Наступна сторінка “‘.

Застосування

‘· ‘,
‘prelabel’ => ‘«’,
‘nxtlabel’ => ‘»’
);
$posts_nav = get_posts_nav_link( $args );
// Виводимо навігацію по записах.
posts_nav_link( ‘ – ‘, __( ‘Попередні’, ‘translation-domain’ ), __( ‘З’, ‘translation-domain’ ) );
?>

Отримуємо і виводимо форму пошуку: get_search_form()

Тег повертає або виводить класичну форму пошуку.

Параметри

• $echo (bool, необов’язковий): Вивести (TRUE) або повернути (FALSE) результат. За замовчуванням: TRUE.

Застосування

Отримуємо і виводимо поточний пошуковий запит: get_search_query() і the_search_query()

Теги повертають або відображають введені пошукові запити.

Параметри

the_search_query() не приймає параметрів, а get_search_query() приймає лише один:

• $escaped (bool, необов’язковий): Був результат екранований. Варто залишити значення TRUE, якщо ви не збираєтеся надалі його екранувати. За замовчуванням: TRUE.

Застосування

Отримуємо постійну посилання для пошукового запиту: get_search_link()

Тег генерує URL для пошуку за заданими умовами.

Параметри

Цей тег шаблону приймає один параметр:

• $query (string, необов’язковий): Умови пошуку для створення запиту. За замовчуванням: поточний пошуковий запит.

Застосування

Отримуємо і виводимо посилання “Реєстрація” або “Консоль”: wp_register()

Залежно від статусу користувача тег виводить посилання «Зареєструватися» або «Консоль».

Параметри

Цей тег шаблону приймає три параметри:

• $before (string, необов’язковий): Текст або HTML-код, який буде показаний до заслання. За замовчуванням: “;
• $after (string, необов’язковий): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: “;
• $echo (bool, необов’язковий): Вивести на екран (TRUE) або повернути для обробки (FALSE). За замовчуванням: TRUE.

Застосування

Отримуємо і виводимо форму “Авторизуватися”: wp_login_form()

Тег повертає і виводить форму авторизації на сайті. Використовується в шаблонах і плагінах, в яких користувачам потрібна обов’язкова авторизація.

Параметри

Цей тег шаблону приймає один параметр:

• $args (array, необов’язковий): Масив включає в себе наступні аргументи:

— ‘echo‘ (bool): виводити на екран чи ні. За замовчуванням: TRUE;
— ‘redirect‘ (string): посилання для перенаправлення користувача після успішної авторизації. За замовчуванням: поточна сторінка;
— ‘form_id‘ (string): ID для тега форми авторизації . (За замовчуванням: ‘loginform‘);
— ‘label_username‘ (string): Напис для поля “Ім’я користувача”. За замовчуванням: ‘Ім’я користувача’;
— ‘label_password‘ (string): Напис для поля “Пароль”. За замовчуванням: ‘Пароль’;
— ‘label_remember‘ (string): Напис для поля “Запам’ятати”. За замовчуванням: ‘Запам’ятати’;
— ‘label_log_in‘ (string): Напис для кнопки підтвердження. За замовчуванням: ‘Увійти’;
— ‘id_username‘ (string): ID поля “Ім’я користувача”. За замовчуванням: ‘user_login‘;
— ‘id_password‘ (string): ID поля “Пароль”. За замовчуванням: ‘user_pass‘;
— ‘id_remember‘ (string): ID чекбокса “Запам’ятати”. За замовчуванням: ‘rememberme‘;
— ‘id_submit‘ (string): ID кнопки підтвердження. За замовчуванням: ‘wp-submit‘;
— ‘remember‘ (bool): Показувати чекбокс “Запам’ятати”. За замовчуванням: TRUE;
— ‘value_username‘ (string): Значення за промовчанням для поля “Ім’я користувача”. За замовчуванням: »;
— ‘value_remember‘ (bool): Зазначити чи чекбокс “Запам’ятати”. За замовчуванням: FALSE.

Застосування

get_permalink( 8 ),
// Довільні id для форм і полів введення.
‘form_id’ => ‘mytheme-login-form’,
‘id_username’ => ‘mytheme-login-form-username’,
‘id_password’ => ‘mytheme-login-form-password’,
‘id_remember’ => ‘mytheme-login-form-remember’,
‘id_submit’ => ‘mytheme-login-form-submit’,
);
wp_login_form( $args );
?>

Повертаємо й відображаємо посилання “Вийти”: wp_loginout()

Тег повертає або відображає посилання “Увійти” для відвідувачів, і “Вийти” – для авторизованих користувачів.

Параметри

Цей тег шаблону приймає два параметри:

• $redirect (string, необов’язковий): URL, на який надходять користувачі при авторизації або виході з системи. За замовчуванням: »;
• $echo (bool, необов’язковий): Вивести на екран (TRUE) або повернути для обробки (FALSE) тег. За замовчуванням: TRUE.

Застосування

Отримуємо URL для авторизації: wp_login_url()

Тег повертає посилання для авторизації користувачів.

Параметри

Цей тег шаблону приймає два параметри:

• $redirect (string, необов’язковий): URL, на який надходять користувачі при авторизації. За замовчуванням: »;
• $force_reauth (bool, необов’язковий): Повторна авторизація користувачів навіть при збережених cookies. За замовчуванням: FALSE.

Застосування

Застосування

Отримуємо посилання «Забули пароль»: wp_lostpassword_url()

Тег повертає посилання на сторінку відновлення пароля.

Параметри

Цей тег шаблону приймає один параметр:

• redirect (string, необов’язковий): URL для перенаправлення користувачів. За замовчуванням: ».

Застосування

На завершення

Сподіваємося, вам сподобалася чергова «порція» тегів шаблонів. Найближчим часом ми представимо ще кілька частин з цієї серії.

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

Переклад статті “The Tuts+ Guide to Template Tags: Seventh Batch” був підготовлений дружною командою проекту Сайтостроение від А до Я.