384 lines
6.7 KiB
PHP
384 lines
6.7 KiB
PHP
<?php
|
|
|
|
/*
|
|
* ACF Widget Form Class
|
|
*
|
|
* All the logic for adding fields to widgets
|
|
*
|
|
* @class acf_form_widget
|
|
* @package ACF
|
|
* @subpackage Forms
|
|
*/
|
|
|
|
if( ! class_exists('acf_form_widget') ) :
|
|
|
|
class acf_form_widget {
|
|
|
|
|
|
/*
|
|
* __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() {
|
|
|
|
// vars
|
|
$this->preview_values = array();
|
|
$this->preview_reference = array();
|
|
$this->preview_errors = array();
|
|
|
|
|
|
// actions
|
|
add_action('admin_enqueue_scripts', array($this, 'admin_enqueue_scripts'));
|
|
add_action('in_widget_form', array($this, 'edit_widget'), 10, 3);
|
|
add_action('acf/validate_save_post', array($this, 'acf_validate_save_post'), 5);
|
|
|
|
|
|
// filters
|
|
add_filter('widget_update_callback', array($this, 'save_widget'), 10, 4);
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* 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 26/01/13
|
|
* @since 3.6.0
|
|
*
|
|
* @param N/A
|
|
* @return N/A
|
|
*/
|
|
|
|
function admin_enqueue_scripts() {
|
|
|
|
// validate screen
|
|
if( acf_is_screen('widgets') || acf_is_screen('customize') ) {
|
|
|
|
// valid
|
|
|
|
} else {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
// load acf scripts
|
|
acf_enqueue_scripts();
|
|
|
|
|
|
// actions
|
|
add_action('acf/input/admin_footer', array($this, 'admin_footer'), 1);
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* acf_validate_save_post
|
|
*
|
|
* This function will loop over $_POST data and validate
|
|
*
|
|
* @type action 'acf/validate_save_post' 5
|
|
* @date 7/09/2016
|
|
* @since 5.4.0
|
|
*
|
|
* @param n/a
|
|
* @return n/a
|
|
*/
|
|
|
|
function acf_validate_save_post() {
|
|
|
|
// bail ealry if not widget
|
|
if( !isset($_POST['_acf_widget_id']) ) return;
|
|
|
|
|
|
// vars
|
|
$id = $_POST['_acf_widget_id'];
|
|
$number = $_POST['_acf_widget_number'];
|
|
$prefix = $_POST['_acf_widget_prefix'];
|
|
|
|
|
|
// validate
|
|
acf_validate_values( $_POST[ $id ][ $number ]['acf'], $prefix );
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* edit_widget
|
|
*
|
|
* This function will render the fields for a widget form
|
|
*
|
|
* @type function
|
|
* @date 11/06/2014
|
|
* @since 5.0.0
|
|
*
|
|
* @param $widget (object)
|
|
* @param $return (null)
|
|
* @param $instance (object)
|
|
* @return $post_id (int)
|
|
*/
|
|
|
|
function edit_widget( $widget, $return, $instance ) {
|
|
|
|
// vars
|
|
$post_id = 0;
|
|
$prefix = 'widget-' . $widget->id_base . '[' . $widget->number . '][acf]';
|
|
|
|
|
|
// get id
|
|
if( $widget->number !== '__i__' ) {
|
|
|
|
$post_id = "widget_{$widget->id}";
|
|
|
|
}
|
|
|
|
|
|
// get field groups
|
|
$field_groups = acf_get_field_groups(array(
|
|
'widget' => $widget->id_base
|
|
));
|
|
|
|
|
|
// render
|
|
if( !empty($field_groups) ) {
|
|
|
|
// render post data
|
|
acf_form_data(array(
|
|
'post_id' => $post_id,
|
|
'nonce' => 'widget',
|
|
'widget_id' => 'widget-' . $widget->id_base,
|
|
'widget_number' => $widget->number,
|
|
'widget_prefix' => $prefix
|
|
));
|
|
|
|
|
|
// wrap
|
|
echo '<div class="acf-widget-fields acf-fields -clear">';
|
|
|
|
// loop
|
|
foreach( $field_groups as $field_group ) {
|
|
|
|
// load fields
|
|
$fields = acf_get_fields( $field_group );
|
|
|
|
|
|
// bail if not fields
|
|
if( empty($fields) ) continue;
|
|
|
|
|
|
// change prefix
|
|
acf_prefix_fields( $fields, $prefix );
|
|
|
|
|
|
// render
|
|
acf_render_fields( $post_id, $fields, 'div', $field_group['instruction_placement'] );
|
|
|
|
}
|
|
|
|
//wrap
|
|
echo '</div>';
|
|
|
|
|
|
// jQuery selector looks odd, but is necessary due to WP adding an incremental number into the ID
|
|
// - not possible to find number via PHP parameters
|
|
if( $widget->updated ): ?>
|
|
<script type="text/javascript">
|
|
(function($) {
|
|
|
|
acf.do_action('append', $('[id^="widget"][id$="<?php echo $widget->id; ?>"]') );
|
|
|
|
})(jQuery);
|
|
</script>
|
|
<?php endif;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* save_widget
|
|
*
|
|
* This function will hook into the widget update filter and save ACF data
|
|
*
|
|
* @type function
|
|
* @date 27/05/2015
|
|
* @since 5.2.3
|
|
*
|
|
* @param $instance (array) widget settings
|
|
* @param $new_instance (array) widget settings
|
|
* @param $old_instance (array) widget settings
|
|
* @param $widget (object) widget info
|
|
* @return $instance
|
|
*/
|
|
|
|
function save_widget( $instance, $new_instance, $old_instance, $widget ) {
|
|
|
|
// bail ealry if not valid (!customize + acf values + nonce)
|
|
if( isset($_POST['wp_customize']) || !isset($new_instance['acf']) || !acf_verify_nonce('widget') ) return $instance;
|
|
|
|
|
|
// save
|
|
acf_save_post( "widget_{$widget->id}", $new_instance['acf'] );
|
|
|
|
|
|
// return
|
|
return $instance;
|
|
|
|
}
|
|
|
|
|
|
/*
|
|
* admin_footer
|
|
*
|
|
* This function will add some custom HTML to the footer of the edit page
|
|
*
|
|
* @type function
|
|
* @date 11/06/2014
|
|
* @since 5.0.0
|
|
*
|
|
* @param n/a
|
|
* @return n/a
|
|
*/
|
|
|
|
function admin_footer() {
|
|
|
|
?>
|
|
<script type="text/javascript">
|
|
(function($) {
|
|
|
|
// vars
|
|
acf.update('post_id', 'widgets');
|
|
|
|
|
|
// restrict get fields
|
|
acf.add_filter('get_fields', function( $fields ){
|
|
|
|
// widgets
|
|
$fields = $fields.not('#available-widgets .acf-field');
|
|
|
|
|
|
// customizer
|
|
$fields = $fields.not('.widget-tpl .acf-field');
|
|
|
|
|
|
// return
|
|
return $fields;
|
|
|
|
});
|
|
|
|
|
|
$('#widgets-right').on('click', '.widget-control-save', function( e ){
|
|
|
|
// vars
|
|
var $form = $(this).closest('form');
|
|
|
|
|
|
// bail early if not active
|
|
if( !acf.validation.active ) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
// ignore validation (only ignore once)
|
|
if( acf.validation.ignore ) {
|
|
|
|
acf.validation.ignore = 0;
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
// bail early if this form does not contain ACF data
|
|
if( !$form.find('#acf-form-data').exists() ) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
// stop WP JS validation
|
|
e.stopImmediatePropagation();
|
|
|
|
|
|
// store submit trigger so it will be clicked if validation is passed
|
|
acf.validation.$trigger = $(this);
|
|
|
|
|
|
// run validation
|
|
acf.validation.fetch( $form );
|
|
|
|
|
|
// stop all other click events on this input
|
|
return false;
|
|
|
|
});
|
|
|
|
|
|
$(document).on('click', '.widget-top', function(){
|
|
|
|
var $el = $(this).parent().children('.widget-inside');
|
|
|
|
setTimeout(function(){
|
|
|
|
acf.get_fields('', $el).each(function(){
|
|
|
|
acf.do_action('show_field', $(this));
|
|
|
|
});
|
|
|
|
}, 250);
|
|
|
|
});
|
|
|
|
$(document).on('widget-added', function( e, $widget ){
|
|
|
|
// - use delay to avoid rendering issues with customizer (ensures div is visible)
|
|
setTimeout(function(){
|
|
|
|
acf.do_action('append', $widget );
|
|
|
|
}, 100);
|
|
|
|
});
|
|
|
|
$(document).on('widget-saved widget-updated', function( e, $widget ){
|
|
|
|
// unlock form
|
|
acf.validation.toggle( $widget, 'unlock' );
|
|
|
|
|
|
// submit
|
|
acf.do_action('submit', $widget );
|
|
|
|
});
|
|
|
|
})(jQuery);
|
|
</script>
|
|
<?php
|
|
|
|
}
|
|
|
|
}
|
|
|
|
new acf_form_widget();
|
|
|
|
endif;
|
|
|
|
?>
|