Вложения (media файлы) (рубрика)
| get_attached_file() | Получает абсолютный (серверный) путь вложения (прикрепленного файла) по переданному ID вложения. |
| get_attached_media() | Получает вложения (картинки, видео, аудио) прикрепленные к записи (посту). Получает объекты данных в виде массива. |
| get_attachment_link() | Получает УРЛ страницы медиафайла на сайте (фронте). |
| get_children() | Получает дочерние записи: вложения, ревизии, подстраницы и т.д. Аналог get_posts(). |
| get_post_mime_type() | Получает mime тип прикрепленных записей (картинки, файлы и т.п.), на основе переданного ID. |
| is_local_attachment() | Является ли переданный URL страницей вложения текущего сайта. |
| the_attachment_link() | Выводит html тег A ссылки на прикрепленный к посту файл (вложение) или страницу этого файла в шаблона. |
| wp_attachment_is() | Проверяет, является ли указанное вложение: картинкой, аудио или видео. Условный тег. |
| wp_delete_attachment() | Удаляет вложение WordPress (файл медиатеки, прикрепленный файл). Файл удаляется физически. |
| wp_get_attachment_link() | Получает ссылку на файл вложения или WP страницу вложения. Возвращает <a> тег. |
| wp_get_attachment_url() | Получает УРЛ вложения по переданному ID вложения. Получает ссылку на файл. |
| wp_get_original_image_path() | Получает путь оригинальной картинки (не её уменьшенной копии) по указанному ID вложения. |
| wp_get_original_image_url() | Получает URL оригинальной картинки (не её уменьшенной копии) по указанному ID вложения. |
| wp_insert_attachment() | Добавляет медиафайл (вложение) в медиатеку WordPress. Файл физически не добавляется — функция создает запись в таблице wp_posts в базе данных и возвращает ID созданной записи. |
Картинки
| file_is_displayable_image() | Проверяет является ли файл изображением (подходит ли он для показа на странице). Условный тег. |
| image_downsize() | Получает массив данных картинки указанного размера: УРЛ, ширина и высота картинки-вложения. |
| next_image_link() | Выводит на экран ссылку на следующую картинку прикрепленную к записи. |
| previous_image_link() | Выводит ссылку на предыдущую картинку прикрепленную к посту. Возвращает HTML код ссылки. |
| wp_attachment_is_image() | Проверяет, является ли текущая запись вложением-картинкой. Условный тег. |
| wp_get_attachment_caption() | Получает описание (подпись) указанного вложения-картинки. |
| wp_get_attachment_image() | Получает <img> тег картинки указанного вложения (прикрепленного к посту файла). |
| wp_get_attachment_image_sizes() | Получает значения размеров указанной картинки-вложения для атрибута sizes. |
| wp_get_attachment_image_src() | Получает массив данных указанной картинки: URL, ширина, высота картинки-вложения. |
| wp_get_attachment_image_srcset() | Получает значение атрибута |
| wp_get_attachment_image_url() | Получает URL картинки-вложения по переданному ID картинки. Также, можно указать размер картинки, URL на которую нужно получить. |
| wp_get_image_mime() | Возвращает реальный mime-тип изображения. |
Миниатюры
| add_image_size() | Регистрирует новый размер картинки (миниатюры). |
| delete_post_thumbnail() | Удаляет миниатюру записи по ID записи. Удаляется метаполе, а не сам файл миниатюры. |
| get_intermediate_image_sizes() | Получает массив названий всех промежуточных размеров картинок, зарегистрированных для сайта. Также можно получить все данные размеров. |
| get_post_thumbnail_id() | Получает ID миниатюры указанной записи (поста). Получает ID вложения (картинки). |
| get_the_post_thumbnail() | Получает IMG тег миниатюры поста, если она существует. |
| get_the_post_thumbnail_caption() | Получает описание (caption) миниатюры записи (поста). |
| get_the_post_thumbnail_url() | Получает URL установленной для записи миниатюры. Если миниатюры нет, то вернет false. |
| has_image_size() | Проверяет, существует ли указанный размер картинки. |
| has_post_thumbnail() | Проверяет имеет ли указанная запись (пост) картинку миниатюру. Условный тег. |
| image_get_intermediate_size() | Получает массив данных картинки-вложения указанного размера: thumbnail, medium и т.д, если она существует. |
| remove_image_size() | Удаляет ранее зарегистрированный размер картинки. Размер картинки-миниатюры регистрируется с помощью функции add_image_size(). |
| set_post_thumbnail() | Устанавливает миниатюру записи по переданным ID записи и ID вложения (медиафайла). Если указанного вложения нет в базе данных, то функция удалит миниатюру записи. |
| set_post_thumbnail_size() | Устанавливает дефолтный размер миниатюры поста. |
| the_post_thumbnail() | Выводит html код (<img> тег) картинки-миниатюры текущего поста. |
| the_post_thumbnail_caption() | Выводит на экран описание (caption) миниатюры записи (поста). |
| the_post_thumbnail_url() | Выводит URL миниатюры текущей записи. Если миниатюры нет вернет NULL (ничего не выведет). Используется в цикле WordPress. |
| wp_get_additional_image_sizes() | Получает данные всех дополнительно зарегистрированных размеров изображений (миниатюр). |
| wp_get_attachment_thumb_url() | Получает URL картинки-вложения с размером |
| wp_get_image_editor() | Возвращает объект WP_Image_Editor с указанной картинкой. Используется для изменения размеров изображения (создания миниатюр) и редактирования картинки. |
| wp_get_registered_image_subsizes() | Получает данные (width, height, crop) зарегистрированных в текущий момент размеров изображений. |
Галерея
| get_post_galleries() | Получает все галереи из текста указанной записи/поста. Ищет шорткоды [[gallery]] в тексте, обрабатывает их и возвращает массив данных картинок галерей. |
| get_post_galleries_images() | Получает все URL картинок галерей из указанного текста записи/поста, если галереи в тексте имеются. |
| get_post_gallery() | Получает первую галерею из текста указанной записи/поста. Ищет шорткод [[gallery]] в тексте, обрабатывает его и возвращает массив данных картинок галереи. |
| get_post_gallery_images() | Возвращает все URL картинок первой галереи из указанного текста записи (поста), если галерея в тексте есть. |
Загрузка (download upload)
| media_handle_sideload() | Загружает файл в медиатеку WordPress из переданного массива с данными о файле, аналогично media_handle_upload(). |
| media_handle_upload() | Загружает переданный в форме файл в папку загрузок WordPress и создает запись о файле в базе данных (добавляет файл в медиатеку WP). |
| media_sideload_image() | Загружает картинку в медиатеку WP из указанного УРЛ и прикрепляет её к посту. |
| wp_check_filetype() | Получает расширение и MIME тип файла по переданному имени (пути) файла. Используется для проверки разрешен ли указанный тип файла к загрузке на сайт. |
| wp_check_filetype_and_ext() | Проверяет разрешен ли к загрузке указанный файл по его реальному MIME типу. |
| wp_get_upload_dir() | Получает данные о папке загрузок (upload) в виде массива параметров. |
| wp_handle_sideload() | Перемещает временный файл в папку uploads. |
| wp_handle_upload() | Обрабатывает загрузку файла через $_FILES. Проверяет файл и перемещает его в папку UPLOADS. |
| wp_max_upload_size() | Получает максимальный размер файла (в байтах), который разрешен к загрузке в WordPress. |
| wp_unique_filename() | Уникализирует имя файла. Используется перед сохранением файла в указанную папку, чтобы изменить его имя, если такой файл уже существует. |
| wp_upload_bits() | Создает файл с указанным контентом в папке загрузок (upload). Возвращает данные загруженного файла. Не размещает данные о файле в БД. |
| wp_upload_dir() | Получает данные о каталоге загрузок: путь, УРЛ. |
Метаданные (postmeta)
| delete_post_meta_by_key() | Удаляет все метаполя (произвольные поля) всех постов по указанному ключу метаполя. |
| wp_generate_attachment_metadata() | Генерирует метаданные для картинки-вложения и создает промежуточные копии изображения - миниатюры всех зарегистрированных размеров. |
| wp_get_attachment_metadata() | Получает метаданные прикрепленного файла (вложения). |
| wp_maybe_generate_attachment_metadata() | Создает метаданные вложения, если они отсутствуют, в противном случае ничего не делает. |
| wp_read_audio_metadata() | Получает все данные об аудио файле из его ID3 меток. Сюда входят все доступные данные: формат, каналы, битрейт, размер, MIMEтип, продолжительность, год, альбом, артист, комментарий, картинка и т.д. |
| wp_update_attachment_metadata() | Обновляет метаданные вложения (медиафайла). |
Редко используемые
| attachment_url_to_postid() | Пытается получить ID вложения (картинки из медиатеки) по указанному URL вложения. |
| get_allowed_mime_types() | Получает список разрешенных типов файлов. Возвращает массив: |
| wp_get_audio_extensions() | Получает массив поддерживаемых аудио форматов в WordPress. Получает расширения файлов. |
| wp_get_avif_info() | Извлекает метаданные указанной AVIF картинки. Такие как: ширина, высота, глубина цвета и количество каналов. |
| wp_get_ext_types() | Получает список базовых расширений файлов и по типу. Например, расширения картинок, аудио-файлов, видео-файлов и т.д. |
| wp_get_video_extensions() | Получает массив поддерживаемых видео форматов в WordPress. Получает расширения файлов. |
| wp_getimagesize() | Получает размеры изображения и другую сопутствующую информацию. |
| wp_read_image_metadata() | Собирает массив полезных метаданных картинки из метаданных файла exif и iptc. |