Вывести посты с тегами

Как отобразить тэги (метки) на страницах WordPress

Разница между записями (постами) и страницами в WordPress

Как написано в документации WordPress, записи (посты) — это сообщения вашего блога, то, что вы обычно и пишете каждый день. Страницы — это информационные страницы, например «О сайте», «Контакты» и т. п. Записи (посты) попадают в ленту новостей, их можно выводить в хронологическом порядке на главной странице сайта, т. е. они связаны с временем публикации. К записям можно указать Формат, задать Рубрику(и), написать Метки. К страницам этого указать нельзя, но можно выбрать некоторые атрибуты, например, Родительскую страницу, Порядковый номер при отображении и т. д. Т.е. страницы можно организовать иерархически с многоуровневым вложением (записи можно вложить только в рубрики).

Как уже было упомянуто, для страниц нельзя задать тэги.

Зачем задавать метки (тэги) для страниц в WordPress

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

Например, я хочу сделать небольшой справочник прямо на своём сайте, работающем на WordPress. Этот справочник будет состоять из страницы оглавления и вложенных страниц, на которые ссылаются пункты оглавления. Для этого мне, конечно же, нужно выбрать такой формат как Страницы: эти справочные страницы не будут засорять ленты новостей моих подписчиков, не будут отображаться на главной и т. д. Но я хочу, чтобы для этих страниц также работал плагин Similarity (работает на основе тэгов), да и сами по себе тэги мне нравятся — страницы по темам сайта, а некоторые посетители кликают на тэги, чтобы увидеть всю доступную информацию по этому вопросу.

Окей, думаю, я у вас убедил, что иногда тэги нужны и для страниц. А теперь я расскажу как добавить тэги на страницы WordPress.

Включение тэгов (меток) для страниц в WordPress

Нам нужен… ну конечно плагин. Пожалуй, нет такой такой вещи, для которой не был бы сделан плагин WordPress. Плагинов для добавления тэгов несколько, я выбрал TagPages. (Если вы хотите не только добавлять тэги к страницам, но ещё и помещать страницы в Рубрики, то вместо названного плагина установите плагин Category Tag Pages).

Отлично, уже на этом этапе мы можем добавлять к страницам тэги:

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

Показ тэгов (меток) на страницах WordPress

К сожалению, это чуть сложнее. Нам нужно редактировать исходный код. В панели управления перейдите к пункту Внешний вид, а затем в Редактор. Выберите для редактирования файл content-page.php. В зависимости от темы, содержание этого файла может варьироваться.

И после неё вставляем следующий код:

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

Источник

Как в WordPress вывести только отдельные теги к записям

Как отобразить в WordPress один или несколько тегов для записи (статьи, поста) или категории (раздела), которые принадлежат этой записи.

Стандартный вывод меток (тегов)

Для вывода всех тегов (меток) у сайта на WordPress есть стандартные конструкции и его разновидности.

Вывод через запятую всех меток, которые прикреплены к записи. Перед тегами будет заголовок «Метки»:

Меняем текст и разделитель:

Вывод тегов списком:

Нестандартный вывод меток (тегов)

Что если нужно вывести не все метки, а только некоторые из них?

Для этих целей подойдёт следующий код:

‘Название_тега1’,
‘slug_name2’ => ‘Название_тега2’,
);

// Массив для хранения совпадающих тегов
$found_tag = array();

// Разделитель между каждым тегом
$seperator = ‘ — ‘;

// Если у нас есть хоть один тег
if( has_tag( $find_tags ) ) :

// Перебираем массив тегов
foreach( $find_tags as $slug => $name ) :

// Если тег соответсвует перебору, добавляем к массиву данных
if( has_tag( $slug ) )
$found_tag[] = » $name «;

// Соединяем результаты вместе используя разделитель там где это требуется
echo ‘

В этом участке кода:

«Название тега» должно соответствовать заданному в WordPress. Если вписать другое название, данная метка не будет показана.

Отдельные PHP коды для вывода меток

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

Читайте также

Кстати, на сайте нет рекламы. У сайта нет цели самоокупаться, но если вам пригодилась информация можете задонатить мне на чашечку кофе в макдаке. Лайкнуть страницу или просто поблагодарить. Карма вам зачтется.

Комментарии к статье “ Как в WordPress вывести только отдельные теги к записям ” (3)

• 

Спасибо.
А как сделать чтобы выводились все метки поста, кроме одно заданной.

• 

Сам не выводил, советовать непроверенное не буду, но в погуглив найдете много примеров. Ищите по английским ключевым словам: the_tags exept one

Источник

the_tags() WP 2.3.0

Выводит ссылки на метки, которые относятся к посту.

Нужно использовать внутри Цикла WordPress.

Возвращает

null . Выводит HTML код на экран.

Использование

Примеры

#1. Ссылки на метки поста

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

#2. Изменим начальный текст и разделитель между метками:

#3. Выведем метки в списке

:

Список изменений

Код the_tags() the tags WP 5.8.1

Cвязанные функции

loop (Цикл WP)

Для записей

Записи: посты, страницы, .

Здравствуйте, а как можно сделать так, чтобы слово «Метки» в первом » не размещалось, а то оно по умолчанию стоит? Спасибо.

Просто нужно поставить две одинарные кавычки, вот так the_tags(»). В статье есть переменная $before — она за это и отвечает.

