acf/validate_attachment/type=(type) filter-hookACF 5.2.3

Filters the errors for a file before it is uploaded or displayed in the media modal.

Usage

add_filter( 'acf/validate_attachment/type=(type)', 'wp_kama_acf_validate_attachment_type_filter', 10, 5 );

/**
 * Function for `acf/validate_attachment/type=(type)` filter-hook.
 * 
 * @param array  $errors     An array of errors.
 * @param array  $file       An array of data for a single file.
 * @param array  $attachment An array of attachment data which differs based on the context.
 * @param array  $field      The field array.
 * @param string $context    The curent context (uploading, preparing)
 *
 * @return array
 */
function wp_kama_acf_validate_attachment_type_filter( $errors, $file, $attachment, $field, $context ){
	// filter...
	return $errors;
}
$errors(array)
An array of errors.
$file(array)
An array of data for a single file.
$attachment(array)
An array of attachment data which differs based on the context.
$field(array)
The field array.
$context(string)
The curent context (uploading, preparing)

Changelog

Since 5.2.3 Introduced.

Where the hook is called

acf_validate_attachment()
acf/validate_attachment/type=(type)
acf/includes/api/api-helpers.php 3463
$errors = apply_filters( "acf/validate_attachment/type={$field['type']}", $errors, $file, $attachment, $field, $context );

Where the hook is used in Advanced Custom Fields PRO

acf/includes/fields/class-acf-field-image.php 51
add_filter( 'acf/validate_attachment/type=image', 'acf_validate_is_image_attachment', 10, 5 );
acf/pro/fields/class-acf-field-gallery.php 65
add_filter( 'acf/validate_attachment/type=gallery', 'acf_validate_is_image_attachment', 10, 5 );