У минулій статті з нашої серії ми пройшлися по шостий частини тегів шаблонів WordPress. Сьогодні ми раді представити вам чергову «порцію» тегів шаблонів. Ми розглянемо теги, пов’язані з архівами, пошуком, а також авторизацією і реєстрацією.
Повертаємо посилання на архів: get_archives_link()
Тег повертає посилання на архів в різних форматах.
Параметри
Цей тег шаблону приймає 5 параметрів:
- $url (string): URL архіву. За замовчуванням: NULL;
- $text (string): Опис архіву, при $format виставленому на ‘link‘. За замовчуванням: NULL;
- $format (string, необов’язковий): Формат посилання. Можна використовувати наступні:
— ‘link‘- створює тег ;
— ‘option‘- створює тег , який можна використовувати в випадаючому HTML-списку;
— ‘html‘- тег створює усередині тега
— ‘custom‘ або будь-який інший текст створюють тег . Значення за замовчуванням: ‘html‘;
- $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‘ — тег створює усередині тега
— ‘option‘ — створює тег , який можна використовувати в випадаючому HTML-списку;
— ‘custom‘ — створює теги . Значення за замовчуванням: ‘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» був підготовлений дружною командою проекту Сайтостроение від А до Я.