Необходимо, в теле читаемого поста, вывести заголовки двух других постов — связанных с читаемым — метками.
Есть варианты ?

Привет. Как то делал урок про шорткоды и там подобный пример был.

Спасибо Юрию Белотицкому (blog.portal.kharkov.ua) за помощь.
Вот код, если кому будет нужен:

Добрый день, подскажите пожалуйста, можно ли вывести метку обычным текстом, не ссылой? Или же данным тэгом только ссылка выводится?

Подскажите пожалуйста как сделать вывод тегов (метки) термы произвольного типа записи?

, где ‘services’ — таксономия в виде категорий
, где ‘mylabel’ — таксономия в виде тегов (метки)
, где ‘uslugi’ — созданный тип записи.

Создал новый тип записи, затем файл таксономии (taxonomy-services.php) в котором выводится списком (тут весь код с описанием и вопросом) все наименования относящиеся к конкретной терме.

Однако, если сделать файл таксономии в виде taxonomy-mylabel.php, то при переходе на любую созданную терму содержащейся в ‘mylabel’ (как тег(метки)) выводит все записи относящиеся к конкретной терме (при коде в этом файле равнозначном для архивной страницы).

Вообщем бьюсь уже давно и ни как не получается сделать вывод с учётом тегов (метки) этой термы.

Источник

wp_get_post_tags() WP 2.3

Получает список меток указанного поста в виде массива.

Возвращает

• array( WP_Term, WP_Term ) — массив объектов WP_Term
• array() — пустой массив если меток не найдено.
• WP_Error — object WP_Error если таксономия post_tag не существует.

Использование

Переписывает аргументы по умолчанию. Весь список аргументов смотрите в описании функции wp_get_object_terms().

По умолчанию в $args устанавливается параметр fields=all (получить все поля термина). Другие значения этого аргумента: names (получать только названия терминов) и ids (только ID терминов ).

По умолчанию: array()

Примеры

#1. Получим метки текущего поста

Допустим пост имеет следующие метки: tag2, tag5 и tag6 :

#2. Получим список ID меток текущего поста

В списке будут только ID меток (поле ids):

Список изменений

Код wp_get_post_tags() wp get post tags WP 5.8.1

Cвязанные функции

Для записей

Здравствуйте, вопрос уже по сути в теме, но всё же напишу подробней.

Как вывести все имена меток записи известно, а как вывести имя, допустим, метки, которая идёт первой к записи, порядку они какому-то подчиняются?

Суть в чём?
Этот код выводит похожие записи для метки, которая прописана для записи первой:

Этот код отличающийся одним символом (вместо 0 — 1) выводит похожие записи для второй метки:

Так вот можно вывести имена самих меток по отдельности, сначала первой, потом второй в шаблоне?

Чтобы это выглядело так:
Похожие записи с меткой [1]
перечисление записей

Похожие записи с меткой [2]
перечисление записей

Вроде, проблема то не проблема, но гуглить уже устал, как имена категорий отдельно вывести все знают, а имена меток — нет. Может я просто не знаю что искать. Заранее благодарен.

Источник

query_posts() WP 1.5.0

Используется самим WordPress при получении записей для текущей страницы (архив авторов, отдельная запись, рубрика, метка). Определяет какие посты будут показаны в базовом Цикле WordPress. Создает базовый Цикл WordPress. Возвращает список записей (постов).

Эта функция может принимать массу различных параметров, которые можно указывать как в виде массива, так и в виде строки: cat=4&posts_per_page=5 .

Благодаря этой функции можно изменить стандартный вывод постов в WordPress. Вывод формируется на основе того, какая страница показывается (главная, архив по дате, категория, архив автора и т.п.). Например, можно изменить цикл так:

• Показывать только один пост на главной странице блога;
• Показывать последние посты только на главной странице блога;
• Изменить порядок сортировки постов;
• Показывать или не показывать посты из определенной категории.

Для внедрения непосредственно в SQL запрос, можно использовать эти фильтры.

Возвращает

WP_Post[]|int[] . Глобальный объект WP_Query.

Использование

Функция query_posts() должна располагаться перед Циклом WordPress (The Loop), потому что при вызове query_posts создается новый объект wp_query , который затем будет использоваться в цикле. После этого WordPress не будет учитывать параметры полученные через УРЛ (например, номер страницы или категории). Если нужно сохранить параметры основного запроса, то можно использовать глобальную переменную $query_string (содержит текущие параметры для query_posts).

Например, давайте изменим порядок сортировки постов, при этом не затрагивая остальные параметры запроса, для этого нужно написать такой код перед Циклом WordPress:

В этом примере «порция» добавочных аргументов должна претворятся знаком амперсанд ( & )

Так же параметры можно передать в виде массива:

Параметры

Параметры Категорий (рубрик)

Получает посты относящиеся к определенным категориям.

cat(число/строка/массив) ID категории. Можно указать несколько ID в строке через запятую или в массиве. Чтобы исключить рубрики укажите минус (-) перед ID категории — это исключит и все вложенные рубрики. Чтобы не исключить вложенные, используйте параметр category__not_in . category_name(строка) Имя категории. Используйте слаг (альтернативное имя), а не само название категории. category__and(массив) Получить посты, которые входят одновременно в несколько категорий. category__in(массив) Получить посты, которые входят в одну из указанных категорий. category__not_in(массив)

