acf_admin_field_group{}ACF 1.0

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

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

Методы

  1. public __construct()
  2. public admin_enqueue_scripts()
  3. public admin_footer()
  4. public admin_head()
  5. public admin_l10n( $l10n )
  6. public ajax_move_field()
  7. public ajax_render_field_settings()
  8. public ajax_render_location_rule()
  9. public current_screen()
  10. public edit_form_after_title()
  11. public form_data( $args )
  12. public mb_fields()
  13. public mb_locations()
  14. public mb_options()
  15. public post_submitbox_misc_actions()
  16. public post_updated_messages( $messages )
  17. public save_post( $post_id, $post )
  18. public screen_settings( $html )
  19. public use_block_editor_for_post_type( $use_block_editor, $post_type )

Код acf_admin_field_group{} ACF 5.10.2

<?php
class acf_admin_field_group {


	/*
	*  __construct
	*
	*  This function will setup the class functionality
	*
	*  @type    function
	*  @date    5/03/2014
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function __construct() {

		// actions
		add_action( 'current_screen', array( $this, 'current_screen' ) );
		add_action( 'save_post', array( $this, 'save_post' ), 10, 2 );

		// ajax
		add_action( 'wp_ajax_acf/field_group/render_field_settings', array( $this, 'ajax_render_field_settings' ) );
		add_action( 'wp_ajax_acf/field_group/render_location_rule', array( $this, 'ajax_render_location_rule' ) );
		add_action( 'wp_ajax_acf/field_group/move_field', array( $this, 'ajax_move_field' ) );

		// filters
		add_filter( 'post_updated_messages', array( $this, 'post_updated_messages' ) );
		add_filter( 'use_block_editor_for_post_type', array( $this, 'use_block_editor_for_post_type' ), 10, 2 );
	}

	/**
	 *  use_block_editor_for_post_type
	 *
	 *  Prevents the block editor from loading when editing an ACF field group.
	 *
	 *  @date    7/12/18
	 *  @since   5.8.0
	 *
	 *  @param   bool   $use_block_editor Whether the post type can be edited or not. Default true.
	 *  @param   string $post_type The post type being checked.
	 *  @return  bool
	 */
	function use_block_editor_for_post_type( $use_block_editor, $post_type ) {
		if ( $post_type === 'acf-field-group' ) {
			return false;
		}
		return $use_block_editor;
	}

	/*
	*  post_updated_messages
	*
	*  This function will customize the message shown when editing a field group
	*
	*  @type    action (post_updated_messages)
	*  @date    30/04/2014
	*  @since   5.0.0
	*
	*  @param   $messages (array)
	*  @return  $messages
	*/

	function post_updated_messages( $messages ) {

		// append to messages
		$messages['acf-field-group'] = array(
			0  => '', // Unused. Messages start at index 1.
			1  => __( 'Field group updated.', 'acf' ),
			2  => __( 'Field group updated.', 'acf' ),
			3  => __( 'Field group deleted.', 'acf' ),
			4  => __( 'Field group updated.', 'acf' ),
			5  => false, // field group does not support revisions
			6  => __( 'Field group published.', 'acf' ),
			7  => __( 'Field group saved.', 'acf' ),
			8  => __( 'Field group submitted.', 'acf' ),
			9  => __( 'Field group scheduled for.', 'acf' ),
			10 => __( 'Field group draft updated.', 'acf' ),
		);

		// return
		return $messages;
	}


