| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821 |
- <?php
- /*
- * ACF Admin Field Group Class
- *
- * All the logic for editing a field group
- *
- * @class acf_admin_field_group
- * @package ACF
- * @subpackage Admin
- */
- if ( ! class_exists( 'acf_admin_field_group' ) ) :
- 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();
- }
- }
- // initialize
- new acf_admin_field_group();
- endif;
- ?>
|