Получить посты, которые не входят в указанную категорию.

Этот параметр не учитывает вложенные рубрики. Чтобы исключить рубрику и вложенные рубрики, укажите ID рубрик через запятую со знаком минус в параметре cat : cat=-25,-32 .

Посты из одной категории

Вывод постов из одной категории (записи из дочерних категорий так же будут выбраны):

Вывод постов из одной категории по ярлыку (альтернативному названию категории):

Выведем посты только из категории 4 (дочерние категории не затрагиваются):

Посты из нескольких категорий

Вывод постов из категорий по ID категорий:

Выведем посты из категорий по слагу категорий:

Исключим посты принадлежащие категориям

Выведем все посты, кроме постов из категорий 12,34,56:

Показать все посты, кроме тех, что принадлежать категории 3:

Посты из нескольких категорий одновременно

Показать посты, которые находятся сразу в двух категориях:

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

Можно исключить несколько категорий, таким образом:

Параметры Меток

Получает посты относящиеся к определенным меткам.

tag(строка) slug метки. tag_id(число) ID метки. tag__and(массив) Посты одновременно из нескольких меток. Нужно указывать ID. tag__in(массив) Посты из хотя бы одной указанной метки. Нужно указывать ID. tag__not_in(массив) Посты не относящиеся к указанным меткам. Нужно указывать ID. tag_slug__and(массив) Тоже что и tag__and , только указываются альт. названия (slug) меток. tag_slug__in(массив) тоже что и tag__in , только указываются альт. названия меток.

Посты с одной меткой

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

Получить посты, имеющие хотя бы одну указанную метку:

Посты с несколькими метками

Получить посты имеющие любую из меток:

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

Получить посты, имеющие сразу две метки (37 и 47). Этот вариант более предпочтителен вышеприведенному из-за быстродействия.

Получить посты, имеющие хотя бы одно метку 37 или 47. Этот вариант предпочтительнее т.к. указываются сразу ID.

Получить посты, НЕ связанные с метками 37 или 47:

Параметры Таксономий

Выводит посты связанные с определенной таксономией.

(строка) Нужно указывать имя таксономии и слаг термина: array(‘category’=>’wordpress’) . Запрещен с версии 3.1. tax_query(массив)

С WP 3.1. Нужно указать параметры запроса по таксономии. Может принимать ряд вложенных аргументов, это:

relation(строка)
Как выбирать записи из указанных таксономий. Может быть:

• AND — записи которые одновременно входят в указанные термины таксономии.
• OR — записи принадлежащие любому из указанных терминов таксономии.

Указывается в первом массиве, а термины во вложенных массивах, которые могут иметь следующие параметры:

taxonomy(строка)
Название таксономии.

field(строка)
Поле которое будет указывать в параметре terms . Может быть:

• id или term_id — в terms указываем id терминов.
• name — в terms указываем заголовок термина.

slug — в terms указываем ярлык термина.

По умолчанию: ‘term_id’

terms(число/строка/массив)
Термины таксономии, из которых нужно вывести записи.

operator(строка)
Оператор, указывающий как сравнивать указанные термины в параметре terms. Может быть:

• IN — записи из указанных терминов (по умолчанию).
• NOT IN — записи из всех терминов, кроме указанных.
• AND — записи одновременно принадлежащие всем указанным терминам.
• EXISTS — записи из таксономии (у которых есть любой термин таксономии). В этом случае параметр terms указывать не надо. С версии 4.1.

NOT EXISTS — записи НЕ из таксономии (у которых нет ни одного термина таксономии). В этом случае параметр terms указывать не надо. С версии 4.1.

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

tax_query это массив, элементами которого являются другие массивы, в каждом из которых указывается таксономия, её термины и то как использовать эти термины. Оператор relation указывается в первом массиве tax_query и определяет как сравнивать вложенные массивы между собой. Такая конструкция позволяет создавать запрос одновременно к нескольким таксономиям.

#1 Вывод записей из одной таксономии

Выведем записи из раздела (термина) bob , который является элементом таксономии people :

#2 Выведем посты прикрепленные к термину bob из таксономии people :

Сделаем тоже самое что и в примере выше, только с использованием аргумента tax_query :

#3 Вывод из нескольких таксономий

Выведем посты из нескольких произвольных таксономий:

Аналог примера выше. Выведем записи, который одновременно относятся к нескольким произвольным таксономиям через tax_query :

#4 Использование аргумента relation=OR

Выведем посты, которые находятся в рубрике quotes или которые имеют формат quote (форматы введены в версии 3.1). Для этого используем аргумент relation :

#5 Многоуровневый сложный запрос с использование оператора relation=OR

Допустим, нам нужно получить записи одной из групп элементов таксономии.

Например, надо получить автомобили марки ford черного цвета или автомобили марки bmw белого цвета:

В этом примере первый оператор relation=OR влияет на первые дочерние вложенные массивы. А оператор relation=AND во вложенных массивах влияет на массивы вложенных массивов.

Использование get_posts()

#6 Выведем заголовки всех типов записей countries из всех подрубрик термина 62, который относится к таксономии country :

#7 Выведем все записи произвольного типа (article) не относящиеся к указанным терминам (‘term-slug’, ‘term-slug-two’, ‘term-slug-three’) таксономии (artictag):

#8 Получим все записи типа func , которых нет в таксономии func_cat

