'customize_controls', ) ); // actions add_action( 'acf/input/admin_footer', array( $this, 'admin_footer' ), 1 ); } /** * 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 ) { // The field lists are kept in the instance's ACF data instead. unset( $instance['_acf_fields'] ); // bail early if not valid (customize + acf values + nonce) if ( ! isset( $_POST['wp_customize'] ) || ! isset( $new_instance['acf'] ) || ! acf_verify_nonce( 'widget' ) ) { return $instance; } // vars $data = array( 'post_id' => "widget_{$widget->id}", 'values' => array(), 'fields' => array(), '_acf_fields' => array(), ); // Only keep fields rendered for the widget, or that apply to it. The lists are kept so customize_save() can check again. $data['_acf_fields'] = isset( $new_instance['_acf_fields'] ) && is_array( $new_instance['_acf_fields'] ) ? $new_instance['_acf_fields'] : array(); $data['values'] = acf_get_instance( 'acf_form_widget' )->filter_values( $new_instance['acf'], $data['_acf_fields'], $widget->id_base, $data['post_id'] ); // append fields (name => key relationship) - used later in 'acf/get_field_reference' for customizer previews foreach ( $data['values'] as $k => $v ) { // get field $field = acf_get_field( $k ); // continue if no field if ( ! $field ) { continue; } // update $data['fields'][ $field['name'] ] = $field['key']; } // append data to instance $instance['acf'] = $data; // return return $instance; } /** * This function will return an array of cutomizer settings that include ACF data * similar to `$customizer->settings();` * * @type function * @date 22/03/2016 * @since 5.3.2 * * @param $customizer (object) * @return $value (mixed) */ function settings( $customizer ) { // vars $data = array(); $settings = $customizer->settings(); // bail early if no settings if ( empty( $settings ) ) { return false; } // loop over settings foreach ( $settings as $setting ) { // vars $id = $setting->id; // verify settings type if ( substr( $id, 0, 6 ) == 'widget' || substr( $id, 0, 7 ) == 'nav_menu' ) { // allow } else { continue; } // get value $value = $setting->post_value(); // bail early if no acf if ( ! is_array( $value ) || ! isset( $value['acf'] ) ) { continue; } // set data $setting->acf = $value['acf']; // append $data[] = $setting; } // bail early if no settings if ( empty( $data ) ) { return false; } // return return $data; } /** * This function is called when customizer preview is initialized * * @type function * @date 22/03/2016 * @since 5.3.2 * * @param $customizer (object) * @return n/a */ function customize_preview_init( $customizer ) { // get customizer settings (widgets) $settings = $this->settings( $customizer ); // bail early if no settings if ( empty( $settings ) ) { return; } // append values foreach ( $settings as $setting ) { // get acf data $data = $setting->acf; // append acf_value to preview_values $this->preview_values[ $data['post_id'] ] = $data['values']; $this->preview_fields[ $data['post_id'] ] = $data['fields']; } // bail early if no preview_values if ( empty( $this->preview_values ) ) { return; } // add filters add_filter( 'acf/pre_load_value', array( $this, 'pre_load_value' ), 10, 3 ); add_filter( 'acf/pre_load_reference', array( $this, 'pre_load_reference' ), 10, 3 ); } /** * pre_load_value * * Used to inject preview value * * @date 2/2/18 * @since 5.6.5 * * @param type $var Description. Default. * @return type Description. */ function pre_load_value( $value, $post_id, $field ) { // check if ( isset( $this->preview_values[ $post_id ][ $field['key'] ] ) ) { return $this->preview_values[ $post_id ][ $field['key'] ]; } // return return $value; } /** * pre_load_reference * * Used to inject preview value * * @date 2/2/18 * @since 5.6.5 * * @param type $var Description. Default. * @return type Description. */ function pre_load_reference( $field_key, $field_name, $post_id ) { // check if ( isset( $this->preview_fields[ $post_id ][ $field_name ] ) ) { return $this->preview_fields[ $post_id ][ $field_name ]; } // return return $field_key; } /** * This function is called when customizer saves a widget. * Normally, the widget_update_callback filter would be used, but the customizer disables this and runs a custom action * class-customizer-settings.php will save the widget data via the function set_root_value which uses update_option * * @type function * @date 22/03/2016 * @since 5.3.2 * * @param $customizer (object) * @return n/a */ function customize_save( $customizer ) { // get customizer settings (widgets) $settings = $this->settings( $customizer ); // bail early if no settings if ( empty( $settings ) ) { return; } // Widget values are saved from the settings, not $_FILES. acf_discard_uploaded_field_values(); // append values foreach ( $settings as $setting ) { // remove [acf] data from saved widget array $id_data = $setting->id_data(); add_filter( 'pre_update_option_' . $id_data['base'], array( $this, 'pre_update_option' ), 10, 3 ); // The setting value isn't always verified: block widget instances can be posted as raw values. // Save only to the setting's own widget, and only fields rendered for it or that apply to it. $widget = $this->get_setting_widget( $setting ); if ( ! $widget ) { continue; } $data = is_array( $setting->acf ) ? $setting->acf : array(); $post_id = "widget_{$widget['id_base']}-{$widget['number']}"; acf_save_post( $post_id, acf_get_instance( 'acf_form_widget' )->filter_values( $data['values'] ?? array(), $data['_acf_fields'] ?? array(), $widget['id_base'], $post_id ) ); } } /** * Returns the widget a Customizer setting stores, from the setting's ID (`widget_{id_base}[{number}]`). * * @since 6.8.11 * * @param WP_Customize_Setting $setting The setting. * @return array|false The widget's `id_base` and `number`, or false if the setting isn't a registered widget. */ private function get_setting_widget( $setting ) { global $wp_widget_factory; $id_data = $setting->id_data(); $base = (string) ( $id_data['base'] ?? '' ); $keys = (array) ( $id_data['keys'] ?? array() ); if ( strpos( $base, 'widget_' ) !== 0 || count( $keys ) !== 1 || ! ctype_digit( (string) reset( $keys ) ) ) { return false; } $id_base = substr( $base, 7 ); if ( ! $wp_widget_factory instanceof WP_Widget_Factory || ! $wp_widget_factory->get_widget_object( $id_base ) ) { return false; } return array( 'id_base' => $id_base, 'number' => (int) reset( $keys ), ); } /** * This function will remove the [acf] data from widget insance * * @type function * @date 22/03/2016 * @since 5.3.2 * * @param $post_id (int) * @return $post_id (int) */ function pre_update_option( $value, $option, $old_value ) { // bail early if no value if ( empty( $value ) ) { return $value; } // loop over widgets // WP saves all widgets (of the same type) as an array of widgets foreach ( $value as $i => $widget ) { // bail early if no acf if ( ! is_array( $widget ) || ( ! isset( $widget['acf'] ) && ! isset( $widget['_acf_fields'] ) ) ) { continue; } // remove widget unset( $value[ $i ]['acf'], $value[ $i ]['_acf_fields'] ); } // return return $value; } /** * 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() { ?>