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

  • ОСТАВЬТЕ ОТВЕТ

    Please enter your comment!
    Please enter your name here