Т.е. получим записи типа func , у которых нет ни одного термина из таксономии func_cat . Для этого используем параметр ‘operator=NOT EXISTS’ .

Параметры Авторов

Получает посты принадлежащие определенным авторам.

author(число) ID автора. author_name(строка) Ник автора. Нужно указывать значение поля user_nicename . author__in(массив) Массив ID авторов, записи которых нужно получить. author__not_in(массив) Массив ID авторов, записи которых нужно исключить.

#1 Выведем посты для одного автора

Посты по ID автора:

Посты по нику автора:

#2 Выведем посты нескольких авторов сразу

Посты четырех авторов по ID:

#3 Исключим посты автора

Исключим посты автора 12 и покажем все посты, кроме его:

#4 Еще пример

Показать все страницы автора 1 (author=1), отсортировать по заголовку (orderby=title) в алфавитном порядке (order=ASC) и не показывать прикрепленные посты вверху.

#5 Несколько авторов одновременно

Получим все записи авторов с ID 2 и 6:

Получим записи всех авторов, кроме авторов с ID 2 и 6:

Параметры Записей (постов, страниц)

Получает отдельные страницы или посты.

p(число) ID поста который нужно получить (p=27). name(строка) post_name (слаг) записи (поста). Пример: name=o-saite . title(строка) Заголовок записи (поста). Пример: name=О сайте . С версии 4.4. page_id(число) ID постоянной страницы, которую нужно получить (page_id=27) pagename(строка) Альт. название постоянной страницы (pagename=o-saite) post_parent(число) Вернет только дочерние страницы. post_parent__in(массив) Выберет посты родители которых указанны в массиве. post_parent__not_in(массив) Выберет посты родители которых не указанны в массиве. post__in(массив)

Укажите через запятую ID постов, которые нужно получить (post__in=5,12,2,14,7).

Заметка: если есть прилепленные записи, они будут включены автоматом. Отключить их можно параметром ignore_sticky_posts .

post__not_in(массив) Выберет все посты кроме указанных. post_name__in(массив) Выберет указанные посты. Указывать нужно post_name (slug) через запятую или в массиве. С версии 4.4.

Посты/страницы по ID

Выведем пост по ID:

Выведем страницу по ID:

Посты/страницы по Слагу

Выведем пост по Слагу:

Выведем страницу по Слагу:

Дочерние посты/страницы

Выведем дочернюю страницу, используя слаг родительской и дочерней страницы разделенные слэшом: parent_slug/child_slug

Выведем дочерние страницы, используя ID родительской:

Выведем страницы верхнего уровня, исключим все дочерние:

Выведем посты родители которых указаны в массиве:

Множественные выводы постов/страниц

Выведем только указанные посты:

Выведем все посты, кроме указанных:

Заметка: нельзя объединять post__in и post__not_in в одном запросе.

Не используете строку с ID разделенными запятыми, так работать не будет. Нужно передавать готовый массив:

Параметры Типов записей

Показывает посты указанного типа.

Записи какого типа нужно показывать. По умолчанию: post . Но если указан параметр tax_query , то по умолчанию ставиться any .

• any — включает все типы, кроме revision и типов у которых указан параметр exclude_from_search=true .
• attachment — по умолчанию WP_Query ставит статус ‘post_status’=>’publish’ , а вложения имеют статус ‘post_status’=>’inherit’ , поэтому чтобы вывести вложения нужно еще изменить параметр post_status на ‘inherit’ или ‘any’.
• page — страница.
• post — пост.
• revision — ревизия.
• custom_type — название (ярлык) произвольного типа записи.
• array(‘post’,’page’) — сразу несколько типов в массиве.

По умолчанию: post

Посты по типу

Выведем только страницы:

Выведем все посты, кроме ревизий и типов постов у которых при регистрации параметр exclude_from_search выставлен в true:

Выведем 4 типа постов одновременно:

Параметры Произвольных полей (postmeta)

Основным параметром для работы с мета-данными в WP_Query является meta_query , который получает записи (посты) по существующим у них произвольным полям и их значениям. По принципу использования, meta_query похож на tax_query — массив, где каждый элемент в свою очередь является массивом с параметрами запроса, т.е. meta_query — это массив массивов:

Такая конструкция позволяет использовать множественные запросы. Первый параметр relation во «внешнем» массиве описывает логическую связь между запросами. Он может принимать значения AND (используется по умолчанию. Совпадение со всеми запросами) или OR (совпадение с любым из запросов).

Старые переменные запроса мета-данных: meta_key , meta_value , meta_value_num , meta_compare по прежнему поддерживаются и могут быть использованы для простых запросов связанных с произвольными полями.

Список всех параметров связанных с мета-данными:

meta_key(строка) Ключ(название) произвольного поля. meta_value(строка) Значение произвольного поля. meta_value_num(число) Значение произвольного поля, число. meta_compare(строка) Оператор для проверки значения произвольного поля. Может быть: = , != , > , >= , , , LIKE , NOT LIKE , IN , NOT IN , BETWEEN , NOT BETWEEN , EXISTS (с версии 3.5), NOT EXISTS (3.5), REGEXP (3.7), NOT REGEXP (3.7) и RLIKE (3.7);
По умолчанию ‘=’ meta_query(массив)

