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