'', // 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; } /** * This function is fired when loading the admin page before HTML has been rendered. * * @since 5.0.0 * * @return void */ public 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( 'admin_body_class', array( $this, 'admin_body_class' ) ); 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' ) ); } /** * Modifies the admin body class. * * @since 6.0.0 * * @param string $classes Space-separated list of CSS classes. * @return string */ public function admin_body_class( $classes ) { $classes .= ' acf-admin-single-field-group'; return $classes; } /** * This action is run after post query but before any admin script / head actions. * It is a good place to register all actions. * * @since 5.0.0 * * @return void */ public 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 field group to trash?' => __( 'Move field group to trash?', 'acf' ), 'No toggle fields available' => __( 'No toggle fields available', 'acf' ), 'Move Custom Field' => __( 'Move Custom Field', 'acf' ), 'Close modal' => __( 'Close modal', 'acf' ), 'Field moved to other group' => __( 'Field moved to other group', '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' ); } /** * This function will setup all functionality for the field group edit page to work * * @since 3.1.8 * * @return void */ public 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' ); if ( ! defined( 'ACF_PRO' ) || ! ACF_PRO ) { add_meta_box( 'acf-field-group-pro-features', 'ACF PRO', array( $this, 'mb_pro_features' ), '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 ); add_filter( 'get_user_option_screen_layout_acf-field-group', array( $this, 'screen_layout' ), 10, 1 ); // 3rd party hook. do_action( 'acf/field_group/admin_head' ); } /** * This action will allow ACF to render metaboxes after the title * * @date 17/08/13 * * @return void */ public 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, ) ); } /** * This function will add extra HTML to the acf form data element * * @since 5.3.8 * * @param array $args Arguments array to pass through to action. * @return void */ public function form_data( $args ) { // do action. do_action( 'acf/field_group/form_data', $args ); } /** * This function will append extra l10n strings to the acf JS object * * @since 5.3.8 * * @param array $l10n The array of translated strings. * @return $l10n */ public function admin_l10n( $l10n ) { return apply_filters( 'acf/field_group/admin_l10n', $l10n ); } /** * Admin footer third party hook support * * @since 5.3.2 * * @return void */ public function admin_footer() { // 3rd party hook do_action( 'acf/field_group/admin_footer' ); } /** * Screen settings html output * * @since 3.6.0 * * @param string $html Current screen settings HTML. * @return string $html */ public function screen_settings( $html ) { $show_field_keys = acf_get_user_setting( 'show_field_keys' ) ? 'checked="checked"' : ''; $show_field_settings_tabs = acf_get_user_setting( 'show_field_settings_tabs', true ) ? 'checked="checked"' : ''; $hide_field_settings_tabs = apply_filters( 'acf/field_group/disable_field_settings_tabs', false ); $html .= '
'; $html .= ''; if ( ! $hide_field_settings_tabs ) { $html .= ''; } $html .= '
'; return $html; } /** * Sets the "Edit Field Group" screen to use a one-column layout. * * @param int $columns Number of columns for layout. * * @return int */ public function screen_layout( $columns = 0 ) { return 1; } /** * This function will customize the publish metabox * * @since 5.2.9 * * @return void */ public function post_submitbox_misc_actions() { global $field_group; $status_label = $field_group['active'] ? _x( 'Active', 'post status', 'acf' ) : _x( 'Inactive', 'post status', 'acf' ); ?> 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 ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized when saved. if ( ! isset( $field['key'] ) ) { continue; } // 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'] ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized below. // clean. $ids = explode( '|', $_POST['_acf_delete_fields'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized below. $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; // phpcs:disable WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized when saved. $_POST['acf_field_group']['title'] = $_POST['post_title']; // save field group. acf_update_field_group( $_POST['acf_field_group'] ); // phpcs:enable WordPress.Security.ValidatedSanitizedInput.InputNotSanitized return $post_id; } /** * This function will render the HTML for the medtabox 'acf-field-group-fields' * * @since 5.0.0 * * @return void */ public 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 ); } /** * This function will render the HTML for the metabox 'acf-field-group-pro-features' * * @since 6.0.0 * * @return void */ public function mb_pro_features() { // load view. acf_get_view( 'field-group-pro-features' ); } /** * This function will render the HTML for the metabox 'acf-field-group-options' * * @since 5.0.0 * * @return void */ public 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' ); } /** * This function can be accessed via an AJAX action and will return the result from the render_location_value function * * @since 5.0.0 * * @return void */ public 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( acf_sanitize_request_args( $_POST['rule'] ) ); // view. acf_get_view( 'html-location-rule', array( 'rule' => $rule, ) ); // die. die(); } /** * This function will return HTML containing the field's settings based on it's new type * * @since 5.0.0 * * @return void */ public function ajax_render_field_settings() { // Verify the current request. if ( ! acf_verify_ajax() || ! acf_current_user_can_admin() ) { wp_send_json_error(); } // Make sure we have a field. $field = acf_maybe_get_POST( 'field' ); if ( ! $field ) { wp_send_json_error(); } $field['prefix'] = acf_maybe_get_POST( 'prefix' ); $field = acf_get_valid_field( $field ); $tabs = array( 'general' => '', 'validation' => '', 'presentation' => '', 'conditional_logic' => '', ); foreach ( $tabs as $tab => $content ) { ob_start(); if ( 'general' === $tab ) { // Back-compat for fields not using tab-specific hooks. do_action( "acf/render_field_settings/type={$field['type']}", $field ); } do_action( "acf/render_field_{$tab}_settings/type={$field['type']}", $field ); $sections[ $tab ] = ob_get_clean(); } wp_send_json_success( $sections ); } /** * Move field AJAX function * * @since 5.0.0 * * @return void No return, HTML output for AJAX consumption. */ public function ajax_move_field() { // disable filters to ensure ACF loads raw data from DB. acf_disable_filters(); $args = acf_parse_args( //phpcs:ignore WordPress.Security.NonceVerification.Missing $_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 = '' . esc_html( $field_group['title'] ) . ''; echo '' . '

' . __( 'Move Complete.', 'acf' ) . '

' . '

' . sprintf( /* translators: Confirmation message once a field has been moved to a different field group. */ acf_punctify( __( 'The %1$s field can now be found in the %2$s field group', 'acf' ) ), esc_html( $field['label'] ), $link //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ) . '

' . '' . __( 'Close Modal', 'acf' ) . ''; 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 early if is current. if ( $field_group['ID'] == $args['post_id'] ) { continue; } $choices[ $field_group['ID'] ] = $field_group['title']; } } // render options. $field = acf_get_valid_field( array( 'type' => 'select', 'name' => 'acf_field_group', 'choices' => $choices, 'aria-label' => __( 'Please select the destination for this field', 'acf' ), ) ); echo '

' . __( 'Please select the destination for this field', 'acf' ) . '

'; echo '
'; // render. acf_render_field_wrap( $field ); echo ''; echo '
'; // die. die(); } } // initialize. new acf_admin_field_group(); } ?>