Массив параметров мета-данных определяющих вывод (этот параметр включает в себя meta_key , meta_value и meta_compare и заменяет их). С версии 3.1.
В массиве можно указать следующие параметры:

relation(строка)
Этот параметр указывается как строка в главном массиве meta_query и указывает как сравнивать между собой несколько массивов с параметрами запроса, указанных в этом главном массиве.
Параметр может принимать два значение:
OR — выбрать мета-поля подходящие хоты бы под один массив с параметрами запроса;
AND (по умолчанию) — выбрать мета поля подходящие для всех массивов с параметрами запроса.

key(строка)
Ключ поля.

value(строка/массив)
Значение поля. Указывать не нужно, если при сравнении используется: ‘EXISTS’ или ‘NOT EXISTS’ (с версии 3.9).

compare(строка)
Как сравнивать указанное в value значение. Может быть:

• = — равно.
• != — не равно.
• > — больше.
• >= — больше или равно.
• — меньше.
• — меньше или равно.
• LIKE — указанная в value подстрока имеется в строке. Как ‘%значение%’ в sql запросе.
• NOT LIKE — тоже что LIKE только наоборот.
• IN — в value указываются несколько значений в массиве и поиск идет хотя бы по одному из значений.
• NOT IN — любое значение, кроме тех что указанны в виде массива в value.
• BETWEEN — в value указываются 2 значения в массиве: большее и меньшее и поиск идет между этих значений. , например: ‘value’ => array(5, 25) — от 5 до 25 (включительно).
• NOT BETWEEN — любое значение, за пределами диапазона указанного в value, например: ‘value’ => array(5, 25) — меньше 5 и больше 25.
• EXISTS — выведет всё где существует указанный в ‘key’ ключ. ‘value’ не указывается в этом случае. (с версии 3.5)
• NOT EXISTS — выведет всё где указанный в ‘key’ ключ не существует. ‘value’ не указывается в этом случае. (с версии 3.5)
• REGEXP — в value указывается регулярное выражение для поиска, например: ‘value’ => ‘^bar’ , (найдет строку: ‘bar is’). (с версии 3.7)
• NOT REGEXP — в value указывается регулярное выражение для поиска, найдет все что не входит в это выражение. (с версии 3.7)
• RLIKE — синоним REGEXP. (с версии 3.7)

По умолчанию ‘IN’, если value массив, ‘=’ в других случаях.

type(строка)
тип произвольного поля (если, например в поле указываются только числа то нужно использовать NUMERIC, чтобы числа не сравнивались как строки). Может быть:

• NUMERIC — целые числа
• DECIMAL — дробные числа
• SIGNED — целые числа, положительные и отрицательные
• UNSIGNED — целые числа, только положительные
• CHAR — строка не чувствительна к регистру
• BINARY — строка чувствительная к регистру
• DATETIME — дата и время
• DATE — только дата
• TIME — только время

По умолчанию: CHAR .

Тип DATE работает при сравнении BETWEEN только если дата указывается в формате YYYY-MM-DD и сравнивается с аналогичным форматом.

Смотрите также отдельное описание класса мета запросов: WP_Meta_Query

Сортировка по произвольному полю

Для сортировки по полю, нужно указать ключ данных поля, и затем в параметре ‘orderby’ указать название этого ключа, например:

Если произвольное поле указывается через параметр meta_key и meta_value , то для сортировки по этому полю в параметре orderby укажите значения: meta_value или meta_value_num (для чисел). См. ниже описание параметра orderby.

Базовые примеры (без meta_query)

#1 Посты с ключом произвольного поля color, не обращая внимание на значение этого поля.

#2 Посты со значением произвольно поля blue, не обращая внимание на название ключа.

#3 Посты с ключом поля color и значением этого поля blue:

#4 Посты у которых ключ равен color и значение поля не равно blue:

#5 Продукты с ключом price и значение произвольно поля меньше или равно 22.

При использовании параметра «meta_value» значение 99 будет больше 100, так как эти значения распознаются как строки, а не числа. Для того чтобы числа понимались как числа нужно использовать параметр «meta_value_num»:

#6 Посты со значением произвольного поля равным 0, не важно какой ключ.

Примеры с использованием meta_query

#1 Записи с одним произвольным полем

Выведем продукты (product) у которых ключ равен color и значение поля не равно blue:

Заметка: для meta_query нужно указывать массив в массиве, даже если вы задаете один запрос.

#2 Записи имеющие одновременно два произвольных поля

Пример вывода постов с несколькими произвольными полями и указанием различных условий для значений этих произвольных полей:

#3 Записи имеющие хотя бы одно поле

Выведем посты с ключом color и значением не (NOT LIKE) blue или (OR) посты с ключом price со значениями поля от 20 до 100:

#4 Записи с двумя полями отсортированные по третьему полю

Предположим у нас есть тип записей toys — игрушки, а в произвольных полях мы указываем материал: твердая мягкая и вес игрушки в граммах: 100 300 500.

Получим мягкие игрушки вес которых от 200 до 500 грамм и отсортируем их по цене по убыванию:

#5 Получим записи у которые есть произвольное поле

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

#6 Вложенные сложные запросы

С версии 4.1 можно создавать вложенные запросы. Например, выполним такое условие: нужно показать продукты оранжевого цвета (color=orange) ИЛИ маленькие (size=small) продукты красного цвета (color=red):

#7 Сортировка по произвольному полю

