Функция is_local_attachment() в WordPress проверяет, является ли переданный URL локальным вложением (файлом медиатеки) сайта. Это полезная функция для ситуаций, когда нужно определить, был ли файл загружен на сайт через медиабиблиотеку WordPress.
is_local_attachment( string $url ): bool
Описание
Эта функция используется для проверки, является ли переданный URL вложением, которое было загружено на текущий сайт через медиабиблиотеку. Функция возвращает true, если URL соответствует вложению сайта, и false в противном случае.
Параметры
- $url (string, обязательный): URL файла, который нужно проверить.
Возвращаемое значение
- Возвращает
true, если URL является локальным вложением медиатеки сайта, иfalse, если это не так.
Пример 1: Проверка локального вложения
Предположим, что у нас есть URL файла, и мы хотим проверить, был ли он загружен через медиабиблиотеку WordPress:
$url = 'https://example.com/wp-content/uploads/2023/10/myimage.jpg';
if ( is_local_attachment( $url ) ) {
echo esc_html__( 'Этот URL является локальным вложением.', 'your-text-domain' );
} else {
echo esc_html__( 'Этот URL не является локальным вложением.', 'your-text-domain' );
}
В этом примере функция проверяет, является ли указанный URL локальным вложением сайта. Если это так, выведется сообщение, что файл был загружен через медиабиблиотеку WordPress.
Пример 2: Использование в проверке нескольких ссылок
Этот пример демонстрирует, как можно использовать is_local_attachment() для проверки списка URL и вывода информации о том, какие из них являются вложениями сайта:
$urls = [
'https://example.com/wp-content/uploads/2023/10/file1.pdf',
'https://external-site.com/file2.png',
'https://example.com/wp-content/uploads/2023/10/file3.jpg',
];
foreach ( $urls as $url ) {
if ( is_local_attachment( $url ) ) {
echo esc_html__( $url . ' — локальное вложение.', 'your-text-domain' ) . '<br>';
} else {
echo esc_html__( $url . ' — не локальное вложение.', 'your-text-domain' ) . '<br>';
}
}
Заключение
Функция is_local_attachment() в WordPress — полезный инструмент для проверки, был ли файл загружен через медиабиблиотеку WordPress и относится ли он к текущему сайту. Это особенно актуально, если вы работаете с файлами или ссылками на медиафайлы и хотите убедиться, что они локальны.