_x( 'Select', 'verb', 'acf' ), 'Edit.verb' => _x( 'Edit', 'verb', 'acf' ), 'Update.verb' => _x( 'Update', 'verb', 'acf' ), 'Uploaded to this post' => __( 'Uploaded to this post', 'acf' ), 'Expand Details' => __( 'Expand Details', 'acf' ), 'Collapse Details' => __( 'Collapse Details', 'acf' ), 'Restricted' => __( 'Restricted', 'acf' ), 'All images' => __( 'All images', 'acf' ), ) ); acf_localize_data( array( 'mimeTypeIcon' => wp_mime_type_icon(), 'mimeTypes' => get_allowed_mime_types(), ) ); } } /** * Uploads attachments found in the basic `$_FILES` array. * * @date 24/10/2014 * @since 5.0.9 * * @param string|int $post_id The post ID being saved. * @return void */ public function save_files( $post_id = 0 ) { if ( isset( $_FILES['acf']['name'] ) ) { acf_upload_files(); } } /** * Filters data for the current file being uploaded. * * @date 16/02/2015 * @since 5.1.5 * * @param array $file An array of data for a single file. * @return array */ public function handle_upload_prefilter( $file ) { $field = $this->get_source_field(); if ( ! $field ) { return $file; } // Validate the attachment and append any errors. $errors = acf_validate_attachment( $file, $field, 'upload' ); /** * Filters the errors for a file before it is uploaded to WordPress. * * @date 16/02/2015 * @since 5.1.5 * * @param array $errors An array of errors. * @param array $file An array of data for a single file. * @param array $field The field array. */ $errors = apply_filters( "acf/upload_prefilter/type={$field['type']}", $errors, $file, $field ); $errors = apply_filters( "acf/upload_prefilter/name={$field['_name']}", $errors, $file, $field ); $errors = apply_filters( "acf/upload_prefilter/key={$field['key']}", $errors, $file, $field ); $errors = apply_filters( 'acf/upload_prefilter', $errors, $file, $field ); // Append errors. if ( ! empty( $errors ) ) { $file['error'] = implode( "\n", $errors ); } // Ensure newly uploaded image contains "preview_size" within the "size" data. add_filter( 'image_size_names_choose', array( $this, 'image_size_names_choose' ), 10, 1 ); // Return. return $file; } /** * Returns the field responsible for the current Media query or upload context. * * @date 21/5/21 * @since 5.9.7 * * @param void * @return array| false. */ private function get_source_field() { $field = false; // Search for field key within available data. // Case 1) Media modal query. if ( isset( $_POST['query']['_acfuploader'] ) ) { $field_key = (string) $_POST['query']['_acfuploader']; // Case 2) Media modal upload. } elseif ( isset( $_POST['_acfuploader'] ) ) { $field_key = (string) $_POST['_acfuploader']; } // Attempt to load field. // Note the `acf_get_field()` function will return false if not found. if ( isset( $field_key ) ) { $field = acf_get_field( $field_key ); } return $field; } /** * Fires during the WP Modal Query AJAX call. * * @date 26/06/2015 * @since 5.2.3 * * @param void * @return void */ function wp_ajax_query_attachments() { if ( $this->get_source_field() ) { add_filter( 'wp_prepare_attachment_for_js', array( $this, 'wp_prepare_attachment_for_js' ), 10, 3 ); add_filter( 'image_size_names_choose', array( $this, 'image_size_names_choose' ), 10, 1 ); } else { add_filter( 'wp_prepare_attachment_for_js', array( $this, 'clear_acf_errors_for_core_requests' ), 5, 3 ); } } /** * Append acf_errors false for non-acf media library calls to prevent media library caching. * * @date 31/8/21 * @since 5.10.2 * * @param array $response Array of prepared attachment data. * @param WP_Post $attachment Attachment object. * @param array|false $meta Array of attachment meta data, or false if there is none. * @return array */ function clear_acf_errors_for_core_requests( $response, $attachment, $meta ) { $response['acf_errors'] = false; return $response; } /** * Filters attachment data as it is being prepared for JS. * * @date 21/5/21 * @since 5.9.7 * * @param array $response Array of prepared attachment data. * @param WP_Post $attachment Attachment object. * @param array|false $meta Array of attachment meta data, or false if there is none. * @return array */ function wp_prepare_attachment_for_js( $response, $attachment, $meta ) { $field = $this->get_source_field(); // Validate the attachment and append any errors. $errors = acf_validate_attachment( $response, $field, 'prepare' ); $response['acf_errors'] = false; if ( ! empty( $errors ) ) { $response['acf_errors'] = implode( '
', $errors ); } // Return. return $response; } /** * Filters the names and labels of the default image sizes. * * @date 21/5/21 * @since 5.9.7 * * @param array $size_names Array of image size labels keyed by their name. * @return array */ function image_size_names_choose( $size_names ) { $field = $this->get_source_field(); // Append "preview_size" setting to array of image sizes so WP will include in prepared JS data. if ( isset( $field['preview_size'] ) ) { $name = (string) $field['preview_size']; $size_names[ $name ] = $name; // Don't worry about size label, it is never used. } return $size_names; } } // Instantiate. acf_new_instance( 'ACF_Media' ); endif; // class_exists check