С версии 4.2 массивам в meta_query можно указывать ключи, чтобы затем сортировать по этому ключу:

Параметры MIME Типов записей

Выбирает вложения с указанным миме типом. Список миме типов смотрите в описании wp_get_mime_types().

Миме тип записи. Используется только для вложений — записей с типом ‘attachment’.

Этот параметр будет работать только когда параметр post_type = attachment и post_status = inherit . Т.е. миме-тип может быть только у вложений.

Получим только картинки любого типа

Получим только картинки gif типа

Получим все типы вложений, кроме картинок

Параметры Статусов

Получает посты с указанным статусом.

По умолчанию publish , а если пользователь авторизован добавляется еще и private . Если запрос запущен из админ части, добавляются еще и защищенные типы статусов: future , draft и pending . Все типы статусов:

• publish — опубликованный пост;
• pending — пост на модерации;
• draft — черновик;
• auto-draft — черновик, сохраненный самим WordPress (авто-сохранение);
• future — запланированный пост;
• private — личный пост;
• inherit — ревизия;
• trash — удаленный пост (в корзине). С версии 2.9;
• any — все статусы, кроме статусов в параметре которых указано exclude_from_search=true . См. register_post_status() и get_post_stati().

По умолчанию: ‘publish’

Посты по статусам

Получим только черновики:

Получим посты с разными статусами:

Получим все виды вложений:

Параметры Даты (времени)

Выводит посты принадлежащие определенному периоду времени.

year(число) 4 цифры года (2013) monthnum(число) Номер месяцы (1 — 12) w(число) Неделя в году (с 0 до 53) day(число) День месяца (1 — 31) hour(число) Час (0 — 23) minute(число) Минута (0 — 60) second(число) Секунда (0 — 60) m(число) ГодМесяц (201306) date_query(массив)

Параметры по которым будет отстроиться запрос. Работает на основе отдельного класса: WP_Date_Query.

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

Возможные форматы дат смотрите в документации PHP.

column — поле в базе данных для запроса. Может быть:
post_date
post_date_gmt
post_modified
post_modified_gmt
comment_date
comment_date_gmt
user_registered
По умолчанию: ‘post_date’

compare — Оператор сравнения для всех вложенных массивов по умолчанию. Может быть: Может быть: = , != , > , >= , , , IN , NOT IN , BETWEEN , NOT BETWEEN .
По умолчанию: ‘=’

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

Параметры ниже должны использоваться во вложенных массивах. Они определяют запрос для отдельной даты.

Также все параметры ниже, могут быть использованы в основном массиве.

before (строка/массив) — Дата записи «до» которой будут получены. Принимает строку которую поймет функция strtotime() : все возможные форматы. Или можно передать массив с индексами: year , month , day : array(‘year’=>’2015’, ‘month’=>’5’, ‘day’=>’28’ )
Относительно текущего времени сайта (не UTC).

after (строка/массив) — Дата записи «после» которой будут получены. Принимает строку которую поймет функция strtotime() : все возможные форматы. Или можно передать массив с индексами: year , month , day : array(‘year’ => ‘2015’, ‘month’ => ‘5’, ‘day’ => ’28’ )
Относительно текущего времени сайта (не UTC).

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

compare (строка) — см. выше, только для конкретной даты. По умолчанию ‘=’.

inclusive (логический) — аргументы before и after обрабатываются включительно, если true. По умолчанию: false.

year (число/массив) — год, например 2013

dayofyear (число/массив) — номер дня в году, 1-366.

month (число/массив) — месяц, 1-12

week (число/массив) — неделя, 0-53

day (число/массив) — день, 1-31

dayofweek (число/массив) — день недели, 1-7, где 1 — воскресенье

dayofweek_iso (число/массив) — день недели, 1-7, где 1 — понедельник

hour (число/массив) — час, 0-23

minute (число/массив) — минута, 0-60

second (число/массив) — секунда, 0-60

В параметрах: year , month , week , dayofyear , day , dayofweek , dayofweek_iso , hour , minute , second можно указать несколько значений, в виде массива, если параметр compare соответствует.

#1. Получим посты за сегодня:

#2. Получим посты за последнюю неделю:

#3. Получим посты за 20 Декабря:

Заметка: запросы выше возвращают посты за указанный период в истории: «Посты за Х месяц, Х день». Они не могут получать посты за произвольный промежуток времени по отношению к настоящему. Поэтому запросы типа «Посты за последние 30 дней» или «Посты за последний год» не возможны в базовом варианте, для таких запросов нужно использовать фильтр «posts_where». Примеры ниже показывают как это делать.

#4. Получим посты за промежуток времени с 1 марта по 15 марта 2010 года:

#5. Получим посты за последние 30 дней:

#6. Получим посты за промежуток от 30 до 60 дней, до настоящего:

Параметр «m» может быть установлен только в списке постов в админ-панели. Он полезен когда вы выбираете из выпадающего списка select где дата установлена как число YYYYmm.

Примеры с параметром date_query

#1. Получим посты между 9 и 17 часами:

#2. Получим посты за промежуток времени: 1 января по 28 февраля:

Даты можно указывать цифрами и строками, как видно из этого примера, потому что аргументы before и after обрабатываются функцией PHP strtotime(), а она понимает строки.

#3. Получим посты опубликованные год назад, но измененные в последний месяц:

