Доброго времени суток. Мы с Вами продолжаем изучать основные теги для работы с шаблонами WordPress. Так в прошлом посте мы рассмотрели теги для работы с ссылками. А сегодня остановимся на тегах для работы с постами в WordPress. Как Вы можете догадаться посты являются важнейшей составляющей любого интернет ресурса. Поэтому и тегам для работы с постами уделяется большое внимание. Ну, что ж приступим.

Теги для работы с постами в WordPress:

• body_class
• next_image_link
• next_post_link
• next_posts_link
• post_class
• post_password_required
• posts_nav_link
• previous_image_link
• previous_post_link
• previous_posts_link
• single_post_title
• sticky_class
• the_category
• the_category_rss
• the_content
• the_content_rss
• the_excerpt
• the_excerpt_rss
• the_ID
• the_meta
• the_shortlink
• the_tags
• the_title
• the_title_attribute
• the_title_rss
• wp_link_pages
• get_attachment_link
• wp_get_attachment_link
• the_attachment_link
• the_search_query
• is_attachment
• wp_attachment_is_image
• wp_get_attachment_image
• wp_get_attachment_image_src
• wp_get_attachment_metadata
• get_the_date
• single_month_title
• the_date
• the_date_xml
• the_modified_author
• the_modified_date
• the_modified_time
• the_time
• the_shortlink
• wp_get_shortlink

body_class()
Добавляет CSS класс. Позволяет добавить один или несколько классов разделенных пробелами. В качестве параметра принимает $class — название класса.
Пример:

>

К списку тегов

next_image_link()
Создает ссылку на следующее изображение текущего поста. В качестве параметров принимает:

• $size — размер картинки, по умолчанию миниатюра
• $text — если true, то ссылка будет ввиде текста, по умолчанию false

Пример:

<!--?php next_image_link(); ?-->

К списку тегов

next_post_link()
Отображает ссылку на следующий пост. Используется внутри механизма The Loop. Принимает следующие параметры:

• ‘format’ — формат строки для ссылки
• ‘link’ — текст ссылки, по умолчанию %title
• ‘in_same_cat’ — если установлен true, то посты будут изображаться только из данной категории, по умолчанию False
• ‘excluded_categories’ — ID категорий из которых не будут показываться посты

К списку тегов

next_posts_link()
Выводит список ссылок на следующие посты. Если необходимо не вывести, а вернуть ссылки, то используйте функцию get_next_posts_link(). В качестве параметров принимает:

• $label — текст ссылки
• $max_pages — ограничение на показ ссылок, по умолчанию без ограничений

К списку тегов

post_class()
Устанавливает CSS класс поста, например

</pre>
<div id="post">
 >

К списку тегов

post_password_required()
Проверяет пароль для сообщения. В качестве параметра принимает $post — ID поста. Данная функция возвращает true или false.

К списку тегов

posts_nav_link()
Отображает ссылки на следующую и предыдущую страницу. Необходима для постраничной навигации. Принимает следующие параметры:

• $sep — текст между ссылками
• $prelabel — текст ссылки на предыдущую страницу
• $nextlabel — текст ссылки на следующую страницу

К списку тегов

previous_image_link()
Создает ссылку на предыдущее изображение текущего поста. В качестве параметров принимает:

• $size — размер картинки, по умолчанию миниатюра
• $text — если true, то ссылка будет ввиде текста, по умолчанию false

Пример:

<!--?php previous_image_link(); ?-->

К списку тегов

previous_post_link()
Отображает ссылку на предыдущий пост. Используется внутри механизма The Loop. Принимает следующие параметры:

• ‘format’ — формат строки для ссылки
• ‘link’ — текст ссылки, по умолчанию %title
• ‘in_same_cat’ — если установлен true, то посты будут изображаться только из данной категории, по умолчанию False
• ‘excluded_categories’ — ID категорий из которых не будут показываться посты

К списку тегов

previous_posts_link()
Выводит список ссылок на предыдущие посты. Если необходимо не вывести, а вернуть ссылки, то используйте функцию get_previous_posts_link(). В качестве параметров принимает:

• $label — текст ссылки
• $max_pages — ограничение на показ ссылок, по умолчанию без ограничений

К списку тегов

single_post_title()
Отображает или возвращает название поста, когда пост один на странице. Используется вне механизма The Loop. Принимает следующие параметры:

• $prefix — текст перед заголовком
• $display — true для отображения заголовка и false для возвращения значения заголовка.

К списку тегов

sticky_class()
Отображает прикрепленный CSS класс поста. Применяется внутри механизма The Loop.

К списку тегов

the_category()
Отображает ссылку на категорию или категории к которым принадлежит данное сообщение. Используется внутри механизма The Loop. Принимает следующие параметры:

• $separator — текст между ссылками
• $parents — как отображать ссылки, которые находятся в дочерних категориях: multiple — показывает родительские и дочерние категории как отдельные, single — показывает ссылку только на дочернюю категорию
• $post_id — ID поста, если данная функция используется за пределами механизма The Loop.

