WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Хостинг, VPS/VDS и отдельные сервера только на SSD дисках. 7 дней бесплатного тестирования.
Главная Функции Вложения (media файлы)

Рубрика: Вложения (media файлы) 12

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

Проверяет является ли указанное вложение: картинкой, аудио или видео. Возвращает true/false.

wp_delete_attachment()

Удаляет вложение - файл медиатеки (прикрепленный файл).

wp_get_attachment_link()

Получает html код ссылки на вложение (прикрепленный к посту файл) или страницу, содержащую вложения.

wp_get_attachment_url()

Получает УРЛ вложения по переданному ID вложения. Получает ссылку на файл.

wp_insert_attachment()

Добавляет медиафайл (вложение) в медиатеку WordPress. Файл физически не добавляется — функция создает запись в таблице wp_posts в базе данных и возвращает ID созданной записи.

Картинки

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 прикрепленной к посту картинки миниатюры.

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 код картинки-миниатюры текущего поста.

the_post_thumbnail_caption()

Выводит на экран описание (caption) миниатюры записи (поста).

the_post_thumbnail_url()

Выводит на экран URL миниатюры установленной для текущей записи. Если миниатюры нет вернет NULL (ничего не выведет).

wp_get_additional_image_sizes()

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

wp_get_attachment_thumb_url()

Получает URL картинки-вложения с размером thumbnail.

wp_get_image_editor()

Возвращает объект WP_Image_Editor с указанной картинкой. Используется для изменения размеров изображения (создания миниатюр) и редактирования картинки.

Галерея

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

Получает данные о папке загрузок (upload) в виде массива параметров.

wp_handle_sideload()

Перемещает временный файл в папку uploads. Обертка для _wp_handle_upload(). Указывает название события: wp_handle_sideload. Событие можно изменить в переменной $overrides['action'].

wp_handle_upload()

Обрабатывает загрузку файла через $_FILES. Очищает название файла, проверяет расширение файла (на основе mime типа) и сохраняет файл в соответствующий каталог wp-content/uploads/....

wp_unique_filename()

Уникализирует имя файла. Используется перед сохранением файла в указанную папку, чтобы изменить его имя, если такой файл уже существует.

wp_upload_bits()

Создает файл с указанным контентом в папке загрузок (upload). Возвращает данные загруженного файла.

wp_upload_dir()

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

Метаданные (postmeta)

wp_generate_attachment_metadata()

Генерирует метаданные для картинки-вложения и создает промежуточные копии изображения - миниатюры всех зарегистрированных размеров.

wp_get_attachment_metadata()

Получает метаданные прикрепленного файла.

wp_read_audio_metadata()

Получает все данные об аудио файле из его ID3 меток. Сюда входят все доступные данные: формат, каналы, битрейт, размер, MIMEтип, продолжительность, год, альбом, артист, комментарий, картинка и т.д.

wp_update_attachment_metadata()

Обновляет метаданные вложения (медиафайла).

Редко используемые

attachment_url_to_postid()

Пытается получить ID вложения (картинки из медиатеки) по указанному URL вложения.

get_allowed_mime_types()

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

wp_check_filetype()

Получает расширение и MIME тип файла по переданному имени (пути) файла. Используется для проверки разрешен ли указанный файл на сайте.

wp_get_audio_extensions()

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

wp_get_ext_types()

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

wp_get_video_extensions()

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