Отримує записи (пости, сторінки, вкладення) з бази даних за зазначеними критеріями. Можна вибрати будь-які посади і впорядкувати їх як завгодно.
якщо ми вказуємо висновок таксономії для типу записів відмінного від post, то параметр post_type потрібно змінити, тому що він за замовчуванням завжди дорівнює post;
✈ 1 раз = 0.0036с = дуже повільно | 50000 раз = 99.1с = дуже повільно
повертає
Масив. Якщо не вдалося отримати записи. то поверне порожній масив.
Масив об'єктів (записів). Кожен об'єкт в масиві буде виглядати так:
Використання
шаблон використання
$ Args (рядок / масив) Список аргументів, відповідно до яких буде отримано результат.
За замовчуванням: встановлені
Аргументи параметра $ args
Таке відключення фільтрів за замовчуванням, може ввести в оману, якщо є плагіни впливають на висновок записів, через фільтри SQL запиту, наприклад WPML. У таких випадках suppress_filters потрібно відключити.
offset (число) Відступ від першого поста (записи).
tag (рядок) Отримати записи мають зазначені в цьому параметрі мітки. Потрібно вказувати альтернативне ім'я (slug) мітки. Якщо вказати кілька імен (міток) через кому. то будуть отримані записи відповідні будь-мітці, а якщо розділити пробілами, то будуть отримані записи мають всі зазначені мітки.
За замовчуванням: немає
ID постів, які потрібно отримати. Якщо вказується рядок, то ID потрібно розділяти комами або пробілами. Приклад, отримає 6 постів: '45, 63,78,94,128,140 '.
exclude (рядок / число) ID постів які потрібно виключити з вибірки, вказувати через кому або пробіл.
За замовчуванням: немає
meta_key і meta_value (рядок)
Отримати пости мають вказане довільне поле (meta_key) зі значенням (meta_value).
Можна вказати meta_key і meta_value. тоді матимемо пости, у яких є вказане метапол і значення якого дорівнює вказаному значення.
Або можна вказати тільки meta_key. тоді будуть отримані всі записи у яких це метапол є і не важливо, яке там значення.
За замовчуванням: немає
Якого типу пости потрібно отримувати, може бути:
- any - всі типи, крім revision і типів у яких вказано параметр exclude_from_search = true.
attachment - прикріплення записи.
за замовчуванням WP_Query ставить статус 'post_status' => 'publish'. а вкладення мають статус 'post_status' => 'inherit'. тому щоб вивести вкладення потрібно ще змінити параметр post_status на 'inherit' або 'any'.
За замовчуванням: 'post'
Якого типу вкладення потрібно отримати. Можна використовувати, коли параметр post_type = attachment.
- image / jpeg
- image / png
- image / gif
- image - для будь-яких картинок
- audio / mpeg
- application / pdf
- application / zip
Замість одне МІМ типу можна вказати кілька в масиві. Повний список МІМ типів дивіться тут.
За замовчуванням: немає
Статус запису. Можна передати кілька статусів через кому. Може приймати:
За замовчуванням: publish
post_parent (число) Показати тільки дочірні записи до зазначеного ID.
За замовчуванням: немає
Сортувати результат за вказаними полями. Можна вказувати кілька полів сортування, через пробіл. Допустимі поля:
Префікс post_ у полів таблиці опускається для зручності. Наприклад замість date можна написати post_date. замість content post_content і т.д.
За замовчуванням: 'date'
order (рядок) В якому напрямку впорядкувати, вказане в параметрі $ orderby. поле:
ASC - по порядку (від меншого до більшого: а, б, в).
DESC - в зворотному порядку (від більшого до меншого: в, б, а).
За замовчуванням: 'DESC'
# 1. Висновок постів з відступом
# 2. Висновок постів з відступом, без порушення основного циклу.
# 3. Можливість використовувати спеціальні функції Циклу ВП
Не забувайте, що на екран дані виводяться через php оператор echo:
# 4. Останні пости відсортовані за назвою
Отримаємо останні пости відсортовані за назвою в алфавітному порядку. Наступний приклад виведе дату, заголовок і цитату поста:
# 5. випадкові пости
Отримаємо 5 випадкових постів, реалізується за рахунок параметра 'orderby' => 'rand':
# 6. Отримати всі прикріплені файли
Використовується за межами Циклу WordPress. Наступний код виведе заголовок, посилання і цитату прикріпленого файлу:
# 7. Прикріплені файли певного поста
Код потрібно використовувати всередині Циклу WordPress, де змінна $ post-> ID:
# 8. Останні записи з тієї ж рубрики
Виведемо список останніх записів поточної рубрики, в якій знаходиться запис. При цьому виключимо поточну запис:
З версії 2.6 змінений ряд переданих значень у параметра orderby - префікс post_ був видалений, наприклад, було post_title, стало просто title.