Теги для работы с постами в WordPress
Доброго времени суток. Мы с Вами продолжаем изучать основные теги для работы с шаблонами 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.
[…] мы продолжаем изучать теги для шаблонов WordPress. Так в прошлой статье мы с Вами рассмотрели теги для работы с постами WordPress. […]
[…] the_tags() Вы можете подробней почитать в моей стаье «Теги для работы с постами в WordPress» , которая относится к серии статей посвященных […]