В первой части серии мы рассмотрели, что такое теги шаблонов, где их можно найти, как они работают и как их использовать.
Во второй части мы рассмотрим первую партию из почти 200 шаблонных тегов. В этом руководстве мы увидим теги шаблонов для данных публикации: заголовки, даты, содержимое и другие метаданные.
Получение и отображение содержимого публикации: get_the_content() & the_content()
Они могут быть самыми популярными тегами шаблонов всех времен: эти теги шаблонов возвращают или отражают содержание публикации.
параметры
Оба тега шаблона принимают два параметра:
-
$more_link_text(необязательно — строка) :
Текст для замены текста по умолчанию «(подробнее …)».
По умолчанию: «(more & hellip;)») -
$strip_teaser(необязательно — логическое) :
Уберите текст тизера.
По умолчанию:FALSE
Примечание к «тексту тизера»: Знаете ли вы, что есть тег <!--noteaser--> , чтобы сделать контент перед <!--more--> «текстом тизера» и не показывать эту часть в отдельная страница сообщения, даже если для $strip_teaser установлено значение FALSE ? Я конечно не сделал! Это не совсем неизвестно, хотя — вот пост 2009 года .
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the post content.
get_the_content();
// Display post content with a custom «read more» text.
the_content( ‘– Read More »’ );
?>
|
Получение и отображение содержимого публикации для каналов: get_the_content_feed() & the_content_feed()
Эти теги шаблонов получают и выводят контент для каналов.
параметры
Оба тега шаблона принимают только один параметр:
-
$feed_type(необязательно — строка) :
Тип корма.
(По умолчанию: тип фида по умолчанию)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the content for the default feed type.
get_the_content_feed();
// Display the content for the «atom» feed type.
the_content_feed( ‘atom’ );
?>
|
Получение и отображение get_the_excerpt() из сообщения: get_the_excerpt() & the_excerpt()
Эти теги шаблонов извлекают и отображают выдержку из сообщения.
параметры
Эти теги шаблона не принимают никаких параметров.
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Echoes the excerpt.
the_excerpt();
// Returns the excerpt.
$excerpt = get_the_excerpt();
?>
|
Отображение выдержки из сообщения для каналов: the_excerpt_rss()
Этот тег шаблона готовит отрывок к записи и выводит его.
параметры
Этот шаблон тега не принимает никаких параметров.
использование
|
1
2
3
4
5
|
<?php
the_excerpt_rss();
?>
|
Получение и отображение заголовка сообщения: get_the_title() & the_title()
Эти теги шаблонов позволяют вам возвращать или отображать заголовки ваших сообщений.
параметры
get_the_title() принимает три параметра:
-
$post_ID(необязательно — целое число или объект) :
Идентификатор поста.
(По умолчанию: текущий пост)
И the_title() принимает три параметра:
-
$before(необязательно — строка) :
Текст или HTML-код для отображения перед выводом.
(По умолчанию: пусто) -
$after(необязательно — строка) :
Текст или HTML-код для отображения после вывода.
(По умолчанию: пусто) -
$echo(необязательно — логическое) :
Будь эхо (TRUE) или вернуть (FALSE) тег.
(По умолчанию:TRUE)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the current post’s title with default options.
$post_title = get_the_title();
// Display the current post’s title wrapped with a H1 tag.
the_title( ‘<h1>’, ‘</h1>’ );
?>
|
Получение и отображение заголовка сообщения « the_title_attribute() : the_title_attribute()
Этот тег шаблона берет заголовки ваших сообщений и готовит их для использования в значениях атрибутов HTML. Смотрите пример для дальнейшего объяснения.
параметры
Этот шаблонный тег принимает только один параметр:
-
$args(необязательно — массив) :
Массив следующих аргументов:-
'before'(строка): HTML-код, добавляемый перед выводом.
(По умолчанию: пусто) -
'after'(строка): HTML-код, добавляемый после вывода.
(По умолчанию: пусто) -
'echo'(логическое значение): выводить тег шаблона или нет.
(По умолчанию:TRUE) -
'post'(объект): текущий объект записи, из которого можно получить заголовок.
(По умолчанию: 0)
-
использование
Давайте возьмем этот заголовок в качестве примера:
Билл и Мелинда Гейтс тратят миллиарды на благотворительность, говорят: «Мы сделали ???»
Заголовок содержит две кавычки и один амперсанд, который испортит ваш HTML-код, если он используется внутри атрибута HTML, потому что атрибуты также заключены в кавычки. Вот где the_title_attribute() пригодится:
|
1
|
<a href=»<?php the_permalink(); ?>» title=»<?php the_title_attribute(); ?>»><?php the_title();
|
Теперь атрибут title ссылки выглядит так:
Билл & amp; Мелинда Гейтс тратит миллиарды на благотворительность, скажи «мы сделали ???»
И вот так, он не испортит HTML с неэкранированными кавычками и амперсандами.
Отображение заголовка сообщения для каналов: the_title_rss()
Этот шаблонный тег получает ваш заголовок, готовит его для каналов и отображает его.
параметры
Этот шаблон тега не принимает никаких параметров.
использование
|
1
2
3
4
5
|
<?php
the_title_rss();
?>
|
Получение и отображение даты публикации: get_the_date() & the_date()
Эти теги шаблонов извлекают и отображают дату публикации.
параметры
get_the_date() принимает два параметра:
-
$date_format(необязательно — строка) :
Формат даты.
(По умолчанию: формат даты установлен на странице общих параметров) -
$post_ID(необязательно — целое число или объект) :
Идентификатор поста.
(По умолчанию: текущий пост)
И the_date() принимает четыре параметра:
-
$date_format(необязательно — строка) :
Формат даты.
(По умолчанию: формат даты установлен на странице общих параметров) -
$before(необязательно — строка) :
Текст или HTML-код для отображения перед выводом.
(По умолчанию: пусто) -
$after(необязательно — строка) :
Текст или HTML-код для отображения после вывода.
(По умолчанию: пусто) -
$echo(необязательно — логическое) :
Будь эхо (TRUE) или вернуть (FALSE) тег.
(По умолчанию:TRUE)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the date with the default date format.
get_the_date();
// Display the date with a different date format and some before & after content.
the_date( ‘Ym-d’, ‘<time>’, ‘</time>’ );
?>
|
Получение и отображение даты публикации в формате ISO 8601: the_date_xml()
Эти теги шаблона возвращают и отображают дату публикации в формате ISO 8601.
параметры
Этот шаблон тега не принимает никаких параметров.
использование
|
1
2
3
4
5
|
<?php
the_date_xml();
?>
|
Получение и отображение времени публикации: get_the_time() & the_time()
Эти шаблоны возвращают или отображают время публикации.
параметры
get_the_time() принимает два параметра:
-
$time_format(необязательно — строка) :
Формат времени.
(По умолчанию: формат времени установлен на странице «Общие параметры») -
$post_ID(необязательно — целое число или объект) :
Идентификатор поста.
(По умолчанию: текущий пост)
И the_time() принимает только один параметр:
-
$time_format(необязательно — строка) :
Формат времени.
(По умолчанию: формат времени установлен на странице «Общие параметры»)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get current post’s publish time with the default time format.
$post_time = get_the_time();
// Display current post’s publish time with a custom time format.
the_time( ‘H:i:s’ );
?>
|
Получение и отображение имени автора: get_the_author() & the_author()
Эти шаблоны тегов получают или отображают имя автора поста.
параметры
Эти теги шаблона не принимают никаких параметров.
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Echoes the author name.
the_author();
// Returns the author name.
$author_name = get_the_author();
?>
|
Отображение всех метаданных поста: the_meta()
В этом теге шаблона перечислены все метаданные сообщения с неупорядоченным списком.
параметры
Этот шаблон тега не принимает никаких параметров.
использование
|
1
2
3
4
5
|
<?php
the_meta();
?>
|
Получение и отображение даты изменения сообщения: get_the_modified_date() & the_modified_date()
Эти теги шаблона получают и отражают дату последнего изменения поста.
параметры
get_the_modified_date() принимает только один параметр:
-
$date_format(необязательно — строка) :
Формат даты.
(По умолчанию: формат даты установлен на странице общих параметров)
И the_modified_date() принимает четыре параметра:
-
$date_format(необязательно — строка) :
Формат даты.
(По умолчанию: формат даты установлен на странице общих параметров) -
$before(необязательно — строка) :
Текст или HTML-код для отображения перед выводом.
(По умолчанию: пусто) -
$after(необязательно — строка) :
Текст или HTML-код для отображения после вывода.
(По умолчанию: пусто) -
$echo(необязательно — логическое) :
Будь эхо (TRUE) или вернуть (FALSE) тег.
(По умолчанию:TRUE)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the last modification date with the default date format.
get_the_modified_date();
// Display the last modification date with a different date format and some before & after content.
the_modified_date( ‘Ym-d’, ‘<time>’, ‘</time>’ );
?>
|
Получение и отображение времени модификации сообщения: get_the_modified_time() & the_modified_time()
Эти теги шаблонов извлекают и выводят время модификации поста.
параметры
Оба тега шаблона принимают только один параметр:
-
$time_format(необязательно — строка) :
Формат времени.
(По умолчанию: формат времени установлен на странице «Общие параметры»)
использование
|
1
2
3
4
5
6
7
8
9
|
<?php
// Get the last modification time with the default time format.
get_the_time();
// Display the last modification time of the post with a different time format.
the_time( ‘H:i:s’ );
?>
|
Получение и отображение автора, который редактировал текущее сообщение: get_the_modified_author() & the_modified_author()
Эти теги шаблона извлекают и отображают автора, который изменил сообщение последним.
параметры
Эти теги шаблона не принимают никаких параметров.
использование
|
1
2
3
4
5
6
|
<?php
the_modified_author();
get_the_modified_author();
?>
|
Получение и отображение списка страниц постраничных сообщений: wp_link_pages()
Вы можете разделить свои посты на страницы с помощью <!--nextpage--> , и этот тег шаблона поможет вам перечислить эти страницы.
параметры
Этот шаблонный тег принимает только один параметр:
-
$args(необязательно — массив) :
Массив следующих аргументов:-
'before'(строка): HTML-код, добавляемый перед выводом.
По умолчанию: «<p> Страницы:» -
'after'(строка): HTML-код, добавляемый после вывода.
По умолчанию: «</ p>» -
'link_before'(строка): HTML-код, добавляемый перед каждой ссылкой.
(По умолчанию: ») -
'link_after'(строка): HTML-код, добавляемый после каждой ссылки.
(По умолчанию: ») -
'next_or_number'(строка): показывать ссылки на номера страниц («номер») или «следующая (или предыдущая) страница» («далее»).
(По умолчанию: «число») -
'sep'(строка): разделитель текста.
(По умолчанию: ‘ ‘) -
'nextpagelink'(строка): текст ссылки «следующая страница».
(По умолчанию: «Следующая страница») -
'previouspagelink'ссылка'previouspagelink'(строка): текст ссылки «предыдущая страница».
(По умолчанию: «Предыдущая страница») -
'pagelink'(строка): формат ссылок ‘якорных текстов, если для’ next_or_number ‘установлено значение’ number ‘. Символ «%» будет заменен номером страницы, поэтому вы можете использовать значение, например «Page%», для создания ссылок, таких как «Страница 1, Страница 2, Страница 3».
(По умолчанию: ‘%’) -
'echo'(целое число): выводить ли вывод (1) или возвращать его (0).
(По умолчанию: 1)
-
использование
|
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
|
<?php
$args = array(
// Custom HTML before & after output.
‘before’ => ‘<p>’,
‘after’ => ‘</p>’,
// Custom separator.
‘sep’ => ‘ ·
// Custom page links.
‘pagelink’ => ‘Part %’,
// Return the output instead of echoing.
‘echo’ => 0
);
$in_post_pagination = wp_link_pages( $args );
?>
|
Вывод
Надеюсь, вам понравилась эта первая партия тегов шаблонов. Осталось еще семь пакетов, так что следите за обновлениями тегов шаблонов!
Если у вас есть какие-либо вопросы, комментарии или исправления, вы можете поделиться с нами своими мыслями в разделе «Комментарии». И если вам понравилась статья, не забудьте поделиться ею с друзьями!