Вивчаємо теги шаблонів: частина перша
Вивчаємо теги шаблонів: частина друга
Вивчаємо теги шаблонів: частина третя
Вивчаємо теги шаблонів: частина четверта
Вивчаємо теги шаблонів: частина п’ята
Вивчаємо теги шаблонів: частина шоста

У другій статті з нашої серії ми розглянули першу «порцію» тегів шаблонів WordPress. Сьогодні ми раді представити наступну їх частину. Ми розглянемо теги, пов’язані з таксономією та мітками.

Отримуємо опис рубрики: category_description()

Тег шаблону повертає опис поточної (вказаної) рубрики.

Параметри

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

  • $category_ID (integer, необов’язковий): ID рубрики. За замовчуванням: запитувана рубрика.

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

Отримуємо опис тега: tag_description()

Повертає опис тега.

Параметри

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

  • $tag_ID (integer, необов’язковий): ID тега. За замовчуванням: поточний тег.

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

Отримуємо опис елемента таксономії: term_description()

Тег повертає опис елемента таксономії (мітки, категорії та інше).

Параметри

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

  • $term_ID (integer, необов’язковий): ID мітки. За замовчуванням: опис поточного елемента;
  • $taxonomy (sting, необов’язковий): Назва таксономії. За замовчуванням: ‘post_tag’.

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

Отримуємо і виводимо заголовок сторінки категорій архівів: single_cat_title()

Тег виводить і повертає ім’я категорії поточної сторінки.

Параметри

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

  • $prefix (sting, необов’язковий): Що повинно відображатися перед заголовком. За замовчуванням: ”;
  • $echo (bool, необов’язковий): Вивести ім’я категорії (TRUE) або повернути (FALSE). За замовчуванням: TRUE.

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

Отримуємо і виводимо заголовок сторінки архіву тегів: single_tag_title()

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

Параметри

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

  • $prefix (sting, необов’язковий): текст, що виводиться перед заголовком. За замовчуванням: ”;
  • $echo (опціонально – логічне значення): Вивести заголовок (TRUE) або отримати (FALSE). За замовчуванням: TRUE.

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

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

Тег шаблону отримує і повертає заголовок таксономії поточного посту.

Параметри

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

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

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

Отримуємо і виводимо категорії запису: get_the_category_list() і the_category()

Теги витягують і виводять категорії запису.

Параметри

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

  • $separator (sting, необов’язковий): роздільник між категоріями. За замовчуванням: ”. Якщо цей параметр не встановлено, то категорії будуть виводитися у вигляді неупорядкованого списку;
  • $parents (sting, необов’язковий): Як вивести батьківські категорії (‘multiple’, ‘single’ або ‘ ‘.). За замовчуванням: ”;
  • $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточний запис.

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

Отримуємо і виводимо категорії записів для розсилки: get_the_category_rss() і the_category_rss()

Теги дозволяють отримати всі записи категорії, відформатовані для виведення в RSS.

Параметри

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

  • $feed_type (sting, необов’язковий): Тип розсилки. За замовчуванням: тип розсилки за замовчуванням.

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

Отримуємо і виводимо теги до запису: get_the_tag_list() і the_tags()

Повертають і виводять всі теги, пов’язані із зазначеною записом.

Параметри

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

  • $before (sting, необов’язковий): Текст або HTML-код, який відображається перед виведенням. Значення за замовчуванням: ” для get_the_tag_list() і ‘Tags:’ для the_tags();
  • $sep (sting, необов’язковий): Текст, який буде використовуватися в якості розділювача. Значення за замовчуванням: ” для get_the_tag_list() і ‘, ‘ для the_tags();
  • $after (sting, необов’язковий): Текст або HTML-код, який відображається після виводу. За замовчуванням: ”.

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

Отримуємо і виводимо мітки запису: get_the_term_list() і the_terms()

Теги отримують і виводять список термінів таксономії, що належать до певного посаді.

Параметри

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

  • $post_ID (sting, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $taxonomy (sting, обов’язковий): Таксономія, для якої потрібно отримати список термінів. За замовчуванням:’ ‘;
  • $before (sting, необов’язковий): Текст або HTML-код, який відображається перед виведенням. За замовчуванням: ”;
  • $sep (sting, необов’язковий): Роздільник термінів таксономій. За замовчуванням: ‘, ‘;
  • $after (sting, необов’язковий): Текст або HTML-код, який відображається після виводу. За замовчуванням: ”.

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

ID ‘available-brands’ );
// Виводимо мітки поточної записи з таксономії “Available Brands” з довільним оформленням.
the_terms( $post->ID, ‘available-brands’, __( ‘Доступні бренди: ‘, ‘translation-domain’ ), ‘ – ‘ );
?>

