ACF_Assets{}ACF 1.0

Использование

$ACF_Assets = new ACF_Assets();
// use class methods

Методы

  1. public __call( $name, $arguments )
  2. public __construct()
  3. public add_action( $action, $method, $priority = 10, $accepted_args = 1 )
  4. private add_actions()
  5. public add_data( $data )
  6. public add_text( $text )
  7. public enqueue( $args = array() )
  8. public enqueue_script( $name )
  9. public enqueue_scripts()
  10. public enqueue_style( $name )
  11. public enqueue_uploader()
  12. public print_footer_scripts()
  13. public print_scripts()
  14. public print_uploader_scripts()
  15. public register_scripts()

Код ACF_Assets{} ACF 5.10.2

<?php
class ACF_Assets {

	/**
	 * Storage for i18n data.
	 *
	 * @since 5.6.9
	 * @var array
	 */
	public $text = array();

	/**
	 * Storage for l10n data.
	 *
	 * @since 5.6.9
	 * @var array
	 */
	public $data = array();

	/**
	 * List of enqueue flags.
	 *
	 * @since 5.9.0
	 * @var bool
	 */
	private $enqueue = array();

	/**
	 * Constructor.
	 *
	 * @date    10/4/18
	 * @since   5.6.9
	 *
	 * @param   void
	 * @return  void
	 */
	public function __construct() {
		add_action( 'init', array( $this, 'register_scripts' ) );
	}

	/**
	 * Magic __call method for backwards compatibility.
	 *
	 * @date    10/4/20
	 * @since   5.9.0
	 *
	 * @param   string $name The method name.
	 * @param   array  $arguments The array of arguments.
	 * @return  mixed
	 */
	public function __call( $name, $arguments ) {
		switch ( $name ) {
			case 'admin_enqueue_scripts':
			case 'admin_print_scripts':
			case 'admin_head':
			case 'admin_footer':
			case 'admin_print_footer_scripts':
				_doing_it_wrong( __FUNCTION__, 'The ACF_Assets class should not be accessed directly.', '5.9.0' );
		}
	}

	/**
	 * Appends an array of i18n data.
	 *
	 * @date    13/4/18
	 * @since   5.6.9
	 *
	 * @param   array $text An array of text for i18n.
	 * @return  void
	 */
	public function add_text( $text ) {
		foreach ( (array) $text as $k => $v ) {
			$this->text[ $k ] = $v;
		}
	}

	/**
	 * Appends an array of l10n data.
	 *
	 * @date    13/4/18
	 * @since   5.6.9
	 *
	 * @param   array $data An array of data for l10n.
	 * @return  void
	 */
	public function add_data( $data ) {
		foreach ( (array) $data as $k => $v ) {
			$this->data[ $k ] = $v;
		}
	}

	/**
	 * Registers the ACF scripts and styles.
	 *
	 * @date    10/4/18
	 * @since   5.6.9
	 *
	 * @param   void
	 * @return  void
	 */
	public function register_scripts() {
		// Extract vars.
		$suffix  = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
		$version = acf_get_setting( 'version' );

		// Register scripts.
		wp_register_script( 'acf', acf_get_url( 'assets/build/js/acf' . $suffix . '.js' ), array( 'jquery' ), $version );
		wp_register_script( 'acf-input', acf_get_url( 'assets/build/js/acf-input' . $suffix . '.js' ), array( 'jquery', 'jquery-ui-sortable', 'jquery-ui-resizable', 'acf' ), $version );
		wp_register_script( 'acf-field-group', acf_get_url( 'assets/build/js/acf-field-group' . $suffix . '.js' ), array( 'acf-input' ), $version );

		// Register styles.
		wp_register_style( 'acf-global', acf_get_url( 'assets/build/css/acf-global.css' ), array( 'dashicons' ), $version );
		wp_register_style( 'acf-input', acf_get_url( 'assets/build/css/acf-input.css' ), array( 'acf-global' ), $version );
		wp_register_style( 'acf-field-group', acf_get_url( 'assets/build/css/acf-field-group.css' ), array( 'acf-input' ), $version );

		/**
		 * Fires after core scripts and styles have been registered.
		 *
		 * @since   5.6.9
		 *
		 * @param   string $version The ACF version.
		 * @param   string $suffix The potential ".min" filename suffix.
		 */
		do_action( 'acf/register_scripts', $version, $suffix );
	}

