838 lines
16 KiB
PHP
838 lines
16 KiB
PHP
<?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'));
|
|
add_action('acf/input/admin_footer_js', array($this, 'admin_footer_js'));
|
|
|
|
|
|
// 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'),
|
|
'Null' => __('Null', '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');
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* admin_footer_js
|
|
*
|
|
* description
|
|
*
|
|
* @type function
|
|
* @date 31/05/2016
|
|
* @since 5.3.8
|
|
*
|
|
* @param $post_id (int)
|
|
* @return $post_id (int)
|
|
*/
|
|
|
|
function admin_footer_js() {
|
|
|
|
// 3rd party hook
|
|
do_action('acf/field_group/admin_footer_js');
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* 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
|
|
global $field_group;
|
|
|
|
|
|
// vars
|
|
$status = $field_group['active'] ? __("Active",'acf') : __("Inactive",'acf');
|
|
|
|
?>
|
|
<script type="text/javascript">
|
|
(function($) {
|
|
|
|
// modify status
|
|
$('#post-status-display').html('<?php echo $status; ?>');
|
|
|
|
|
|
// remove edit links
|
|
$('#misc-publishing-actions a').remove();
|
|
|
|
|
|
// remove editables (fixes status text changing on submit)
|
|
$('#misc-publishing-actions .hide-if-js').remove();
|
|
|
|
})(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();
|
|
|
|
// 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();
|
|
|
|
// 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();
|
|
|
|
|
|
// 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);
|
|
|
|
|
|
// message
|
|
$a = '<a href="' . admin_url("post.php?post={$field_group['ID']}&action=edit") . '" target="_blank">' . $field_group['title'] . '</a>';
|
|
echo '<p><strong>' . __('Move Complete.', 'acf') . '</strong></p>';
|
|
echo '<p>' . sprintf( __('The %s field can now be found in the %s field group', 'acf'), $field['label'], $a ). '</p>';
|
|
echo '<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;
|
|
|
|
?>
|