Виводимо таксономії запису: the_taxonomies()

Тег виводить таксономії запису і доступні опції.

Параметри

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

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

— ‘post‘ (integer): ID запису. За замовчуванням: 0.
— ‘before‘ (sting, необов’язковий): HTML-код, який додається до висновку. За замовчуванням: ”.
— ‘sep‘ (sting): роздільник. За замовчуванням: ”.
— ‘after‘ (sting): HTML-код, який додається після виводу. За замовчуванням: пусто’ ‘.
— ‘template‘ (sting): Шаблон виводу списку.
За замовчуванням: ‘%s: %l.’ де %s – це мітка таксономії, а %l – список посилань.

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

‘
‘,
‘sep’ => ‘, ‘,
‘after’ =>’
‘
);
the_taxonomies( $args );
?>

Отримуємо і виводимо посилання «змінити тег»: get_edit_tag_link() і edit_tag_link()

Ці теги отримують або виводять посилання «змінити тег», яку можна використовувати в шаблонах.

Параметри

get_edit_tag_link() приймає два параметри:

  • $tag_ID (integer, обов’язковий): ID тег. За замовчуванням: NULL;
  • $taxonomy (sting, необов’язковий): Тип таксономії. За замовчуванням: ‘post_tag’.

і edit_tag_link() приймає чотири параметри:

  • $link (sting, необов’язковий): Текст посилання. За замовчуванням: ‘Edit This’;
  • $before (sting, необов’язковий): Текст або HTML-код, який відображається перед виведенням. За замовчуванням: ”;
  • $after (sting, необов’язковий): Текст або HTML-код, який відображається після виводу. За замовчуванням: ”;
  • $tag (object, необов’язковий): Об’єкт тега. За замовчуванням: NULL.

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

Отримуємо і виводимо список категорій: wp_list_categories()

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

Параметри

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

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