	/**
	 * Enqueues a script and sets up actions for priting supplemental scripts.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   string $name The script name.
	 * @return  void
	 */
	public function enqueue_script( $name ) {
		wp_enqueue_script( $name );
		$this->add_actions();
	}

	/**
	 * Enqueues a style.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   string $name The style name.
	 * @return  void
	 */
	public function enqueue_style( $name ) {
		wp_enqueue_style( $name );
	}

	/**
	 * Adds the actions needed to print supporting inline scripts.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   void
	 * @return  void
	 */
	private function add_actions() {

		// Only run once.
		if ( acf_has_done( 'ACF_Assets::add_actions' ) ) {
			return;
		}

		// Add actions.
		$this->add_action( 'admin_enqueue_scripts', 'enqueue_scripts', 20 );
		$this->add_action( 'admin_print_scripts', 'print_scripts', 20 );
		$this->add_action( 'admin_print_footer_scripts', 'print_footer_scripts', 20 );
	}

	/**
	 * Extends the add_action() function with two additional features:
	 * 1. Renames $action depending on the current page (customizer, login, front-end).
	 * 2. Alters the priotiry or calls the method directly if the action has already passed.
	 *
	 * @date    28/4/20
	 * @since   5.9.0
	 *
	 * @param   string $action The action name.
	 * @param   string $method The method name.
	 * @param   int    $priority See add_action().
	 * @param   int    $accepted_args See add_action().
	 * @return  void
	 */
	public function add_action( $action, $method, $priority = 10, $accepted_args = 1 ) {

		// Generate an array of action replacements.
		$replacements = array(
			'customizer' => array(
				'admin_enqueue_scripts'      => 'admin_enqueue_scripts',
				'admin_print_scripts'        => 'customize_controls_print_scripts',
				'admin_head'                 => 'customize_controls_print_scripts',
				'admin_footer'               => 'customize_controls_print_footer_scripts',
				'admin_print_footer_scripts' => 'customize_controls_print_footer_scripts',
			),
			'login'      => array(
				'admin_enqueue_scripts'      => 'login_enqueue_scripts',
				'admin_print_scripts'        => 'login_head',
				'admin_head'                 => 'login_head',
				'admin_footer'               => 'login_footer',
				'admin_print_footer_scripts' => 'login_footer',
			),
			'wp'         => array(
				'admin_enqueue_scripts'      => 'wp_enqueue_scripts',
				'admin_print_scripts'        => 'wp_print_scripts',
				'admin_head'                 => 'wp_head',
				'admin_footer'               => 'wp_footer',
				'admin_print_footer_scripts' => 'wp_print_footer_scripts',
			),
		);

		// Determine the current context.
		if ( did_action( 'customize_controls_init' ) ) {
			$context = 'customizer';
		} elseif ( did_action( 'login_form_register' ) ) {
			$context = 'login';
		} elseif ( is_admin() ) {
			$context = 'admin';
		} else {
			$context = 'wp';
		}

		// Replace action if possible.
		if ( isset( $replacements[ $context ][ $action ] ) ) {
			$action = $replacements[ $context ][ $action ];
		}

		// Check if action is currently being or has already been run.
		if ( did_action( $action ) ) {
			$doing = acf_doing_action( $action );
			if ( $doing && $doing < $priority ) {
				// Allow action to be added as per usual.
			} else {
				// Call method directly.
				return call_user_func( array( $this, $method ) );
			}
		}

		// Add action.
		add_action( $action, array( $this, $method ), $priority, $accepted_args );
	}