	/*
	*  current_screen
	*
	*  This function is fired when loading the admin page before HTML has been rendered.
	*
	*  @type    action (current_screen)
	*  @date    21/07/2014
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function current_screen() {

		// validate screen
		if ( ! acf_is_screen( 'acf-field-group' ) ) {
			return;
		}

		// disable filters to ensure ACF loads raw data from DB
		acf_disable_filters();

		// enqueue scripts
		acf_enqueue_scripts();

		// actions
		add_action( 'acf/input/admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
		add_action( 'acf/input/admin_head', array( $this, 'admin_head' ) );
		add_action( 'acf/input/form_data', array( $this, 'form_data' ) );
		add_action( 'acf/input/admin_footer', array( $this, 'admin_footer' ) );

		// filters
		add_filter( 'acf/input/admin_l10n', array( $this, 'admin_l10n' ) );
	}


	/*
	*  admin_enqueue_scripts
	*
	*  This action is run after post query but before any admin script / head actions.
	*  It is a good place to register all actions.
	*
	*  @type    action (admin_enqueue_scripts)
	*  @date    30/06/2014
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function admin_enqueue_scripts() {

		// no autosave
		wp_dequeue_script( 'autosave' );

		// custom scripts
		wp_enqueue_style( 'acf-field-group' );
		wp_enqueue_script( 'acf-field-group' );

		// localize text
		acf_localize_text(
			array(
				'The string "field_" may not be used at the start of a field name' => __( 'The string "field_" may not be used at the start of a field name', 'acf' ),
				'This field cannot be moved until its changes have been saved' => __( 'This field cannot be moved until its changes have been saved', 'acf' ),
				'Field group title is required' => __( 'Field group title is required', 'acf' ),
				'Move to trash. Are you sure?'  => __( 'Move to trash. Are you sure?', 'acf' ),
				'No toggle fields available'    => __( 'No toggle fields available', 'acf' ),
				'Move Custom Field'             => __( 'Move Custom Field', 'acf' ),
				'Checked'                       => __( 'Checked', 'acf' ),
				'(no label)'                    => __( '(no label)', 'acf' ),
				'(this field)'                  => __( '(this field)', 'acf' ),
				'copy'                          => __( 'copy', 'acf' ),
				'or'                            => __( 'or', 'acf' ),
				'Show this field group if'      => __( 'Show this field group if', 'acf' ),
				'Null'                          => __( 'Null', 'acf' ),

				// Conditions
				'Has any value'                 => __( 'Has any value', 'acf' ),
				'Has no value'                  => __( 'Has no value', 'acf' ),
				'Value is equal to'             => __( 'Value is equal to', 'acf' ),
				'Value is not equal to'         => __( 'Value is not equal to', 'acf' ),
				'Value matches pattern'         => __( 'Value matches pattern', 'acf' ),
				'Value contains'                => __( 'Value contains', 'acf' ),
				'Value is greater than'         => __( 'Value is greater than', 'acf' ),
				'Value is less than'            => __( 'Value is less than', 'acf' ),
				'Selection is greater than'     => __( 'Selection is greater than', 'acf' ),
				'Selection is less than'        => __( 'Selection is less than', 'acf' ),

				// Pro-only fields
				'Repeater (Pro only)'           => __( 'Repeater (Pro only)', 'acf' ),
				'Flexibly Content (Pro only)'   => __( 'Flexible Content (Pro only)', 'acf' ),
				'Clone (Pro only)'              => __( 'Clone (Pro only)', 'acf' ),
				'Gallery (Pro only)'            => __( 'Gallery (Pro only)', 'acf' ),
			)
		);

		// localize data
		acf_localize_data(
			array(
				'fieldTypes' => acf_get_field_types_info(),
			)
		);

		// 3rd party hook
		do_action( 'acf/field_group/admin_enqueue_scripts' );

	}


	/*
	*  admin_head
	*
	*  This function will setup all functionality for the field group edit page to work
	*
	*  @type    action (admin_head)
	*  @date    23/06/12
	*  @since   3.1.8
	*
	*  @param   $post_id (int)
	*  @return  $post_id (int)
	*/