К списку тегов

the_category_rss()
Показывает сообщения категории в потоке. В качестве параметра принимает $type — тип потока rss, atom, rdf. По умолчанию RSS.

К списку тегов

the_content()
Показывает контент для текущего сообщения. Используется в механизме The Loop. В качестве параметров принимает:

• $more_link_text — текст ссылки для отображения полного текста поста
• $stripteaser — скрыть текст перед ссылкой Далее, по умолчанию false.

К списку тегов

the_content_rss()
Отображает контент поста в потоке. В качестве параметров принимает следующие значения:

• $more_link_text — текст ссылки на полное содержание поста

• $stripteaser — скрыть текст перед ссылкой Далее, по умолчанию false.
• $more_file — ссылка на файл

• $cut — количество слов выводимых до конца сообщения
• $encode_html — как будет отображаться контент, фильтры.

К списку тегов

the_excerpt()
Отображает цитату из сообщения. В конце будет стоять […]. Данный тег должен находиться внутри механизма The Loop. По умолчанию будет показываться первые 55 слов.
Пример:

<!--?php if ( is_category() || is_archive() ) { the_excerpt(); } else { the_content(); } ?-->

К списку тегов

the_excerpt_rss()
Показывает цитату из сообщения в потоке.

К списку тегов

the_ID()
Отображает ID текущего поста. Используется внутри механизма The Loop. Если необходимо не вывести, а получить ID для дальнейшей обработки, то необходимо использовать get_the_ID.

К списку тегов

the_meta()
Выводит дополнительных полей текущего сообщения. Должен использоваться внутри механизма The Loop или на странице шаблона, где выводиться один пост, например single.php.

К списку тегов

the_shortlink()
Возвращает короткую ссылку на пост, по умолчанию /?id=123. Принимает следующие параметры:

• $text — выводит текст ссылки
• $title — текст всплывающей подсказки
• $before — текст перед ссылкой
• $after — текст после ссылки

К списку тегов

the_tags()
Отображает ссылку на тег или теги. Используется внутри механизма The Loop. Принимает следующие параметры:

• $before — текст перед ссылкой
• $sep — разделительный текст между ссылками
• $after — текст после ссылки

К списку тегов

the_title()
Отображает или возвращает заголовок текущего поста. Используется внутри механизма The Loop. Принимает следующие значения:

• $before — текст перед заголовком
• $after — текст после заголовка
• $echo — показывать (true) или вернуть(false)

К списку тегов

the_title_attribute()
Отображает или возвращает заголовок текущего поста. Но в отличие от the_title() выводит чистый заголовок без тегов HTML. Должен использоваться внутри механизма The Loop. В качестве параметров принимает:

• $before — текст перед заголовком
• $after — текст после заголовка
• $echo — показывать (true) или вернуть(false)

К списку тегов

the_title_rss()
Выводит заголовок поста в потоке.

К списку тегов

wp_link_pages()
Отображает навигацию по постам. Используется внутри механизма The Loop. В качестве параметров принимает массив

<?php $args = array(
    'before'           => '<p>' . __('Pages:'),
    'after'            => '</p>',
    'link_before'      => ,
    'link_after'       => ,
    'next_or_number'   => 'number',
    'nextpagelink'     => __('Next page'),
    'previouspagelink' => __('Previous page'),
    'pagelink'         => '%',
    'more_file'        => ,
    'echo'             => 1 ); ?>

где:

• before — текст перед ссылками
• after — текст после ссылок
• link_before — текст, который идет непосредственно перед текстом ссылки
• ink_after — текст, который идет непосредственно после текста ссылки
• next_or_number — указывает как отображены номера страниц, принимает: number — номер страницы отображается числом (по умолчанию) или ссылкой next.
• nextpagelink — текст ссылки на следующую страницу
• previouspagelink — текст ссылки на предыдущую страницу
• pagelink — формат строки для номера страницы %, так например, если указать Страница%, то будет отображаться Страница<номер страницы>
• more_file — указывает ссылку на файл страницы, по умолчанию текущий файл
• echo — отобразить или вернуть результат для дальнейшей обработки, по умолчанию 1 — показывает результат.

Пример:

<?php wp_link_pages(); ?>

К списку тегов

get_attachment_link()
Возвращает URI на страницу приложения. В качестве параметра принимает $id — приложения. Если используется внутри механизма The Loop, то на текущую страницу.

К списку тегов

wp_get_attachment_link()
Возвращает HTML гиперссылки на вложенный файл или страницу. Принимает следующие параметры:

• $id — ID искомого приложения
• $size — размер изображения, принимает следующие значения: thumbnail, medium, large or full, либо массив из двух элементов: ширина и высота
• $permalink — прямая ссылка на файл (false — по умолчанию) или на страницу с вложением (true)
• $icon — использовать иконку для вложения, по умолчанию false
• $text — отображает текстовую ссылку на вложение, по умолчанию false

К списку тегов