— ‘show_option_all‘ (string): Показує посилання на головну сторінку (або на “Сторінку записів”, виставлену в розділі Налаштування > Читання), якщо виставлено не пусте значення. Значення буде анкорним текстом посилання. За замовчуванням: ”;
— ‘show_option_none‘ (string): Текст, який буде відображатися при відсутності рубрик. За замовчуванням: Немає рубрик’;
— ‘orderby‘ (string): Метод сортування рубрик. Приймає значення ‘name’, ‘ID’, ‘slug’, ‘count’ і ‘term_group’. За замовчуванням: ‘name’;
— ‘order‘ (string): Сортувати за зростанням (‘ASC’) або за спаданням (‘DESC’). За замовчуванням: ‘ASC‘;
— ‘style‘ (sting): Стиль відображення рубрик—’list’ генерує ненумерованний список посилань, ‘none’ генерує список посилань, розділених тегом
. За замовчуванням: ‘list’;
— ‘show_count‘ (integer): Показує кількість записів поруч з кожною рубрикою. За замовчуванням: 0;
— ‘hide_empty‘ (integer): Приховувати порожні рубрики чи ні. За замовчуванням: 1;
— ‘use_desc_for_title‘ (integer): Використовувати опису в якості атрибута title посилання. За замовчуванням: 1;
— ‘child_of‘ (integer): Відображення тільки дочірніх елементів з категорії зазначеного ID. За замовчуванням: 0;
— ‘feed‘ (string): Якщо використовується не пусте значення, поряд з кожною категорією буде відображатися посилання на розсилку. Значення буде використовуватися в якості анкорного тексту посилань. За замовчуванням: ”;
— ‘feed_type‘ (string): Тип розсилки (‘rss’, ‘rss2’, ‘atom’ або ‘rdf’). За замовчуванням: ”;
— ‘feed_image‘ (string): Шлях до зображення, яке буде використовуватися замість анкорного тексту посилання на розсилку. За замовчуванням: ”;
— ‘exclude‘ (string): ID рубрик через кому, які потрібно виключити з списку. За замовчуванням: ”;
— ‘exclude_tree‘ (string): Те ж, що “exclude”, але цей параметр, якщо аргумент hierarchical виставлений на 1. За замовчуванням: ”;
— ‘current_category‘ (integer): Додає клас “current-cat”, якщо це потрібно. За замовчуванням: 0;
— ‘hierarchical‘ (integer): Відображення елементів в ієрархічному форматі. За замовчуванням: 1;
— ‘title_li‘ (string): Обрамляє результат тегом

  • і виводить заголовок перед списком рубрик. За замовчуванням: ‘Категорії’;
    — ‘echo‘ (integer): Виводити результат (1) або повертати його (0). За замовчуванням: 1;
    — ‘depth‘ (integer): Максимальна глибина ієрархії. За замовчуванням: 0;
    — ‘taxonomy‘ (string): Таксономія списку. За замовчуванням: ‘category’.

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

    __( ‘Записи’, ‘translation-domain’ ),
    // Сортування за номером запису.
    ‘orderby’ => ‘count’,
    // Показувати номери записів.
    ‘show_count’ => 1,
    // Показувати посилання на розсилки.
    ‘feed’ => ‘Feed’,
    // Видалення title_li.
    ‘title_li’ =>”
    );
    wp_list_categories( $args );
    ?>

    Отримуємо і виводимо випадаючий HTML-список категорій: wp_dropdown_categories()

    Тег отримує і виводить випадаючий список (елемент ), що складається з найменувань категорій.

    Параметри

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

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

    — ‘show_option_all‘ (string): Текст для відображення у всіх категоріях. За замовчуванням: ”;
    — ‘show_option_none‘ (string): Текст, що відображається при відсутності категорій. За замовчуванням: ”;
    — ‘option_none_value‘ (змішане значення): Значення, яке використовується при відсутності вибраних категорій. За замовчуванням: -1;
    — ‘orderby‘ (string): сортування виведених категорій за певними критеріями. За замовчуванням: ‘ID’;
    — ‘order‘ (string): напрямок сортування (за зростанням або за спаданням). За замовчуванням: ‘ASC’;
    — ‘show_count‘ (bool або integer): Показувати чи ні кількість записів в категорії. За замовчуванням: 0;
    — ‘hide_empty‘ (bool або integer): показувати чи ні категорії без запису. За замовчуванням: 1;
    — ‘child_of‘ (integer): Показувати чи ні всі дочірні категорії. За замовчуванням: 0;
    — ‘exclude‘ (string): Список розділених комами ID категорій, які потрібно виключити з списку. За замовчуванням: ”;
    — ‘echo‘ (bool або integer): Виводити або вилучати контент. За замовчуванням: 1;
    — ‘depth‘ (integer): Максимальна глибина вкладеності. За замовчуванням: 0;
    — ‘tab_index‘ (integer): значення атрибута tabindex для елемента SELECT. За замовчуванням: 0;
    — ‘name‘ (string): Значення атрибута NAME елемента SELECT. За замовчуванням: ‘cat’;
    — ‘id‘ (string): значення атрибута ID елемента SELECT. За замовчуванням: порожньо;
    — ‘class‘ (string): CSS-клас для елемента SELECT. За замовчуванням: ‘postform’;
    — ‘selected‘ (integer): ID категорії, яка повинна бути обрана за замовчуванням. За замовчуванням: 0;
    — ‘taxonomy‘ (string): назва таксономії для виводу. За замовчуванням: ‘category’.

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

    __( ‘Нічого не знайдено’, ‘translation-domain’ ),
    ‘orderby’ => ‘title’,
    ‘show_count’ => 1,
    ‘echo’ => 0,
    ‘name’ => __( ‘brands’, ‘translation-domain’ ),
    ‘taxonomy’ => __( ‘available-brands’, ‘translation-domain’ )
    );
    $brands_dropdown = wp_categories_dropdown( $args );
    ?>

    Отримуємо і виводимо хмара тегів: wp_tag_cloud()

    Тег отримує або виводить хмара тегів, створений з вказаної таксономії (за замовчуванням: з тегів).

    Параметри

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

    • $args (array, необов’язковий):

    Масив включає в себе наступні аргументи:
    — ‘smallest‘ (integer): найменший розмір шрифту. За замовчуванням: 8;
    — ‘largest‘ (integer): Найбільший розмір шрифту. За замовчуванням: 22;
    — ‘unit‘ (string): Одиниця зміни розміру тексту. За замовчуванням: ‘pt’;
    — ‘number‘ (string): Максимальна кількість тегів для відображення. За замовчуванням: 45;
    — ‘format‘ (string): Як відображати список тегів: ‘flat’ – елементи розділяються пропуском, ‘list’ – невпорядкований HTML-список, і ‘array’ – у вигляді PHP-масиву. За замовчуванням: ‘flat’;
    — ‘separator‘ (string): Текст роздільника. За замовчуванням: «n«;
    — ‘orderby‘ (string): Критерії сортування тегів (‘name’ або ‘count’). За замовчуванням: ‘name’;
    — ‘order‘ (string): Сортувати за зростанням (‘ASC’) або за спаданням (‘DESC’) порядку. За замовчуванням: ‘ASC’;
    — ‘include‘ (array): Масив з ID, які слід включити в видачу. За замовчуванням: ”;
    — ‘exclude‘ (array): Масив з ID, які слід виключити з видачі. За замовчуванням: ”;
    — ‘taxonomy‘ (string): Таксономія, з якої буде побудовано хмара. За замовчуванням: ‘post_tag’;
    — ‘link‘ (string): Результат натискання на посилання ‘view’ для перегляду ‘edit’ для редагування посилань. Працює з аргументом ‘post_type’. За замовчуванням: ‘view’;
    — ‘post_type‘ (string): Якщо аргумент ‘link’ виставлений на ‘edit’, то вам потрібно вказати ‘post_type’, щоб визначити, які типи записів у списку “редагувати посилання”. За замовчуванням: порожньо;
    — ‘echo‘ (boolean): вивести хмара на екран або повертати значення для подальшої обробки. За замовчуванням: TRUE.

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

    10,
    ‘largest’ => 32,
    // Отримувати тільки 20 тегів.
    ‘number’ => 20,
    // Сортування по популярності.
    ‘orderby’ => ‘count’,
    // Довільна таксономія.
    ‘taxonomy’ => ‘brands’,
    // Замість відображення повернути видачу.
    ‘echo’ => 0
    );
    $tag_cloud = wp_tag_cloud( $args );
    ?>

    Отримуємо довільно згенероване хмара тегів: wp_generate_tag_cloud()

    Повертає HTML рядок зі сформованим «хмара тегів».

    Параметри

    Тег приймає два параметри:

    • $tags (array, обов’язковий): Масив зі списком тегів. За замовчуванням: NULL;
    • $args (array, обов’язковий): Масив містить наступні елементи:

    — ‘smallest‘ (integer): найменший розмір шрифту. За замовчуванням: 8;
    — ‘largest‘ (integer): Найбільший розмір шрифту. За замовчуванням: 22;
    — ‘unit‘ (string): Одиниця зміни розміру тексту. За замовчуванням: ‘pt’;
    — ‘number‘ (string): Скільки тегів виводити. За замовчуванням: 0;
    — ‘format‘ (string): Як відображати список тегів: ‘flat’ – елементи розділяються пропуском, ‘list’ – невпорядкований HTML-список, і ‘array’ – у вигляді PHP-масиву. За замовчуванням: ‘flat’;
    — ‘separator‘ (string): Текст роздільника. За замовчуванням: «n«;
    — ‘orderby‘ (string): За якими критеріями сортувати теги (‘name’ або ‘count’). За замовчуванням: ‘name’;
    — ‘order‘ (string): Сортувати за зростанням (‘ASC’) або за спаданням (‘DESC’). За замовчуванням: ‘ASC’;
    — ‘topic_count_text‘ (string): Текст підказки для посилання, прив’язаною до тегу. За замовчуванням: NULL;
    — ‘topic_count_text_callback‘ (string): callback-функція, яка отримує кількість записів з використанням цього тега, і відображає його в підказці до заслання, прив’язаною до тегу. За замовчуванням: NULL;
    — ‘topic_count_scale_callback‘ (string): callback-функція, яка працює з аргументами ‘smallest’ і ‘largest’ і вирахує розміри шрифту для тегів в залежності від кількості згадувань. За замовчуванням: ‘default_topic_count_scale’;
    — ‘filter‘ (integer): якщо цей параметр виставлений на 0, функція не застосовує фільтр з такою ж назвою (‘wp_generate_tag_cloud’). За замовчуванням: 1.

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

    10,
    ‘largest’ => 36,
    ‘orderby’ => ‘count’
    );
    wp_generate_tag_cloud( $tags, $args );
    ?>

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

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

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

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

    • RELATED ARTICLESMORE FROM AUTHOR