	/**
	 * Generic controller for enqueuing scripts and styles.
	 *
	 * @date    28/4/20
	 * @since   5.9.0
	 *
	 * @param   array $args {
	 *      @type bool $uploader Whether or not to enqueue uploader scripts.
	 * }
	 * @return  void
	 */
	public function enqueue( $args = array() ) {

		// Apply defaults.
		$args = wp_parse_args(
			$args,
			array(
				'input'    => true,
				'uploader' => false,
			)
		);

		// Set enqueue flags and add actions.
		if ( $args['input'] ) {
			$this->enqueue[] = 'input';
		}
		if ( $args['uploader'] ) {
			$this->enqueue[] = 'uploader';
		}
		$this->add_actions();
	}

	/**
	 * Enqueues the scripts and styles needed for the WP media uploader.
	 *
	 * @date    27/10/2014
	 * @since   5.0.9
	 *
	 * @param   void
	 * @return  void
	 */
	public function enqueue_uploader() {

		// Only run once.
		if ( acf_has_done( 'ACF_Assets::enqueue_uploader' ) ) {
			return;
		}

		// Enqueue media assets.
		if ( current_user_can( 'upload_files' ) ) {
			wp_enqueue_media();
		}

		// Add actions.
		$this->add_action( 'admin_footer', 'print_uploader_scripts', 1 );

		/**
		 * Fires when enqueuing the uploader.
		 *
		 * @since   5.6.9
		 *
		 * @param   void
		 */
		do_action( 'acf/enqueue_uploader' );
	}

	/**
	 * Enqueues and localizes scripts.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   void
	 * @return  void
	 */
	public function enqueue_scripts() {

		// Enqueue input scripts.
		if ( in_array( 'input', $this->enqueue ) ) {
			wp_enqueue_script( 'acf-input' );
			wp_enqueue_style( 'acf-input' );
		}

		// Enqueue media scripts.
		if ( in_array( 'uploader', $this->enqueue ) ) {
			$this->enqueue_uploader();
		}

		// Localize text.
		acf_localize_text(
			array(

				// Tooltip
				'Are you sure?' => __( 'Are you sure?', 'acf' ),
				'Yes'           => __( 'Yes', 'acf' ),
				'No'            => __( 'No', 'acf' ),
				'Remove'        => __( 'Remove', 'acf' ),
				'Cancel'        => __( 'Cancel', 'acf' ),
			)
		);

		// Localize "input" text.
		if ( wp_script_is( 'acf-input' ) ) {
			acf_localize_text(
				array(

					// Unload
					'The changes you made will be lost if you navigate away from this page' => __( 'The changes you made will be lost if you navigate away from this page', 'acf' ),

					// Validation
					'Validation successful'       => __( 'Validation successful', 'acf' ),
					'Validation failed'           => __( 'Validation failed', 'acf' ),
					'1 field requires attention'  => __( '1 field requires attention', 'acf' ),
					'%d fields require attention' => __( '%d fields require attention', 'acf' ),

					// Other
					'Edit field group'            => __( 'Edit field group', 'acf' ),
				)
			);

			/**
			 * Fires during "admin_enqueue_scripts" when ACF scripts are enqueued.
			 *
			 * @since   5.6.9
			 *
			 * @param   void
			 */
			do_action( 'acf/input/admin_enqueue_scripts' );
		}

		/**
		 * Fires during "admin_enqueue_scripts" when ACF scripts are enqueued.
		 *
		 * @since   5.6.9
		 *
		 * @param   void
		 */
		do_action( 'acf/admin_enqueue_scripts' );
		do_action( 'acf/enqueue_scripts' );

		// Filter i18n translations that differ from English and localize script.
		$text = array();
		foreach ( $this->text as $k => $v ) {
			if ( str_replace( '.verb', '', $k ) !== $v ) {
				$text[ $k ] = $v;
			}
		}
		if ( $text ) {
			wp_localize_script( 'acf', 'acfL10n', $text );
		}
	}

