media.php

<?php 

if( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly

if( ! class_exists('ACF_Media') ) :

class ACF_Media {
	
	/**
	 * Constructor.
	 *
	 * @date	23/06/12
	 * @since	5.0.0
	 *
	 * @param	void
	 * @return	void
	 */
	public function __construct() {
		
		// Localize media strings.
		add_action( 'acf/enqueue_scripts',			array( $this, 'enqueue_scripts' ) );
		
		// Save files uploaded from basic `$_FILE` field.
		add_action( 'acf/save_post', 				array( $this, 'save_files' ), 5, 1 );
		
		// Hook into Media Upload to run additional logic.
		add_filter( 'wp_handle_upload_prefilter', 	array( $this, 'handle_upload_prefilter' ), 10, 1 );
		
		// Hook into Media Modal Query to run additional logic.
		add_action( 'wp_ajax_query-attachments',	array( $this, 'wp_ajax_query_attachments' ), -1 );
	}
	
	/**
	 * Fires when ACF scrtips are enqueued.
	 *
	 * @date	27/4/18
	 * @since	5.6.9
	 *
	 * @param	void
	 * @return	void
	 */
	public function enqueue_scripts(){
		if( wp_script_is('acf-input') ) {
			acf_localize_text(array(
				'Select.verb'			=> _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 );
		}
	}
	
	/**
	 * 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' );
		if( !empty($errors) ) {
			$response['acf_errors'] = implode('<br />', $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