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

• $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» був підготовлений дружною командою проекту Сайтостроение від А до Я.