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

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

Отримуємо і виводимо автоматичні класи для кожного запису: get_post_class() і post_class()

Дані теги дозволяють додавати нові класи CSS, які можна використовуватиме в тілі кожного запису.

Параметри

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

  • $class (string, необов’язковий): Додаткові CSS-класи, які необхідно додати. За замовчуванням:’ ‘;
  • $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточний запис.

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

Отримуємо і виводимо постійне посилання на поточну запис: get_permalink() і the_permalink()

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

Параметри

the_permalink() не приймає параметрів.

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

  • $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $leavename (bool, необов’язковий): Зберігати чи назву сторінки. За замовчуванням: FALSE.

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

Отримуємо і виводимо ID запису: get_the_ID() і the_ID()

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

Параметри

Ці теги шаблонів не приймають параметрів.

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

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

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

Параметри

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

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

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

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

Дані теги дозволяють отримувати або виводити посилання на наступну запис щодо поточної.

Параметри

Обидва тега шаблонів беруть п’ять параметрів:

  • format (string, необов’язковий): Формат посилання, де %link є параметром $link. За замовчуванням: ‘%link «‘;
  • $link (string, необов’язковий): Формат анкорного тексту, де %title – це заголовок запису. За замовчуванням: ‘%title‘;
  • $in_same_term (bool, необов’язковий): Робити посилання на записи з тієї ж таксономії. За замовчуванням: FALSE;
  • $excluded_terms (string або array, необов’язковий): Список термінів для виключення. За замовчуванням: »;
  • $taxonomy (string, необов’язковий): Таксономія для фільтрації наступних записів. За замовчуванням: ‘category‘.

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

Отримуємо і виводимо посилання на попередню запис: get_previous_post_link() і previous_post_link()

Дані теги дозволяють отримувати або виводити посилання на попередню запис.

Параметри

Обидва тега шаблонів беруть п’ять параметрів:

  • format (string, необов’язковий): Формат посилання, де %link є параметром $link. За замовчуванням: ‘%link «;’;
  • $link (string, необов’язковий): Анкор посилання. ‘%title‘ заміниться на заголовок запису. За замовчуванням: ‘%title‘;
  • $in_same_term (bool, необов’язковий): Робити посилання на запис з тієї ж таксономії. За замовчуванням: FALSE;
  • $excluded_terms (string або array, необов’язковий): Список термінів таксономії для виключення. За замовчуванням: »;
  • $taxonomy (string, необов’язковий): Таксономія для фільтрації наступних записів. За замовчуванням: ‘category‘.

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

Отримуємо постійну посилання на сторінку: get_page_link()

Тег отримує постійний URL заданої сторінки.

Параметри

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

  • $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $leavename (bool, необов’язковий): Зберігати назва сторінки чи ні. За замовчуванням: FALSE;
  • $sample (bool, необов’язковий): це Є зразком постійної посилання. За замовчуванням: FALSE.

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

Отримуємо і виводимо постійне посилання запису: get_post_permalink() і post_permalink()

Дані теги отримують і виводять постійне посилання запису.

Параметри

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

  • $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $leavename (bool, необов’язковий): Зберігати чи назву сторінки. За замовчуванням: FALSE;
  • $sample (bool, необов’язковий): це Є зразком постійної посилання. За замовчуванням: FALSE.

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

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

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

Отримуємо і виводимо коротке посилання на запис: wp_get_shortlink() і the_shortlink()

Дані теги повертають і виводять коротку версію посилання на запис.

Параметри

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

  • $ID (string, необов’язковий): ID запису або блогу. За замовчуванням: поточний запис або на блог;
  • $context (string, необов’язковий): ID записом в блозі, записом на сайті або ID медіа файлу. Ви можете виставити параметр на ‘post‘ (для записів у блозі) або ‘query‘ (для іншого типу ID). За замовчуванням: ‘post‘;
  • $allow_slugs (bool, необов’язковий): Використовувати транслітерацію (slug) в укорочених посиланнях. За замовчуванням: TRUE.

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

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

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

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

Даний тег дозволяє отримати або вивести на посилання «Редагувати запис», яку потім можна використовувати в шаблонах.

Параметри

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

  • $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $context (integer, необов’язковий): потрібно екранувати символ & (тобто замінювати на &). Можна використовувати всі значення, крім ‘display‘, щоб запобігти шифрування посилання. За замовчуванням: ‘display‘.

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

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

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

Отримуємо посилання для видалення запису: get_delete_post_link()

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

Параметри

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

  • $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточна запис;
  • $deprecated (string, застарілий): Цей параметр застарів, залишіть його порожнім. За замовчуванням: »;
  • $force_delete (bool, необов’язковий): Видалити запис повністю, минаючи Кошик. За замовчуванням: FALSE.

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

ID, ‘ ‘, true );
?>

Виводимо «анкорный текст» для постійної посилання на поточну запис: permalink_anchor()

Тег виводить анкорный текст для постійної посилання на запис. Для наочності, погляньте на приклад.

Параметри

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

  • $mode (string, необов’язковий): задає тип якоря для виводу. Якщо задати значення параметру ‘id‘, то якір буде дорівнює числовому ID посту. Якщо ‘title‘, то анкор буде дорівнює імені посту. За замовчуванням: ‘id‘.

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

Завантажуємо шаблон заголовка: get_header()

Цей відомий тег дозволяє довантажувати зовнішній PHP-файл, в якому міститься шаблон заголовка.

Параметри

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

  • $name (string, необов’язковий): Назва файлу шапки сайту (header-{$name}.php). За замовчуванням: »,якщо цей параметр завантажує файл header.php.

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

Завантажуємо шаблон підвалу сайту: get_footer()

Цей популярний тег дозволяє завантажити зовнішній PHP-файл, в якому міститься шаблон підвалу сайту.

Параметри

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

  • $name (string, необов’язковий): Назва файлу підвалу (footer-{$name}.php). За замовчуванням: », якщо цей параметр завантажить файл footer.php.

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

Завантажуємо шаблон бічній панелі: get_sidebar()

Популярний тег, який дозволяє завантажувати зовнішній PHP-файл, в якому міститься шаблон боковій панелі:

Параметри

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

  • $name (string, необов’язковий): Назва файлу бічній панелі (sidebar-{$name}.php). За замовчуванням: », якщо цей параметр завантажить файл sidebar.php.

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

Завантажуємо файли шаблону: get_template_part()

Цей тег дозволяє завантажувати зовнішні PHP-файли з папки шаблону.

Параметри

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

  • $slug (string, обов’язковий): назва файлу шаблону. За замовчуванням: NULL;
  • $name (string, необов’язковий): Довільну назву, яка додається до імені файлу. За замовчуванням: NULL.

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

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

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

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

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