the_attachment_link()
Выводит ссылку на вложение или страницу с вложением. Принимает следующие параметры:

• $id — ID искомого приложения
• $fullsize — для графического изображения используется оригинальный размер (true), значок, который создается WordPress (false -по умолчанию)
• $deprecated — максимальная размер изображения
• $permalink — прямая ссылка на файл вложения (false — по умолчанию) или на страницу с вложением (true)

К списку тегов

the_search_query()
Показывает текущий запрос, если таковой был.

К списку тегов

is_attachment()
Это условный тег, который проверяет вложение загружено или нет

К списку тегов

wp_attachment_is_image()
Эта функция проверяет является ли вложение изображением. Если да, то возвращает TRUE. Проверяет следующие расширения .jpg, .jpeg, .gif, .png. В качестве параметра принимает $post_id — ID поста.

К списку тегов

wp_get_attachment_image()
Возвращает HTML-элемент изображения, которое представлено вложенным файлом. В качестве параметров принимает:

• $attachment_id — ID искомого приложения

• $size — размер изображения, принимает следующие значения: thumbnail, medium, large or full, либо массив из двух элементов: ширина и высота

• $icon — использовать значок для представления вложения. По умолчанию: false
• $attr — строка запроса или массив атрибутов

$default_attr = array(
'src'    => $src,
'class'    => "attachment-$size",
'alt'   => trim(strip_tags( get_post_meta($attachment_id, '_wp_attachment_image_alt', true) )),
'title' => trim(strip_tags( $attachment->post_title )),
);

К списку тегов

wp_get_attachment_image_src()
Возвращает массив с атрибутами вложенного изображения: URL, ширина и высота. Принимает следующие параметры:

• $attachment_id — ID приложения
• $size — размер изображения (thumbnail, medium, large, full или массив из двух элементов ширина и высота)
• $icon — использовать значок для представления вложения. По умолчанию: false.

Возвращает массив $arr, где:

• $arr[0] — URL
• $arr[1] — ширина
• $arr[2] — высота

К списку тегов

wp_get_attachment_metadata()
Получает мета поля вложения. В качестве параметров принимает:

• $post_id — ID приложения
• $unfiltered — если true, то фильтры не работают. По умолчанию false.

К списку тегов

get_the_date()
Возвращает дату написания текущего поста. В качестве параметра принимает $d — дата в PHP формате.
Пример:

<span><?php echo get_the_date(); ?></span>

К списку тегов

single_month_title()
Возвращает название месяца и года для текущей страницы. Работает только на страницах архива. В качестве параметров принимает:

• $prefix — текст перед заголовком.
• $display — отображать (true) или вернуть (false) значения для дальнейшей обработки.

К списку тегов

the_date()
Возвращает дату поста или несколько постов, опубликованных в одно время. Используется в механизме The Loop. В качестве параметров принимает:

• $format — формат даты, используется формат даты, который установлен в настройках WordPress
• $before — текст перед датой
• $after — текст после даты
• $echo — выводить (true) или возвращать (false) значение

К списку тегов

the_date_xml()
Отображает дату поста в формате YYYY-MM-DD, например (2012-03-19) Должен использоваться внутри механизма The Loop.

К списку тегов

the_modified_author()
Отображает автора, который последний внес изменения в текущий пост. Используется внутри механизма The Loop.

К списку тегов

the_modified_date()
Отображает дату и время последнего изменения текущего поста. Используется внутри механизма The Loop. В качестве параметров принимает:

• $d — формат даты, используется формат указанный в настройках WordPress
• $before — текст перед датой
• $after — текст после даты
• $echo — отображать (true) или возвращать (false) дату.

К списку тегов

the_modified_time()
Отображает время последнего редактирования данного поста. Используется внутри механизма The Loop. В качестве параметра принимает $d — формат времени, используется формат, который указан в настройках WordPress.

К списку тегов

the_time()
Отображает время текущего поста. Используется внутри механизма The Loop. В качестве параметра принимает $d — формат времени, который указан в настройках WordPress.

К списку тегов

the_shortlink()
Используется на страницах сообщений и отображает постоянную ссылку. Используется внутри механизма The Loop. В качестве параметров принимает следующие значения:

• $text — текст ссылки
• $title — текст всплывающей подсказки
• $before — текст перед ссылкой
• $after — текст после ссылки

К списку тегов

wp_get_shortlink()
Возвращает ссылку на сообщение, но не отображает ее. В качестве параметров принимает:

• $id — ID поста или блога
• $context — использовать ID blog, post или media.
• $allow_slugs — допускать ли использование альтернативных названий (true)

К списку тегов

На этом мы с Вами рассмотрели теги для работы с постами в WordPress. Данный пост получился достаточно большим, но и в то же время необходимым для продолжения создания собственной темы для WordPress. А на этом я заканчиваю.
В следующей статье мы поговорим о тегах для работы с миниатюрами постов, так, что не пропускайте выхода новых постов, подписавшись на RSS-рассылку данного блога.
Всем удачного изучения WordPress.