wp_get_attachment_image_src()

Получает изображение для представления вложения
Функция WordPress
INT 2.5.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение URL изображения для заданного вложения
  4. Изменение размера изображения
  5. Получение URL иконки MIME-типа
  6. Получение URL изображения с заданными размерами и иконкой MIME-типа
  7. Получение URL изображения с заданными размерами и без иконки MIME-типа
  8. Вопросы и ответы
  9. Как получить URL изображения в полном размере?
  10. Как получить URL изображения в определенном размере?
  11. Как получить ширину и высоту изображения?
  12. Как проверить, существует ли изображение для данного вложения?
  13. Как получить URL иконки MIME-типа, если изображение недоступно?
  14. Как изменить размер изображения при использовании wp_get_attachment_image_src()?
  15. Как получить URL изображения без указания размера?
  16. Как получить URL изображения с наибольшим доступным размером?
  17. Как получить URL изображения с наименьшим доступным размером?
  18. Связанные элементы

Описание функции

Функция wp_get_attachment_image_src() используется для получения изображения, представляющего вложение. Она возвращает массив данных об изображении или логическое значение false, если изображение недоступно.

Использование

wp_get_attachment_image_src( int $attachment_id, string|int[] $size = 'thumbnail', bool $icon = false ): array|false

Эта функция принимает три параметра: $attachment_id (обязательный), $size (необязательный) и $icon (необязательный). Она возвращает массив данных об изображении или логическое значение false.

  • $attachment_id (int) — Обязательный. Идентификатор вложения изображения.
  • $size (string|int[]) — Необязательный. Размер изображения. Принимает имя зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (в указанном порядке). По умолчанию ‘thumbnail’.
  • $icon (bool) — Необязательный. Определяет, должно ли изображение заменяться значком типа MIME. По умолчанию false.

Функция возвращает массив данных об изображении или логическое значение false, если изображение недоступно.

<?php
$attachment_id = 123; // Идентификатор вложения изображения
// Получение данных об изображении размером 'medium'
$image_data = wp_get_attachment_image_src( $attachment_id, 'medium' );
if ( $image_data ) {
  $image_url = $image_data[0]; // URL изображения
  $image_width = $image_data[1]; // Ширина изображения в пикселях
  $image_height = $image_data[2]; // Высота изображения в пикселях
  $image_is_intermediate = $image_data[3]; // Является ли изображение промежуточным размером
  // Вывод данных об изображении
  echo "URL изображения: " . $image_url . "<br>";
  echo "Ширина изображения: " . $image_width . "<br>";
  echo "Высота изображения: " . $image_height . "<br>";
  echo "Является ли изображение промежуточным размером: " . $image_is_intermediate . "<br>";
} else {
  echo "Изображение недоступно.";
}
?>

В этом примере мы получаем данные об изображении с идентификатором 123 и размером ‘medium’. Затем мы проверяем, доступны ли данные об изображении, и выводим информацию об изображении, если она доступна. Если изображение недоступно, выводится сообщение «Изображение недоступно».

Примеры использования

Получение URL изображения для заданного вложения


$attachment_id = 123; // ID вложения
$image = wp_get_attachment_image_src( $attachment_id, 'full' ); // Получение URL изображения
if ( $image ) {
    $image_url = $image[0]; // URL изображения
    echo 'URL изображения: ' . $image_url;
} else {
    echo 'Изображение недоступно.';
}

В этом примере мы используем функцию wp_get_attachment_image_src() для получения URL изображения для заданного вложения. Мы передаем ID вложения и указываем размер изображения как ‘full’, чтобы получить полноразмерное изображение. Если изображение доступно, мы выводим его URL, иначе выводим сообщение об ошибке.

Изменение размера изображения


$attachment_id = 123; // ID вложения
$image = wp_get_attachment_image_src( $attachment_id, array( 500, 300 ) ); // Получение URL изображения с измененным размером
if ( $image ) {
    $image_url = $image[0]; // URL изображения
    echo 'URL изображения с измененным размером: ' . $image_url;
} else {
    echo 'Изображение недоступно.';
}

