request_filesystem_credentials — filter WordPress: параметры и применение

Сигнатура

apply_filters( 'request_filesystem_credentials', mixed $credentials, string $form_post, string $type, bool|WP_Error $error, string $context, array $extra_fields, bool $allow_relaxed_file_ownership )

Описание

Возврат любого значения, кроме пустой строки, фактически прервёт вывод формы учётных данных файловой системы и вернёт это значение вместо неё.
Фильтр должен вернуть true, если учётные данные файловой системы не требуются, false — если они требуются, но не были предоставлены, или массив учётных данных, если они требуются и были предоставлены.

Оригинал (английский)

Returning anything other than an empty string will effectively short-circuit output of the filesystem credentials form, returning that value instead.

A filter should return true if no filesystem credentials are required, false if they are required but have not been provided, or an array of credentials if they are required and have been provided.

Фильтруемое значение

Учётные данные, возвращаемые вместо этого. По умолчанию пустая строка.

Параметры

$credentials mixed обязательный

Учётные данные, возвращаемые вместо этого. По умолчанию пустая строка.

$form_post string обязательный

URL, на который отправляется форма.

$type string обязательный

Выбранный тип файловой системы.

$error bool|WP_Error обязательный

Не удалось ли текущему запросу установить соединение, либо объект ошибки.

$context string обязательный

Полный путь к каталогу, который проверяется на возможность записи.

$extra_fields array обязательный

Дополнительные поля POST.

$allow_relaxed_file_ownership bool обязательный

Разрешать ли запись для группы и всех пользователей.

Исходный код

wp-admin/includes/file.php:2389

$req_cred = apply_filters( 'request_filesystem_credentials', '', $form_post, $type, $error, $context, $extra_fields, $allow_relaxed_file_ownership );

История изменений

Версия	Описание
4.6.0	The $context parameter default changed from false to an empty string.
2.5.0	Introduced.