Вложения (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 страницей вложения (файла медиатеки WordPress) текущего сайта.

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()

Получает значение для атрибута srcset html тега <img>. Значение будет содержать имена всех имеющихся размеров указанной картинки (вложения) в таком виде: image.jpg 1x, image-sm.jpg 640w".

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()

Проверяет, существует ли указанный размер картинки. В функцию, для проверки указывается называние размера, которое было использовано при его регистрации, в функции add_image_size(). Условный тег, возвращает TRUE или FALSE.

has_post_thumbnail()

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

image_get_intermediate_size()

Получает массив данных картинки-вложения указанного размера (thumbnail, medium ...), если она существует. Возвращает false если картинки нет.

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 картинки-вложения с размером thumbnail.

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()

Получает список разрешенных типов файлов. Возвращает массив: расширение => mime/тип.

wp_get_audio_extensions()

Получает массив поддерживаемых аудио форматов в WordPress. Получает расширения файлов.

wp_get_ext_types()

Получает список базовых расширений файлов и по типу. Например, расширения картинок, аудио-файлов, видео-файлов и т.д.

wp_get_video_extensions()

Получает массив поддерживаемых видео форматов в WordPress. Получает расширения файлов.

wp_getimagesize()

Получает размеры изображения и другую сопутствующую информацию.

wp_read_image_metadata()

Собирает массив полезных метаданных картинки из метаданных файла exif и iptc.