В этом примере мы используем функцию wp_get_attachment_image_src() для получения URL изображения для заданного вложения с измененным размером. Мы передаем ID вложения и указываем размер изображения как массив с шириной 500 пикселей и высотой 300 пикселей. Если изображение доступно, мы выводим его URL, иначе выводим сообщение об ошибке.

Получение URL иконки MIME-типа


$attachment_id = 123; // ID вложения
$image = wp_get_attachment_image_src( $attachment_id, 'thumbnail', true ); // Получение URL иконки MIME-типа
if ( $image ) {
    $image_url = $image[0]; // URL иконки MIME-типа
    echo 'URL иконки MIME-типа: ' . $image_url;
} else {
    echo 'Иконка MIME-типа недоступна.';
}

В этом примере мы используем функцию wp_get_attachment_image_src() для получения URL иконки MIME-типа для заданного вложения. Мы передаем ID вложения, указываем размер изображения как ‘thumbnail’ и устанавливаем параметр $icon в значение true. Если иконка MIME-типа доступна, мы выводим ее URL, иначе выводим сообщение об ошибке.

Получение URL изображения с заданными размерами и иконкой MIME-типа


$attachment_id = 123; // ID вложения
$image = wp_get_attachment_image_src( $attachment_id, array( 500, 300 ), true ); // Получение URL изображения с измененным размером и иконкой MIME-типа
if ( $image ) {
    $image_url = $image[0]; // URL изображения
    echo 'URL изображения с измененным размером и иконкой MIME-типа: ' . $image_url;
} else {
    echo 'Изображение недоступно.';
}

В этом примере мы используем функцию wp_get_attachment_image_src() для получения URL изображения для заданного вложения с измененным размером и иконкой MIME-типа. Мы передаем ID вложения, указываем размер изображения как массив с шириной 500 пикселей и высотой 300 пикселей, и устанавливаем параметр $icon в значение true. Если изображение доступно, мы выводим его URL, иначе выводим сообщение об ошибке.

Получение URL изображения с заданными размерами и без иконки MIME-типа


$attachment_id = 123; // ID вложения
$image = wp_get_attachment_image_src( $attachment_id, array( 500, 300 ), false ); // Получение URL изображения с измененным размером и без иконки MIME-типа
if ( $image ) {
    $image_url = $image[0]; // URL изображения
    echo 'URL изображения с измененным размером и без иконки MIME-типа: ' . $image_url;
} else {
    echo 'Изображение недоступно.';
}

В этом примере мы используем функцию wp_get_attachment_image_src() для получения URL изображения для заданного вложения с измененным размером и без иконки MIME-типа. Мы передаем ID вложения, указываем размер изображения как массив с шириной 500 пикселей и высотой 300 пикселей, и устанавливаем параметр $icon в значение false. Если изображение доступно, мы выводим его URL, иначе выводим сообщение об ошибке.

Вопросы и ответы

Как получить URL изображения в полном размере?

Для получения URL изображения в полном размере используется функция wp_get_attachment_image_src() с параметром $size равным 'full'.


$image = wp_get_attachment_image_src( $attachment_id, 'full' );
if ( $image ) {
    $image_url = $image[0];
    // Дальнейшая обработка URL изображения
}

Как получить URL изображения в определенном размере?

Для получения URL изображения в определенном размере используется функция wp_get_attachment_image_src() с параметром $size указывающим на нужный размер.


$image = wp_get_attachment_image_src( $attachment_id, 'medium' );
if ( $image ) {
    $image_url = $image[0];
    // Дальнейшая обработка URL изображения
}

Как получить ширину и высоту изображения?

Для получения ширины и высоты изображения используется функция wp_get_attachment_image_src() с параметром $size равным 'full'. Размеры изображения будут доступны в элементах массива $image[1] и $image[2].