	/**
	 * Prints scripts in head.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   void
	 * @return  void
	 */
	public function print_scripts() {
		if ( wp_script_is( 'acf-input' ) ) {

			/**
			 * Fires during "admin_head" when ACF scripts are enqueued.
			 *
			 * @since   5.6.9
			 *
			 * @param   void
			 */
			do_action( 'acf/input/admin_head' );
			do_action( 'acf/input/admin_print_scripts' );
		}

		/**
		 * Fires during "admin_head" when ACF scripts are enqueued.
		 *
		 * @since   5.6.9
		 *
		 * @param   void
		 */
		do_action( 'acf/admin_head' );
		do_action( 'acf/admin_print_scripts' );
	}

	/**
	 * Prints scripts in footer.
	 *
	 * @date    27/4/20
	 * @since   5.9.0
	 *
	 * @param   void
	 * @return  void
	 */
	public function print_footer_scripts() {
		global $wp_version;

		// Bail early if 'acf' script was never enqueued (fixes Elementor enqueue reset conflict).
		if ( ! wp_script_is( 'acf' ) ) {
			return;
		}

		// Localize data.
		acf_localize_data(
			array(
				'admin_url'   => admin_url(),
				'ajaxurl'     => admin_url( 'admin-ajax.php' ),
				'nonce'       => wp_create_nonce( 'acf_nonce' ),
				'acf_version' => acf_get_setting( 'version' ),
				'wp_version'  => $wp_version,
				'browser'     => acf_get_browser(),
				'locale'      => acf_get_locale(),
				'rtl'         => is_rtl(),
				'screen'      => acf_get_form_data( 'screen' ),
				'post_id'     => acf_get_form_data( 'post_id' ),
				'validation'  => acf_get_form_data( 'validation' ),
				'editor'      => acf_is_block_editor() ? 'block' : 'classic',
			)
		);

		// Print inline script.
		printf( "<script>\n%s\n</script>\n", 'acf.data = ' . wp_json_encode( $this->data ) . ';' );

		if ( wp_script_is( 'acf-input' ) ) {

			/**
			 * Filters an empty array for compat l10n data.
			 *
			 * @since   5.0.0
			 *
			 * @param   array $data An array of data to append to.
			 */
			$compat_l10n = apply_filters( 'acf/input/admin_l10n', array() );
			if ( $compat_l10n ) {
				printf( "<script>\n%s\n</script>\n", 'acf.l10n = ' . wp_json_encode( $compat_l10n ) . ';' );
			}

			/**
			 * Fires during "admin_footer" when ACF scripts are enqueued.
			 *
			 * @since   5.6.9
			 *
			 * @param   void
			 */
			do_action( 'acf/input/admin_footer' );
			do_action( 'acf/input/admin_print_footer_scripts' );
		}

		/**
		 * Fires during "admin_footer" when ACF scripts are enqueued.
		 *
		 * @since   5.6.9
		 *
		 * @param   void
		 */
		do_action( 'acf/admin_footer' );
		do_action( 'acf/admin_print_footer_scripts' );

		// Once all data is localized, trigger acf.prepare() to execute functionality before DOM ready.
		printf( "<script>\n%s\n</script>\n", "acf.doAction( 'prepare' );" );
	}

	/**
	 * Prints uploader scripts in footer.
	 *
	 * @date    11/06/2020
	 * @since   5.9.0
	 *
	 * @param   void
	 * @return  void
	 */
	public function print_uploader_scripts() {
		// Todo: investigate output-buffer to hide HTML.
		?>
	<div id="acf-hidden-wp-editor" style="display: none;">
		<?php wp_editor( '', 'acf_content' ); ?>
	</div>
		<?php

		/**
		 * Fires when printing uploader scripts.
		 *
		 * @since   5.6.9
		 *
		 * @param   void
		 */
		do_action( 'acf/admin_print_uploader_scripts' );
	}
}