#4. Получим посты за последние 2 недели, использовав строку ‘2 weeks ago’:

#5. Получим записи за последние 2 месяца, опубликованные в будние дни:

Аргумент date_query работает и с классом WP_Comment_Query, поэтому его точно также можно использовать в функции: get_comments().

Параметры Отступов

Можно установить отступ от первого поста в результатах запроса. Например, стандартно запрос возвращает 6 постов, а если в тот же запрос добавить параметр offset=1 , то будут возвращены 5 постов (первый пост из запроса будет пропущен).

offset(число) Сколько постов из результатов запроса пропустить.

Пример использования

Пропустим первый/один пост (offset=1) и вернем следующие 5:

Параметры Сортировки и порядка

Сортирует и устанавливает направление сортировки.

Направление сортировки по параметру orderby , может быть:

• ASC — по порядку, от меньшего к большему (1, 2, 3; a, b, c).
• DESC — в обратном порядке, от большего к меньшему (3, 2, 1; c, b, a) .

orderby(строка)

Поля по которым можно сортировать посты. Может быть

• none — не сортировать, выводить как есть в БД. Равносильно сортировке по ID. С версии 2.8.
• ID — сортировка по ID.
• author — сортировка по ID авторов.
• title — сортировка по заголовку.
• name — по названию поста (ярлык, слаг поста).
• date — сортировка по дате публикации.
• modified — сортировка по дате изменения.
• type — по типу поста (post_type). С версии 4.0
• parent — сортировка по значению поля parent.
• rand — случайный порядок.
• RAND(x) — в случайном порядке для числовых значений. Тут «x» — это целое число.
• comment_count — сортировка по количеству комментариев. С версии 2.9.
• menu_order — стандартно используется для страниц и вложений. Порядковый номер указывается на странице редактирования поста.

meta_value — по значения произвольного поля.

Важно: параметр meta_key так же должен быть определен. Заметка: сортировка будет алфавитной и будет не логична, если значения произвольных полей числа (будет, например, так 1, 3, 34, 4, 56, 6 и т.д., а не 1, 3, 4, 6, 34, 56).

С версии WordPress 4.0 в orderby можно указывать массив сочетающий в себе оба параметра: orderby и order . Сделано это для сортировки по нескольким колонкам одновременною Синтаксис такой:

#1 Сортировка по заголовку

Отсортируем по порядку в меню, а затем по заголовку

#2 Выведем один случайный пост:

#3 Отсортируем посты по количеству комментариев:

#4 Отсортируем продукты по цене (произвольное поле price):

#5 Множественная сортировка

Выведем посты отсортированные по двум полям: ‘title’ и ‘menu_order’ (title первостепенен):

#6 Множественная сортировка с использованием массива (с версии 4.0)

Получим страницы отсортированные по заголовку (title) и номеру меню (menu_order) в разном порядке (ASC/DESC):

#7 Сортировка по ‘meta_value’ для нового типа поста (post_type)

Выведем посты типа ‘my_custom_post_type’ отсортированные по ключу произвольного поля «age» и отфильтрованные, чтобы показывались только посты со значением поля 3 и 4:

Параметры Пагинации

Количество постов на одной странице. Если выставить -1 , то будут выведены все посты (без пагинации).

С версии 2.1 заменяет параметр showposts . Установите параметр paged , если пагинация не работает, после использования этого параметра.

Заметка: если запрос в feed части, WP перезаписывает этот параметр опцией posts_per_rss . Чтобы повлиять на вывод постов в фиде используйте фильтры post_limits или pre_option_posts_per_rss .

Игнорировать прилепленные посты или нет (true/false). С версии 3.1. Заменяет параметр caller_get_posts.

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

#1 Посты на странице

Выведем 3 поста на странице:

Выведем все посты на странице:

Выведем все посты и отключим пагинацию:

#2 Отступы сверху

Выведем посты начиная с четвертого (пропустим первые 3):

Выведем 5 постов которые идет за тремя последними:

#3 Записи со страницы пагинации 6

#4 Записи с текущей страницы

Покажем посты с текущей страницы пагинации. Полезно при построении произвольной пагинации:

Выведем посты с текущей страницы и установим параметр paged в 1, когда переменная не определена на первой странице пагинации:

Используйте get_query_var(‘page’); если нужно получить номер страницы пагинации для статической главной страницы сайта (is_front_page()). Переменная «page» раже содержит номер пагинации на отдельных страницах типа post, когда в контенте используется тег для разбиения контента на страницы.

Вывод текущей страницы пагинации на статической главной странице:

#5 Прилепленные записи (посты)

# Все прилепленные записи

# Только первый прилепленный пост

# Первый прилепленный пост, если такого поста нет, то последний опубликованный

# Первый прилепленный пост, если такого поста нет, то ничего не выводим

# 5 последних прилепленных записей

#6 Скрытие прилепленных постов

Исключим все прилепленные посты из запроса:

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

Исключим прилепленные посты из категории. Вернет все посты рубрики, но прилепленные посты будут полностью исключены. Также добавим сюда правило для правильной пагинации:

Параметры Комментариев

В объект WP_Query добавляются данные комментариев записи, если это отдельная запись. В параметрах ниже, указывается как нужно получать комментарии в таких случаях.

comment_status(строка) Статус комментария. ping_status(число) Статус пинга. comments_per_page(число) Число комментариев для получения на отдельной странице комментариев. По умолчанию опция: comments_per_page . comment_count(число/массив)

