pre_attachment_url_to_postid
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'pre_attachment_url_to_postid', int|null $post_id, string $url )Описание
Позволяет плагинам обойти поиск идентификатора вложения. Плагины, использующие эту функцию, должны возвращать:
0 (целое число), чтобы указать, что вложение не найдено,
идентификатор вложения (целое число), чтобы указать найденный идентификатор вложения,
null, чтобы указать, что WordPress должен продолжить поиск.
Предупреждение: идентификатор записи может быть null или ноль, и оба этих значения приводятся к логическому false. Сведения о приведении к логическим значениям см. в документации PHP.
При разработке фильтров с использованием этого хука для проверки идентификатора записи используйте оператор ===.
Оригинал (английский)
Allows plugins to short-circuit attachment ID lookups. Plugins making use of this function should return:
- 0 (integer) to indicate the attachment is not found,
- attachment ID (integer) to indicate the attachment ID found,
- null to indicate WordPress should proceed with the lookup.
Warning: The post ID may be null or zero, both of which cast to a boolean false. For information about casting to booleans see the PHP documentation.
Use the === operator for testing the post ID when developing filters using this hook.
Фильтруемое значение
Параметры
$post_id
int|null
обязательный
$url
string
обязательный
Исходный код
wp-includes/media.php:5524
$post_id = apply_filters( 'pre_attachment_url_to_postid', null, $url );История изменений
| Версия | Описание |
|---|---|
| 6.7.0 | Introduced. |
