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

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

Ця частина циклу присвячена першій партії (з майже 200) тегів шаблонів. У ній ми познайомимося з тегами, пов’язаними з іменами, датами, контентом та іншими мета даними.

Отримуємо і виводимо вміст запису: get_the_content() і the_content()

Одні з найпопулярніших тегів шаблону, так як дозволяють отримати і вивести вміст запису (публікації).

Параметри

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

  • $more_link_text (string, необов’язковий): Текст для заміни стандартного тексту «(more…)». Значення за замовчуванням: «(more…)»;
  • $strip_teaser (bool, необов’язковий): Показувати анонс тексту. Значення за замовчуванням: FALSE.

Примітка: існує тег , який дозволяє перетворити контент після тега анонс, і не показувати цей фрагмент тексту на сторінці запису, навіть якщо параметр $strip_teaser виставлений на FALSE.

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

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

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

Параметри

Обидва тега приймають єдиний параметр:

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

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

Отримуємо і виводимо цитати (Excerpt) для запису: get_the_excerpt() і the_excerpt()

Ці теги шаблонів витягують і виводять цитати (excerpt) з запису.

Параметри

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

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

Висновок цитат із запису для розсилок: the_excerpt_rss()

Цей тег шаблону виводить анонс поточної записи для подальшого відображення в RSS.

Параметри

Тег не приймає параметрів.

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

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

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

Параметри

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

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

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

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

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

‘, ‘

‘);
?>

Отримуємо і виводимо заголовок «втраченої» запису: the_title_attribute()

Цей тег шаблону бере заголовки ваших записів і готує їх для використання в якості значень HTML-атрибутів. Для наочності розглянемо приклад.

Параметри

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

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

‘before’ (string): HTML-код для додавання перед заголовком. Значення за замовчуванням: »;
‘after’ (string): HTML-код для додавання після заголовка. Значення за замовчуванням: »;
‘echo’ (bool): Виводити чи тег шаблону чи ні. Значення за замовчуванням: TRUE;
‘post’ (object): Поточна запис, з якого потрібно взяти заголовок. Значення за замовчуванням: ».

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

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

Bill & Melinda Gates Spend Billions on Charity, Say «We Did???»

У заголовку представлено два знака лапок і один амперсанд, які можуть конфліктувати з HTML-кодом, якщо використовувати їх в якості HTML-атрибути, так як вони також обрамляються лапками. В такому разі нам потрібно використовувати the_title_attribute():

Тепер атрибут title у посилання виглядає ось так:

Bill & Melinda Gates Spend Billions into Charity, Say «We Did???»

У такому вигляді він не буде конфліктувати з HTML-кодом, так як тут не використовуються спеціальні символи.

Виводимо заголовок запису для розсилок: the_title_rss()

Цей тег шаблону виводить заголовок поточної записи в відформатованому вигляді для RSS.

Параметри

Цей тег не приймає параметрів.

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

Отримуємо і виводимо дату запису: get_the_date() і the_date()

Параметри

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

  • $date_format (string, необов’язковий): Формат дати. За замовчуванням: формат дати встановлюється у налаштуваннях WordPress;
  • $post_ID (integer або object): ID запису. За замовчуванням: поточний запис.

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

  • $date_format (string, необов’язковий): Формат дати. За замовчуванням: формат дати встановлюється в загальних параметрах WordPress;
  • $before (string, необов’язковий): Текст або HTML-код, який відображається до дати. Значення за замовчуванням: »;
  • $after (string, необов’язковий): Текст або HTML-код, що з’являється після основного вмісту. Значення за замовчуванням: »;
  • $echo (bool, необов’язковий): виводити дату (TRUE) або повернути (FALSE). За замовчуванням: TRUE.

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

Отримуємо і виводимо дату публікації у форматі ISO 8601: the_date_xml()

Цей тег шаблону виводить дату запису в форматі ISO 8601.

Параметри

Цей тег не приймає параметрів.

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

Отримуємо і виводимо час публікації запису: get_the_time() і the_time()

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

Параметри

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

  • $time_format (string, необов’язковий): Формат часу. За замовчуванням: формат часу встановлюється в загальних параметрах WordPress;
  • $post_ID (integer або object, необов’язковий): ID запису. За замовчуванням: поточний запис.

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

  • $time_format (string, необов’язковий): Формат часу. За замовчуванням: формат часу встановлюється в загальних параметрах WordPress.

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

Отримуємо і виводимо ім’я автора: get_the_author() і the_author()

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

Параметри

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

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

Виводимо всі метадані запису: the_meta()

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

Параметри

Цей тег не приймає параметрів.

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

Отримуємо і виводимо дату зміни запису: get_the_modified_date() і the_modified_date()

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

Параметри

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

  • $date_format (string, необов’язковий): Формат дати. За замовчуванням: формат дати встановлюється в загальних параметрах WordPress.

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

  • $date_format (string, необов’язковий): Формат дати. За замовчуванням: формат дати встановлюється в загальних параметрах WordPress;
  • $before (string, необов’язковий): Текст або HTML-код, який буде показаний до основного вмісту. Значення за замовчуванням: »;
  • $after (string, необов’язковий): Текст або HTML-код, який буде показаний після основного вмісту. Значення за замовчуванням: »;
  • $echo (bool, необов’язковий): Виводить (TRUE) або отримати (FALSE) тег. За замовчуванням: TRUE.

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

Отримуємо і виводимо час редагування запису: get_the_modified_time() і the_modified_time()

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

Параметри

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

  • $time_format (string, необов’язковий): Формат часу.

За замовчуванням: формат часу встановлюється в загальних параметрах WordPress.

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

Отримуємо і виводимо автора, отредактировавшего запис: get_the_modified_author() і the_modified_author()

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

Параметри

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

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

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

Ви можете розділяти ваші записи на аркуші за допомогою , а тег шаблон призначений для відображення цих сторінок.

Параметри

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

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

‘before’ (string): HTML-код, який відображається до виводу. За замовчуванням: ‘Сторінки:’;
‘after’ (string): HTML-код, який відображається після виводу. За замовчуванням »;
‘link_before’ (string): HTML-код, який відображається перед кожною посиланням. За замовчуванням ‘ ‘;
‘link_after’ (string): HTML-код, який відображається після кожного посилання. За замовчуванням ‘ ‘;
‘next_or_number’ (string): Показувати номери сторінок (‘number’) або посилання наступна/попередня сторінка (‘next‘). За замовчуванням ‘number’;
‘sep’ (string): Текст роздільника. За замовчуванням ‘ ‘;
‘nextpagelink’ (string): Текст посилання для переходу на наступну сторінку. За замовчуванням ‘Next Page’;
‘previouspagelink’ (string): Текст посилання для переходу на попередню сторінку. За замовчуванням ‘Попередня Сторінка’;
‘pagelink’ (string): Формат рядка для нумерації. Знак «%» буде замінено цифрами, тому можна використати тексти на кшталт «Сторінка %», щоб отримати перерахування Сторінка 1, Сторінка 2, Сторінка 3«.Значення за замовчуванням: ‘%’;
‘echo’ (integer): Виводить результат (1) або повертає його (0). Значення за замовчуванням: 1.

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

‘,
‘after’ => ‘

‘,
// Довільний символ.
‘sep’ => ‘ · ‘,
// Довільний текст посилання.
‘pagelink’ => ‘Частина %’,
// Отримання значення замість висновку.
‘echo’ => 0
);
$in_post_pagination = wp_link_pages( $args );
?>

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

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

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

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

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

Please enter your comment!
Please enter your name here