Количество комментариев, которое должен иметь пост. С версии 4.9.

• Если указать число, получит посты с указанным числом комментариев (оператор поиска = ).
• Массив позволяет указать вариант сравнения числа комментариев. В массиве можно указать параметры:
  • value(число) — количество комментариев для сравнения.
  • compare(строка) — как сравнивать кол-во комментов. Может быть: = , != , > , >= , , . По умолчанию: = .

меню

Параметры Поиска

Посты найденные по поисковой фразе.

Параметры Доступа

Показывает посты если пользователь имеет достаточные права.

perm(строка) Доступ пользователя.

Выведем опубликованные приватные посты, если у пользователя есть достаточные для просмотра права:

Параметры Кэширования

Не добавляет данные в кэш при выполнении запросов.

cache_results(логический) Кэшировать ли информацию о посте. update_post_meta_cache(логический) Кэшировать ли информацию о мета данных поста. update_post_term_cache(логический) Кэшировать ли информацию о привязке поста к терминам и таксономиям.

#1 Выведем 50 постов, но не будет добавлять информацию о постах в кэш:

#2 Выведем 50 постов, но не будем добавлять мета данные поста в кэш

#3 Выведем 50 постов, но не будем добавлять в кэш информацию о терминах постов

Обычно эти функции использовать не нужно — кэш необходим! Однако, такой подход может пригодится в ряде случаев. Например, если нам нужно получить список заголовков постов и не нужна никакая другая информация о постах: ни о таксономиях ни о мета данных. Не загружая эту информацию мы может сохранить время на ненужных SQL запросах.

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

Параметры Возвращаемых данных

Устанавливает какие данные должен возвращать запрос.

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

• ids — вернет массив с ID постов.
• id=>parent — вернет ассоциативный массив [ parent => ID, … ].
• Вставка любых других параметров, вернет все поля (по умолчанию) — массив объектов постов.

no_found_rows(логический) true — не подсчитывать количество найденных строк. В некоторых случаях может ускорить запрос.
По умолчанию: falseменю

Комбинирование параметров

#1. Комбинирование в строке

Вы наверняка заметили, что параметры соединяются между собой символом амперсанд — &, именно этим символом параметры комбинируются (объединяются).

#2. Комбинирование с переменными

Посты из категории 13 за текущий месяц на главной странице блога:

#3. Комбинирование массивом

Вернет только 2 поста, из категории 1 и 3, отсортированные в обратном порядке по заголовку:

#4. Записи из категории и с меткой

Вывести все посты из категории 1 , имеющие метку apples :

Примеры

#1. На главной, исключим посты из рубрики 3

Чтобы на главной странице блога исключить посты, которые находятся в категории 3, нужно вставить следующий код в файл index.php перед началом Цикла WordPress:

#1.2. Можно добавить еще несколько категорий к исключению:

#2. Получим определенный пост (пост с Если нужно использовать функцию «читать дальше» (read more) с новым запросом, то нужно переключить глобальную переменную $more на 0 :

#4. Получаем определенную страницу (страницу 7):

#4.1. Для дочерних страниц нужно указывать имя родительской страницы и самой дочерней страницы. Имена разделяются слэшем ( / ). Пример:

Вставка переменных в параметры запроса

Можно создавать динамические параметры запроса, если нужно, чтобы запрос менялся в зависимости он каких либо обстоятельств, для этого значение параметра нужно записать в переменную, а затем переменную передать в параметры запроса, сделать это можно несколькими способами:

#1. Сборка запроса с использованием одинарных кавычек ‘ ‘ :

#2. Сборка запроса с использованием двойных кавычек » «

Переменные внутри двойных кавычек интерпретируются PHP как переменные, а не как простой текст:

#3. Использование глобальной переменной $query_string

Которая содержит в себе базовый запрос для функции query_posts. Если нам нужно не нарушать стандартный вывод постов WordPress (например, на странице категорий), но при этом убрать пагинацию (вывести все посты на одной странице), то мы может дополнить базовый запрос функции query_posts, параметром posts_per_page=-1 :

Можно измерить значение posts_per_page на конкретное число необходимых нам постов на одной странице. Например, posts_per_page=10 выведет только 10 постов, а если при этом в конце цикла поставить тег шаблона posts_nav_link(), то под циклом появится ссылка для перехода к следующим 10-ти постам (ссылка пагинации).

#4. Параметры также можно передать в виде массива

Так они будут более наглядны и читаемы. Например, пример 2 можно записать так:

Как видите тут можно поставить каждую переменную на отдельную строку, а это более понятно и читаемо.

Добавление параметров в запрос

Сохранение базового запроса текущей страницы и добавление в него своих параметров

функция query_posts полностью переписывает запрос, если например, мы напишем query_posts (‘cat=1’) , то другие параметры запроса, которые используются для текущей страницы (например, сортировка, пагинация и т.д.), будут потеряны и будут выведены посты категории 1 с остальными параметрами по умолчанию. Чтобы сохранить базовые параметры запроса и дополнить/заменить их своими нужно использовать PHP функцию array_merge (объединяет 2 массива в один):

Этот пример по сути тоже самое что и пример 3 (Использование глобальной переменной $query_string ), только с использованием массивов.

То есть грубо говоря на странице два раза алфавита

Источник