Get_posts () - отримує записи (пости, сторінки, вкладення) з бази даних за зазначеними критеріями

Отримує записи (пости, сторінки, вкладення) з бази даних за зазначеними критеріями. Можна вибрати будь-які посади і впорядкувати їх як завгодно.

якщо ми вказуємо висновок таксономії для типу записів відмінного від 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'.

  • page - постійні сторінки
  • post - пости
  • revision - ревізії
  • custom_type - назва (ярлик) довільного типу записи
  • array ( 'post', 'page') - відразу кілька типів в масиві.
  • За замовчуванням: '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.

  • З версії 3.0 параметрам include і exclude можна передавати і масиви ID.
  • cвязана функції

    З мітки: query (запит)