	function admin_head() {

		// global
		global $post, $field_group;

		// set global var
		$field_group = acf_get_field_group( $post->ID );

		// metaboxes
		add_meta_box( 'acf-field-group-fields', __( 'Fields', 'acf' ), array( $this, 'mb_fields' ), 'acf-field-group', 'normal', 'high' );
		add_meta_box( 'acf-field-group-locations', __( 'Location', 'acf' ), array( $this, 'mb_locations' ), 'acf-field-group', 'normal', 'high' );
		add_meta_box( 'acf-field-group-options', __( 'Settings', 'acf' ), array( $this, 'mb_options' ), 'acf-field-group', 'normal', 'high' );

		// actions
		add_action( 'post_submitbox_misc_actions', array( $this, 'post_submitbox_misc_actions' ), 10, 0 );
		add_action( 'edit_form_after_title', array( $this, 'edit_form_after_title' ), 10, 0 );

		// filters
		add_filter( 'screen_settings', array( $this, 'screen_settings' ), 10, 1 );

		// 3rd party hook
		do_action( 'acf/field_group/admin_head' );

	}


	/*
	*  edit_form_after_title
	*
	*  This action will allow ACF to render metaboxes after the title
	*
	*  @type    action
	*  @date    17/08/13
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function edit_form_after_title() {

		// globals
		global $post;

		// render post data
		acf_form_data(
			array(
				'screen'        => 'field_group',
				'post_id'       => $post->ID,
				'delete_fields' => 0,
				'validation'    => 0,
			)
		);

	}


	/*
	*  form_data
	*
	*  This function will add extra HTML to the acf form data element
	*
	*  @type    function
	*  @date    31/05/2016
	*  @since   5.3.8
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function form_data( $args ) {

		// do action
		do_action( 'acf/field_group/form_data', $args );

	}


	/*
	*  admin_l10n
	*
	*  This function will append extra l10n strings to the acf JS object
	*
	*  @type    function
	*  @date    31/05/2016
	*  @since   5.3.8
	*
	*  @param   $l10n (array)
	*  @return  $l10n
	*/

	function admin_l10n( $l10n ) {
		return apply_filters( 'acf/field_group/admin_l10n', $l10n );
	}



	/*
	*  admin_footer
	*
	*  description
	*
	*  @type    function
	*  @date    11/01/2016
	*  @since   5.3.2
	*
	*  @param   $post_id (int)
	*  @return  $post_id (int)
	*/

	function admin_footer() {

		// 3rd party hook
		do_action( 'acf/field_group/admin_footer' );

	}


	/*
	*  screen_settings
	*
	*  description
	*
	*  @type    function
	*  @date    26/01/13
	*  @since   3.6.0
	*
	*  @param   $current (string)
	*  @return  $current
	*/

	function screen_settings( $html ) {

		// vars
		$checked = acf_get_user_setting( 'show_field_keys' ) ? 'checked="checked"' : '';

		// append
		$html .= '<div id="acf-append-show-on-screen" class="acf-hidden">';
		$html .= '<label for="acf-field-key-hide"><input id="acf-field-key-hide" type="checkbox" value="1" name="show_field_keys" ' . $checked . ' /> ' . __( 'Field Keys', 'acf' ) . '</label>';
		$html .= '</div>';

		// return
		return $html;

	}


	/*
	*  post_submitbox_misc_actions
	*
	*  This function will customize the publish metabox
	*
	*  @type    function
	*  @date    17/07/2015
	*  @since   5.2.9
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function post_submitbox_misc_actions() {
		global $field_group;
		$status_label = $field_group['active'] ? _x( 'Active', 'post status', 'acf' ) : _x( 'Disabled', 'post status', 'acf' );

		?>
<script type="text/javascript">
(function($) {
$('#post-status-display').html( '<?php echo esc_html( $status_label ); ?>' );
})(jQuery);	
</script>
		<?php
	}


	/*
	*  save_post
	*
	*  This function will save all the field group data
	*
	*  @type    function
	*  @date    23/06/12
	*  @since   1.0.0
	*
	*  @param   $post_id (int)
	*  @return  $post_id (int)
	*/

	function save_post( $post_id, $post ) {

		// do not save if this is an auto save routine
		if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
			return $post_id;
		}