$image = wp_get_attachment_image_src( $attachment_id, 'full' );
if ( $image ) {
    $width = $image[1];
    $height = $image[2];
    // Дальнейшая обработка ширины и высоты изображения
}

Как проверить, существует ли изображение для данного вложения?

Для проверки наличия изображения для определенного вложения в WordPress можно использовать функцию wp_get_attachment_image_src(). Если изображение существует, функция вернет массив данных об изображении. В противном случае, функция вернет значение false.

Пример кода:


$image_data = wp_get_attachment_image_src( $attachment_id );
if ( $image_data ) {
    // Изображение существует
} else {
    // Изображение не существует
}

Как получить URL иконки MIME-типа, если изображение недоступно?

Если изображение недоступно, можно получить URL иконки MIME-типа с помощью функции wp_get_attachment_image_src() и передав параметр true вторым аргументом.

Пример кода:


$icon_url = wp_get_attachment_image_src( $attachment_id, 'thumbnail', true );
if ( $icon_url ) {
    // Иконка MIME-типа доступна
} else {
    // Иконка MIME-типа недоступна
}

Как изменить размер изображения при использовании wp_get_attachment_image_src()?

Для изменения размера изображения при использовании функции wp_get_attachment_image_src() нужно передать вторым аргументом имя зарегистрированного размера изображения или массив значений ширины и высоты в пикселях.

Пример кода:


$image_data = wp_get_attachment_image_src( $attachment_id, array( 800, 600 ) );
if ( $image_data ) {
    // Изображение доступно в новом размере
} else {
    // Изображение недоступно в новом размере
}

Как получить URL изображения без указания размера?

Для получения URL изображения без указания размера используется функция wp_get_attachment_image_src() с параметром $size по умолчанию.

$attachment_id = 123; // ID вложения
$image_data = wp_get_attachment_image_src( $attachment_id );
$image_url = $image_data[0]; // URL изображения

Как получить URL изображения с наибольшим доступным размером?

Для получения URL изображения с наибольшим доступным размером используется функция wp_get_attachment_image_src() с параметром $size равным 'full'.

$attachment_id = 123; // ID вложения
$image_data = wp_get_attachment_image_src( $attachment_id, 'full' );
$image_url = $image_data[0]; // URL изображения

Как получить URL изображения с наименьшим доступным размером?

Для получения URL изображения с наименьшим доступным размером используется функция wp_get_attachment_image_src() с параметром $size равным 'thumbnail'.

$attachment_id = 123; // ID вложения
$image_data = wp_get_attachment_image_src( $attachment_id, 'thumbnail' );
$image_url = $image_data[0]; // URL изображения

Функция wp_get_attachment_image_src() возвращает URL изображения в зависимости от указанного размера. Она позволяет получить URL изображения без указания размера, с наибольшим доступным размером и с наименьшим доступным размером. Это удобно для работы с изображениями в WordPress и позволяет легко получать нужные URL для дальнейшей обработки или отображения.

Связанные элементы

  • Функция wp_get_attachment_image(): Возвращает HTML-код для отображения изображения вложения.
  • Функция wp_get_attachment_image_srcset(): Возвращает HTML-код для атрибута srcset изображения вложения.
  • Функция wp_get_attachment_image_sizes(): Возвращает HTML-код для атрибута sizes изображения вложения.
  • Функция wp_get_attachment_caption(): Возвращает описание вложения.
  • Функция wp_get_attachment_metadata(): Возвращает метаданные вложения.
  • Функция wp_get_attachment_thumb_file(): Возвращает путь к файлу миниатюры вложения.
  • Функция wp_get_attachment_thumb_url(): Возвращает URL-адрес миниатюры вложения.
  • Функция wp_get_attachment_url(): Возвращает URL-адрес вложения.
  • Хук wp_get_attachment_image_attributes: Позволяет изменить атрибуты изображения вложения.
  • Хук wp_get_attachment_image_src: Позволяет изменить массив данных изображения вложения.
Обсуждение