Плагин Display Posts Shortcode для WordPress – позволяет вывести последние записи с миниатюрами с помощью шорткода

1 Июня 2013 | Автор: Дунин Владимир

Если требуется вывести список записей с миниатюрами на произвольную страницу, можно прибегнуть к различным способам, но на мой взгляд самый простой и практичный - воспользоваться плагином Display Posts Shortcode. Вставив шорткод на страницу в визуальном редакторе, и добавив нужные аргументы, можно добиться желаемого результата. Оформить выводимый список под дизайн блога можно, добавив в файл CSS темы нужные стили.

Плагин использует аргументы на основе тегов, категорий, типов записей, и др. Также есть несколько дополнительных параметров, с помощью которых можно выводить кроме названий записей еще и дату, текстовую выдержку из статьи, размер миниатюры.

Если нужно вывести список записей с заголовками, текстовыми выдержками, миниатюрами, с выравниванием по левому краю, можно использовать такой шорткод:

[display-posts include_excerpt="true" image_size="thumbnail" wrapper="div"]
Шорткод содержит параметр вывода выдержки, миниатюры с размером "thumbnail" (задается в настройках медиафайлов: "Параметры > Медиафайлы"), а также оборачивает выводимые элементы в блоки.

Плагин не содержит собственных стилей для выводимого списка, так что оформление придется делать самостоятельно (что на мой взгляд является большим плюсом). Чтобы задать блоку с выводимым элементом обтекание слева, добавьте следующий стиль в свою таблицу стилей:

.display-posts-listing .listing-item {
clear: both;
}

.display-posts-listing img {
float: left;
margin: 0 10px 10px 0;
}

Несколько примеров

[display-posts tag="advanced" posts_per_page="20"]
Этот шорткод выведет 20 последних записей с тегом "advanced".
[display-posts tag="advanced" image_size="thumbnail"]
Такой шорткод выведет 10 последних записей с тегом "advanced", и выведет миниатюры записей с размером "thumbnail".
[display-posts category="must-read" posts_per_page="-1" include_date="true" order="ASC" orderby="title"]
Этот шорткод выведет список записей из категории "must-read" , в алфавитном порядке, с указанием даты, добавленной в конце.
[display-posts taxonomy="color" tax_term="blue" include_excerpt="true"]
Выведет названия и текстовые выдержки из 10 последних записей с меткой "blue" в пользовательской таксономии "цвет".
[display-posts wrapper="ol"]
Шорткод выведет записи на странице в виде упорядоченного списка. Возможные варианты: ul - неупорядоченный список (по умолчанию), ol - упорядоченный список, div - для блочной разбивки.
[display-posts id="14,3"]
Отобразит только записи с идентификаторами 14 и 13.

Аргументы

author

Указывает автора записи. По умолчанию: нет.

Пример:

 
[display-posts author="bill"]

category

Указывает название категории (либо несколько категорий, разделенных запятыми). По умолчанию: нет.

Пример:

[display-posts category="fishing,hiking"]

date_format

Указывает формат выводимой даты, при условии наличия аргумента include_date="true". Формирование даты и времени в wordpres будет рассмотрено в другой статье. По умолчанию: '(n/j/Y)'

Пример:

[display-posts include_date="true" date_format="F j, Y"]

id

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

Пример:

 
[display-posts id="9, 10"]

image_size

Если запись имеет миниатюру, этот аргумент выведет ее. Принимает значения: thumbnail, medium, large (эти размеры устанавливаются в настройках WordPress "Параметры > Медиафайлы"). Также есть возможность установить произвольные размеры выводимых миниатюр. По умолчанию: нет.

Пример:

[display-posts image_size="thumbnail"]

include_date

Добавляет дату записи после его заголовка. Формат по умолчанию (7/30/12), можно изменить с помощью параметра "date_format". По умолчанию: нет.

Пример:

 
[display-posts include_date="true"]

include_excerpt

Выводит отрывок записи после названия (и даты, если включено). По умолчанию: нет.

Пример:

 
[display-posts include_excerpt="true"]

offset

Количество записей, которые нужно пропустить (не выводить). По умолчанию: 0

Пример:

 
[display-posts offset="3"]

order

Указывает как сортировать список записей, по убыванию (DESC) или по возрастанию (ASC). По умолчанию: DESC

Пример:

 
[display-posts order="ASC"]

orderby

Можно указать по каким параметрам сортировать список. По умолчанию сортирует по дате создания записей. По умолчанию: date

Пример:

 
[display-posts orderby="title"]

post_parent

Отображение страниц, которые являются дочерними для определенной страницы. Можно указывать "ID" страницы, либо указать текущую страницу "current", дети которой будут отображены. По умолчанию: нет.

Пример:

 
[display-posts post_type="page" post_parent="8"]

post_status

Выводит записи с определенным статусом. По умолчанию выводит опубликованные посты. По умолчанию: publish

Пример:

 
[display-posts post_status="publish, future"]

post_type

Указывает на тип выводимых записей. Можно использовать стандартные типы (post или page), либо любой пользовательский тип записи, созданный вами. По умолчанию: post

Пример:

 
[display-posts post_type="event"]

posts_per_page

Количество выводимых записей. По умолчанию: 10

Пример:

 
[display-posts posts_per_page="5"]

tag

Выводит записи с определенным тегом (или тегами). По умолчанию: нет.

Пример:

 
[display-posts tag="tag1, tag2"]

taxonomy, tax_term, и tax_operator

Эти параметры используются для создания расширенных запросов таксономии. taxonomy используется для запроса определенной таксономии, tax_term для включения определенных условий, и tax_operator для того, чтобы изменить способ запроса (скорее всего это не будет использоваться). По умолчанию: 'taxonomy' = empty , 'tax_term' = empty , 'tax_operator' = 'IN'

Пример:

 
[display-posts taxonomy="color" tax_term="blue, green"]

wrapper

Указывает на то, какой тип html-разметки использовать для вывода списка. Может быть неупорядоченный список (ul), упорядоченный список (ol) и блоки (div), для которых потом можно будет задать собственный стиль. По умолчанию: ul

Пример:

  
[display-posts wrapper="ol"]
 

Несколько запросов таксономии

Хотя для большинства задач можно использовать только один запрос таксономии, этот плагин поддерживает бесконечно большое количество запросов. Допустим нужно вывести все записи из раздела "featured" а также записи с тегами "homepage".  Выглядеть такой запрос будет следующим образом:
[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="homepage"]
Строку можно формировать как угодно, только начать отсчет с цифры 2. В нижеприведенных аргументах нужно заменить (count) на фактическое число: Доступные поля:  

taxonomy_(count)

Какую использовать таксономию для запроса. По умолчанию: нет.

tax_(count)_term

Какие условия включить (если их несколько, то нужно разделять запятыми). По умолчанию: нет.

tax_(count)_operator

Как запрашивать условия (IN, NOT IN, или AND). По умолчанию: IN

tax_relation

Описывает взаимосвязь между несколькими запросами таксономии (результат должен соответствовать всем запросам или только одному из них). Доступные варианты AND и OR. По умолчанию: AND