		// bail early if not acf-field-group
		if ( $post->post_type !== 'acf-field-group' ) {
			return $post_id;
		}

		// only save once! WordPress save's a revision as well.
		if ( wp_is_post_revision( $post_id ) ) {
			return $post_id;
		}

		// verify nonce
		if ( ! acf_verify_nonce( 'field_group' ) ) {
			return $post_id;
		}

		// Bail early if request came from an unauthorised user.
		if ( ! current_user_can( acf_get_setting( 'capability' ) ) ) {
			return $post_id;
		}

		// disable filters to ensure ACF loads raw data from DB
		acf_disable_filters();

		// save fields
		if ( ! empty( $_POST['acf_fields'] ) ) {

			// loop
			foreach ( $_POST['acf_fields'] as $field ) {

				// vars
				$specific = false;
				$save     = acf_extract_var( $field, 'save' );

				// only saved field if has changed
				if ( $save == 'meta' ) {
					$specific = array(
						'menu_order',
						'post_parent',
					);
				}

				// set parent
				if ( ! $field['parent'] ) {
					$field['parent'] = $post_id;
				}

				// save field
				acf_update_field( $field, $specific );

			}
		}

		// delete fields
		if ( $_POST['_acf_delete_fields'] ) {

			// clean
			$ids = explode( '|', $_POST['_acf_delete_fields'] );
			$ids = array_map( 'intval', $ids );

			// loop
			foreach ( $ids as $id ) {

				// bai early if no id
				if ( ! $id ) {
					continue;
				}

				// delete
				acf_delete_field( $id );

			}
		}

		// add args
		$_POST['acf_field_group']['ID']    = $post_id;
		$_POST['acf_field_group']['title'] = $_POST['post_title'];

		// save field group
		acf_update_field_group( $_POST['acf_field_group'] );

