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

Ромчик
2

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



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

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.

Понравилась статья? Поделись с друзьями.
  • Add to favorites
  • Добавить ВКонтакте заметку об этой странице
  • Twitter
  • Facebook
  • Мой Мир
  • LiveJournal
  • Одноклассники
  • Блог Я.ру
  • MySpace
  • FriendFeed
  • В закладки Google
  • Google Buzz
  • Яндекс.Закладки
  • Reddit
  • StumbleUpon
  • Technorati
  • del.icio.us
  • БобрДобр
  • LinkedIn
  • Memori.ru
  • Сто закладок
  • Blogger

  • Теги для работы с миниатюрами постов WordPress | Все о WEB программировании - 26.03.2012 в 10:22

    […] мы продолжаем изучать теги для шаблонов WordPress. Так в прошлой статье мы с Вами рассмотрели теги для работы с постами WordPress. […]

  • Как ограничить количество отображаемых тегов в WordPress | Все о WEB программировании - 19.06.2013 в 08:00

    […] the_tags() Вы можете подробней почитать в моей стаье  «Теги для работы с постами в WordPress» , которая относится к серии статей посвященных […]

  • ©2012-2017 По всем вопросам обращайтесь через форму обратной связи

    Яндекс.Метрика