acf_admin_tools{} │ ACF 1.0

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

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

Методы

1. public __construct()
2. public admin_menu()
3. public check_submit()
4. public get_tool( $name )
5. public get_tools()
6. public html()
7. public include_tools()
8. public load()
9. public metabox_html( $post, $metabox )
10. public register_tool( $class )

Код acf_admin_tools{} acf admin tools{} ^{ACF 6.0.4}

<?php
class acf_admin_tools {


	/** @var array Contains an array of admin tool instances */
	var $tools = array();


	/** @var string The active tool */
	var $active = '';


	/**
	 *  __construct
	 *
	 *  This function will setup the class functionality
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function __construct() {

		// actions
		add_action( 'admin_menu', array( $this, 'admin_menu' ) );

	}


	/**
	 *  register_tool
	 *
	 *  This function will store a tool tool class
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   string $class
	 *  @return  n/a
	 */

	function register_tool( $class ) {

		$instance                       = new $class();
		$this->tools[ $instance->name ] = $instance;

	}


	/**
	 *  get_tool
	 *
	 *  This function will return a tool tool class
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   string $name
	 *  @return  n/a
	 */

	function get_tool( $name ) {

		return isset( $this->tools[ $name ] ) ? $this->tools[ $name ] : null;

	}


	/**
	 *  get_tools
	 *
	 *  This function will return an array of all tools
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  array
	 */

	function get_tools() {

		return $this->tools;

	}


	/*
	*  admin_menu
	*
	*  This function will add the ACF menu item to the WP admin
	*
	*  @type    action (admin_menu)
	*  @date    28/09/13
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function admin_menu() {

		// bail early if no show_admin
		if ( ! acf_get_setting( 'show_admin' ) ) {
			return;
		}

		// add page
		$page = add_submenu_page( 'edit.php?post_type=acf-field-group', __( 'Tools', 'acf' ), __( 'Tools', 'acf' ), acf_get_setting( 'capability' ), 'acf-tools', array( $this, 'html' ) );

		// actions
		add_action( 'load-' . $page, array( $this, 'load' ) );

	}


	/**
	 *  load
	 *
	 *  description
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function load() {

		// disable filters (default to raw data)
		acf_disable_filters();

		// include tools
		$this->include_tools();

		// check submit
		$this->check_submit();

		// load acf scripts
		acf_enqueue_scripts();

	}


	/**
	 *  include_tools
	 *
	 *  description
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function include_tools() {

		// include
		acf_include( 'includes/admin/tools/class-acf-admin-tool.php' );
		acf_include( 'includes/admin/tools/class-acf-admin-tool-export.php' );
		acf_include( 'includes/admin/tools/class-acf-admin-tool-import.php' );

		// action
		do_action( 'acf/include_admin_tools' );

	}


	/**
	 *  check_submit
	 *
	 *  description
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function check_submit() {

		// loop
		foreach ( $this->get_tools() as $tool ) {

			// load
			$tool->load();

			// submit
			if ( acf_verify_nonce( $tool->name ) ) {
				$tool->submit();
			}
		}

	}


	/**
	 *  html
	 *
	 *  description
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function html() {

		// vars
		$screen = get_current_screen();
		$active = acf_maybe_get_GET( 'tool' );

		// view
		$view = array(
			'screen_id' => $screen->id,
			'active'    => $active,
		);

		// register metaboxes
		foreach ( $this->get_tools() as $tool ) {

			// check active
			if ( $active && $active !== $tool->name ) {
				continue;
			}

			// add metabox
			add_meta_box( 'acf-admin-tool-' . $tool->name, acf_esc_html( $tool->title ), array( $this, 'metabox_html' ), $screen->id, 'normal', 'default', array( 'tool' => $tool->name ) );

		}

		// view
		acf_get_view( 'html-admin-tools', $view );

	}


	/**
	 *  meta_box_html
	 *
	 *  description
	 *
	 *  @date    10/10/17
	 *  @since   5.6.3
	 *
	 *  @param   n/a
	 *  @return  n/a
	 */

	function metabox_html( $post, $metabox ) {

		// vars
		$tool = $this->get_tool( $metabox['args']['tool'] );

		?>
	<form method="post">
		<?php $tool->html(); ?>
		<?php acf_nonce_input( $tool->name ); ?>
	</form>
		<?php

	}

}