		// return
		return $post_id;
	}


	/*
	*  mb_fields
	*
	*  This function will render the HTML for the medtabox 'acf-field-group-fields'
	*
	*  @type    function
	*  @date    28/09/13
	*  @since   5.0.0
	*
	*  @param   N/A
	*  @return  N/A
	*/

	function mb_fields() {

		// global
		global $field_group;

		// get fields
		$view = array(
			'fields' => acf_get_fields( $field_group ),
			'parent' => 0,
		);

		// load view
		acf_get_view( 'field-group-fields', $view );

	}


	/*
	*  mb_options
	*
	*  This function will render the HTML for the medtabox 'acf-field-group-options'
	*
	*  @type    function
	*  @date    28/09/13
	*  @since   5.0.0
	*
	*  @param   N/A
	*  @return  N/A
	*/

	function mb_options() {

		// global
		global $field_group;

		// field key (leave in for compatibility)
		if ( ! acf_is_field_group_key( $field_group['key'] ) ) {

			$field_group['key'] = uniqid( 'group_' );

		}

		// view
		acf_get_view( 'field-group-options' );

	}


	/*
	*  mb_locations
	*
	*  This function will render the HTML for the medtabox 'acf-field-group-locations'
	*
	*  @type    function
	*  @date    28/09/13
	*  @since   5.0.0
	*
	*  @param   N/A
	*  @return  N/A
	*/

	function mb_locations() {

		// global
		global $field_group;

		// UI needs at lease 1 location rule
		if ( empty( $field_group['location'] ) ) {

			$field_group['location'] = array(

				// group 0
				array(

					// rule 0
					array(
						'param'    => 'post_type',
						'operator' => '==',
						'value'    => 'post',
					),
				),

			);
		}

		// view
		acf_get_view( 'field-group-locations' );

	}


	/*
	*  ajax_render_location_rule
	*
	*  This function can be accessed via an AJAX action and will return the result from the render_location_value function
	*
	*  @type    function (ajax)
	*  @date    30/09/13
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function ajax_render_location_rule() {

		// validate
		if ( ! acf_verify_ajax() ) {
			die();
		}

		// verify user capability
		if ( ! acf_current_user_can_admin() ) {
			die();
		}

		// validate rule
		$rule = acf_validate_location_rule( $_POST['rule'] );

		// view
		acf_get_view(
			'html-location-rule',
			array(
				'rule' => $rule,
			)
		);

		// die
		die();
	}


	/*
	*  ajax_render_field_settings
	*
	*  This function will return HTML containing the field's settings based on it's new type
	*
	*  @type    function (ajax)
	*  @date    30/09/13
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function ajax_render_field_settings() {

		// validate
		if ( ! acf_verify_ajax() ) {
			die();
		}

		// verify user capability
		if ( ! acf_current_user_can_admin() ) {
			die();
		}

		// vars
		$field = acf_maybe_get_POST( 'field' );

		// check
		if ( ! $field ) {
			die();
		}

		// set prefix
		$field['prefix'] = acf_maybe_get_POST( 'prefix' );

		// validate
		$field = acf_get_valid_field( $field );

		// render
		do_action( "acf/render_field_settings/type={$field['type']}", $field );

		// return
		die();

	}

	/*
	*  ajax_move_field
	*
	*  description
	*
	*  @type    function
	*  @date    20/01/2014
	*  @since   5.0.0
	*
	*  @param   $post_id (int)
	*  @return  $post_id (int)
	*/

	function ajax_move_field() {

		// disable filters to ensure ACF loads raw data from DB
		acf_disable_filters();

		$args = acf_parse_args(
			$_POST,
			array(
				'nonce'          => '',
				'post_id'        => 0,
				'field_id'       => 0,
				'field_group_id' => 0,
			)
		);

		// verify nonce
		if ( ! wp_verify_nonce( $args['nonce'], 'acf_nonce' ) ) {
			die();
		}

		// verify user capability
		if ( ! acf_current_user_can_admin() ) {
			die();
		}

		// confirm?
		if ( $args['field_id'] && $args['field_group_id'] ) {

			// vars
			$field       = acf_get_field( $args['field_id'] );
			$field_group = acf_get_field_group( $args['field_group_id'] );

			// update parent
			$field['parent'] = $field_group['ID'];

			// remove conditional logic
			$field['conditional_logic'] = 0;

			// update field
			acf_update_field( $field );

			// Output HTML.
			$link = '<a href="' . admin_url( 'post.php?post=' . $field_group['ID'] . '&action=edit' ) . '" target="_blank">' . esc_html( $field_group['title'] ) . '</a>';

			echo '' .
				'<p><strong>' . __( 'Move Complete.', 'acf' ) . '</strong></p>' .
				'<p>' . sprintf(
					acf_punctify( __( 'The %1$s field can now be found in the %2$s field group', 'acf' ) ),
					esc_html( $field['label'] ),
					$link
				) . '</p>' .
				'<a href="#" class="button button-primary acf-close-popup">' . __( 'Close Window', 'acf' ) . '</a>';
			die();
		}

		// get all field groups
		$field_groups = acf_get_field_groups();
		$choices      = array();

		// check
		if ( ! empty( $field_groups ) ) {

			// loop
			foreach ( $field_groups as $field_group ) {

				// bail early if no ID
				if ( ! $field_group['ID'] ) {
					continue;
				}

				// bail ealry if is current
				if ( $field_group['ID'] == $args['post_id'] ) {
					continue;
				}

				// append
				$choices[ $field_group['ID'] ] = $field_group['title'];

			}
		}

		// render options
		$field = acf_get_valid_field(
			array(
				'type'    => 'select',
				'name'    => 'acf_field_group',
				'choices' => $choices,
			)
		);

		echo '<p>' . __( 'Please select the destination for this field', 'acf' ) . '</p>';

		echo '<form id="acf-move-field-form">';

			// render
			acf_render_field_wrap( $field );

			echo '<button type="submit" class="button button-primary">' . __( 'Move Field', 'acf' ) . '</button>';

		echo '</form>';

		// die
		die();

	}

}