Изучаем теги шаблонов: часть первая

Изучаем теги шаблонов: часть первая
Изучаем теги шаблонов: часть вторая
Изучаем теги шаблонов: часть третья
Изучаем теги шаблонов: часть четвертая
Изучаем теги шаблонов: часть пятая
Изучаем теги шаблонов: часть шестая

В первой статье из этой серии мы познакомились с тегами шаблонов, узнали, как они работают и где применяются.

Эта часть цикла посвящена первой партии (из почти 200) тегов шаблонов. В ней мы познакомимся с тегами, связанными с заголовками, датами, контентом и другими мета данными.

Содержание

Получаем и выводим содержимое записи: get_the_content() и the_content()

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

Параметры

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

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

Примечание: существует тег <!—noteaser—>, который позволяет превратить контент после тега <!—more—> в анонс, и не показывать этот фрагмент текста на странице записи, даже если параметр $strip_teaser выставлен на FALSE.

Применение

<?php
// Получаем содержимое записи.
get_the_content();

// Отображаем содержимое записи с произвольным текстом “читать далее”
the_content( '&ndash; Читать далее &raquo;' );
?>

Получаем и выводим содержимое записи для рассылки: get_the_content_feed() и the_content_feed()

Эти теги шаблонов получают и выводят контент записей в рассылке.

Параметры

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

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

Применение

<?php
// Получаем контент для стандартного типа рассылки.
get_the_content_feed();

// Выводим контент для типа рассылки atom.
the_content_feed( 'atom' );
?>

Получаем и выводим цитаты (Excerpt) для записи: get_the_excerpt() и the_excerpt()

Эти теги шаблонов извлекают и выводят цитаты (excerpt) из записи.

Параметры

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

Применение

<?php 
// Повторяет цитату.
the_excerpt();

// Получает цитату.
$excerpt = get_the_excerpt(); 
?>

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

Этот тег шаблона выводит анонс текущей записи для последующего отображения в RSS.

Параметры

Тег не принимает параметров.

Применение

<?php
the_excerpt_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.

Применение

<?php
// Получение заголовка текущей записи со стандартными опциями.
$post_title = get_the_title();

// Вывод заголовка текущей записи, обозначенного тегом H1.
the_title( '<h1>', '</h1>' );
?>

Получаем и выводим заголовок «потерянной» записи: 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():

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>

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

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

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

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

Этот тег шаблона выводит заголовок текущей записи в отформатированном виде для RSS.

Параметры

Этот тег не принимает параметров.

Применение

<?php
the_title_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.

Применение

<?php
// Получение даты в стандартном формате.
get_the_date();

// Вывод даты в произвольном формате до или после основного контента.
the_date( 'Y-m-d', '<time>', '</time>' );
?>

Получаем и выводим дату публикации в формате ISO 8601: the_date_xml()

Этот тег шаблона выводит дату записи в формате ISO 8601.

Параметры

Этот тег не принимает параметров.

Применение

<?php
the_date_xml();
?>

Получаем и выводим время публикации записи: get_the_time() и the_time()

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

Параметры

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

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

the_time() принимает лишь один параметр:

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

Применение

<?php
// Получение информации о времени публикации записи в стандартном формате.
$post_time = get_the_time();

// Вывод времени публикации текущей записи в произвольном формате времени.
the_time( 'H:i:s' );
?>

Получаем и выводим имя автора: get_the_author() и the_author()

Эти теги шаблонов получают и выводят имя автора записи.

Параметры

Эти теги не принимают параметров.

Применение

<?php
// Выводит имя автора.
the_author();

// Получает имя автора.
$author_name = get_the_author();
?>

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

Этот тег шаблона выводит все метаданные записи в виде неупорядоченного списка.

Параметры

Этот тег не принимает параметров.

Применение

<?php
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.

Применение

<?php
// Получаем дату последнего редактирования записи в стандартном формате.
get_the_modified_date();

// Выводим дату последнего редактирования записи в произвольном формате, до или после основного контента.
the_modified_date( 'Y-m-d', '<time>', '</time>' );
?>

Получаем и выводим время редактирования записи: get_the_modified_time() и the_modified_time()

Эти теги шаблонов возвращают и выводят время редактирования записи.

Параметры

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

  • $time_format (string, необязательный): Формат времени.

По умолчанию: формат времени устанавливается в общих параметрах WordPress.

Применение

<?php
// Получаем время последнего редактирования записи в стандартном формате.
get_the_time();

// Выводим время последнего редактирования записи в произвольном формате.
the_time( 'H:i:s' );
?>

Получаем и выводим автора, отредактировавшего запись: get_the_modified_author() и the_modified_author()

Эти теги шаблонов возвращают и выводят имя автора, который последним редактировал запись.

Параметры

Эти теги шаблонов не принимают параметров.

Применение

<?php
the_modified_author();
get_the_modified_author();
?>

Получаем и выводим список страниц отдельной записи: wp_link_pages()

Вы можете разделять ваши записи на страницы при помощи <!—nextpage—>, а тег шаблона предназначен для отображения этих страниц.

Параметры

Этот тег шаблона принимает лишь один параметр:

  • $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): Текст ссылки для перехода на предыдущую страницу. По умолчанию ‘Previous Page’;
‘pagelink’ (string): Формат строки для нумерации. Знак «%» будет заменен цифрами, поэтому можно использовать тексты вроде «Страница %», чтобы получить перечисление «Страница 1, Страница 2, Страница 3«.Значение по умолчанию: ‘%’;
‘echo’ (integer): Выводит результат (1) или возвращает его (0). Значение по умолчанию: 1.

Применение

<?php 
$args = array(

    // Произвольный HTML-код перед выводом и после него.
    'before' => '<p>',
    'after' => '</p>',

    // Произвольный разделитель.
    'sep' => ' &middot; ',

    // Произвольный текст ссылки.
    'pagelink' => 'Часть %',

    // Получение значения вместо вывода.
    'echo' => 0
);

$in_post_pagination = wp_link_pages( $args );
?>

В завершение

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

Если у вас возникли какие-либо вопросы или предложения, обязательно напишите об этом в комментариях. И если вам понравилась наша статья, не забудьте поделиться ею с друзьями!

Данная публикация представляет собой перевод статьи «The Tuts+ Guide to Template Tags: First Batch» , подготовленной дружной командой проекта Интернет-технологии.ру

Меню