"+e+"
").replace(/', $changelog ) ); + + // Loop over each version chunk. + foreach ( $bits as $bit ) { + + // Find the version number for this chunk. + $bit = explode( '
', $bit ); + $bit_version = trim( $bit[0] ); + $bit_text = trim( $bit[1] ); + + // Compare the chunk version number against param and return HTML. + if ( acf_version_compare( $bit_version, '==', $version ) ) { + return '' . esc_html( $bit_version ) . '
' . acf_esc_html( $bit_text ); + } + } + + // Return. + return ''; + } + + /** + * admin_menu + * + * Adds the admin menu subpage. + * + * @date 28/09/13 + * @since 5.0.0 + * + * @param void + * @return void + */ + function admin_menu() { + + // Bail early if no show_admin. + if ( ! acf_get_setting( 'show_admin' ) ) { + return; + } + + // Bail early if the updates page is not visible. + if ( ! acf_pro_is_updates_page_visible() ) { + return; + } + + // Add submenu. + $page = add_submenu_page( 'edit.php?post_type=acf-field-group', __( 'Updates', 'acf' ), __( 'Updates', 'acf' ), acf_get_setting( 'capability' ), 'acf-settings-updates', array( $this, 'html' ) ); + + // Add actions to page. + add_action( "load-$page", array( $this, 'load' ) ); + } + + /** + * load + * + * Runs when loading the submenu page. + * + * @date 7/01/2014 + * @since 5.0.0 + * + * @param void + * @return void + */ + function load() { + + add_action( 'admin_body_class', array( $this, 'admin_body_class' ) ); + + // Check activate. + if ( acf_verify_nonce( 'activate_pro_license' ) && ! empty( $_POST['acf_pro_license'] ) ) { + acf_pro_activate_license( sanitize_text_field( $_POST['acf_pro_license'] ) ); //phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash -- unslash not needed. + + // Check deactivate. + } elseif ( acf_verify_nonce( 'deactivate_pro_license' ) ) { + acf_pro_deactivate_license(); + } + + // Check if we should force check the license status. + $force_get_license_status = false; + $retry_license_nonce = acf_request_arg( 'acf_retry_nonce' ); + if ( wp_verify_nonce( $retry_license_nonce, 'acf_recheck_status' ) || ! empty( $_GET['force-license-check'] ) ) { + $force_get_license_status = true; + } + + // vars + $license = acf_pro_get_license_key(); + $this->view = array( + 'license' => $license, + 'license_status' => acf_pro_get_license_status( $force_get_license_status ), + 'active' => $license ? 1 : 0, + 'current_version' => acf_get_setting( 'version' ), + 'remote_version' => '', + 'update_available' => false, + 'changelog' => '', + 'upgrade_notice' => '', + 'is_defined_license' => defined( 'ACF_PRO_LICENSE' ) && ! empty( ACF_PRO_LICENSE ) && is_string( ACF_PRO_LICENSE ), + 'license_error' => false, + 'wp_not_compatible' => false, + ); + + // get plugin updates + $force_check = ! empty( $_GET['force-check'] ); + $info = acf_updates()->get_plugin_info( 'pro', $force_check ); + + // Display error. + if ( is_wp_error( $info ) ) { + return $this->display_wp_error( $info ); + } + + // add info to view + $this->view['remote_version'] = $info['version']; + + // add changelog if the remote version is '>' than the current version + $version = acf_get_setting( 'version' ); + + // check if remote version is higher than current version + if ( version_compare( $info['version'], $version, '>' ) ) { + + // update view. + $this->view['update_available'] = true; + $this->view['changelog'] = $this->get_changelog_changes( $info['changelog'], $info['version'] ); + $this->view['upgrade_notice'] = $this->get_changelog_changes( $info['upgrade_notice'], $info['version'] ); + + // perform update checks if license is active. + $basename = acf_get_setting( 'basename' ); + $update = acf_updates()->get_plugin_update( $basename ); + $no_update = acf_updates()->get_no_update( $basename ); + + if ( $no_update && ! empty( $no_update['reason'] ) && $no_update['reason'] === 'wp_not_compatible' ) { + $this->view['wp_not_compatible'] = true; + acf_new_admin_notice( + array( + /* translators: %s the version of WordPress required for this ACF update */ + 'text' => sprintf( __( 'An update to ACF is available, but it is not compatible with your version of WordPress. Please upgrade to WordPress %s or newer to update ACF.', 'acf' ), $no_update['requires'] ), + 'type' => 'error', + ) + ); + } + + if ( $license ) { + if ( isset( $update['license_valid'] ) && ! $update['license_valid'] ) { + $this->view['license_error'] = true; + acf_new_admin_notice( + array( + 'text' => __( 'Error. Your license for this site has expired or been deactivated. Please reactivate your ACF PRO license.', 'acf' ), + 'type' => 'error', + ) + ); + } else { + // display error if no package url - possible if license key or site URL has been modified. + if ( $update && ! $update['package'] ) { + $this->view['license_error'] = true; + acf_new_admin_notice( + array( + 'text' => __( 'Error. Could not authenticate update package. Please check again or deactivate and reactivate your ACF PRO license.', 'acf' ), + 'type' => 'error', + ) + ); + } + } + + // refresh transient - if no update exists in the transient or if the transient 'new_version' is stale. + if ( ! $update || $update['new_version'] !== $info['version'] ) { + acf_updates()->refresh_plugins_transient(); + } + } + } + } + + /** + * 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-page'; + return $classes; + } + + /** + * html + * + * Displays the submenu page's HTML. + * + * @date 7/01/2014 + * @since 5.0.0 + * + * @param void + * @return void + */ + function html() { + acf_get_view( __DIR__ . '/views/html-settings-updates.php', $this->view ); + } + } + + // Initialize. + acf_new_instance( 'ACF_Admin_Updates' ); +endif; // class_exists check diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/index.php new file mode 100644 index 00000000..97611c0c --- /dev/null +++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/index.php @@ -0,0 +1,2 @@ + '', // Unused. Messages start at index 1. + 1 => $this->options_page_created_message(), // Updated. + 2 => $this->options_page_created_message(), + 3 => __( 'Options page deleted.', 'acf' ), + 4 => __( 'Options page updated.', 'acf' ), + 5 => false, // Post type does not support revisions. + 6 => $this->options_page_created_message( true ), // Created. + 7 => __( 'Options page saved.', 'acf' ), + 8 => __( 'Options page submitted.', 'acf' ), + 9 => __( 'Options page scheduled for.', 'acf' ), + 10 => __( 'Options page draft updated.', 'acf' ), + ); + + return $messages; + } + + /** + * Renders the options page created message. + * + * @since 6.1 + * + * @param boolean $created True if the options page was just created. + * @return string + */ + public function options_page_created_message( $created = false ) { + global $post_id; + + $title = get_the_title( $post_id ); + + /* translators: %s options page name */ + $item_saved_text = sprintf( __( '%s options page updated', 'acf' ), $title ); + /* translators: %s options page name */ + $add_fields_text = sprintf( __( 'Add fields to %s', 'acf' ), $title ); + + if ( $created ) { + /* translators: %s options page name */ + $item_saved_text = sprintf( __( '%s options page created', 'acf' ), $title ); + } + + $add_fields_link = wp_nonce_url( + admin_url( 'post-new.php?post_type=acf-field-group&use_options_page=' . $post_id ), + 'add-fields-' . $post_id + ); + + ob_start(); + ?> + + + $this->get_parent_page_choices(), + ) + ); + } + + /** + * Enqueues any scripts necessary for internal post type. + * + * @since 6.2 + */ + public function admin_enqueue_scripts() { + wp_enqueue_style( 'acf-field-group' ); + + acf_localize_text( + array( + 'Post' => __( 'Post', 'acf' ), + 'Posts' => __( 'Posts', 'acf' ), + 'Page' => __( 'Page', 'acf' ), + 'Pages' => __( 'Pages', 'acf' ), + 'Default' => __( 'Default', 'acf' ), + ) + ); + + parent::admin_enqueue_scripts(); + + do_action( 'acf/ui_options_page/admin_enqueue_scripts' ); + } + + /** + * Sets up all functionality for the post type edit page to work. + * + * @since 3.1.8 + */ + public function admin_head() { + // global. + global $post, $acf_ui_options_page; + + // set global var. + $acf_ui_options_page = acf_get_internal_post_type( $post->ID, $this->post_type ); + + // metaboxes. + add_meta_box( 'acf-basic-settings', __( 'Basic Settings', 'acf' ), array( $this, 'mb_basic_settings' ), 'acf-ui-options-page', 'normal', 'high' ); + add_meta_box( 'acf-advanced-settings', __( 'Advanced Settings', 'acf' ), array( $this, 'mb_advanced_settings' ), 'acf-ui-options-page', '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-ui-options-page', array( $this, 'screen_layout' ), 10, 1 ); + add_filter( 'get_user_option_metaboxhidden_acf-ui-options-page', array( $this, 'force_basic_settings' ), 10, 1 ); + add_filter( 'get_user_option_closedpostboxes_acf-ui-options-page', array( $this, 'force_basic_settings' ), 10, 1 ); + add_filter( 'get_user_option_closedpostboxes_acf-ui-options-page', array( $this, 'force_advanced_settings' ), 10, 1 ); + + // 3rd party hook. + do_action( 'acf/ui_options_page/admin_head' ); + } + + /** + * This action will allow ACF to render metaboxes after the title. + */ + public function edit_form_after_title() { + + // globals. + global $post; + + // render post data. + acf_form_data( + array( + 'screen' => 'ui_options_page', + 'post_id' => $post->ID, + 'delete_fields' => 0, + 'validation' => 1, + ) + ); + } + + /** + * 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( 'acf/ui_options_page/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 array $l10n + */ + public function admin_l10n( $l10n ) { + return apply_filters( 'acf/ui_options_page/admin_l10n', $l10n ); + } + + /** + * Admin footer third party hook support + * + * @since 5.3.2 + */ + public function admin_footer() { + do_action( 'acf/ui_options_page/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 ) { + return $html; + } + + /** + * Sets the "Edit Post Type" screen to use a one-column layout. + * + * @param integer $columns Number of columns for layout. + * @return integer + */ + public function screen_layout( $columns = 0 ) { + return 1; + } + + /** + * Force basic settings to always be visible + * + * @param array $hidden_metaboxes The metaboxes hidden on this page. + * @return array + */ + public function force_basic_settings( $hidden_metaboxes ) { + if ( ! is_array( $hidden_metaboxes ) ) { + return $hidden_metaboxes; + } + return array_diff( $hidden_metaboxes, array( 'acf-basic-settings' ) ); + } + + /** + * Force advanced settings to be visible + * + * @param array $hidden_metaboxes The metaboxes hidden on this page. + * @return array + */ + public function force_advanced_settings( $hidden_metaboxes ) { + if ( ! is_array( $hidden_metaboxes ) ) { + return $hidden_metaboxes; + } + return array_diff( $hidden_metaboxes, array( 'acf-advanced-settings' ) ); + } + + /** + * This function will customize the publish metabox + * + * @since 5.2.9 + */ + public function post_submitbox_misc_actions() { + global $acf_ui_options_page; + + $status_label = $acf_ui_options_page['active'] ? _x( 'Active', 'post status', 'acf' ) : _x( 'Inactive', 'post status', 'acf' ); + ?> + + verify_save_post( $post_id, $post ) ) { + return $post_id; + } + + // Disable filters to ensure ACF loads raw data from DB. + acf_disable_filters(); + + // phpcs:disable WordPress.Security.NonceVerification.Missing -- Validated in $this->verify_save_post() above. + // phpcs:disable WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized when saved. + $_POST['acf_ui_options_page']['ID'] = $post_id; + $_POST['acf_ui_options_page']['title'] = isset( $_POST['acf_ui_options_page']['page_title'] ) ? $_POST['acf_ui_options_page']['page_title'] : ''; + + // Save the post type. + acf_update_internal_post_type( $_POST['acf_ui_options_page'], $this->post_type ); // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Validated in verify_save_post + // phpcs:enable WordPress.Security.ValidatedSanitizedInput.InputNotSanitized + // phpcs:enable WordPress.Security.NonceVerification.Missing + + return $post_id; + } + + /** + * Renders HTML for the basic settings metabox. + * + * @since 6.2 + */ + public function mb_basic_settings() { + global $acf_ui_options_page, $acf_parent_page_options; + + if ( ! acf_is_internal_post_type_key( $acf_ui_options_page['key'], 'acf-ui-options-page' ) ) { + $acf_ui_options_page['key'] = uniqid( 'ui_options_page_' ); + } + + $acf_parent_page_options = $this->get_parent_page_choices( (int) $acf_ui_options_page['ID'] ); + + acf_get_view( __DIR__ . '/../views/acf-ui-options-page/basic-settings.php' ); + } + + + /** + * Renders the HTML for the advanced settings metabox. + * + * @since 6.2 + */ + public function mb_advanced_settings() { + acf_get_view( __DIR__ . '/../views/acf-ui-options-page/advanced-settings.php' ); + } + + /** + * Iterates through the registered options pages and finds eligible parent pages. + * + * @since 6.2 + * + * @param integer $post_id The post ID of a current ACF UI options page used to prevent selection of itself as a child. + * @return array + */ + public function get_parent_page_choices( int $post_id = 0 ) { + global $menu; + $acf_all_options_pages = acf_get_options_pages(); + $acf_parent_page_choices = array( 'None' => array( 'none' => __( 'No Parent', 'acf' ) ) ); + $self_slug = false; + + if ( is_array( $acf_all_options_pages ) ) { + foreach ( $acf_all_options_pages as $options_page ) { + // Can't assign to child pages. + if ( ! empty( $options_page['parent_slug'] ) ) { + continue; + } + + // Can't be a child of itself. + if ( isset( $options_page['ID'] ) && $post_id === $options_page['ID'] ) { + $self_slug = $options_page['menu_slug']; + continue; + } + + $acf_parent_menu_slug = ! empty( $options_page['menu_slug'] ) ? $options_page['menu_slug'] : ''; + + // ACF overrides the `menu_slug` of parent pages with one child so they redirect to the child. + if ( ! empty( $options_page['_menu_slug'] ) ) { + $acf_parent_menu_slug = $options_page['_menu_slug']; + } + + $acf_parent_page_choices['acfOptionsPages'][ $acf_parent_menu_slug ] = ! empty( $options_page['page_title'] ) ? $options_page['page_title'] : $options_page['menu_slug']; + } + } + + foreach ( $menu as $item ) { + if ( ! empty( $item[0] ) ) { + $page_name = $item[0]; + $markup = '/<[^>]+>.*<\/[^>]+>/'; + $sanitized_name = preg_replace( $markup, '', $page_name ); + + // Prevent options pages being parents of themselves. + if ( ! empty( $item[2] ) && $item[2] === $self_slug ) { + continue; + } + + // If the current item is not an ACF-created options page, add it to the "Others" list. + if ( empty( $acf_parent_page_choices['acfOptionsPages'][ $item[2] ] ) ) { + $acf_parent_page_choices['Others'][ $item[2] ] = acf_esc_html( $sanitized_name ); + } + } + } + return $acf_parent_page_choices; + } + + /** + * Creates a simple options page over AJAX. + * + * @since 6.2 + * @return void + */ + public function ajax_create_options_page() { + // Disable filters to ensure ACF loads raw data from DB. + acf_disable_filters(); + + // phpcs:disable WordPress.Security.NonceVerification.Missing + $args = acf_parse_args( + $_POST, + array( + 'nonce' => '', + 'post_id' => 0, + 'acf_ui_options_page' => array(), + 'field_group_title' => '', + 'acf_parent_page_choices' => array(), + ) + ); + // phpcs:enable WordPress.Security.NonceVerification.Missing + + // Verify nonce and user capability. + if ( ! wp_verify_nonce( $args['nonce'], 'acf_nonce' ) || ! acf_current_user_can_admin() || ! $args['post_id'] ) { + die(); + } + + // Process form data. + if ( ! empty( $args['acf_ui_options_page'] ) ) { + // Prepare for save. + $options_page = acf_validate_internal_post_type( $args['acf_ui_options_page'], 'acf-ui-options-page' ); + $options_page['key'] = uniqid( 'ui_options_page_' ); + $options_page['title'] = ! empty( $args['acf_ui_options_page']['page_title'] ) ? $args['acf_ui_options_page']['page_title'] : ''; + $existing_options_pages = acf_get_options_pages(); + + // Check for duplicates. + if ( ! empty( $existing_options_pages ) ) { + foreach ( $existing_options_pages as $existing_options_page ) { + if ( $existing_options_page['menu_slug'] === $options_page['menu_slug'] ) { + wp_send_json_error( + array( + 'error' => __( 'The provided Menu Slug already exists.', 'acf' ), + ) + ); + } + } + } + + // Save the options page. + acf_update_internal_post_type( $options_page, 'acf-ui-options-page' ); + + wp_send_json_success( + array( + 'page_title' => esc_html( $options_page['page_title'] ), + 'menu_slug' => esc_attr( $options_page['menu_slug'] ), + ) + ); + } + + // Render the form. + ob_start(); + acf_get_view( + __DIR__ . '/../views/acf-ui-options-page/create-options-page-modal.php', + array( + 'field_group_title' => $args['field_group_title'], + 'acf_parent_page_choices' => $args['acf_parent_page_choices'], + ) + ); + $content = ob_get_clean(); + + wp_send_json_success( + array( + 'content' => $content, + 'title' => esc_html__( 'Add New Options Page', 'acf' ), + ) + ); + } + } + + new ACF_Admin_UI_Options_Page(); +endif; // Class exists check. diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/admin-ui-options-pages.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/admin-ui-options-pages.php new file mode 100644 index 00000000..b8e6a5d7 --- /dev/null +++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/admin-ui-options-pages.php @@ -0,0 +1,217 @@ +post_type}" ) ) { + return; + } + + parent::current_screen(); + + // Run a first-run routine to set some defaults which are stored in user preferences. + if ( ! acf_get_user_setting( 'options-pages-first-run', false ) ) { + $option_key = 'manageedit-' . $this->post_type . 'columnshidden'; + $hidden_items = get_user_option( $option_key ); + + if ( ! is_array( $hidden_items ) ) { + $hidden_items = array(); + } + + if ( ! in_array( 'acf-key', $hidden_items ) ) { + $hidden_items[] = 'acf-key'; + } + update_user_option( get_current_user_id(), $option_key, $hidden_items, true ); + + acf_update_user_setting( 'options-pages-first-run', true ); + } + } + + /** + * Add any menu items required for post types. + * + * @since 6.1 + */ + public function admin_menu() { + $parent_slug = 'edit.php?post_type=acf-field-group'; + $cap = acf_get_setting( 'capability' ); + add_submenu_page( $parent_slug, __( 'Options Pages', 'acf' ), __( 'Options Pages', 'acf' ), $cap, 'edit.php?post_type=acf-ui-options-page' ); + } + + /** + * Customizes the admin table columns. + * + * @date 1/4/20 + * @since 5.9.0 + * + * @param array $_columns The columns array. + * @return array + */ + public function admin_table_columns( $_columns ) { + // Set the "no found" label to be our custom HTML for no results. + if ( empty( acf_request_arg( 's' ) ) ) { + global $wp_post_types; + $wp_post_types[ $this->post_type ]->labels->not_found = $this->get_not_found_html(); + } + + $columns = array( + 'cb' => $_columns['cb'], + 'title' => $_columns['title'], + 'acf-description' => __( 'Description', 'acf' ), + 'acf-key' => __( 'Key', 'acf' ), + ); + + if ( acf_get_local_json_files( $this->post_type ) ) { + $columns['acf-json'] = __( 'Local JSON', 'acf' ); + } + + return $columns; + } + + /** + * Renders a specific admin table column. + * + * @date 17/4/20 + * @since 5.9.0 + * + * @param string $column_name The name of the column to display. + * @param array $post The main ACF post array. + * @return void + */ + public function render_admin_table_column( $column_name, $post ) { + switch ( $column_name ) { + case 'acf-key': + echo ''; + echo esc_html( $post['key'] ); + break; + + // Description. + case 'acf-description': + if ( ! empty( $post['description'] ) && ( is_string( $post['description'] ) || is_numeric( $post['description'] ) ) ) { + echo '' . acf_esc_html( $post['description'] ) . ''; + } else { + echo ''; + echo '' . esc_html__( 'No description', 'acf' ) . ''; + } + break; + + // Local JSON. + case 'acf-json': + $this->render_admin_table_column_local_status( $post ); + break; + } + } + + /** + * Gets the translated action notice text for list table actions (activate, deactivate, sync, etc.). + * + * @since 6.1 + * + * @param string $action The action being performed. + * @param integer $count The number of items the action was performed on. + * @return string + */ + public function get_action_notice_text( $action, $count = 1 ) { + $text = ''; + $count = (int) $count; + + switch ( $action ) { + case 'acfactivatecomplete': + $text = sprintf( + /* translators: %s number of post types activated */ + _n( 'Options page activated.', '%s options pages activated.', $count, 'acf' ), + $count + ); + break; + case 'acfdeactivatecomplete': + $text = sprintf( + /* translators: %s number of post types deactivated */ + _n( 'Options page deactivated.', '%s options pages deactivated.', $count, 'acf' ), + $count + ); + break; + case 'acfduplicatecomplete': + $text = sprintf( + /* translators: %s number of post types duplicated */ + _n( 'Options page duplicated.', '%s options pages duplicated.', $count, 'acf' ), + $count + ); + break; + case 'acfsynccomplete': + $text = sprintf( + /* translators: %s number of post types synchronized */ + _n( 'Options page synchronized.', '%s options pages synchronized.', $count, 'acf' ), + $count + ); + break; + } + + return $text; + } + } + + // Instantiate. + acf_new_instance( 'ACF_Admin_UI_Options_Pages' ); +endif; // Class exists check. diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/index.php new file mode 100644 index 00000000..97611c0c --- /dev/null +++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/post-types/index.php @@ -0,0 +1,2 @@ + $tab_label ) { + acf_render_field_wrap( + array( + 'type' => 'tab', + 'label' => $tab_label, + 'key' => 'acf_ui_options_page_tabs', + ) + ); + + $wrapper_class = str_replace( '_', '-', $tab_key ); + + echo ''; +} diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/basic-settings.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/basic-settings.php new file mode 100644 index 00000000..d8d76d2a --- /dev/null +++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/basic-settings.php @@ -0,0 +1,98 @@ + __( 'Page Title', 'acf' ), + /* translators: example options page name */ + 'placeholder' => __( 'Site Settings', 'acf' ), + 'type' => 'text', + 'name' => 'page_title', + 'key' => 'page_title', + 'class' => 'acf_options_page_title acf_slugify_to_key', + 'prefix' => 'acf_ui_options_page', + 'value' => $acf_ui_options_page['page_title'], + 'required' => true, + ), + 'div', + 'field' +); + +acf_render_field_wrap( + array( + 'label' => __( 'Menu Slug', 'acf' ), + 'type' => 'text', + 'name' => 'menu_slug', + 'key' => 'menu_slug', + 'class' => 'acf-options-page-menu_slug acf_slugified_key', + 'prefix' => 'acf_ui_options_page', + 'value' => $acf_ui_options_page['menu_slug'], + 'required' => true, + ), + 'div', + 'field' +); + +acf_render_field_wrap( + array( + 'label' => __( 'Parent Page', 'acf' ), + 'type' => 'select', + 'name' => 'parent_slug', + 'key' => 'parent_slug', + 'class' => 'acf-options-page-parent_slug', + 'prefix' => 'acf_ui_options_page', + 'value' => $acf_ui_options_page['parent_slug'], + 'choices' => $acf_parent_page_options, + 'required' => true, + ), + 'div', + 'field' +); + +do_action( 'acf/post_type/basic_settings', $acf_ui_options_page ); + +acf_render_field_wrap( array( 'type' => 'seperator' ) ); + +acf_render_field_wrap( + array( + 'label' => __( 'Advanced Configuration', 'acf' ), + 'instructions' => __( 'I know what I\'m doing, show me all the options.', 'acf' ), + 'type' => 'true_false', + 'name' => 'advanced_configuration', + 'key' => 'advanced_configuration', + 'prefix' => 'acf_ui_options_page', + 'value' => $acf_ui_options_page['advanced_configuration'], + 'ui' => 1, + 'class' => 'acf-advanced-settings-toggle', + ) +); + +?> +
+
+
+
+
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/index.php
new file mode 100644
index 00000000..97611c0c
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/acf-ui-options-page/index.php
@@ -0,0 +1,2 @@
+options pages are custom admin pages for managing global settings via fields. You can create multiple pages and sub-pages.', 'acf' ),
+ acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/options-page/', 'docs', 'no-options-pages' )
+);
+
+$acf_getting_started = sprintf(
+ /* translators: %s url to getting started guide */
+ __( 'New to ACF? Take a look at our getting started guide.', 'acf' ),
+ acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/getting-started-with-acf/', 'docs', 'no-options-pages' )
+);
+
+$acf_learn_more_link = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/pro/', 'ACF upgrade', 'no-options-pages' );
+$acf_upgrade_button = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/pro/', 'ACF upgrade', 'no-options-pages-pricing', 'pricing-table' );
+?>
+
+
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-options-page.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-options-page.php
new file mode 100644
index 00000000..47b50eb1
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-options-page.php
@@ -0,0 +1,57 @@
+
+ ); ?>){kind=spacer}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-settings-updates.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-settings-updates.php
new file mode 100644
index 00000000..9054b517
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/html-settings-updates.php
@@ -0,0 +1,315 @@
+' . esc_html( $status_text ) . '';
+ ?>
+
+ | + + | ++ |
|---|---|
| + + | ++ + | +
| + + | ++ + | +
+
+
+
+
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/index.php
new file mode 100644
index 00000000..97611c0c
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/admin/views/index.php
@@ -0,0 +1,2 @@
+ false,
+ 'render_callback' => false,
+ 'enqueue_style' => false,
+ 'enqueue_script' => false,
+ 'enqueue_assets' => false,
+ 'post_types' => array(),
+ 'uses_context' => array(),
+ 'supports' => array(),
+ 'attributes' => array(),
+ 'acf_block_version' => $default_acf_block_version,
+ 'validate' => true,
+ 'validate_on_load' => true,
+ 'use_post_meta' => false,
+ )
+ );
+
+ // Add user provided attributes to ACF's required defaults.
+ $settings['attributes'] = wp_parse_args(
+ acf_get_block_type_default_attributes( $metadata ),
+ $settings['attributes']
+ );
+
+ // Add default ACF 'supports' settings.
+ $settings['supports'] = wp_parse_args(
+ $settings['supports'],
+ array(
+ 'align' => true,
+ 'html' => false,
+ 'mode' => true,
+ 'jsx' => true,
+ 'multiple' => true,
+ )
+ );
+
+ // Add default ACF 'uses_context' settings.
+ $settings['uses_context'] = array_values(
+ array_unique(
+ array_merge(
+ $settings['uses_context'],
+ array(
+ 'postId',
+ 'postType',
+ )
+ )
+ )
+ );
+
+ // Map custom ACF properties from the ACF key, with localization.
+ $property_mappings = array(
+ 'renderCallback' => 'render_callback',
+ 'renderTemplate' => 'render_template',
+ 'mode' => 'mode',
+ 'blockVersion' => 'acf_block_version',
+ 'postTypes' => 'post_types',
+ 'validate' => 'validate',
+ 'validateOnLoad' => 'validate_on_load',
+ 'usePostMeta' => 'use_post_meta',
+ 'hideFieldsInSidebar' => 'hide_fields_in_sidebar',
+ );
+ $textdomain = ! empty( $metadata['textdomain'] ) ? $metadata['textdomain'] : 'acf';
+ $i18n_schema = get_block_metadata_i18n_schema();
+
+ foreach ( $property_mappings as $key => $mapped_key ) {
+ if ( isset( $metadata['acf'][ $key ] ) ) {
+ unset( $settings[ $key ] );
+ $settings[ $mapped_key ] = $metadata['acf'][ $key ];
+ if ( $textdomain && isset( $i18n_schema->$key ) ) {
+ $settings[ $mapped_key ] = translate_settings_using_i18n_schema( $i18n_schema->$key, $settings[ $key ], $textdomain );
+ }
+ }
+ }
+
+ if ( isset( $metadata['apiVersion'] ) ) {
+ // Use the apiVersion defined in block.json if it exists.
+ $settings['api_version'] = $metadata['apiVersion'];
+ } elseif ( $settings['acf_block_version'] >= 3 && version_compare( get_bloginfo( 'version' ), '6.3', '>=' ) ) {
+ // Otherwise, if we're on WP 6.3+ and the block is ACF block version 3 or greater, use apiVersion 3.
+ $settings['api_version'] = 3;
+ } else {
+ // Otherwise, default to apiVersion 2.
+ $settings['api_version'] = 2;
+ }
+
+ // Add the block name and registration path to settings.
+ $settings['name'] = $metadata['name'];
+ $settings['path'] = dirname( $metadata['file'] );
+
+ // Prevent blocks that usePostMeta from being nested or saving multiple.
+ if ( ! empty( $settings['use_post_meta'] ) ) {
+ $settings['parent'] = array( 'core/post-content' );
+ $settings['supports']['multiple'] = false;
+ }
+
+ acf_get_store( 'block-types' )->set( $metadata['name'], $settings );
+ add_action( 'enqueue_block_editor_assets', 'acf_enqueue_block_assets' );
+
+ // Ensure our render callback is used.
+ $settings['render_callback'] = 'acf_render_block_callback';
+
+ return $settings;
+}
+
+/**
+ * Check if a block.json block is an ACF block.
+ *
+ * @since 6.0.0
+ *
+ * @param array $metadata The raw block metadata array.
+ * @return boolean
+ */
+function acf_is_acf_block_json( $metadata ) {
+ return ( isset( $metadata['acf'] ) && $metadata['acf'] );
+}
+
+
+/**
+ * Registers a block type.
+ *
+ * @date 18/2/19
+ * @since 5.8.0
+ *
+ * @param array $block The block settings.
+ * @return (array|false)
+ */
+function acf_register_block_type( $block ) {
+ // Validate block type settings.
+ $block = acf_validate_block_type( $block );
+
+ /**
+ * Filters the arguments for registering a block type.
+ *
+ * @since 5.8.9
+ *
+ * @param array $block The array of arguments for registering a block type.
+ */
+ $block = apply_filters( 'acf/register_block_type_args', $block );
+
+ // Require name.
+ if ( ! $block['name'] ) {
+ $message = __( 'Block type name is required.', 'acf' );
+ _doing_it_wrong( __FUNCTION__, $message, '5.8.0' ); //phpcs:ignore -- escape not required.
+ return false;
+ }
+
+ // Bail early if already exists.
+ if ( acf_has_block_type( $block['name'] ) ) {
+ /* translators: The name of the block type */
+ $message = sprintf( __( 'Block type "%s" is already registered.', 'acf' ), $block['name'] );
+ _doing_it_wrong( __FUNCTION__, $message, '5.8.0' ); //phpcs:ignore -- escape not required.
+ return false;
+ }
+
+ // Set ACF required attributes.
+ $block['attributes'] = acf_get_block_type_default_attributes( $block );
+
+ /**
+ * Filters the default ACF block version for blocks registered via acf_register_block_type().
+ *
+ * @since 6.6.0
+ *
+ * @param integer $default_acf_block_version The default ACF block version.
+ * @param array $block An array of block settings.
+ * @return integer
+ */
+ $default_acf_block_version = apply_filters( 'acf/blocks/default_block_version', 1, $block );
+
+ if ( ! isset( $block['acf_block_version'] ) ) {
+ $block['acf_block_version'] = $default_acf_block_version;
+ }
+
+ if ( ! isset( $block['api_version'] ) ) {
+ if ( $block['acf_block_version'] >= 3 && version_compare( get_bloginfo( 'version' ), '6.3', '>=' ) ) {
+ $block['api_version'] = 3;
+ } else {
+ $block['api_version'] = 2;
+ }
+ }
+
+ // Add to storage.
+ acf_get_store( 'block-types' )->set( $block['name'], $block );
+
+ // Overwrite callback for WordPress registration.
+ $block['render_callback'] = 'acf_render_block_callback';
+
+ // Register block type in WP.
+ if ( function_exists( 'register_block_type' ) ) {
+ register_block_type(
+ $block['name'],
+ $block
+ );
+ }
+
+ // Register action.
+ add_action( 'enqueue_block_editor_assets', 'acf_enqueue_block_assets' );
+
+ // Return block.
+ return $block;
+}
+
+/**
+ * See acf_register_block_type().
+ *
+ * @date 18/2/19
+ * @since 5.7.12
+ *
+ * @param array $block The block settings.
+ * @return (array|false)
+ */
+function acf_register_block( $block ) {
+ return acf_register_block_type( $block );
+}
+
+/**
+ * Returns true if a block type exists for the given name.
+ *
+ * @since 5.7.12
+ *
+ * @param string $name The block type name.
+ * @return boolean
+ */
+function acf_has_block_type( $name ) {
+ return acf_get_store( 'block-types' )->has( $name );
+}
+
+/**
+ * Returns an array of all registered block types.
+ *
+ * @since 5.7.12
+ *
+ * @return array
+ */
+function acf_get_block_types() {
+ return acf_get_store( 'block-types' )->get();
+}
+
+/**
+ * Returns a block type for the given name.
+ *
+ * @since 5.7.12
+ *
+ * @param string $name The block type name.
+ * @return (array|null)
+ */
+function acf_get_block_type( $name ) {
+ return acf_get_store( 'block-types' )->get( $name );
+}
+
+/**
+ * Removes a block type for the given name.
+ *
+ * @since 5.7.12
+ *
+ * @param string $name The block type name.
+ * @return void
+ */
+function acf_remove_block_type( $name ) {
+ acf_get_store( 'block-types' )->remove( $name );
+}
+
+/**
+ * Returns an array of default attribute settings for a block type.
+ *
+ * @date 19/11/18
+ * @since 5.8.0
+ *
+ * @param array $block_type A block configuration array.
+ * @return array
+ */
+function acf_get_block_type_default_attributes( $block_type ) {
+ $attributes = array(
+ 'name' => array(
+ 'type' => 'string',
+ 'default' => '',
+ ),
+ 'data' => array(
+ 'type' => 'object',
+ 'default' => array(),
+ ),
+ 'align' => array(
+ 'type' => 'string',
+ 'default' => '',
+ ),
+ 'mode' => array(
+ 'type' => 'string',
+ 'default' => '',
+ ),
+ );
+
+ foreach ( acf_get_block_back_compat_attribute_key_array() as $new => $old ) {
+ if ( isset( $block_type['supports'][ $old ] ) ) {
+ $block_type['supports'][ $new ] = $block_type['supports'][ $old ];
+ unset( $block_type['supports'][ $old ] );
+ }
+ }
+
+ if ( ! empty( $block_type['supports']['alignText'] ) ) {
+ $attributes['alignText'] = array(
+ 'type' => 'string',
+ 'default' => '',
+ );
+ }
+ if ( ! empty( $block_type['supports']['alignContent'] ) ) {
+ $attributes['alignContent'] = array(
+ 'type' => 'string',
+ 'default' => '',
+ );
+ }
+ if ( ! empty( $block_type['supports']['fullHeight'] ) ) {
+ $attributes['fullHeight'] = array(
+ 'type' => 'boolean',
+ 'default' => '',
+ );
+ }
+
+ // For each of ACF's block attributes, check if the user's block attributes contains a default value we should use.
+ if ( isset( $block_type['attributes'] ) && is_array( $block_type['attributes'] ) ) {
+ foreach ( array_keys( $attributes ) as $key ) {
+ if ( isset( $block_type['attributes'][ $key ] ) && is_array( $block_type['attributes'][ $key ] ) && isset( $block_type['attributes'][ $key ]['default'] ) ) {
+ $attributes[ $key ]['default'] = $block_type['attributes'][ $key ]['default'];
+ }
+ }
+ }
+
+ return $attributes;
+}
+
+/**
+ * Validates a block type ensuring all settings exist.
+ *
+ * @since 5.8.0
+ *
+ * @param array $block The block settings.
+ * @return array
+ */
+function acf_validate_block_type( $block ) {
+
+ // Add default settings.
+ $block = wp_parse_args(
+ $block,
+ array(
+ 'name' => '',
+ 'title' => '',
+ 'description' => '',
+ 'category' => 'common',
+ 'icon' => '',
+ 'mode' => 'preview',
+ 'keywords' => array(),
+ 'supports' => array(),
+ 'post_types' => array(),
+ 'uses_context' => array(),
+ 'render_template' => false,
+ 'render_callback' => false,
+ 'enqueue_style' => false,
+ 'enqueue_script' => false,
+ 'enqueue_assets' => false,
+ )
+ );
+
+ // Generate name with prefix.
+ if ( $block['name'] ) {
+ $block['name'] = 'acf/' . acf_slugify( $block['name'] );
+ }
+
+ // Add default 'supports' settings.
+ $block['supports'] = wp_parse_args(
+ $block['supports'],
+ array(
+ 'align' => true,
+ 'html' => false,
+ 'mode' => true,
+ )
+ );
+
+ // Add default 'uses_context' settings.
+ $block['uses_context'] = wp_parse_args(
+ $block['uses_context'],
+ array(
+ 'postId',
+ 'postType',
+ )
+ );
+
+ // Correct "Experimental" flags.
+ if ( isset( $block['supports']['__experimental_jsx'] ) ) {
+ $block['supports']['jsx'] = $block['supports']['__experimental_jsx'];
+ }
+
+ // Normalize block 'parent' setting.
+ if ( array_key_exists( 'parent', $block ) ) {
+ // As of WP 6.8, parent must be an array.
+ if ( null === $block['parent'] ) {
+ unset( $block['parent'] );
+ } elseif ( is_string( $block['parent'] ) ) {
+ $block['parent'] = array( $block['parent'] );
+ }
+ }
+
+ // Return block.
+ return $block;
+}
+
+/**
+ * Prepares a block for use in render_callback by merging in all settings and attributes.
+ *
+ * @since 5.8.0
+ *
+ * @param array $block The block props.
+ * @return array|boolean
+ */
+function acf_prepare_block( $block ) {
+ // Bail early if no name.
+ if ( ! isset( $block['name'] ) ) {
+ return false;
+ }
+
+ // Ensure a block ID is always prefixed with `block_` for meta.
+ $block['id'] = acf_ensure_block_id_prefix( $block['id'] );
+
+ // Get block type and return false if doesn't exist.
+ $block_type = acf_get_block_type( $block['name'] );
+ if ( ! $block_type ) {
+ return false;
+ }
+
+ // Prevent protected attributes being overridden.
+ $protected = array(
+ 'render_template',
+ 'render_callback',
+ 'enqueue_script',
+ 'enqueue_style',
+ 'enqueue_assets',
+ 'post_types',
+ 'use_post_meta',
+ );
+ $block = array_diff_key( $block, array_flip( $protected ) );
+
+ // Generate default attributes.
+ $attributes = array();
+ foreach ( acf_get_block_type_default_attributes( $block_type ) as $k => $v ) {
+ $attributes[ $k ] = $v['default'];
+ }
+
+ // Merge together arrays in order of least to most specific.
+ $block = array_merge( $block_type, $attributes, $block );
+
+ // Add backward compatibility attributes.
+ $block = acf_add_back_compat_attributes( $block );
+
+ // Return block.
+ return $block;
+}
+
+/**
+ * Add backwards compatible attribute values.
+ *
+ * @since 6.0.0
+ *
+ * @param array $block The original block.
+ * @return array Modified block array with backwards compatibility attributes.
+ */
+function acf_add_back_compat_attributes( $block ) {
+ foreach ( acf_get_block_back_compat_attribute_key_array() as $new => $old ) {
+ if ( ! empty( $block[ $new ] ) || ( isset( $block[ $new ] ) && ! isset( $block[ $old ] ) ) ) {
+ $block[ $old ] = $block[ $new ];
+ }
+ }
+
+ return $block;
+}
+
+/**
+ * Get back compat new values and old values.
+ *
+ * @since 6.0.0
+ *
+ * @return array back compat key array.
+ */
+function acf_get_block_back_compat_attribute_key_array() {
+ return array(
+ 'fullHeight' => 'full_height',
+ 'alignText' => 'align_text',
+ 'alignContent' => 'align_content',
+ );
+}
+
+
+/**
+ * The render callback for all ACF blocks.
+ *
+ * @date 28/10/20
+ * @since 5.9.2
+ *
+ * @param array $attributes The block attributes.
+ * @param string $content The block content.
+ * @param WP_Block $wp_block The block instance (since WP 5.5).
+ * @return string The block HTML.
+ */
+function acf_render_block_callback( $attributes, $content = '', $wp_block = null ) {
+
+ $is_preview = false;
+ $post_id = get_the_ID();
+
+ // Set preview flag to true when rendering for the block editor.
+ if ( is_admin() && acf_is_block_editor() ) {
+ $is_preview = true;
+ }
+
+ // If ACF's block save method hasn't been called yet, try to initialize a default block.
+ if ( empty( $attributes['name'] ) && ! empty( $wp_block->name ) ) {
+ $attributes['name'] = $wp_block->name;
+ }
+
+ // Return rendered block HTML.
+ return acf_rendered_block( $attributes, $content, $is_preview, $post_id, $wp_block );
+}
+
+/**
+ * Returns the rendered block HTML.
+ *
+ * @date 28/2/19
+ * @since 5.7.13
+ *
+ * @param array $attributes The block attributes.
+ * @param string $content The block content.
+ * @param boolean $is_preview Whether or not the block is being rendered for editing preview.
+ * @param integer $post_id The current post being edited or viewed.
+ * @param WP_Block $wp_block The block instance (since WP 5.5).
+ * @param array $context The block context array.
+ * @param boolean $is_ajax_render Whether or not this is an ACF AJAX render.
+ * @return string The block HTML.
+ */
+function acf_rendered_block( $attributes, $content = '', $is_preview = false, $post_id = 0, $wp_block = null, $context = false, $is_ajax_render = false ) {
+ $registry = WP_Block_Type_Registry::get_instance();
+ $wp_block_type = $registry->get_registered( $attributes['name'] );
+
+ if ( isset( $wp_block_type->acf_block_version ) && $wp_block_type->acf_block_version >= 3 ) {
+ $mode = 'preview';
+ $form = false;
+ } else {
+ $mode = isset( $attributes['mode'] ) ? $attributes['mode'] : 'auto';
+ $form = ( 'edit' === $mode && $is_preview );
+ }
+
+ // If context is available from the WP_Block class object and we have no context of our own, use that.
+ if ( empty( $context ) && ! empty( $wp_block->context ) ) {
+ $context = $wp_block->context;
+ }
+
+ // Check if we need to generate a block ID.
+ $force_new_id = false;
+ if ( acf_block_uses_post_meta( $attributes ) && ! empty( $attributes['id'] ) && empty( $attributes['data'] ) ) {
+ $force_new_id = true;
+ }
+ $attributes['id'] = acf_get_block_id( $attributes, $context, $force_new_id );
+
+ // Check if we've already got a cache of this block ID and return it to save rendering if we're in the backend.
+ if ( $is_preview ) {
+ $cached_block = acf_get_store( 'block-cache' )->get( $attributes['id'] );
+ if ( $cached_block ) {
+ if ( $form ) {
+ if ( $cached_block['form'] ) {
+ return $cached_block['html'];
+ }
+ } elseif ( ! $cached_block['form'] ) {
+ return $cached_block['html'];
+ }
+ }
+ }
+
+ ob_start();
+
+ $validation = false;
+
+ if ( $form ) {
+ // Load the block form since we're in edit mode.
+ // Set flag for post REST cleanup of media enqueue count during preloads.
+ acf_set_data( 'acf_did_render_block_form', true );
+
+ $block = acf_prepare_block( $attributes );
+ $block = acf_add_block_meta_values( $block, $post_id );
+ acf_setup_meta( $block['data'], $block['id'], true );
+
+ if ( ! empty( $block['validate'] ) ) {
+ $validation = acf_get_block_validation_state( $block, false, false, true );
+ }
+
+ $fields = acf_get_block_fields( $block );
+ if ( $fields ) {
+ acf_prefix_fields( $fields, "acf-{$block['id']}" );
+
+ echo '
+
+
+
+
+
+
+
+
+
+
+
+ + +
+ + +
+ %3$s',
+ esc_attr( $acf_recheck_class ),
+ esc_url( $acf_recheck_url ),
+ esc_html( $acf_recheck_text )
+ );
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+ %s ',
+ acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/pro/', 'ACF upgrade', 'license activations' ),
+ $acf_view_pricing_text
+ );
+ echo acf_esc_html(
+ sprintf(
+ /* translators: %s - link to ACF website */
+ __( 'Don\'t have an ACF PRO license? %s', 'acf' ),
+ $acf_view_pricing_link
+ )
+ );
+ ?>
+
+
+
+ ';
+ acf_render_fields( $fields, acf_ensure_block_id_prefix( $block['id'] ), 'div', 'field' );
+ echo '
';
+ } else {
+ echo acf_get_empty_block_form_html( $attributes['name'] ); //phpcs:ignore -- escaped in function.
+ }
+ } else {
+ if ( $is_preview ) {
+ acf_set_data( 'acf_doing_block_preview', true );
+ }
+
+ // Capture block render output.
+ acf_render_block( $attributes, $content, $is_preview, $post_id, $wp_block, $context );
+
+ if ( $is_preview && ! $is_ajax_render ) {
+ /**
+ * If we're in preloaded preview, we need to get the validation state for a preview too.
+ * Because the block render resets meta once it's finished to not pollute $post_id, we need to redo that process here.
+ */
+ $block = acf_prepare_block( $attributes );
+ $block = acf_add_block_meta_values( $block, $post_id );
+ acf_setup_meta( $block['data'], $block['id'], true );
+ if ( ! empty( $block['validate'] ) ) {
+ $validation = acf_get_block_validation_state( $block, false, false, true );
+ }
+ }
+ }
+
+ $html = ob_get_clean();
+ $html = is_string( $html ) ? $html : '';
+
+ // Replace ' . __( 'The render template for this ACF Block was not found', 'acf' ) . '
' ) ); + } + + do_action( 'acf/blocks/post_block_template_render', $block, $content, $is_preview, $post_id, $wp_block, $context ); +} + +/** + * Returns an array of all fields for the given block. + * + * @date 24/10/18 + * @since 5.8.0 + * + * @param array $block The block props. + * @return array + */ +function acf_get_block_fields( $block ) { + $fields = array(); + + // We need at least a block name to check. + if ( empty( $block['name'] ) ) { + return $fields; + } + + // Get field groups for this block. + $field_groups = acf_get_field_groups( + array( + 'block' => $block['name'], + ) + ); + + // Loop over results and append fields. + if ( $field_groups ) { + foreach ( $field_groups as $field_group ) { + $fields = array_merge( $fields, acf_get_fields( $field_group ) ); + } + } + + return $fields; +} + +/** + * Enqueues and localizes block scripts and styles. + * + * @since 5.7.13 + * + * @return void + */ +function acf_enqueue_block_assets() { + + // Localize text. + acf_localize_text( + array( + 'Switch to Edit' => __( 'Switch to Edit', 'acf' ), + 'Switch to Preview' => __( 'Switch to Preview', 'acf' ), + 'Change content alignment' => __( 'Change content alignment', 'acf' ), + 'Error previewing block' => __( 'An error occurred when loading the preview for this block.', 'acf' ), + 'Error loading block form' => __( 'An error occurred when loading the block in edit mode.', 'acf' ), + 'Edit Block' => __( 'Edit Block', 'acf' ), + 'Open Expanded Editor' => __( 'Open Expanded Editor', 'acf' ), + 'Error previewing block v3' => __( 'The preview for this block couldn’t be loaded. Review its content or settings for issues.', 'acf' ), + 'ACF Block' => __( 'ACF Block', 'acf' ), + + /* translators: %s: Block type title */ + '%s settings' => __( '%s settings', 'acf' ), + ) + ); + + // Get block types. + $block_types = array_map( + function ( $block ) { + // Render Callback may contain a incompatible class for JSON encoding. Turn it into a boolean for the frontend. + $block['render_callback'] = ! empty( $block['render_callback'] ); + return $block; + }, + acf_get_block_types() + ); + + // Localize data. + acf_localize_data( + array( + 'blockTypes' => array_values( $block_types ), + 'postType' => get_post_type(), + ) + ); + + // Enqueue script. + $min = defined( 'ACF_DEVELOPMENT_MODE' ) && ACF_DEVELOPMENT_MODE ? '' : '.min'; + + $blocks_js_path = acf_get_url( "assets/build/js/pro/acf-pro-blocks{$min}.js" ); + + wp_enqueue_script( 'acf-blocks', $blocks_js_path, array( 'acf-input', 'wp-blocks' ), ACF_VERSION, true ); + + // Enqueue block assets. + array_map( 'acf_enqueue_block_type_assets', $block_types ); + + // During the edit screen loading, WordPress renders all blocks in its own attempt to preload data. + // Retrieve any cached block HTML and include this in the localized data. + if ( acf_get_setting( 'preload_blocks' ) ) { + $preloaded_blocks = acf_get_store( 'block-cache' )->get_data(); + acf_localize_data( + array( + 'preloadedBlocks' => $preloaded_blocks, + ) + ); + } +} + +/** + * Enqueues scripts and styles for a specific block type. + * + * @since 5.7.13 + * + * @param array $block_type The block type settings. + * @return void + */ +function acf_enqueue_block_type_assets( $block_type ) { + + // Generate handle from name. + $handle = 'block-' . acf_slugify( $block_type['name'] ); + + // Enqueue style. + if ( $block_type['enqueue_style'] ) { + wp_enqueue_style( $handle, $block_type['enqueue_style'], array(), ACF_VERSION, 'all' ); + } + + // Enqueue script. + if ( $block_type['enqueue_script'] ) { + wp_enqueue_script( $handle, $block_type['enqueue_script'], array(), ACF_VERSION, true ); + } + + // Enqueue assets callback. + if ( $block_type['enqueue_assets'] && is_callable( $block_type['enqueue_assets'] ) ) { + call_user_func( $block_type['enqueue_assets'], $block_type ); + } +} + +/** + * Handles the ajax request for block data. + * + * @since 5.7.13 + * + * @return void + */ +function acf_ajax_fetch_block() { + // Validate ajax request. + if ( ! acf_verify_ajax() ) { + wp_send_json_error(); + } + + // Get request args. + $args = acf_request_args( + array( + 'post_id' => 0, + 'clientId' => null, + 'query' => array(), + ) + ); + + // Verify capability. + if ( ! empty( $args['post_id'] ) && is_numeric( $args['post_id'] ) ) { + // Editing a normal post - we can verify if the user has access to that post. + if ( ! acf_current_user_can_edit_post( (int) $args['post_id'] ) ) { + wp_send_json_error(); + } + } else { + // Could be editing a widget, using the site editor, etc. + $render_capability = apply_filters( 'acf/blocks/render_capability', 'edit_theme_options', $args['post_id'] ); + + if ( ! current_user_can( $render_capability ) ) { + wp_send_json_error(); + } + } + + $args['block'] = isset( $_REQUEST['block'] ) ? $_REQUEST['block'] : false; //phpcs:ignore -- requires auth; designed to contain unescaped html. + $args['context'] = isset( $_REQUEST['context'] ) ? $_REQUEST['context'] : array(); //phpcs:ignore -- requires auth; designed to contain unescaped html. + + $block = $args['block']; + $query = $args['query']; + $client_id = $args['clientId']; + $raw_context = $args['context']; + $post_id = $args['post_id']; + + // Bail early if no block. + if ( ! $block ) { + wp_send_json_error(); + } + + // Unslash and decode $_POST data for block and context. + $block = wp_unslash( $block ); + $block = json_decode( $block, true ); + + $context = false; + if ( ! empty( $raw_context ) ) { + $raw_context = wp_unslash( $raw_context ); + $raw_context = json_decode( $raw_context, true ); + if ( is_array( $raw_context ) ) { + $context = $raw_context; + // Check if a postId is set in the context, otherwise try and use it the default post_id. + $post_id = isset( $context['postId'] ) ? intval( $context['postId'] ) : intval( $args['post_id'] ); + } + } + + // Check if clientId should become $block['id']. + if ( empty( $block['id'] ) && ! empty( $client_id ) ) { + $block['id'] = $client_id; + } + + // Prepare block ensuring all settings and attributes exist. + $block = acf_prepare_block( $block ); + $block = acf_add_block_meta_values( $block, $post_id ); + + if ( ! $block ) { + wp_send_json_error(); + } + + // Load field defaults when first previewing a block. + $first_preview = false; + if ( ! empty( $query['preview'] ) && ! $block['data'] ) { + $fields = acf_get_block_fields( $block ); + foreach ( $fields as $field ) { + $block['data'][ "_{$field['name']}" ] = $field['key']; + } + $first_preview = true; + } + + // Setup postdata allowing form to load meta. + acf_setup_meta( $block['data'], $block['id'], true ); + + // Setup main postdata for post_id. + global $post; + //phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- required for block template rendering. + $post = get_post( $post_id ); + setup_postdata( $post ); + + // Vars. + $response = array( 'clientId' => $client_id ); + + // Check if we've recieved serialised form data + $use_post_data = false; + if ( ! empty( $block['data'] ) && is_array( $block['data'] ) ) { + // Ensure we've got field keys posted. + $valid_field_keys = array_filter( array_keys( $block['data'] ), 'acf_is_field_key' ); + if ( ! empty( $valid_field_keys ) ) { + $use_post_data = true; + } + } + + $query['validate'] = ( ! empty( $query['validate'] ) && ( $query['validate'] === 'true' || $query['validate'] === true ) ); + if ( ! empty( $query['validate'] ) || ! empty( $block['validate'] ) ) { + $response['validation'] = acf_get_block_validation_state( $block, $first_preview, $use_post_data ); + } + + // Query form. + if ( ! empty( $query['form'] ) ) { + + // Load fields for form. + $fields = acf_get_block_fields( $block ); + + // Prefix field inputs to avoid multiple blocks using the same name/id attributes. + acf_prefix_fields( $fields, "acf-{$block['id']}" ); + + if ( $fields ) { + // Start Capture. + ob_start(); + + // Render. + echo '';
+ acf_render_fields( $fields, $block['id'], 'div', 'field' );
+ echo '
';
+
+ // Store Capture.
+ $response['form'] = ob_get_clean();
+ } else {
+ // There are no fields on this block.
+ $response['form'] = acf_get_empty_block_form_html( $block['name'] ); //phpcs:ignore -- escaped in function.
+ }
+ }
+
+ // Query preview.
+ if ( ! empty( $query['preview'] ) ) {
+ // Render_callback vars.
+ $content = '';
+ $is_preview = true;
+
+ // Render and store HTML.
+ $response['preview'] = acf_rendered_block( $block, $content, $is_preview, $post_id, null, $context, true );
+ }
+
+ // Send response.
+ wp_send_json_success( $response );
+}
+
+// Register ajax action.
+acf_register_ajax( 'fetch-block', 'acf_ajax_fetch_block' );
+
+/**
+ * Render the empty block form for when a block has no fields assigned.
+ *
+ * @since 6.0.0
+ *
+ * @param string $block_name The block name current being rendered.
+ * @return string The html that makes up a block form with no fields.
+ */
+function acf_get_empty_block_form_html( $block_name ) {
+
+ $message = __( 'This block contains no editable fields.', 'acf' );
+
+ if ( acf_current_user_can_admin() ) {
+ $message .= ' ';
+ $message .= sprintf(
+ /* translators: %s: an admin URL to the field group edit screen */
+ __( 'Assign a field group to add fields to this block.', 'acf' ),
+ admin_url( 'edit.php?post_type=acf-field-group' )
+ );
+ }
+
+ $message = apply_filters( 'acf/blocks/no_fields_assigned_message', $message, $block_name );
+
+ if ( ! is_string( $message ) ) {
+ $message = '';
+ }
+
+ if ( empty( $message ) ) {
+ return acf_esc_html( '' );
+ } else {
+ return acf_esc_html( '' . $message . '
' );
+ }
+}
+
+/**
+ * Parse content that may contain HTML block comments and saves ACF block meta.
+ *
+ * @since 5.7.13
+ *
+ * @param string $text Content that may contain HTML block comments.
+ * @return string
+ */
+function acf_parse_save_blocks( $text = '' ) {
+
+ // Search text for dynamic blocks and modify attrs.
+ return addslashes(
+ preg_replace_callback(
+ '//',
+ 'acf_parse_save_blocks_callback',
+ stripslashes( $text )
+ )
+ );
+}
+
+// Hook into saving process.
+add_filter( 'content_save_pre', 'acf_parse_save_blocks', 5, 1 );
+
+/**
+ * Callback used in preg_replace to modify ACF Block comment.
+ *
+ * @since 5.7.13
+ *
+ * @param array $matches The preg matches.
+ * @return string
+ */
+function acf_parse_save_blocks_callback( $matches ) {
+ // Defaults.
+ $name = isset( $matches['name'] ) ? $matches['name'] : '';
+ $attrs = isset( $matches['attrs'] ) ? json_decode( $matches['attrs'], true ) : '';
+ $void = isset( $matches['void'] ) ? $matches['void'] : '';
+
+ // Bail early if missing data or not an ACF Block.
+ if ( ! $name || ! $attrs || ! acf_has_block_type( $name ) ) {
+ return $matches[0];
+ }
+
+ // Check if we need to generate a block ID.
+ $block_id = acf_ensure_block_id_prefix( acf_get_block_id( $attrs ) );
+
+ if ( ! empty( $attrs['data'] ) ) {
+ if ( acf_block_uses_post_meta( $attrs ) ) {
+ // Block ID is used later to retrieve & save values.
+ $attrs['id'] = $block_id;
+
+ // Cache the values until we have a post ID and can save.
+ $store = acf_get_store( 'block-meta-values' );
+ $store->set( $block_id, $attrs['data'] );
+
+ // No need to store values in post content.
+ unset( $attrs['data'] );
+ } else {
+ // Convert "data" to "meta".
+ // No need to check if already in meta format. Local Meta will do this for us.
+ $attrs['data'] = acf_setup_meta( $attrs['data'], $block_id );
+ }
+ }
+
+ /**
+ * Filters the block attributes before saving.
+ *
+ * @since 5.7.14
+ *
+ * @param array $attrs The block attributes.
+ */
+ $attrs = apply_filters( 'acf/pre_save_block', $attrs );
+
+ // Gutenberg expects a specific encoding format.
+ $attrs = acf_serialize_block_attributes( $attrs );
+
+ return '';
+}
+
+/**
+ * Return or generate a block ID.
+ *
+ * @since 6.0.0
+ *
+ * @param array $attributes A block attributes array.
+ * @param array $context The block context array, defaults to an empty array.
+ * @param boolean $force If we should generate a new block ID even if one exists.
+ * @return string A block ID.
+ */
+function acf_get_block_id( $attributes, $context = array(), $force = false ) {
+ $context = is_array( $context ) ? $context : array();
+
+ ksort( $context );
+ $attributes['_acf_context'] = $context;
+ if ( empty( $attributes['id'] ) || $force ) {
+ unset( $attributes['id'] );
+
+ // Remove all empty string values as they're not present in JS hash building.
+ foreach ( $attributes as $key => $value ) {
+ if ( '' === $value ) {
+ unset( $attributes[ $key ] );
+ }
+ }
+
+ // Check if data is empty and remove it if so to match JS hash building.
+ if ( isset( $attributes['data'] ) && empty( $attributes['data'] ) ) {
+ unset( $attributes['data'] );
+ }
+
+ ksort( $attributes );
+ return md5( wp_json_encode( $attributes, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ) );
+ }
+ return $attributes['id'];
+}
+
+/**
+ * Ensure a block ID always has a block_ prefix for post meta internals.
+ *
+ * @since 6.0.0
+ *
+ * @param string $block_id A possibly non-prefixed block ID.
+ * @return string A prefixed block ID.
+ */
+function acf_ensure_block_id_prefix( $block_id ) {
+ if ( substr( $block_id, 0, 6 ) === 'block_' ) {
+ return $block_id;
+ }
+ return 'block_' . $block_id;
+}
+
+/**
+ * This directly copied from the WordPress core `serialize_block_attributes()` function.
+ *
+ * We need this in order to make sure that block attributes are stored in a way that is
+ * consistent with how Gutenberg sends them over from JS, and so that things like wp_kses()
+ * work as expected. Copied from core to get around a bug that was fixed in 5.8.1 or on the off chance
+ * that folks are still using WP 5.3 or below.
+ *
+ * TODO: Remove this when we refactor `acf_parse_save_blocks_callback()` to use `serialize_block()`,
+ * or when we're confident that folks aren't using WP versions prior to 5.8.
+ *
+ * @since 5.12
+ *
+ * @param array $block_attributes Attributes object.
+ * @return string Serialized attributes.
+ */
+function acf_serialize_block_attributes( $block_attributes ) {
+ $encoded_attributes = wp_json_encode( $block_attributes, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
+ $encoded_attributes = preg_replace( '/--/', '\\u002d\\u002d', $encoded_attributes );
+ $encoded_attributes = preg_replace( '//', '\\u003e', $encoded_attributes );
+ $encoded_attributes = preg_replace( '/&/', '\\u0026', $encoded_attributes );
+ // Regex: /\\"/.
+ $encoded_attributes = preg_replace( '/\\\\"/', '\\u0022', $encoded_attributes );
+
+ return $encoded_attributes;
+}
+
+/**
+ * Handle validating a block's fields and return the validity, and any errors.
+ *
+ * This function can use values loaded into Local Meta, which means they have to be
+ * converted back to the data format before they can be validated.
+ *
+ * @since 6.3
+ *
+ * @param array $block An array of the block's data attribute.
+ * @param boolean $using_defaults True if the block is currently being generated with default values. Default false.
+ * @param boolean $use_post_data True if we should validate the POSTed data rather than local meta values. Default false.
+ * @param boolean $on_load True if we're validating as part of a render. This is essentially the same as a first load. Default false.
+ * @return array An array containing a valid boolean, and an errors array.
+ */
+function acf_get_block_validation_state( $block, $using_defaults = false, $use_post_data = false, $on_load = false ) {
+ $block_id = $block['id'];
+
+ if ( $on_load && empty( $block['validate_on_load'] ) ) {
+ // If we're in a page load render, and validate on load is false, skip validation.
+ $errors = false;
+ } elseif ( $use_post_data ) {
+ $errors = acf_validate_block_from_post_data( $block );
+ } elseif ( $using_defaults || empty( $block['data'] ) ) {
+ // If data is empty or it's first preview, load the default fields for this block so we can get a required validation state from the current field set.
+ // Treat as "on load" if it's the first render of a block.
+ if ( empty( $block['validate_on_load'] ) ) {
+ $errors = false;
+ } else {
+ $errors = acf_validate_block_from_local_meta( $block_id, acf_get_block_fields( $block ), true );
+ }
+ } else {
+ $errors = acf_validate_block_from_local_meta( $block_id, get_field_objects( $block_id, false ), false );
+ }
+
+ return array(
+ 'valid' => empty( $errors ),
+ 'errors' => $errors,
+ );
+}
+
+/**
+ * Handle the specific validation for a block from POSTed values.
+ *
+ * @since 6.3.1
+ *
+ * @param array $block The block object containing the POSTed values and other block data
+ * @return array|boolean An array containing the validation errors, or false if there are no errors.
+ */
+function acf_validate_block_from_post_data( $block ) {
+ acf_reset_validation_errors();
+ acf_validate_values( $block['data'], "acf-{$block['id']}" );
+ $errors = acf_get_validation_errors();
+ return $errors;
+}
+
+/**
+ * Handle the specific validation for a block from local meta.
+ *
+ * This function uses the values loaded into Local Meta, which means they have to be
+ * converted back to the data format because they can be validated.
+ *
+ * @since 6.3.1
+ *
+ * @param string $block_id The block ID.
+ * @param array $field_objects The field objects in local meta to be validated.
+ * @param boolean $using_defaults True if this is the first load of the block, when special validation may apply.
+ * @return array|boolean An array containing the validation errors, or false if there are no errors.
+ */
+function acf_validate_block_from_local_meta( $block_id, $field_objects, $using_defaults = false ) {
+ if ( empty( $field_objects ) ) {
+ return false;
+ }
+
+ $using_loaded_meta = false;
+ if ( acf_get_data( $block_id . '_loaded_meta_values' ) ) {
+ $using_loaded_meta = true;
+ }
+
+ acf_reset_validation_errors();
+ foreach ( $field_objects as $field ) {
+ // Skip for nested fields - these don't work correctly on initial load of a saved block.
+ if ( ! empty( $field['sub_fields'] ) ) {
+ continue;
+ }
+
+ // If we're using default values, or loaded meta we may have values which are about to be populated at field render, so shouldn't raise errors here.
+ if ( $using_defaults || $using_loaded_meta ) {
+ // Fields with conditional logic applied shouldn't be validated during first load as conditionals aren't respected.
+ if ( ! empty( $field['conditional_logic'] ) ) {
+ continue;
+ }
+
+ // If we've got a empty value with a default value set and it's first load, don't produce a validation error as it will be substituted on render.
+ if ( $field['required'] && empty( $field['value'] ) && ! empty( $field['default_value'] ) ) {
+ continue;
+ }
+
+ // If we're loading a few radio or select-like fields, without allow null, HTML will automatically select the first value on render, so skip here.
+ if ( $field['required'] && in_array( $field['type'], array( 'radio', 'button_group', 'select' ), true ) && ! $field['allow_null'] ) {
+ continue;
+ }
+ }
+
+ $key = $field['key'];
+ $value = $field['value'];
+ acf_validate_value( $value, $field, "acf-{$block_id}[{$key}]" );
+ }
+
+ return acf_get_validation_errors();
+}
+
+/**
+ * Set ACF data before a rest call if media scripts have not been enqueued yet for after REST reset.
+ *
+ * @date 07/06/22
+ * @since 6.0
+ *
+ * @param WP_REST_Response|WP_HTTP_Response|WP_Error|mixed $response The WordPress response object.
+ * @return mixed
+ */
+function acf_set_after_rest_media_enqueue_reset_flag( $response ) {
+ global $wp_actions;
+
+ acf_set_data( 'acf_inside_rest_call', true );
+ acf_set_data( 'acf_should_reset_media_enqueue', empty( $wp_actions['wp_enqueue_media'] ) );
+ acf_set_data( 'acf_did_render_block_form', false );
+
+ return $response;
+}
+add_filter( 'rest_request_before_callbacks', 'acf_set_after_rest_media_enqueue_reset_flag' );
+
+/**
+ * Reset wp_enqueue_media action count after REST call so it can happen inside the main execution if required.
+ *
+ * @date 07/06/22
+ * @since 6.0
+ *
+ * @param WP_REST_Response|WP_HTTP_Response|WP_Error|mixed $response The WordPress response object.
+ * @return mixed
+ */
+function acf_reset_media_enqueue_after_rest( $response ) {
+ acf_set_data( 'acf_inside_rest_call', false );
+ if ( acf_get_data( 'acf_should_reset_media_enqueue' ) && acf_get_data( 'acf_did_render_block_form' ) ) {
+ global $wp_actions;
+ //phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- no other option here as this works around a breaking WordPress change with REST preload scopes.
+ $wp_actions['wp_enqueue_media'] = 0;
+ }
+
+ return $response;
+}
+add_filter( 'rest_request_after_callbacks', 'acf_reset_media_enqueue_after_rest' );
+
+/**
+ * Checks if the provided block is configured to save/load post meta.
+ *
+ * @since 6.3
+ *
+ * @param array $block The block to check.
+ * @return boolean
+ */
+function acf_block_uses_post_meta( $block ): bool {
+ if ( ! empty( $block['name'] ) && ! isset( $block['use_post_meta'] ) ) {
+ $block = acf_get_block_type( $block['name'] );
+ }
+
+ return ! empty( $block['use_post_meta'] );
+}
+
+/**
+ * Loads ACF field values from the post meta if the block is configured to do so.
+ *
+ * @since 6.3
+ *
+ * @param array $block The block to get values for.
+ * @param integer $post_id The ID of the post to retrieve meta from.
+ * @return array
+ */
+function acf_add_block_meta_values( $block, $post_id ) {
+ // Bail if the block already has data (i.e. previewing an update).
+ if ( ! is_array( $block ) || ! empty( $block['data'] ) ) {
+ return $block;
+ }
+
+ // Bail if block doesn't load from meta.
+ if ( ! acf_block_uses_post_meta( $block ) ) {
+ return $block;
+ }
+
+ // Bail if we don't have a post ID or block ID.
+ if ( empty( $post_id ) || empty( $block['id'] ) ) {
+ return $block;
+ }
+
+ $fields = acf_get_block_fields( $block );
+
+ if ( empty( $fields ) ) {
+ return $block;
+ }
+
+ $values = array();
+ $store = acf_get_store( 'values' );
+ $block_id = acf_ensure_block_id_prefix( $block['id'] );
+
+ foreach ( $fields as $field ) {
+ $value = acf_get_value( $post_id, $field );
+
+ // Make sure we got a value (i.e. $allow_load = true).
+ if ( ! $store->has( "{$post_id}:{$field['name']}" ) ) {
+ continue;
+ }
+
+ $store->set( "{$block_id}:{$field['name']}", $value );
+
+ $values[ $field['name'] ] = $value;
+ $values[ '_' . $field['name'] ] = $field['key']; // TODO: Is there a better way to generate this?
+ }
+
+ $block['data'] = $values;
+
+ acf_set_data( $block_id . '_loaded_meta_values', true );
+
+ return $block;
+}
+
+/**
+ * Stores ACF field values in post meta for any blocks configured to do so.
+ *
+ * @since 6.3
+ *
+ * @param integer $post_id The ID of the post being saved.
+ * @param WP_Post $post The post object.
+ * @return void
+ */
+function acf_save_block_meta_values( $post_id, $post ) {
+ $meta_values = acf_get_block_meta_values_to_save( $post->post_content );
+
+ if ( empty( $meta_values ) ) {
+ return;
+ }
+
+ // Save values for any post meta blocks.
+ acf_save_post( $post_id, $meta_values );
+}
+add_action( 'save_post', 'acf_save_block_meta_values', 10, 2 );
+
+/**
+ * Iterates over blocks in post content and retrieves values
+ * that need to be saved to post meta.
+ *
+ * @since 6.3
+ *
+ * @param string $content The content saved for the post.
+ * @return array An array containing the field values that need to be saved.
+ */
+function acf_get_block_meta_values_to_save( $content = '' ) {
+ $meta_values = array();
+
+ // Bail early if not in a format we expect or if it has no blocks.
+ if ( ! is_string( $content ) || empty( $content ) || ! has_blocks( $content ) ) {
+ return $meta_values;
+ }
+
+ $blocks = parse_blocks( $content );
+
+ // Bail if no blocks to save.
+ if ( ! is_array( $blocks ) || empty( $blocks ) ) {
+ return $meta_values;
+ }
+
+ foreach ( $blocks as $block ) {
+ // Verify this is an ACF block that should save to meta.
+ if ( ! acf_block_uses_post_meta( $block['attrs'] ) ) {
+ continue;
+ }
+
+ // We need a block ID to retrieve the values from cache.
+ $block_id = ! empty( $block['attrs']['id'] ) ? $block['attrs']['id'] : false;
+ if ( ! $block_id ) {
+ continue;
+ }
+
+ // Verify that we have values for this block.
+ $store = acf_get_store( 'block-meta-values' );
+ if ( ! $store->has( $block_id ) ) {
+ continue;
+ }
+
+ // Get the values and remove from cache.
+ $block_values = $store->get( $block_id );
+ $store->remove( $block_id );
+
+ $meta_values = array_merge( $meta_values, $block_values );
+ }
+
+ return $meta_values;
+}
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-clone.php b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-clone.php
new file mode 100644
index 00000000..db9b2f32
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-clone.php
@@ -0,0 +1,1252 @@
+name = 'clone';
+ $this->label = _x( 'Clone', 'noun', 'acf' );
+ $this->category = 'layout';
+ $this->description = __( 'Allows you to select and display existing fields. It does not duplicate any fields in the database, but loads and displays the selected fields at run-time. The Clone field can either replace itself with the selected fields or display the selected fields as a group of subfields.', 'acf' );
+ $this->preview_image = acf_get_url() . '/assets/images/field-type-previews/field-preview-clone.png';
+ $this->doc_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/clone/', 'docs', 'field-type-selection' );
+ $this->tutorial_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/how-to-use-the-clone-field/', 'docs', 'field-type-selection' );
+ $this->pro = true;
+ $this->supports = array( 'bindings' => false );
+ $this->defaults = array(
+ 'clone' => '',
+ 'prefix_label' => 0,
+ 'prefix_name' => 0,
+ 'display' => 'seamless',
+ 'layout' => 'block',
+ );
+ $this->have_rows = 'single';
+
+ // register filter
+ acf_enable_filter( 'clone' );
+
+ // ajax
+ add_action( 'wp_ajax_acf/fields/clone/query', array( $this, 'ajax_query' ) );
+
+ // filters
+ add_filter( 'acf/get_fields', array( $this, 'acf_get_fields' ), 5, 2 );
+ add_filter( 'acf/prepare_field', array( $this, 'acf_prepare_field' ), 10, 1 );
+ add_filter( 'acf/clone_field', array( $this, 'acf_clone_field' ), 10, 2 );
+ }
+
+
+ /**
+ * This function will return true if acf_local functionality is enabled
+ *
+ * @type function
+ * @date 14/07/2016
+ * @since 5.4.0
+ *
+ * @param n/a
+ * @return n/a
+ */
+ function is_enabled() {
+
+ return acf_is_filter_enabled( 'clone' );
+ }
+
+
+ /**
+ * This filter is appied to the $field after it is loaded from the database
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $field - the field array holding all the field options
+ *
+ * @return $field - the field array holding all the field options
+ */
+ function load_field( $field ) {
+
+ // bail early if not enabled
+ if ( ! $this->is_enabled() ) {
+ return $field;
+ }
+
+ // load sub fields
+ // - sub field name's will be modified to include prefix_name settings
+ $field['sub_fields'] = $this->get_cloned_fields( $field );
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * This function will hook into the 'acf/get_fields' filter and inject/replace seamless clones fields
+ *
+ * @type function
+ * @date 17/06/2016
+ * @since 5.3.8
+ *
+ * @param $fields (array)
+ * @param $parent (array)
+ * @return $fields
+ */
+ function acf_get_fields( $fields, $parent ) {
+
+ // bail early if empty
+ if ( empty( $fields ) ) {
+ return $fields;
+ }
+
+ // bail early if not enabled
+ if ( ! $this->is_enabled() ) {
+ return $fields;
+ }
+
+ // vars
+ $i = 0;
+
+ // loop
+ while ( $i < count( $fields ) ) {
+
+ // vars
+ $field = $fields[ $i ];
+
+ // $i
+ ++$i;
+
+ // bail early if not a clone field
+ if ( $field['type'] != 'clone' ) {
+ continue;
+ }
+
+ // bail early if not seamless
+ if ( $field['display'] != 'seamless' ) {
+ continue;
+ }
+
+ // bail early if sub_fields isn't set or not an array
+ if ( ! isset( $field['sub_fields'] ) || ! is_array( $field['sub_fields'] ) ) {
+ continue;
+ }
+
+ // replace this clone field with sub fields
+ --$i;
+ array_splice( $fields, $i, 1, $field['sub_fields'] );
+ }
+
+ // return
+ return $fields;
+ }
+
+
+ /**
+ * This function will return an array of fields for a given clone field
+ *
+ * @type function
+ * @date 28/06/2016
+ * @since 5.3.8
+ *
+ * @param $field (array)
+ * @param $parent (array)
+ * @return (array)
+ */
+ function get_cloned_fields( $field ) {
+
+ // vars
+ $fields = array();
+
+ // bail early if no clone setting
+ if ( empty( $field['clone'] ) ) {
+ return $fields;
+ }
+
+ // bail early if already cloning this field (avoid infinite looping)
+ if ( isset( $this->cloning[ $field['key'] ] ) ) {
+ return $fields;
+ }
+
+ // update local ref
+ $this->cloning[ $field['key'] ] = 1;
+
+ // Loop over selectors and load fields.
+ foreach ( $field['clone'] as $selector ) {
+
+ // Field Group selector.
+ if ( acf_is_field_group_key( $selector ) ) {
+ $field_group = acf_get_field_group( $selector );
+ if ( ! $field_group ) {
+ continue;
+ }
+
+ $field_group_fields = acf_get_fields( $field_group );
+ if ( ! $field_group_fields ) {
+ continue;
+ }
+
+ $fields = array_merge( $fields, $field_group_fields );
+
+ // Field selector.
+ } elseif ( acf_is_field_key( $selector ) ) {
+ $fields[] = acf_get_field( $selector );
+ }
+ }
+
+ // field has ve been loaded for this $parent, time to remove cloning ref
+ unset( $this->cloning[ $field['key'] ] );
+
+ // clear false values (fields that don't exist)
+ $fields = array_filter( $fields );
+
+ // bail early if no sub fields
+ if ( empty( $fields ) ) {
+ return array();
+ }
+
+ // loop
+ // run acf_clone_field() on each cloned field to modify name, key, etc
+ foreach ( array_keys( $fields ) as $i ) {
+ $fields[ $i ] = acf_clone_field( $fields[ $i ], $field );
+ }
+
+ // return
+ return $fields;
+ }
+
+
+ /**
+ * This function is run when cloning a clone field
+ * Important to run the acf_clone_field function on sub fields to pass on settings such as 'parent_layout'
+ *
+ * @type function
+ * @date 28/06/2016
+ * @since 5.3.8
+ *
+ * @param $field (array)
+ * @param $clone_field (array)
+ * @return $field
+ */
+ function acf_clone_field( $field, $clone_field ) {
+
+ // bail early if this field is being cloned by some other kind of field (future proof)
+ if ( $clone_field['type'] != 'clone' ) {
+ return $field;
+ }
+
+ // backup (used later)
+ // - backup only once (cloned clone fields can cause issues)
+ if ( ! isset( $field['__key'] ) ) {
+ $field['__key'] = $field['key'];
+ $field['__name'] = $field['_name'];
+ $field['__label'] = $field['label'];
+ }
+
+ // seamless
+ if ( $clone_field['display'] == 'seamless' ) {
+
+ // modify key
+ // - this will allow sub clone fields to correctly load values for the same cloned field
+ // - the original key will later be restored by acf/prepare_field allowing conditional logic JS to work
+ $field['key'] = $clone_field['key'] . '_' . $field['key'];
+
+ // modify prefix allowing clone field to save sub fields
+ // - only used for parent seamless fields. Block or sub field's prefix will be overriden which also works
+ $field['prefix'] = $clone_field['prefix'] . '[' . $clone_field['key'] . ']';
+
+ // modify parent
+ $field['parent'] = $clone_field['parent'];
+
+ // label_format
+ if ( $clone_field['prefix_label'] ) {
+ $field['label'] = $clone_field['label'] . ' ' . $field['label'];
+ }
+ }
+
+ // prefix_name
+ if ( $clone_field['prefix_name'] ) {
+
+ // modify the field name
+ // - this will allow field to load / save correctly
+ $field['name'] = $clone_field['name'] . '_' . $field['_name'];
+
+ // modify the field _name (orig name)
+ // - this will allow fields to correctly understand the modified field
+ if ( $clone_field['display'] == 'seamless' ) {
+ $field['_name'] = $clone_field['_name'] . '_' . $field['_name'];
+ }
+ }
+
+ // required
+ if ( $clone_field['required'] ) {
+ $field['required'] = 1;
+ }
+
+ // type specific
+ // note: seamless clone fields will not be triggered
+ if ( $field['type'] == 'clone' ) {
+ $field = $this->acf_clone_clone_field( $field, $clone_field );
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * This function is run when cloning a clone field
+ * Important to run the acf_clone_field function on sub fields to pass on settings such as 'parent_layout'
+ * Do not delete! Removing this logic causes major issues with cloned clone fields within a flexible content layout.
+ *
+ * @type function
+ * @date 28/06/2016
+ * @since 5.3.8
+ *
+ * @param $field (array)
+ * @param $clone_field (array)
+ * @return $field
+ */
+ function acf_clone_clone_field( $field, $clone_field ) {
+
+ // modify the $clone_field name
+ // This seems odd, however, the $clone_field is later passed into the acf_clone_field() function
+ // Do not delete!
+ // when cloning a clone field, it is important to also change the _name too
+ // this allows sub clone fields to appear correctly in get_row() row array
+ if ( $field['prefix_name'] ) {
+ $clone_field['name'] = $field['_name'];
+ $clone_field['_name'] = $field['_name'];
+ }
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return $field;
+ }
+
+ // loop
+ foreach ( $field['sub_fields'] as &$sub_field ) {
+
+ // clone
+ $sub_field = acf_clone_field( $sub_field, $clone_field );
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 4/11/16
+ * @since 5.5.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function prepare_field_for_db( $field ) {
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return $field;
+ }
+
+ // bail early if name == _name
+ // this is a parent clone field and does not require any modification to sub field names
+ if ( $field['name'] == $field['_name'] ) {
+ return $field;
+ }
+
+ // this is a sub field
+ // _name = 'my_field'
+ // name = 'rep_0_my_field'
+ // modify all sub fields to add 'rep_0_' name prefix (prefix_name setting has already been applied)
+ $length = strlen( $field['_name'] );
+ $prefix = substr( $field['name'], 0, -$length );
+
+ // bail early if _name is not found at the end of name (unknown potential error)
+ if ( $prefix . $field['_name'] !== $field['name'] ) {
+ return $field;
+ }
+
+ // acf_log('== prepare_field_for_db ==');
+ // acf_log('- clone name:', $field['name']);
+ // acf_log('- clone _name:', $field['_name']);
+ // loop
+ foreach ( $field['sub_fields'] as &$sub_field ) {
+ $sub_field['name'] = $prefix . $sub_field['name'];
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * This filter is applied to the $value after it is loaded from the db
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $value (mixed) the value found in the database
+ * @param $post_id (mixed) the post_id from which the value was loaded
+ * @param $field (array) the field array holding all the field options
+ * @return $value
+ */
+ function load_value( $value, $post_id, $field ) {
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return $value;
+ }
+
+ // modify names
+ $field = $this->prepare_field_for_db( $field );
+
+ // load sub fields
+ $value = array();
+
+ // loop
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // add value
+ $value[ $sub_field['key'] ] = acf_get_value( $post_id, $sub_field );
+ }
+
+ // return
+ return $value;
+ }
+
+
+ /**
+ * This filter is appied to the $value after it is loaded from the db and before it is returned to the template
+ *
+ * @type filter
+ * @since 3.6
+ *
+ * @param mixed $value The value which was loaded from the database.
+ * @param mixed $post_id The $post_id from which the value was loaded.
+ * @param array $field The field array holding all the field options.
+ * @param boolean $escape_html Should the field return a HTML safe formatted value.
+ * @return mixed $value The modified value.
+ */
+ public function format_value( $value, $post_id, $field, $escape_html = false ) {
+
+ // bail early if no value
+ if ( empty( $value ) ) {
+ return false;
+ }
+
+ // modify names
+ $field = $this->prepare_field_for_db( $field );
+
+ // loop
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // extract value
+ $sub_value = acf_extract_var( $value, $sub_field['key'] );
+
+ // format value
+ $sub_value = acf_format_value( $sub_value, $post_id, $sub_field, $escape_html );
+
+ // append to $row
+ $value[ $sub_field['__name'] ] = $sub_value;
+ }
+
+ // return
+ return $value;
+ }
+
+ /**
+ * Apply basic formatting to prepare the value for default REST output.
+ *
+ * @param mixed $value
+ * @param string|integer $post_id
+ * @param array $field
+ * @return mixed
+ */
+ public function format_value_for_rest( $value, $post_id, array $field ) {
+ if ( empty( $value ) || ! is_array( $value ) ) {
+ return $value;
+ }
+
+ if ( ! is_array( $field ) || ! isset( $field['sub_fields'] ) || ! is_array( $field['sub_fields'] ) ) {
+ return $value;
+ }
+
+ // Loop through each row and within that, each sub field to process sub fields individually.
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // Extract the sub field 'field_key'=>'value' pair from the $value and format it.
+ $sub_value = acf_extract_var( $value, $sub_field['key'] );
+ $sub_value = acf_format_value_for_rest( $sub_value, $post_id, $sub_field );
+
+ // Add the sub field value back to the $value but mapped to the field name instead
+ // of the key reference.
+ $value[ $sub_field['name'] ] = $sub_value;
+ }
+
+ return $value;
+ }
+
+ /**
+ * This filter is appied to the $value before it is updated in the db
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $value - the value which will be saved in the database
+ * @param $field - the field array holding all the field options
+ * @param $post_id - the post_id of which the value will be saved
+ *
+ * @return $value - the modified value
+ */
+ function update_value( $value, $post_id, $field ) {
+
+ // bail early if no value
+ if ( ! acf_is_array( $value ) ) {
+ return null;
+ }
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return null;
+ }
+
+ // modify names
+ $field = $this->prepare_field_for_db( $field );
+
+ // loop
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // vars
+ $v = false;
+
+ // key (backend)
+ if ( isset( $value[ $sub_field['key'] ] ) ) {
+ $v = $value[ $sub_field['key'] ];
+
+ // name (frontend)
+ } elseif ( isset( $value[ $sub_field['_name'] ] ) ) {
+ $v = $value[ $sub_field['_name'] ];
+
+ // empty
+ } else {
+
+ // input is not set (hidden by conditioanl logic)
+ continue;
+ }
+
+ // restore original field key
+ $sub_field = $this->acf_prepare_field( $sub_field );
+
+ // update value
+ acf_update_value( $v, $post_id, $sub_field );
+ }
+
+ // return
+ return '';
+ }
+
+
+ /**
+ * Create the HTML interface for your field
+ *
+ * @param $field - an array holding all the field's data
+ *
+ * @type action
+ * @since 3.6
+ * @date 23/01/13
+ */
+ function render_field( $field ) {
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return;
+ }
+
+ // load values
+ foreach ( $field['sub_fields'] as &$sub_field ) {
+
+ // add value
+ if ( isset( $field['value'][ $sub_field['key'] ] ) ) {
+
+ // this is a normal value
+ $sub_field['value'] = $field['value'][ $sub_field['key'] ];
+ } elseif ( isset( $sub_field['default_value'] ) ) {
+
+ // no value, but this sub field has a default value
+ $sub_field['value'] = $sub_field['default_value'];
+ }
+
+ // update prefix to allow for nested values
+ $sub_field['prefix'] = $field['name'];
+
+ // restore label
+ $sub_field['label'] = $sub_field['__label'];
+
+ // restore required
+ if ( $field['required'] ) {
+ $sub_field['required'] = 0;
+ }
+ }
+
+ // render
+ if ( $field['layout'] == 'table' ) {
+ $this->render_field_table( $field );
+ } else {
+ $this->render_field_block( $field );
+ }
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 12/07/2016
+ * @since 5.4.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function render_field_block( $field ) {
+
+ // vars
+ $label_placement = $field['layout'] == 'block' ? 'top' : 'left';
+
+ // html
+ echo '';
+
+ foreach ( $field['sub_fields'] as $sub_field ) {
+ acf_render_field_wrap( $sub_field );
+ }
+
+ echo '
';
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 12/07/2016
+ * @since 5.4.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function render_field_table( $field ) {
+
+ ?>
+| > + + + | + +
|---|
+
+ __( 'Minimum Layouts', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'min',
+ )
+ );
+
+ // max
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Maximum Layouts', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'max',
+ )
+ );
+
+ // add new row label
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Button Label', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'text',
+ 'name' => 'button_label',
+ )
+ );
+ }
+
+ /**
+ * Filters the $value after it is loaded from the database.
+ *
+ * @since 3.6
+ *
+ * @param mixed $value The value found in the database
+ * @param mixed $post_id The post_id from which the value was loaded
+ * @param array $field The field array holding all the field options
+ * @return $value
+ */
+ public function load_value( $value, $post_id, $field ) {
+ // bail early if no value
+ if ( empty( $value ) || empty( $field['layouts'] ) ) {
+ return $value;
+ }
+
+ $value = acf_get_array( $value );
+ $disabled_layouts = $this->get_disabled_layouts( $post_id, $field );
+ $rows = array();
+ $layouts = array();
+
+ // sort layouts into names
+ foreach ( $field['layouts'] as $k => $layout ) {
+ $layouts[ $layout['name'] ] = $layout['sub_fields'];
+ }
+
+ // loop through rows
+ foreach ( $value as $i => $l ) {
+ // If the layout is disabled, prevent it from showing up on the frontend.
+ if ( $this->should_disable_layout( $i, $disabled_layouts ) ) {
+ continue;
+ }
+
+ // append to $values
+ $rows[ $i ] = array();
+ $rows[ $i ]['acf_fc_layout'] = $l;
+
+ // bail early if layout deosnt contain sub fields
+ if ( empty( $layouts[ $l ] ) ) {
+ continue;
+ }
+
+ // get layout
+ $layout = $layouts[ $l ];
+
+ // loop through sub fields
+ foreach ( array_keys( $layout ) as $j ) {
+
+ // get sub field
+ $sub_field = $layout[ $j ];
+
+ // bail early if no name (tab)
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // update full name
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // get value
+ $sub_value = acf_get_value( $post_id, $sub_field );
+
+ // add value
+ $rows[ $i ][ $sub_field['key'] ] = $sub_value;
+ }
+ }
+
+ return $rows;
+ }
+
+ /**
+ * Checks if a layout should be disabled based on the provided index and disabled layouts.
+ *
+ * @since 6.5
+ *
+ * @param integer|string $layout_index The index of the layout to check.
+ * @param array $disabled_layouts The array of disabled layout indices.
+ * @return boolean
+ */
+ private function should_disable_layout( $layout_index, $disabled_layouts = array() ): bool {
+ // No disabled layouts provided, so no need to disable.
+ if ( ! is_array( $disabled_layouts ) || empty( $disabled_layouts ) ) {
+ return false;
+ }
+
+ // The layout is not in the disabled list, so no need to disable.
+ if ( ! in_array( $layout_index, $disabled_layouts, true ) ) {
+ return false;
+ }
+
+ if ( is_admin() ) {
+ $args = acf_request_args(
+ array(
+ 'action' => '',
+ 'query' => '',
+ )
+ );
+
+ // If this is a block preview, disable the layout.
+ if ( ( $args['action'] === 'acf/ajax/fetch-block' && ! empty( $args['query']['preview'] ) ) ||
+ acf_get_data( 'acf_doing_block_preview' ) ) {
+ return true;
+ }
+
+ // Editing a layout in the admin, so don't disable it.
+ return false;
+ }
+
+ // The layout has been disabled, and we're on the frontend.
+ return true;
+ }
+
+ /**
+ * This filter is appied to the $value after it is loaded from the db and before it is returned to the template
+ *
+ * @type filter
+ * @since 3.6
+ *
+ * @param mixed $value The value which was loaded from the database.
+ * @param mixed $post_id The $post_id from which the value was loaded.
+ * @param array $field The field array holding all the field options.
+ * @param boolean $escape_html Should the field return a HTML safe formatted value.
+ * @return mixed $value The modified value.
+ */
+ public function format_value( $value, $post_id, $field, $escape_html = false ) {
+
+ // bail early if no value
+ if ( empty( $value ) || empty( $field['layouts'] ) ) {
+ return false;
+ }
+
+ // sort layouts into names
+ $layouts = array();
+ foreach ( $field['layouts'] as $k => $layout ) {
+ $layouts[ $layout['name'] ] = $layout['sub_fields'];
+ }
+
+ // loop over rows
+ foreach ( array_keys( $value ) as $i ) {
+
+ // get layout name
+ $l = $value[ $i ]['acf_fc_layout'];
+
+ // bail early if layout deosnt exist
+ if ( empty( $layouts[ $l ] ) ) {
+ continue;
+ }
+
+ // get layout
+ $layout = $layouts[ $l ];
+
+ // loop through sub fields
+ foreach ( array_keys( $layout ) as $j ) {
+
+ // get sub field
+ $sub_field = $layout[ $j ];
+
+ // bail early if no name (tab)
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // extract value
+ $sub_value = acf_extract_var( $value[ $i ], $sub_field['key'] );
+
+ // update $sub_field name
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // format value
+ $sub_value = acf_format_value( $sub_value, $post_id, $sub_field, $escape_html );
+
+ // append to $row
+ $value[ $i ][ $sub_field['_name'] ] = $sub_value;
+ }
+ }
+
+ // return
+ return $value;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 11/02/2014
+ * @since 5.0.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ public function validate_value( $valid, $value, $field, $input ) {
+ // vars
+ $count = 0;
+
+ // check if is value (may be empty string)
+ if ( is_array( $value ) ) {
+
+ // remove acfcloneindex
+ if ( isset( $value['acfcloneindex'] ) ) {
+ unset( $value['acfcloneindex'] );
+ }
+
+ foreach ( $value as $row_value ) {
+ // Don't count disabled rows;
+ if ( ! empty( $row_value['acf_fc_layout_disabled'] ) ) {
+ continue;
+ }
+ ++$count;
+ }
+ }
+
+ // validate required
+ if ( $field['required'] && ! $count ) {
+ $valid = false;
+ }
+
+ // validate min
+ $min = (int) $field['min'];
+ if ( $min && $count < $min ) {
+
+ // vars
+ $error = __( 'This field requires at least {min} {label} {identifier}', 'acf' );
+ $identifier = _n( 'layout', 'layouts', $min, 'acf' );
+
+ // replace
+ $error = str_replace( '{min}', $min, $error );
+ $error = str_replace( '{label}', '', $error );
+ $error = str_replace( '{identifier}', $identifier, $error );
+
+ // return
+ return $error;
+ }
+
+ // find layouts
+ $layouts = array();
+ foreach ( array_keys( $field['layouts'] ) as $i ) {
+
+ // vars
+ $layout = $field['layouts'][ $i ];
+
+ // add count
+ $layout['count'] = 0;
+
+ // append
+ $layouts[ $layout['name'] ] = $layout;
+ }
+
+ // validate value
+ if ( $count ) {
+
+ // loop rows
+ foreach ( $value as $i => $row ) {
+ // ensure row is an array
+ if ( ! is_array( $row ) ) {
+ continue;
+ }
+
+ if ( ! empty( $row['acf_fc_layout_disabled'] ) ) {
+ continue;
+ }
+
+ // get layout
+ $l = $row['acf_fc_layout'];
+
+ // bail if layout doesn't exist
+ if ( ! isset( $layouts[ $l ] ) ) {
+ continue;
+ }
+
+ // increase count
+ ++$layouts[ $l ]['count'];
+
+ // bail if no sub fields
+ if ( empty( $layouts[ $l ]['sub_fields'] ) ) {
+ continue;
+ }
+
+ // loop sub fields
+ foreach ( $layouts[ $l ]['sub_fields'] as $sub_field ) {
+
+ // get sub field key
+ $k = $sub_field['key'];
+
+ // bail if no value
+ if ( ! isset( $value[ $i ][ $k ] ) ) {
+ continue;
+ }
+
+ // validate
+ acf_validate_value( $value[ $i ][ $k ], $sub_field, "{$input}[{$i}][{$k}]" );
+ }
+ // end loop sub fields
+ }
+ // end loop rows
+ }
+
+ // validate layouts
+ foreach ( $layouts as $layout ) {
+
+ // validate min / max
+ $min = (int) $layout['min'];
+ $count = $layout['count'];
+ $label = $layout['label'];
+
+ if ( $min && $count < $min ) {
+
+ // vars
+ $error = __( 'This field requires at least {min} {label} {identifier}', 'acf' );
+ $identifier = _n( 'layout', 'layouts', $min, 'acf' );
+
+ // replace
+ $error = str_replace( '{min}', $min, $error );
+ $error = str_replace( '{label}', '"' . $label . '"', $error );
+ $error = str_replace( '{identifier}', $identifier, $error );
+
+ // return
+ return $error;
+ }
+ }
+
+ // return
+ return $valid;
+ }
+
+
+ /**
+ * This function will return a specific layout by name from a field
+ *
+ * @since 5.5.8
+ *
+ * @param string $name The layout name.
+ * @param array $field The field to load the layout from.
+ * @return array|false
+ */
+ public function get_layout( $name, $field ) {
+
+ // bail early if no layouts
+ if ( ! isset( $field['layouts'] ) ) {
+ return false;
+ }
+
+ // loop
+ foreach ( $field['layouts'] as $layout ) {
+
+ // match
+ if ( $layout['name'] === $name ) {
+ return $layout;
+ }
+ }
+
+ // return
+ return false;
+ }
+
+ /**
+ * Retrieves layout meta for the Flexible Content field saved to the provided post.
+ *
+ * @since 6.5
+ *
+ * @param integer|string $post_id The ID of the post being edited.
+ * @param array $field The Flexible Content field array.
+ * @return array
+ */
+ public function get_layout_meta( $post_id, $field ) {
+ $field_name = $field['name'];
+
+ // Enables compatibility with nested Flexible Content fields during render.
+ if ( ! empty( $field['_prepare'] ) ) {
+ $field_name = acf_get_field_type( 'repeater' )->get_field_name_from_input_name( $field_name );
+ }
+
+ // Bail early if we don't have a field name to check.
+ if ( empty( $field_name ) ) {
+ return array();
+ }
+
+ // Return the cached meta if we have it.
+ $cache_key = "$post_id:$field_name";
+ if ( ! empty( $this->layout_meta[ $cache_key ] ) ) {
+ return $this->layout_meta[ $cache_key ];
+ }
+
+ $layout_meta = acf_get_metadata_by_field(
+ $post_id,
+ array(
+ 'name' => '_' . $field_name . '_layout_meta',
+ )
+ );
+
+ if ( empty( $layout_meta ) || ! is_array( $layout_meta ) ) {
+ return array();
+ }
+
+ $this->layout_meta[ $cache_key ] = $layout_meta;
+
+ return $this->layout_meta[ $cache_key ];
+ }
+
+ /**
+ * Returns an array of layouts that have been disabled for the current field.
+ *
+ * @since 6.5
+ *
+ * @param integer|string $post_id The ID of the post being edited.
+ * @param array $field The Flexible Content field array.
+ * @return array
+ */
+ public function get_disabled_layouts( $post_id, $field ): array {
+ $layout_meta = $this->get_layout_meta( $post_id, $field );
+
+ if ( empty( $layout_meta['disabled'] ) || ! is_array( $layout_meta['disabled'] ) ) {
+ return array();
+ }
+
+ return $layout_meta['disabled'];
+ }
+
+ /**
+ * Returns an array of layouts that have been renamed for the current field.
+ *
+ * @since 6.5
+ *
+ * @param integer|string $post_id The ID of the post being edited.
+ * @param array $field The Flexible Content field array.
+ * @return array
+ */
+ public function get_renamed_layouts( $post_id, $field ): array {
+ $layout_meta = $this->get_layout_meta( $post_id, $field );
+
+ if ( empty( $layout_meta['renamed'] ) || ! is_array( $layout_meta['renamed'] ) ) {
+ return array();
+ }
+
+ return $layout_meta['renamed'];
+ }
+
+ /**
+ * This function will delete a value row
+ *
+ * @date 15/2/17
+ * @since 5.5.8
+ *
+ * @param integer $i
+ * @param array $field
+ * @param mixed $post_id
+ * @return boolean
+ */
+ public function delete_row( $i, $field, $post_id ) {
+
+ // vars
+ $value = acf_get_metadata_by_field( $post_id, $field );
+
+ // bail early if no value
+ if ( ! is_array( $value ) || ! isset( $value[ $i ] ) ) {
+ return false;
+ }
+
+ // get layout
+ $layout = $this->get_layout( $value[ $i ], $field );
+
+ // bail early if no layout
+ if ( ! $layout || empty( $layout['sub_fields'] ) ) {
+ return false;
+ }
+
+ // loop
+ foreach ( $layout['sub_fields'] as $sub_field ) {
+
+ // modify name for delete
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // delete value
+ acf_delete_value( $post_id, $sub_field );
+ }
+
+ // return
+ return true;
+ }
+
+ /**
+ * This function will update a value row
+ *
+ * @date 15/2/17
+ * @since 5.5.8
+ *
+ * @param array $row
+ * @param integer $i
+ * @param array $field
+ * @param mixed $post_id
+ * @return boolean
+ */
+ public function update_row( $row, $i, $field, $post_id ) {
+ // bail early if no layout reference
+ if ( ! is_array( $row ) || ! isset( $row['acf_fc_layout'] ) ) {
+ return false;
+ }
+
+ // get layout
+ $layout = $this->get_layout( $row['acf_fc_layout'], $field );
+
+ // bail early if no layout
+ if ( ! $layout || empty( $layout['sub_fields'] ) ) {
+ return false;
+ }
+
+ foreach ( $layout['sub_fields'] as $sub_field ) {
+ $value = null;
+
+ if ( array_key_exists( $sub_field['key'], $row ) ) {
+ $value = $row[ $sub_field['key'] ];
+ } elseif ( array_key_exists( $sub_field['name'], $row ) ) {
+ $value = $row[ $sub_field['name'] ];
+ } else {
+ // Value does not exist.
+ continue;
+ }
+
+ // modify name for save
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // update field
+ acf_update_value( $value, $post_id, $sub_field );
+ }
+
+ return true;
+ }
+
+ /**
+ * Filters the $value before it is updated in the database.
+ *
+ * @since 3.6
+ *
+ * @param mixed $value The value which will be saved in the database
+ * @param mixed $post_id The post_id of which the value will be saved
+ * @param array $field The field array holding all the field options
+ * @return mixed $value The modified value
+ */
+ public function update_value( $value, $post_id, $field ) {
+ // Bail early if no layouts or field name.
+ if ( empty( $field['layouts'] ) || empty( $field['name'] ) ) {
+ return $value;
+ }
+
+ // vars
+ $new_value = array();
+ $disabled_layouts = array();
+ $renamed_layouts = array();
+ $old_value = acf_get_metadata_by_field( $post_id, $field );
+ $old_value = is_array( $old_value ) ? $old_value : array();
+
+ // update
+ if ( ! empty( $value ) ) {
+ $i = -1;
+
+ // remove acfcloneindex
+ if ( isset( $value['acfcloneindex'] ) ) {
+ unset( $value['acfcloneindex'] );
+ }
+
+ // loop through rows
+ foreach ( $value as $row ) {
+ ++$i;
+
+ // bail early if no layout reference
+ if ( ! is_array( $row ) || ! isset( $row['acf_fc_layout'] ) ) {
+ continue;
+ }
+
+ // delete old row if layout has changed
+ if ( isset( $old_value[ $i ] ) && $old_value[ $i ] !== $row['acf_fc_layout'] ) {
+ $this->delete_row( $i, $field, $post_id );
+ }
+
+ if ( ! empty( $row['acf_fc_layout_disabled'] ) ) {
+ $disabled_layouts[] = $i;
+ }
+ unset( $row['acf_fc_layout_disabled'] );
+
+ if ( ! empty( $row['acf_fc_layout_custom_label'] ) ) {
+ $renamed_layouts[ $i ] = $row['acf_fc_layout_custom_label'];
+ }
+ unset( $row['acf_fc_layout_custom_label'] );
+
+ // update row
+ $this->update_row( $row, $i, $field, $post_id );
+
+ // append to order
+ $new_value[] = $row['acf_fc_layout'];
+ }
+ }
+
+ // vars
+ $old_count = empty( $old_value ) ? 0 : count( $old_value );
+ $new_count = empty( $new_value ) ? 0 : count( $new_value );
+
+ // Update layout meta.
+ acf_update_metadata_by_field(
+ $post_id,
+ array(
+ 'name' => '_' . $field['name'] . '_layout_meta',
+ ),
+ array(
+ 'disabled' => $disabled_layouts,
+ 'renamed' => $renamed_layouts,
+ )
+ );
+
+ // remove old rows
+ if ( $old_count > $new_count ) {
+
+ // loop
+ for ( $i = $new_count; $i < $old_count; $i++ ) {
+ $this->delete_row( $i, $field, $post_id );
+ }
+ }
+
+ // save false for empty value
+ if ( empty( $new_value ) ) {
+ $new_value = '';
+ }
+
+ // return
+ return $new_value;
+ }
+
+
+ /**
+ * Deletes a layout from a flexible content field.
+ *
+ * @type function
+ * @date 1/07/2015
+ * @since 5.2.3
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ public function delete_value( $post_id, $key, $field ) {
+
+ // vars
+ $old_value = acf_get_metadata_by_field( $post_id, $field['name'] );
+ $old_value = is_array( $old_value ) ? $old_value : array();
+
+ // bail early if no rows or no sub fields
+ if ( empty( $old_value ) ) {
+ return;
+ }
+
+ // loop
+ foreach ( array_keys( $old_value ) as $i ) {
+ $this->delete_row( $i, $field, $post_id );
+ }
+ }
+
+
+ /**
+ * This filter is appied to the $field before it is saved to the database
+ *
+ * @type filter
+ * @since 3.6
+ *
+ * @param array $field The field array holding all the field options
+ * @return array $field The modified field
+ */
+ public function update_field( $field ) {
+
+ // loop
+ if ( ! empty( $field['layouts'] ) ) {
+ foreach ( $field['layouts'] as &$layout ) {
+ unset( $layout['sub_fields'] );
+ }
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 4/04/2014
+ * @since 5.0.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function delete_field( $field ) {
+
+ if ( ! empty( $field['layouts'] ) ) {
+
+ // loop through layouts
+ foreach ( $field['layouts'] as $layout ) {
+
+ // loop through sub fields
+ if ( ! empty( $layout['sub_fields'] ) ) {
+ foreach ( $layout['sub_fields'] as $sub_field ) {
+ acf_delete_field( $sub_field['ID'] );
+ }
+ // foreach
+ }
+ // if
+ }
+ // foreach
+ }
+ // if
+ }
+
+
+ /**
+ * This filter is appied to the $field before it is duplicated and saved to the database
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $field - the field array holding all the field options
+ *
+ * @return $field - the modified field
+ */
+ function duplicate_field( $field ) {
+
+ // vars
+ $sub_fields = array();
+
+ if ( ! empty( $field['layouts'] ) ) {
+
+ // loop through layouts
+ foreach ( $field['layouts'] as $layout ) {
+
+ // extract sub fields
+ $extra = acf_extract_var( $layout, 'sub_fields' );
+
+ // merge
+ if ( ! empty( $extra ) ) {
+ $sub_fields = array_merge( $sub_fields, $extra );
+ }
+ }
+ // foreach
+ }
+
+ // save field to get ID
+ $field = acf_update_field( $field );
+
+ // duplicate sub fields
+ acf_duplicate_fields( $sub_fields, $field['ID'] );
+
+ return $field;
+ }
+
+
+ /**
+ * Output the layout title for an AJAX response.
+ *
+ * @since 5.3.2
+ */
+ public function ajax_layout_title() {
+
+ $options = acf_parse_args(
+ $_POST, // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified elsewhere.
+ array(
+ 'post_id' => 0,
+ 'i' => 0,
+ 'field_key' => '',
+ 'nonce' => '',
+ 'layout' => '',
+ 'value' => array(),
+ )
+ );
+
+ // load field
+ $field = acf_get_field( $options['field_key'] );
+ if ( ! $field ) {
+ die();
+ }
+
+ // vars
+ $layout = $this->get_layout( $options['layout'], $field );
+ if ( ! $layout ) {
+ die();
+ }
+
+ // title
+ $title = $this->get_layout_title( $field, $layout, $options['i'], $options['value'] );
+
+ // echo
+ echo acf_esc_html( $title );
+ die;
+ }
+
+ /**
+ * Get a layout title for a field.
+ *
+ * @param array $field The field array
+ * @param array $layout The layout array
+ * @param integer $i The order number of the layout
+ * @param array $value The value of the layout
+ * @return string The layout title, optionally filtered.
+ */
+ public function get_layout_title( $field, $layout, $i, $value ) {
+ $layout = new Layout( $field, $layout, $i, $value );
+ return $layout->get_title();
+ }
+
+ /**
+ * This function will update clone field settings based on the origional field
+ *
+ * @type function
+ * @date 28/06/2016
+ * @since 5.3.8
+ *
+ * @param $clone (array)
+ * @param $field (array)
+ * @return $clone
+ */
+ public function clone_any_field( $field, $clone_field ) {
+
+ // remove parent_layout
+ // - allows a sub field to be rendered as a normal field
+ unset( $field['parent_layout'] );
+
+ // attempt to merger parent_layout
+ if ( isset( $clone_field['parent_layout'] ) ) {
+ $field['parent_layout'] = $clone_field['parent_layout'];
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * Handles preparing the layouts for export.
+ *
+ * @since 5.0.0
+ *
+ * @param array $field The whole fiel array
+ * @return array The export ready field array.
+ */
+ public function prepare_field_for_export( $field ) {
+
+ // loop
+ if ( ! empty( $field['layouts'] ) ) {
+ foreach ( $field['layouts'] as &$layout ) {
+ $layout['sub_fields'] = acf_prepare_fields_for_export( $layout['sub_fields'] );
+ }
+ }
+
+ // return
+ return $field;
+ }
+
+ function prepare_any_field_for_export( $field ) {
+
+ // remove parent_layout
+ unset( $field['parent_layout'] );
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 11/03/2014
+ * @since 5.0.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ public function prepare_field_for_import( $field ) {
+
+ // Bail early if no layouts
+ if ( empty( $field['layouts'] ) ) {
+ return $field;
+ }
+
+ // Storage for extracted fields.
+ $extra = array();
+
+ // Loop over layouts.
+ foreach ( $field['layouts'] as &$layout ) {
+
+ // Ensure layout is valid.
+ $layout = $this->get_valid_layout( $layout );
+
+ // Extract sub fields.
+ $sub_fields = acf_extract_var( $layout, 'sub_fields' );
+
+ // Modify and append sub fields to $extra.
+ if ( $sub_fields ) {
+ foreach ( $sub_fields as $i => $sub_field ) {
+
+ // Update atttibutes
+ $sub_field['parent'] = $field['key'];
+ $sub_field['parent_layout'] = $layout['key'];
+ $sub_field['menu_order'] = $i;
+
+ // Append to extra.
+ $extra[] = $sub_field;
+ }
+ }
+ }
+
+ // Merge extra sub fields.
+ if ( $extra ) {
+ array_unshift( $extra, $field );
+ return $extra;
+ }
+
+ // Return field.
+ return $field;
+ }
+
+
+ /**
+ * This function will add compatibility for the 'column_width' setting
+ *
+ * @type function
+ * @date 30/1/17
+ * @since 5.5.6
+ *
+ * @param $field (array)
+ * @return $field
+ */
+ function validate_any_field( $field ) {
+
+ // width has changed
+ if ( isset( $field['column_width'] ) ) {
+ $field['wrapper']['width'] = acf_extract_var( $field, 'column_width' );
+ }
+
+ // return
+ return $field;
+ }
+
+
+ /**
+ * This function will translate field settings
+ *
+ * @type function
+ * @date 8/03/2016
+ * @since 5.3.2
+ *
+ * @param $field (array)
+ * @return $field
+ */
+ function translate_field( $field ) {
+
+ // translate
+ $field['button_label'] = acf_translate( $field['button_label'] );
+
+ // loop
+ if ( ! empty( $field['layouts'] ) ) {
+ foreach ( $field['layouts'] as &$layout ) {
+ $layout['label'] = acf_translate( $layout['label'] );
+ }
+ }
+
+ // return
+ return $field;
+ }
+
+ /**
+ * Additional validation for the flexible content field when submitted via REST.
+ *
+ * @param boolean $valid The current validity booleean
+ * @param integer $value The value of the field
+ * @param array $field The field array
+ * @return boolean|WP
+ */
+ public function validate_rest_value( $valid, $value, $field ) {
+ $param = sprintf( '%s[%s]', $field['prefix'], $field['name'] );
+ $data = array(
+ 'param' => $param,
+ 'value' => $value,
+ );
+
+ if ( ! is_array( $value ) && is_null( $value ) ) {
+ $error = sprintf( __( '%s must be of type array or null.', 'acf' ), $param );
+ return new WP_Error( 'rest_invalid_param', $error, $param );
+ }
+
+ $layouts_to_update = array_count_values( array_column( $value, 'acf_fc_layout' ) );
+
+ foreach ( $field['layouts'] as $layout ) {
+ $num_layouts = isset( $layouts_to_update[ $layout['name'] ] ) ? $layouts_to_update[ $layout['name'] ] : 0;
+
+ if ( '' !== $layout['min'] && $num_layouts < (int) $layout['min'] ) {
+ $error = sprintf(
+ _n(
+ '%1$s must contain at least %2$s %3$s layout.',
+ '%1$s must contain at least %2$s %3$s layouts.',
+ $layout['min'],
+ 'acf'
+ ),
+ $param,
+ number_format_i18n( $layout['min'] ),
+ $layout['name']
+ );
+
+ return new WP_Error( 'rest_invalid_param', $error, $data );
+ }
+
+ if ( '' !== $layout['max'] && $num_layouts > (int) $layout['max'] ) {
+ $error = sprintf(
+ _n(
+ '%1$s must contain at most %2$s %3$s layout.',
+ '%1$s must contain at most %2$s %3$s layouts.',
+ $layout['max'],
+ 'acf'
+ ),
+ $param,
+ number_format_i18n( $layout['max'] ),
+ $layout['name']
+ );
+
+ return new WP_Error( 'rest_invalid_param', $error, $data );
+ }
+ }
+
+ return $valid;
+ }
+
+ /**
+ * Return the schema array for the REST API.
+ *
+ * @param array $field
+ * @return array
+ */
+ public function get_rest_schema( array $field ) {
+ $schema = array(
+ 'type' => array( 'array', 'null' ),
+ 'required' => ! empty( $field['required'] ),
+ 'items' => array(
+ 'oneOf' => array(),
+ ),
+ );
+
+ // Loop through layouts building up a schema for each.
+ foreach ( $field['layouts'] as $layout ) {
+ $layout_schema = array(
+ 'type' => 'object',
+ 'properties' => array(
+ 'acf_fc_layout' => array(
+ 'type' => 'string',
+ 'required' => true,
+ // By using a pattern match against the layout name, data sent in must match an available
+ // layout on the flexible field. If it doesn't, a 400 Bad Request response will result.
+ 'pattern' => '^' . $layout['name'] . '$',
+ ),
+ ),
+ );
+
+ foreach ( $layout['sub_fields'] as $sub_field ) {
+ if ( $sub_field_schema = acf_get_field_rest_schema( $sub_field ) ) {
+ $layout_schema['properties'][ $sub_field['name'] ] = $sub_field_schema;
+ }
+ }
+
+ $schema['items']['oneOf'][] = $layout_schema;
+ }
+
+ if ( ! empty( $field['min'] ) ) {
+ $schema['minItems'] = (int) $field['min'];
+ }
+
+ if ( ! empty( $field['max'] ) ) {
+ $schema['maxItems'] = (int) $field['max'];
+ }
+
+ return $schema;
+ }
+
+ /**
+ * Apply basic formatting to prepare the value for default REST output.
+ *
+ * @param mixed $value
+ * @param integer|string $post_id
+ * @param array $field
+ * @return array|mixed
+ */
+ public function format_value_for_rest( $value, $post_id, array $field ) {
+ if ( empty( $value ) || ! is_array( $value ) || empty( $field['layouts'] ) ) {
+ return null;
+ }
+
+ // Create a map of layout sub fields mapped to layout names.
+ foreach ( $field['layouts'] as $layout ) {
+ $layouts[ $layout['name'] ] = $layout['sub_fields'];
+ }
+
+ // Loop through each layout and within that, each sub field to process sub fields individually.
+ foreach ( $value as &$layout ) {
+ $name = $layout['acf_fc_layout'];
+
+ if ( empty( $layouts[ $name ] ) ) {
+ continue;
+ }
+
+ foreach ( $layouts[ $name ] as $sub_field ) {
+
+ // Bail early if the field has no name (tab).
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // Extract the sub field 'field_key'=>'value' pair from the $layout and format it.
+ $sub_value = acf_extract_var( $layout, $sub_field['key'] );
+ $sub_value = acf_format_value_for_rest( $sub_value, $post_id, $sub_field );
+
+ // Add the sub field value back to the $layout but mapped to the field name instead
+ // of the key reference.
+ $layout[ $sub_field['name'] ] = $sub_value;
+ }
+ }
+
+ return $value;
+ }
+ }
+
+
+ // initialize
+ acf_register_field_type( 'acf_field_flexible_content' );
+endif; // class_exists check
+
+?>
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-gallery.php b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-gallery.php
new file mode 100644
index 00000000..bb6df3ea
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-gallery.php
@@ -0,0 +1,930 @@
+name = 'gallery';
+ $this->label = __( 'Gallery', 'acf' );
+ $this->category = 'content';
+ $this->description = __( 'An interactive interface for managing a collection of attachments, such as images.', 'acf' );
+ $this->preview_image = acf_get_url() . '/assets/images/field-type-previews/field-preview-gallery.png';
+ $this->doc_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/gallery/', 'docs', 'field-type-selection' );
+ $this->tutorial_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/how-to-use-the-gallery-field/', 'docs', 'field-type-selection' );
+ $this->pro = true;
+ $this->supports = array( 'bindings' => false );
+ $this->defaults = array(
+ 'return_format' => 'array',
+ 'preview_size' => 'medium',
+ 'insert' => 'append',
+ 'library' => 'all',
+ 'min' => 0,
+ 'max' => 0,
+ 'min_width' => 0,
+ 'min_height' => 0,
+ 'min_size' => 0,
+ 'max_width' => 0,
+ 'max_height' => 0,
+ 'max_size' => 0,
+ 'mime_types' => '',
+ );
+
+ // actions
+ add_action( 'wp_ajax_acf/fields/gallery/get_attachment', array( $this, 'ajax_get_attachment' ) );
+ add_action( 'wp_ajax_nopriv_acf/fields/gallery/get_attachment', array( $this, 'ajax_get_attachment' ) );
+
+ add_action( 'wp_ajax_acf/fields/gallery/update_attachment', array( $this, 'ajax_update_attachment' ) );
+ add_action( 'wp_ajax_nopriv_acf/fields/gallery/update_attachment', array( $this, 'ajax_update_attachment' ) );
+
+ add_action( 'wp_ajax_acf/fields/gallery/get_sort_order', array( $this, 'ajax_get_sort_order' ) );
+ add_action( 'wp_ajax_nopriv_acf/fields/gallery/get_sort_order', array( $this, 'ajax_get_sort_order' ) );
+ }
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 16/12/2015
+ * @since 5.3.2
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function input_admin_enqueue_scripts() {
+
+ // localize
+ acf_localize_text(
+ array(
+ 'Add Image to Gallery' => __( 'Add Image to Gallery', 'acf' ),
+ 'Maximum selection reached' => __( 'Maximum selection reached', 'acf' ),
+ )
+ );
+ }
+
+ /**
+ * AJAX handler for retrieving and rendering an attachment.
+ *
+ * @since 5.0.0
+ *
+ * @return void
+ */
+ public function ajax_get_attachment() {
+ // Get args.
+ $args = acf_request_args(
+ array(
+ 'id' => 0,
+ 'field_key' => '',
+ 'nonce' => '',
+ )
+ );
+
+ // Validate request.
+ if ( ! acf_verify_ajax( $args['nonce'], $args['field_key'], true ) ) {
+ die();
+ }
+
+ // Cast args.
+ $args['id'] = (int) $args['id'];
+
+ // Bail early if no id.
+ if ( ! $args['id'] ) {
+ die();
+ }
+
+ // Load field.
+ $field = acf_get_field( $args['field_key'] );
+ if ( ! $field ) {
+ die();
+ }
+
+ // Render.
+ $this->render_attachment( $args['id'], $field );
+ die;
+ }
+
+ /**
+ * AJAX handler for updating an attachment.
+ *
+ * @since 5.0.0
+ *
+ * @return void
+ */
+ public function ajax_update_attachment() {
+ $args = acf_request_args(
+ array(
+ 'nonce' => '',
+ 'field_key' => '',
+ )
+ );
+
+ if ( ! acf_verify_ajax( $args['nonce'], $args['field_key'], true ) ) {
+ wp_send_json_error();
+ }
+
+ // bail early if no attachments
+ if ( empty( $_POST['attachments'] ) ) {
+ wp_send_json_error();
+ }
+
+ // loop over attachments
+ foreach ( $_POST['attachments'] as $id => $changes ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized by WP core when saved.
+
+ if ( ! current_user_can( 'edit_post', $id ) ) {
+ wp_send_json_error();
+ }
+
+ $post = get_post( $id, ARRAY_A );
+
+ if ( 'attachment' != $post['post_type'] ) {
+ wp_send_json_error();
+ }
+
+ if ( isset( $changes['title'] ) ) {
+ $post['post_title'] = $changes['title'];
+ }
+
+ if ( isset( $changes['caption'] ) ) {
+ $post['post_excerpt'] = $changes['caption'];
+ }
+
+ if ( isset( $changes['description'] ) ) {
+ $post['post_content'] = $changes['description'];
+ }
+
+ if ( isset( $changes['alt'] ) ) {
+ $alt = wp_unslash( $changes['alt'] );
+ if ( $alt != get_post_meta( $id, '_wp_attachment_image_alt', true ) ) {
+ $alt = wp_strip_all_tags( $alt, true );
+ update_post_meta( $id, '_wp_attachment_image_alt', wp_slash( $alt ) );
+ }
+ }
+
+ // save post
+ wp_update_post( $post );
+
+ /** This filter is documented in wp-admin/includes/media.php */
+ // - seems off to run this filter AFTER the update_post function, but there is a reason
+ // - when placed BEFORE, an empty post_title will be populated by WP
+ // - this filter will still allow 3rd party to save extra image data!
+ $post = apply_filters( 'attachment_fields_to_save', $post, $changes );
+
+ // save meta
+ acf_save_post( $id );
+ }
+
+ // return
+ wp_send_json_success();
+ }
+
+ /**
+ * AJAX handler for getting the attachment sort order.
+ *
+ * @since 5.0.0
+ *
+ * @return void
+ */
+ public function ajax_get_sort_order() {
+ $order = 'DESC';
+ $args = acf_parse_args(
+ $_POST, // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified below.
+ array(
+ 'ids' => 0,
+ 'sort' => 'date',
+ 'field_key' => '',
+ 'nonce' => '',
+ )
+ );
+
+ if ( ! acf_verify_ajax( $args['nonce'], $args['field_key'], true ) ) {
+ wp_send_json_error();
+ }
+
+ // Reverse order.
+ if ( $args['sort'] === 'reverse' ) {
+ $ids = array_reverse( $args['ids'] );
+ wp_send_json_success( $ids );
+ }
+
+ // Ascending order.
+ if ( $args['sort'] === 'title' ) {
+ $order = 'ASC';
+ }
+
+ // Find attachments (DISTINCT POSTS).
+ $ids = get_posts(
+ array(
+ 'post_type' => 'attachment',
+ 'numberposts' => -1,
+ 'post_status' => 'any',
+ 'post__in' => $args['ids'],
+ 'order' => $order,
+ 'orderby' => $args['sort'],
+ 'fields' => 'ids',
+ )
+ );
+
+ if ( ! empty( $ids ) ) {
+ wp_send_json_success( $ids );
+ }
+
+ wp_send_json_error();
+ }
+
+ /**
+ * Renders the sidebar HTML shown when selecting an attachmemnt.
+ *
+ * @date 13/12/2013
+ * @since 5.0.0
+ *
+ * @param integer $id The attachment ID.
+ * @param array $field The field array.
+ * @return void
+ */
+ function render_attachment( $id, $field ) {
+ // Load attachmenet data.
+ $attachment = wp_prepare_attachment_for_js( $id );
+ $compat = get_compat_media_markup( $id );
+
+ // Get attachment thumbnail (video).
+ if ( isset( $attachment['thumb']['src'] ) ) {
+ $thumb = $attachment['thumb']['src'];
+
+ // Look for thumbnail size (image).
+ } elseif ( isset( $attachment['sizes']['thumbnail']['url'] ) ) {
+ $thumb = $attachment['sizes']['thumbnail']['url'];
+
+ // Use url for svg.
+ } elseif ( $attachment['type'] === 'image' ) {
+ $thumb = $attachment['url'];
+
+ // Default to icon.
+ } else {
+ $thumb = wp_mime_type_icon( $id );
+ }
+
+ // Get attachment dimensions / time / size.
+ $dimensions = '';
+ if ( $attachment['type'] === 'audio' ) {
+ $dimensions = __( 'Length', 'acf' ) . ': ' . $attachment['fileLength'];
+ } elseif ( ! empty( $attachment['width'] ) ) {
+ $dimensions = $attachment['width'] . ' x ' . $attachment['height'];
+ }
+ if ( ! empty( $attachment['filesizeHumanReadable'] ) ) {
+ $dimensions .= ' (' . $attachment['filesizeHumanReadable'] . ')';
+ }
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+ -
+
+
+
+
+
- +
+ acf_idify( $layout_prefix . '[key]' ),
+ 'name' => $layout_prefix . '[key]',
+ 'class' => 'layout-key',
+ 'value' => $layout['key'],
+ )
+ );
+
+ ?>
+
+
+
+ $layout['sub_fields'],
+ 'parent' => $field['ID'],
+ 'is_subfield' => true,
+ );
+
+ acf_get_view( 'acf-field-group/fields', $args );
+
+ ?>
+
+ >
+
+
+ __( 'Return Format', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'radio',
+ 'name' => 'return_format',
+ 'layout' => 'horizontal',
+ 'choices' => array(
+ 'array' => __( 'Image Array', 'acf' ),
+ 'url' => __( 'Image URL', 'acf' ),
+ 'id' => __( 'Image ID', 'acf' ),
+ ),
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Library', 'acf' ),
+ 'instructions' => __( 'Limit the media library choice', 'acf' ),
+ 'type' => 'radio',
+ 'name' => 'library',
+ 'layout' => 'horizontal',
+ 'choices' => array(
+ 'all' => __( 'All', 'acf' ),
+ 'uploadedTo' => __( 'Uploaded to post', 'acf' ),
+ ),
+ )
+ );
+ }
+
+ /**
+ * Renders the field settings used in the "Validation" tab.
+ *
+ * @since 6.0
+ *
+ * @param array $field The field settings array.
+ * @return void
+ */
+ function render_field_validation_settings( $field ) {
+ // Clear numeric settings.
+ $clear = array(
+ 'min',
+ 'max',
+ 'min_width',
+ 'min_height',
+ 'min_size',
+ 'max_width',
+ 'max_height',
+ 'max_size',
+ );
+
+ foreach ( $clear as $k ) {
+ if ( empty( $field[ $k ] ) ) {
+ $field[ $k ] = '';
+ }
+ }
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Minimum Selection', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'min',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Maximum Selection', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'max',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Minimum', 'acf' ),
+ 'hint' => __( 'Restrict which images can be uploaded', 'acf' ),
+ 'type' => 'text',
+ 'name' => 'min_width',
+ 'prepend' => __( 'Width', 'acf' ),
+ 'append' => 'px',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => '',
+ 'type' => 'text',
+ 'name' => 'min_height',
+ 'prepend' => __( 'Height', 'acf' ),
+ 'append' => 'px',
+ '_append' => 'min_width',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => '',
+ 'type' => 'text',
+ 'name' => 'min_size',
+ 'prepend' => __( 'File size', 'acf' ),
+ 'append' => 'MB',
+ '_append' => 'min_width',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Maximum', 'acf' ),
+ 'hint' => __( 'Restrict which images can be uploaded', 'acf' ),
+ 'type' => 'text',
+ 'name' => 'max_width',
+ 'prepend' => __( 'Width', 'acf' ),
+ 'append' => 'px',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => '',
+ 'type' => 'text',
+ 'name' => 'max_height',
+ 'prepend' => __( 'Height', 'acf' ),
+ 'append' => 'px',
+ '_append' => 'max_width',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => '',
+ 'type' => 'text',
+ 'name' => 'max_size',
+ 'prepend' => __( 'File size', 'acf' ),
+ 'append' => 'MB',
+ '_append' => 'max_width',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Allowed File Types', 'acf' ),
+ 'hint' => __( 'Comma separated list. Leave blank for all types', 'acf' ),
+ 'type' => 'text',
+ 'name' => 'mime_types',
+ )
+ );
+ }
+
+ /**
+ * Renders the field settings used in the "Presentation" tab.
+ *
+ * @since 6.0
+ *
+ * @param array $field The field settings array.
+ * @return void
+ */
+ function render_field_presentation_settings( $field ) {
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Insert', 'acf' ),
+ 'instructions' => __( 'Specify where new attachments are added', 'acf' ),
+ 'type' => 'select',
+ 'name' => 'insert',
+ 'choices' => array(
+ 'append' => __( 'Append to the end', 'acf' ),
+ 'prepend' => __( 'Prepend to the beginning', 'acf' ),
+ ),
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Preview Size', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'select',
+ 'name' => 'preview_size',
+ 'choices' => acf_get_image_sizes(),
+ )
+ );
+ }
+
+ /**
+ * This filter is appied to the $value after it is loaded from the db and before it is returned to the template
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $value (mixed) the value which was loaded from the database
+ * @param $post_id (mixed) the post_id from which the value was loaded
+ * @param $field (array) the field array holding all the field options
+ *
+ * @return $value (mixed) the modified value
+ */
+ function format_value( $value, $post_id, $field ) {
+
+ // Bail early if no value.
+ if ( ! $value ) {
+ return false;
+ }
+
+ // Clean value into an array of IDs.
+ $attachment_ids = array_map( 'intval', acf_array( $value ) );
+
+ // Find posts in database (ensures all results are real).
+ $posts = acf_get_posts(
+ array(
+ 'post_type' => 'attachment',
+ 'post__in' => $attachment_ids,
+ 'update_post_meta_cache' => true,
+ 'update_post_term_cache' => false,
+ )
+ );
+
+ // Bail early if no posts found.
+ if ( ! $posts ) {
+ return false;
+ }
+
+ // Format values using field settings.
+ $value = array();
+ foreach ( $posts as $post ) {
+
+ // Return object.
+ if ( $field['return_format'] == 'object' ) {
+ $item = $post;
+
+ // Return array.
+ } elseif ( $field['return_format'] == 'array' ) {
+ $item = acf_get_attachment( $post );
+
+ // Return URL.
+ } elseif ( $field['return_format'] == 'url' ) {
+ $item = wp_get_attachment_url( $post->ID );
+
+ // Return ID.
+ } else {
+ $item = $post->ID;
+ }
+
+ // Append item.
+ $value[] = $item;
+ }
+
+ // Return.
+ return $value;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 11/02/2014
+ * @since 5.0.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function validate_value( $valid, $value, $field, $input ) {
+
+ if ( empty( $value ) || ! is_array( $value ) ) {
+ $value = array();
+ }
+
+ if ( count( $value ) < $field['min'] ) {
+ $valid = _n( '%1$s requires at least %2$s selection', '%1$s requires at least %2$s selections', $field['min'], 'acf' );
+ $valid = sprintf( $valid, $field['label'], $field['min'] );
+ }
+
+ return $valid;
+ }
+
+
+ /**
+ * This filter is appied to the $value before it is updated in the db
+ *
+ * @type filter
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param $value - the value which will be saved in the database
+ * @param $post_id - the post_id of which the value will be saved
+ * @param $field - the field array holding all the field options
+ *
+ * @return $value - the modified value
+ */
+ function update_value( $value, $post_id, $field ) {
+
+ // Bail early if no value.
+ if ( empty( $value ) ) {
+ return $value;
+ }
+
+ // Convert to array.
+ $value = acf_array( $value );
+
+ // Format array of values.
+ // - ensure each value is an id.
+ // - Parse each id as string for SQL LIKE queries.
+ $value = array_map( 'acf_idval', $value );
+ $value = array_map( 'strval', $value );
+
+ // Return value.
+ return $value;
+ }
+
+ /**
+ * Validates file fields updated via the REST API.
+ *
+ * @param boolean $valid The current validity booleean
+ * @param integer $value The value of the field
+ * @param array $field The field array
+ * @return boolean|WP
+ */
+ public function validate_rest_value( $valid, $value, $field ) {
+ if ( ! $valid || ! is_array( $value ) ) {
+ return $valid;
+ }
+
+ foreach ( $value as $attachment_id ) {
+ $file_valid = acf_get_field_type( 'file' )->validate_rest_value( $valid, $attachment_id, $field );
+
+ if ( is_wp_error( $file_valid ) ) {
+ return $file_valid;
+ }
+ }
+
+ return $valid;
+ }
+
+ /**
+ * Return the schema array for the REST API.
+ *
+ * @param array $field
+ * @return array
+ */
+ public function get_rest_schema( array $field ) {
+ $schema = array(
+ 'type' => array( 'array', 'null' ),
+ 'required' => ! empty( $field['required'] ),
+ 'items' => array(
+ 'type' => 'number',
+ ),
+ );
+
+ if ( ! empty( $field['min'] ) ) {
+ $schema['minItems'] = (int) $field['min'];
+ }
+
+ if ( ! empty( $field['max'] ) ) {
+ $schema['maxItems'] = (int) $field['max'];
+ }
+
+ return $schema;
+ }
+
+ /**
+ * @see \acf_field::get_rest_links()
+ * @param mixed $value The raw (unformatted) field value.
+ * @param integer|string $post_id
+ * @param array $field
+ * @return array
+ */
+ public function get_rest_links( $value, $post_id, array $field ) {
+ $links = array();
+
+ if ( empty( $value ) ) {
+ return $links;
+ }
+
+ foreach ( (array) $value as $object_id ) {
+ $links[] = array(
+ 'rel' => 'acf:attachment',
+ 'href' => rest_url( '/wp/v2/media/' . $object_id ),
+ 'embeddable' => true,
+ );
+ }
+
+ return $links;
+ }
+
+ /**
+ * Apply basic formatting to prepare the value for default REST output.
+ *
+ * @param mixed $value
+ * @param string|integer $post_id
+ * @param array $field
+ * @return mixed
+ */
+ public function format_value_for_rest( $value, $post_id, array $field ) {
+ return acf_format_numerics( $value );
+ }
+ }
+
+
+ // initialize
+ acf_register_field_type( 'acf_field_gallery' );
+endif; // class_exists check
+
+?>
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-repeater.php b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-repeater.php
new file mode 100644
index 00000000..1fbbbf31
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-field-repeater.php
@@ -0,0 +1,1146 @@
+name = 'repeater';
+ $this->label = __( 'Repeater', 'acf' );
+ $this->category = 'layout';
+ $this->description = __( 'Provides a solution for repeating content such as slides, team members, and call-to-action tiles, by acting as a parent to a set of subfields which can be repeated again and again.', 'acf' );
+ $this->preview_image = acf_get_url() . '/assets/images/field-type-previews/field-preview-repeater.png';
+ $this->doc_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/repeater/', 'docs', 'field-type-selection' );
+ $this->tutorial_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/repeater/how-to-use-the-repeater-field/', 'docs', 'field-type-selection' );
+ $this->pro = true;
+ $this->supports = array( 'bindings' => false );
+ $this->defaults = array(
+ 'sub_fields' => array(),
+ 'min' => 0,
+ 'max' => 0,
+ 'rows_per_page' => 20,
+ 'layout' => 'table',
+ 'button_label' => '',
+ 'collapsed' => '',
+ );
+
+ // field filters
+ $this->add_field_filter( 'acf/prepare_field_for_export', array( $this, 'prepare_field_for_export' ) );
+ $this->add_field_filter( 'acf/prepare_field_for_import', array( $this, 'prepare_field_for_import' ) );
+
+ // filters
+ $this->add_filter( 'acf/validate_field', array( $this, 'validate_any_field' ) );
+ $this->add_filter( 'acf/pre_render_fields', array( $this, 'pre_render_fields' ), 10, 2 );
+
+ add_action( 'wp_ajax_acf/ajax/query_repeater', array( $this, 'ajax_get_rows' ) );
+ }
+
+ /**
+ * Localizes text for the repeater field.
+ *
+ * @date 16/12/2015
+ * @since 5.3.2
+ */
+ public function input_admin_enqueue_scripts() {
+ acf_localize_text(
+ array(
+ 'Minimum rows not reached ({min} rows)' => __( 'Minimum rows not reached ({min} rows)', 'acf' ),
+ 'Maximum rows reached ({max} rows)' => __( 'Maximum rows reached ({max} rows)', 'acf' ),
+ 'Error loading page' => __( 'Error loading page', 'acf' ),
+ 'Order will be assigned upon save' => __( 'Order will be assigned upon save', 'acf' ),
+ )
+ );
+ }
+
+ /**
+ * Filters the field array after it's loaded from the database.
+ *
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param array $field The field array holding all the field options.
+ * @return array
+ */
+ public function load_field( $field ) {
+ $field['min'] = (int) $field['min'];
+ $field['max'] = (int) $field['max'];
+ $sub_fields = acf_get_fields( $field );
+
+ if ( $sub_fields ) {
+ $field['sub_fields'] = array_map(
+ function ( $sub_field ) use ( $field ) {
+ $sub_field['parent_repeater'] = $field['key'];
+ return $sub_field;
+ },
+ $sub_fields
+ );
+ }
+
+ if ( empty( $field['rows_per_page'] ) || (int) $field['rows_per_page'] < 1 ) {
+ $field['rows_per_page'] = 20;
+ }
+
+ if ( '' === $field['button_label'] ) {
+ $field['button_label'] = __( 'Add Row', 'acf' );
+ }
+
+ return $field;
+ }
+
+ /**
+ * Runs on the "acf/pre_render_fields" filter. Used to signify
+ * that we're currently rendering a repeater field.
+ *
+ * @since 6.0.0
+ *
+ * @param array $fields The main field array.
+ * @param mixed $post_id The post ID for the field being rendered.
+ * @return array
+ */
+ public function pre_render_fields( $fields, $post_id = false ) {
+ if ( is_admin() ) {
+ $this->is_rendering = true;
+ $this->post_id = $post_id;
+ }
+
+ return $fields;
+ }
+
+ /**
+ * Create the HTML interface for your field
+ *
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param array $field An array holding all the field's data.
+ */
+ public function render_field( $field ) {
+ $_field = $field;
+ $field['orig_name'] = $this->get_field_name_from_input_name( $field['name'] );
+ $_field['name'] = $field['orig_name'];
+ $field['total_rows'] = (int) acf_get_metadata_by_field( $this->post_id, $_field );
+ $table = new ACF_Repeater_Table( $field );
+ $table->render();
+ }
+
+ /**
+ * Create extra options for your field. This is rendered when editing a field.
+ * The value of $field['name'] can be used (like bellow) to save extra data to the $field
+ *
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param array $field An array holding all the field's data.
+ */
+ function render_field_settings( $field ) {
+ $args = array(
+ 'fields' => $field['sub_fields'],
+ 'parent' => $field['ID'],
+ 'is_subfield' => true,
+ );
+ $supports_pagination = ( empty( $field['parent_repeater'] ) && empty( $field['parent_layout'] ) );
+ ?>
+
+
+
+
+ $attachment ) :
+
+ // Vars
+ $a_id = $attachment['ID'];
+ $a_title = $attachment['title'];
+ $a_type = $attachment['type'];
+ $a_filename = $attachment['filename'];
+ $a_class = "acf-gallery-attachment -{$a_type}";
+
+ // Get thumbnail.
+ $a_thumbnail = acf_get_post_thumbnail( $a_id, $field['preview_size'] );
+ $a_class .= ( $a_thumbnail['type'] === 'icon' ) ? ' -icon' : '';
+
+ ?>
+
+
+
+
+
+
+
+
+
+
+
+
+
+ __( 'Layout', 'acf' ),
+ 'instructions' => '',
+ 'class' => 'acf-repeater-layout',
+ 'type' => 'radio',
+ 'name' => 'layout',
+ 'layout' => 'horizontal',
+ 'choices' => array(
+ 'table' => __( 'Table', 'acf' ),
+ 'block' => __( 'Block', 'acf' ),
+ 'row' => __( 'Row', 'acf' ),
+ ),
+ )
+ );
+
+ if ( $supports_pagination ) {
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Pagination', 'acf' ),
+ 'instructions' => __( 'Useful for fields with a large number of rows.', 'acf' ),
+ 'class' => 'acf-repeater-pagination',
+ 'type' => 'true_false',
+ 'name' => 'pagination',
+ 'ui' => 1,
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Rows Per Page', 'acf' ),
+ 'instructions' => __( 'Set the number of rows to be displayed on a page.', 'acf' ),
+ 'class' => 'acf-repeater-pagination-num-rows',
+ 'type' => 'number',
+ 'name' => 'rows_per_page',
+ 'placeholder' => 20,
+ 'ui' => 1,
+ 'min' => 1,
+ 'conditions' => array(
+ 'field' => 'pagination',
+ 'operator' => '==',
+ 'value' => 1,
+ ),
+ )
+ );
+ }
+ }
+
+ /**
+ * Renders the field settings used in the "Validation" tab.
+ *
+ * @since 6.0
+ *
+ * @param array $field The field settings array.
+ * @return void
+ */
+ function render_field_validation_settings( $field ) {
+ $field['min'] = empty( $field['min'] ) ? '' : $field['min'];
+ $field['max'] = empty( $field['max'] ) ? '' : $field['max'];
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Minimum Rows', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'min',
+ 'placeholder' => '0',
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Maximum Rows', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'number',
+ 'name' => 'max',
+ 'placeholder' => '0',
+ )
+ );
+ }
+
+ /**
+ * Renders the field settings used in the "Presentation" tab.
+ *
+ * @since 6.0
+ *
+ * @param array $field The field settings array.
+ * @return void
+ */
+ function render_field_presentation_settings( $field ) {
+ $choices = array();
+ if ( $field['collapsed'] ) {
+ $sub_field = acf_get_field( $field['collapsed'] );
+
+ if ( $sub_field ) {
+ $choices[ $sub_field['key'] ] = $sub_field['label'];
+ }
+ }
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Collapsed', 'acf' ),
+ 'instructions' => __( 'Select a sub field to show when row is collapsed', 'acf' ),
+ 'type' => 'select',
+ 'name' => 'collapsed',
+ 'allow_null' => 1,
+ 'choices' => $choices,
+ )
+ );
+
+ acf_render_field_setting(
+ $field,
+ array(
+ 'label' => __( 'Button Label', 'acf' ),
+ 'instructions' => '',
+ 'type' => 'text',
+ 'name' => 'button_label',
+ 'placeholder' => __( 'Add Row', 'acf' ),
+ )
+ );
+ }
+
+ /**
+ * Filters the field $value after it is loaded from the database.
+ *
+ * @since 3.6
+ *
+ * @param mixed $value The value found in the database.
+ * @param mixed $post_id The $post_id from which the value was loaded.
+ * @param array $field The field array holding all the field options.
+ * @return array $value
+ */
+ public function load_value( $value, $post_id, $field ) {
+ // Bail early if we don't have enough info to load the field.
+ if ( empty( $value ) || ! is_numeric( $value ) || empty( $field['sub_fields'] ) ) {
+ return false;
+ }
+
+ $value = (int) $value;
+ $rows = array();
+ $offset = 0;
+ $paged = isset( $_POST['paged'] ) ? intval( $_POST['paged'] ) : 1; // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified elsewhere.
+
+ // Ensure pagination is disabled inside blocks.
+ if ( acf_get_data( 'acf_inside_rest_call' ) || doing_action( 'wp_ajax_acf/ajax/fetch-block' ) ) {
+ $field['pagination'] = false;
+ }
+
+ if ( ! empty( $field['pagination'] ) && $this->is_rendering ) {
+ $rows_per_page = isset( $field['rows_per_page'] ) ? (int) $field['rows_per_page'] : 20;
+
+ if ( $rows_per_page < 1 ) {
+ $rows_per_page = 20;
+ }
+
+ if ( doing_action( 'wp_ajax_acf/ajax/query_repeater' ) ) {
+ $offset = ( $paged - 1 ) * $rows_per_page; // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified elsewhere.
+ $value = min( $value, $offset + $rows_per_page );
+ } else {
+ $value = min( $value, $rows_per_page );
+ }
+ }
+
+ for ( $i = $offset; $i < $value; $i++ ) {
+ $rows[ $i ] = array();
+
+ foreach ( array_keys( $field['sub_fields'] ) as $j ) {
+ $sub_field = $field['sub_fields'][ $j ];
+
+ // Bail early if no name (tab field).
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // Update $sub_field name and value.
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+ $sub_value = acf_get_value( $post_id, $sub_field );
+ $rows[ $i ][ $sub_field['key'] ] = $sub_value;
+ }
+ }
+
+ return $rows;
+ }
+
+ /**
+ * This filter is appied to the $value after it is loaded from the db and before it is returned to the template
+ *
+ * @type filter
+ * @since 3.6
+ *
+ * @param mixed $value The value which was loaded from the database.
+ * @param mixed $post_id The $post_id from which the value was loaded.
+ * @param array $field The field array holding all the field options.
+ * @param boolean $escape_html Should the field return a HTML safe formatted value.
+ * @return array $value The modified value.
+ */
+ public function format_value( $value, $post_id, $field, $escape_html = false ) {
+ // bail early if no value
+ if ( empty( $value ) ) {
+ return false;
+ }
+
+ // bail early if not array
+ if ( ! is_array( $value ) ) {
+ return false;
+ }
+
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return false;
+ }
+
+ // loop over rows
+ foreach ( array_keys( $value ) as $i ) {
+
+ // loop through sub fields
+ foreach ( array_keys( $field['sub_fields'] ) as $j ) {
+
+ // get sub field
+ $sub_field = $field['sub_fields'][ $j ];
+
+ // bail early if no name (tab)
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // extract value
+ $sub_value = acf_extract_var( $value[ $i ], $sub_field['key'] );
+
+ // update $sub_field name
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // format value
+ $sub_value = acf_format_value( $sub_value, $post_id, $sub_field, $escape_html );
+
+ // append to $row
+ $value[ $i ][ $sub_field['_name'] ] = $sub_value;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Validates values for the repeater field
+ *
+ * @date 11/02/2014
+ * @since 5.0.0
+ *
+ * @param boolean $valid If the field is valid.
+ * @param mixed $value The value to validate.
+ * @param array $field The main field array.
+ * @param string $input The input element's name attribute.
+ * @return boolean
+ */
+ function validate_value( $valid, $value, $field, $input ) {
+ // vars
+ $count = 0;
+
+ // check if is value (may be empty string)
+ if ( is_array( $value ) ) {
+
+ // remove acfcloneindex
+ if ( isset( $value['acfcloneindex'] ) ) {
+ unset( $value['acfcloneindex'] );
+ }
+
+ // count
+ $count = count( $value );
+ }
+
+ // validate required
+ if ( $field['required'] && ! $count ) {
+ $valid = false;
+ }
+
+ // min
+ $min = (int) $field['min'];
+ if ( empty( $field['pagination'] ) && $min && $count < $min ) {
+
+ // create error
+ $error = __( 'Minimum rows not reached ({min} rows)', 'acf' );
+ $error = str_replace( '{min}', $min, $error );
+
+ // return
+ return $error;
+ }
+
+ // validate value
+ if ( $count ) {
+
+ // bail early if no sub fields
+ if ( ! $field['sub_fields'] ) {
+ return $valid;
+ }
+
+ // loop rows
+ foreach ( $value as $i => $row ) {
+
+ // Skip rows that were deleted in paginated repeaters.
+ if ( false !== strpos( $i, '_deleted' ) ) {
+ continue;
+ }
+
+ // loop sub fields
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // vars
+ $k = $sub_field['key'];
+
+ // test sub field exists
+ if ( ! isset( $row[ $k ] ) ) {
+ continue;
+ }
+
+ // validate
+ acf_validate_value( $row[ $k ], $sub_field, "{$input}[{$i}][{$k}]" );
+ }
+ // end loop sub fields
+ }
+ // end loop rows
+ }
+
+ return $valid;
+ }
+
+ /**
+ * This function will update a value row.
+ *
+ * @date 15/2/17
+ * @since 5.5.8
+ *
+ * @param array $row
+ * @param integer $i
+ * @param array $field
+ * @param mixed $post_id
+ * @return boolean
+ */
+ function update_row( $row, $i, $field, $post_id ) {
+ // bail early if no layout reference
+ if ( ! is_array( $row ) ) {
+ return false;
+ }
+
+ // bail early if no layout
+ if ( empty( $field['sub_fields'] ) ) {
+ return false;
+ }
+
+ foreach ( $field['sub_fields'] as $sub_field ) {
+ $value = null;
+
+ if ( array_key_exists( $sub_field['key'], $row ) ) {
+ $value = $row[ $sub_field['key'] ];
+ } elseif ( array_key_exists( $sub_field['name'], $row ) ) {
+ $value = $row[ $sub_field['name'] ];
+ } else {
+ // Value does not exist.
+ continue;
+ }
+
+ // modify name for save
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // update field
+ acf_update_value( $value, $post_id, $sub_field );
+ }
+
+ return true;
+ }
+
+ /**
+ * This function will delete a value row.
+ *
+ * @date 15/2/17
+ * @since 5.5.8
+ *
+ * @param integer $i
+ * @param array $field
+ * @param mixed $post_id
+ * @return boolean
+ */
+ function delete_row( $i, $field, $post_id ) {
+ // bail early if no sub fields
+ if ( empty( $field['sub_fields'] ) ) {
+ return false;
+ }
+
+ foreach ( $field['sub_fields'] as $sub_field ) {
+ // modify name for delete
+ $sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";
+
+ // delete value
+ acf_delete_value( $post_id, $sub_field );
+ }
+
+ return true;
+ }
+
+ /**
+ * Filters the $value before it is updated in the database.
+ *
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param mixed $value The value which will be saved in the database.
+ * @param mixed $post_id The $post_id of which the value will be saved.
+ * @param array $field The field array holding all the field options.
+ * @return mixed $value
+ */
+ public function update_value( $value, $post_id, $field ) {
+ // Bail early if no sub fields.
+ if ( empty( $field['sub_fields'] ) ) {
+ return $value;
+ }
+
+ if ( ! is_array( $value ) ) {
+ $value = array();
+ }
+
+ if ( isset( $value['acfcloneindex'] ) ) {
+ unset( $value['acfcloneindex'] );
+ }
+
+ $new_value = 0;
+ $old_value = (int) acf_get_metadata_by_field( $post_id, $field );
+
+ if ( ! empty( $field['pagination'] ) && did_action( 'acf/save_post' ) && ! isset( $_POST['_acf_form'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Value not used.
+ $old_rows = acf_get_value( $post_id, $field );
+ $old_rows = is_array( $old_rows ) ? $old_rows : array();
+ $edited_rows = array();
+ $deleted_rows = array();
+ $reordered_rows = array();
+ $new_rows = array();
+
+ // Categorize the submitted values, so we know what to do with them.
+ foreach ( $value as $key => $row ) {
+ if ( ! is_array( $row ) ) {
+ continue;
+ }
+
+ // Check if this is a new row.
+ if ( false === strpos( $key, 'row' ) ) {
+ unset( $row['acf_changed'] );
+
+ // Check if this new row was inserted before an existing row.
+ $reordered_row_num = isset( $row['acf_reordered'] ) ? (int) $row['acf_reordered'] : false;
+
+ if ( false !== $reordered_row_num && $reordered_row_num <= $old_value ) {
+ $reordered_rows[ $key ] = $reordered_row_num;
+ } else {
+ $new_rows[ $key ] = $row;
+ }
+
+ continue;
+ }
+
+ $row_num = (int) str_replace( 'row-', '', $key );
+
+ if ( isset( $row['acf_deleted'] ) ) {
+ $deleted_rows[] = $row_num;
+ } elseif ( isset( $row['acf_reordered'] ) ) {
+ $reordered_rows[ $row_num ] = (int) $row['acf_reordered'];
+ } else {
+ unset( $row['acf_changed'] );
+ $edited_rows[ $row_num ] = $row;
+ }
+ }
+
+ // Process any row deletions first, but don't remove their keys yet.
+ foreach ( $deleted_rows as $deleted_row ) {
+ $this->delete_row( $deleted_row, $field, $post_id );
+ $old_rows[ $deleted_row ] = 'acf_deleted';
+ }
+
+ // Update any existing rows that were edited.
+ foreach ( $edited_rows as $key => $row ) {
+ if ( array_key_exists( $key, $old_rows ) ) {
+ $old_rows[ $key ] = $row;
+ }
+ }
+
+ $rows_to_move = array();
+ $new_rows_to_move = array();
+ foreach ( $reordered_rows as $old_order => $new_order ) {
+ if ( is_int( $old_order ) ) {
+ $rows_to_move[ $new_order ][] = $value[ 'row-' . $old_order ];
+ unset( $old_rows[ $old_order ] );
+ } else {
+ $new_rows_to_move[ $new_order ][] = $value[ $old_order ];
+ }
+ }
+
+ // Iterate over existing moved rows first.
+ if ( ! empty( $rows_to_move ) ) {
+ ksort( $rows_to_move );
+ foreach ( $rows_to_move as $key => $values ) {
+ array_splice( $old_rows, $key, 0, $values );
+ }
+ }
+
+ // Iterate over inserted/duplicated rows in reverse order, so they're inserted into the correct spot.
+ if ( ! empty( $new_rows_to_move ) ) {
+ krsort( $new_rows_to_move );
+ foreach ( $new_rows_to_move as $key => $values ) {
+ array_splice( $old_rows, $key, 0, $values );
+ }
+ }
+
+ // Append any new rows.
+ foreach ( $new_rows as $new_row ) {
+ $old_rows[] = $new_row;
+ }
+
+ // Update the rows in the database.
+ $new_row_num = 0;
+ foreach ( $old_rows as $key => $row ) {
+ if ( 'acf_deleted' === $row ) {
+ unset( $old_rows[ $key ] );
+ continue;
+ }
+
+ $this->update_row( $row, $new_row_num, $field, $post_id );
+ ++$new_row_num;
+ }
+
+ // Calculate the total number of rows that will be saved after this update.
+ $new_value = count( $old_rows );
+ } else {
+ $i = -1;
+
+ foreach ( $value as $row ) {
+ ++$i;
+
+ // Bail early if no row.
+ if ( ! is_array( $row ) ) {
+ continue;
+ }
+
+ $this->update_row( $row, $i, $field, $post_id );
+ ++$new_value;
+ }
+ }
+
+ // Remove old rows.
+ if ( $old_value > $new_value ) {
+ for ( $i = $new_value; $i < $old_value; $i++ ) {
+ $this->delete_row( $i, $field, $post_id );
+ }
+ }
+
+ // Save empty string for empty value.
+ if ( empty( $new_value ) ) {
+ $new_value = '';
+ }
+
+ return $new_value;
+ }
+
+ /**
+ * Deletes any subfields after the field has been deleted.
+ *
+ * @date 4/04/2014
+ * @since 5.0.0
+ *
+ * @param array $field The main field array.
+ * @return void
+ */
+ function delete_field( $field ) {
+ // Bail early if no subfields.
+ if ( empty( $field['sub_fields'] ) ) {
+ return;
+ }
+
+ // Delete any subfields.
+ foreach ( $field['sub_fields'] as $sub_field ) {
+ acf_delete_field( $sub_field['ID'] );
+ }
+ }
+
+ /**
+ * Deletes a value from the database.
+ *
+ * @date 1/07/2015
+ * @since 5.2.3
+ *
+ * @param integer $post_id The post ID to delete the value from.
+ * @param string $key The meta name/key (unused).
+ * @param array $field The main field array.
+ * @return void
+ */
+ function delete_value( $post_id, $key, $field ) {
+ // Get the old value from the database.
+ $old_value = (int) acf_get_metadata_by_field( $post_id, $field );
+
+ // Bail early if no rows or no subfields.
+ if ( ! $old_value || empty( $field['sub_fields'] ) ) {
+ return;
+ }
+
+ for ( $i = 0; $i < $old_value; $i++ ) {
+ $this->delete_row( $i, $field, $post_id );
+ }
+ }
+
+ /**
+ * This filter is applied to the $field before it is saved to the database.
+ *
+ * @since 3.6
+ *
+ * @param array $field The field array holding all the field options.
+ * @return array
+ */
+ public function update_field( $field ) {
+ unset( $field['sub_fields'] );
+ return $field;
+ }
+
+ /**
+ * This filter is applied to the $field before it is duplicated and saved to the database.
+ *
+ * @since 3.6
+ * @date 23/01/13
+ *
+ * @param array $field The field array holding all the field options.
+ * @return array
+ */
+ function duplicate_field( $field ) {
+ // get sub fields
+ $sub_fields = acf_extract_var( $field, 'sub_fields' );
+
+ // save field to get ID
+ $field = acf_update_field( $field );
+
+ // duplicate sub fields
+ acf_duplicate_fields( $sub_fields, $field['ID'] );
+
+ return $field;
+ }
+
+ /**
+ * This function will translate field settings.
+ *
+ * @date 8/03/2016
+ * @since 5.3.2
+ *
+ * @param array $field The main field array.
+ * @return array
+ */
+ function translate_field( $field ) {
+ $field['button_label'] = acf_translate( $field['button_label'] );
+ return $field;
+ }
+
+ /**
+ * This function will add compatibility for the 'column_width' setting
+ *
+ * @date 30/1/17
+ * @since 5.5.6
+ *
+ * @param array $field The main field array.
+ * @return array
+ */
+ function validate_any_field( $field ) {
+ // width has changed
+ if ( isset( $field['column_width'] ) ) {
+ $field['wrapper']['width'] = acf_extract_var( $field, 'column_width' );
+ }
+
+ return $field;
+ }
+
+ /**
+ * Prepares the field for export.
+ *
+ * @date 11/03/2014
+ * @since 5.0.0
+ *
+ * @param array $field The field settings.
+ * @return array
+ */
+ function prepare_field_for_export( $field ) {
+ // Check for subfields.
+ if ( ! empty( $field['sub_fields'] ) ) {
+ $field['sub_fields'] = acf_prepare_fields_for_export( $field['sub_fields'] );
+ }
+
+ return $field;
+ }
+
+ /**
+ * Returns a flat array of fields containing all subfields ready for import.
+ *
+ * @date 11/03/2014
+ * @since 5.0.0
+ *
+ * @param array $field The field settings.
+ * @return array
+ */
+ function prepare_field_for_import( $field ) {
+ // Check for sub fields.
+ if ( ! empty( $field['sub_fields'] ) ) {
+ $sub_fields = acf_extract_var( $field, 'sub_fields' );
+
+ // Modify sub fields.
+ foreach ( $sub_fields as $i => $sub_field ) {
+ $sub_fields[ $i ]['parent'] = $field['key'];
+ $sub_fields[ $i ]['menu_order'] = $i;
+ }
+
+ // Return array of [field, sub_1, sub_2, ...].
+ return array_merge( array( $field ), $sub_fields );
+ }
+
+ return $field;
+ }
+
+ /**
+ * Additional validation for the repeater field when submitted via REST.
+ *
+ * @param boolean $valid The current validity booleean
+ * @param integer $value The value of the field
+ * @param array $field The field array
+ * @return boolean|WP
+ */
+ public function validate_rest_value( $valid, $value, $field ) {
+ if ( ! is_array( $value ) && is_null( $value ) ) {
+ $param = sprintf( '%s[%s]', $field['prefix'], $field['name'] );
+ $data = array(
+ 'param' => $param,
+ 'value' => $value,
+ );
+ $error = sprintf( __( '%s must be of type array or null.', 'acf' ), $param );
+ return new WP_Error( 'rest_invalid_param', $error, $param );
+ }
+
+ return $valid;
+ }
+
+ /**
+ * Return the schema array for the REST API.
+ *
+ * @param array $field
+ * @return array
+ */
+ public function get_rest_schema( array $field ) {
+ $schema = array(
+ 'type' => array( 'array', 'null' ),
+ 'required' => ! empty( $field['required'] ),
+ 'items' => array(
+ 'type' => 'object',
+ 'properties' => array(),
+ ),
+ );
+
+ foreach ( $field['sub_fields'] as $sub_field ) {
+ if ( $sub_field_schema = acf_get_field_rest_schema( $sub_field ) ) {
+ $schema['items']['properties'][ $sub_field['name'] ] = $sub_field_schema;
+ }
+ }
+
+ if ( ! empty( $field['min'] ) ) {
+ $schema['minItems'] = (int) $field['min'];
+ }
+
+ if ( ! empty( $field['max'] ) ) {
+ $schema['maxItems'] = (int) $field['max'];
+ }
+
+ return $schema;
+ }
+
+ /**
+ * Apply basic formatting to prepare the value for default REST output.
+ *
+ * @param mixed $value
+ * @param integer|string $post_id
+ * @param array $field
+ * @return array|mixed
+ */
+ public function format_value_for_rest( $value, $post_id, array $field ) {
+ if ( empty( $value ) || ! is_array( $value ) || empty( $field['sub_fields'] ) ) {
+ return null;
+ }
+
+ // Loop through each row and within that, each sub field to process sub fields individually.
+ foreach ( $value as &$row ) {
+ foreach ( $field['sub_fields'] as $sub_field ) {
+
+ // Bail early if the field has no name (tab).
+ if ( acf_is_empty( $sub_field['name'] ) ) {
+ continue;
+ }
+
+ // Extract the sub field 'field_key'=>'value' pair from the $row and format it.
+ $sub_value = acf_extract_var( $row, $sub_field['key'] );
+ $sub_value = acf_format_value_for_rest( $sub_value, $post_id, $sub_field );
+
+ // Add the sub field value back to the $row but mapped to the field name instead
+ // of the key reference.
+ $row[ $sub_field['name'] ] = $sub_value;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Takes the provided input name and turns it into a field name that
+ * works with repeater fields that are subfields of other fields.
+ *
+ * @param string $input_name The name attribute used in the repeater.
+ * @return string|boolean
+ */
+ public function get_field_name_from_input_name( $input_name ) {
+ $parts = array();
+ preg_match_all( '/\[([^\]]*)\]/', is_null( $input_name ) ? '' : $input_name, $parts );
+
+ if ( ! isset( $parts[1] ) ) {
+ return false;
+ }
+
+ $field_keys = $parts[1];
+ $name_parts = array();
+
+ foreach ( $field_keys as $field_key ) {
+ // Preserve acfcloneindex
+ if ( $field_key === 'acfcloneindex' ) {
+ $name_parts[] = 'acfcloneindex';
+ continue;
+ }
+
+ // Handle row numbers (row-0, row-1, etc.)
+ if ( strpos( $field_key, 'row-' ) === 0 ) {
+ $row_num = substr( $field_key, 4 );
+ if ( is_numeric( $row_num ) ) {
+ $name_parts[] = (int) $row_num;
+ continue;
+ }
+ }
+
+ // Handle compound keys (field_..._field_...)
+ $compound_keys = preg_split( '/_field_/', $field_key );
+ if ( count( $compound_keys ) > 1 ) {
+ foreach ( $compound_keys as $i => $sub_key ) {
+ if ( $i > 0 ) {
+ $sub_key = 'field_' . $sub_key;
+ }
+
+ // Seamless clone fields use compound keys which can be skipped.
+ $field = acf_get_field( $sub_key );
+ if ( $field && 'clone' === $field['type'] && 'seamless' === $field['display'] ) {
+ continue;
+ }
+
+ $name_parts[] = $field && ! empty( $field['name'] ) ? $field['name'] : $sub_key;
+ }
+ continue;
+ }
+
+ // Handle standard field keys
+ if ( strpos( $field_key, 'field_' ) === 0 ) {
+
+ // Skip clone fields with prefix_name disabled.
+ $field = acf_get_field( $field_key );
+ if ( $field && $field['type'] === 'clone' && empty( $field['prefix_name'] ) ) {
+ continue;
+ }
+
+ $name_parts[] = $field && ! empty( $field['name'] ) ? $field['name'] : $field_key;
+ continue;
+ }
+
+ // Fallback: just add as is
+ $name_parts[] = $field_key;
+ }
+
+ return implode( '_', $name_parts );
+ }
+
+ /**
+ * Returns an array of rows used to populate the repeater table over AJAX.
+ *
+ * @since 6.0.0
+ *
+ * @return void|WP_Error
+ */
+ public function ajax_get_rows() {
+ $args = acf_request_args(
+ array(
+ 'field_name' => '',
+ 'field_key' => '',
+ 'field_prefix' => '',
+ 'post_id' => 0,
+ 'rows_per_page' => 0,
+ 'refresh' => false,
+ 'nonce' => '',
+ )
+ );
+
+ if ( ! acf_verify_ajax( $args['nonce'], $args['field_key'], true ) ) {
+ $error = array( 'error' => __( 'Invalid nonce.', 'acf' ) );
+ wp_send_json_error( $error, 401 );
+ }
+
+ if ( '' === $args['field_name'] || '' === $args['field_key'] ) {
+ $error = array( 'error' => __( 'Invalid field key or name.', 'acf' ) );
+ wp_send_json_error( $error, 404 );
+ }
+
+ $field = acf_get_field( $args['field_key'] );
+ $post_id = acf_get_valid_post_id( $args['post_id'] );
+ $response = array();
+
+ if ( ! $field || ! $post_id ) {
+ $error = array( 'error' => __( 'There was an error retrieving the field.', 'acf' ) );
+ wp_send_json_error( $error, 404 );
+ }
+
+ // Make sure we have a valid field.
+ $field = acf_validate_field( $field );
+
+ // Make sure that we only get a subset of the rows.
+ $this->is_rendering = true;
+
+ $args['rows_per_page'] = (int) $args['rows_per_page'];
+
+ if ( $args['rows_per_page'] ) {
+ $field['rows_per_page'] = $args['rows_per_page'];
+ }
+
+ /**
+ * We have to swap out the field name and prefix with the ones sent via JS,
+ * as the repeater could be inside a subfield.
+ */
+ $field['name'] = $args['field_name'];
+ $field['prefix'] = $args['field_prefix'];
+ $field['value'] = acf_get_value( $post_id, $field );
+
+ if ( $args['refresh'] ) {
+ $response['total_rows'] = (int) acf_get_metadata_by_field( $post_id, $field );
+ }
+
+ // Render the rows to be sent back via AJAX.
+ $field = acf_prepare_field( $field );
+ $repeater_table = new ACF_Repeater_Table( $field );
+ $response['rows'] = $repeater_table->rows( true );
+
+ wp_send_json_success( $response );
+ }
+ }
+
+ // initialize
+ acf_register_field_type( 'acf_field_repeater' );
+endif; // class_exists check
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-repeater-table.php b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-repeater-table.php
new file mode 100644
index 00000000..9ebfdc77
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/fields/class-acf-repeater-table.php
@@ -0,0 +1,497 @@
+field = $field;
+ $this->sub_fields = $field['sub_fields'];
+
+ // Default to non-paginated repeaters.
+ if ( empty( $this->field['pagination'] ) ) {
+ $this->field['pagination'] = false;
+ }
+
+ // We don't yet support pagination inside other repeaters or flexible content fields.
+ if ( ! empty( $this->field['parent_repeater'] ) || ! empty( $this->field['parent_layout'] ) ) {
+ $this->field['pagination'] = false;
+ }
+
+ // We don't yet support pagination in frontend forms or inside blocks.
+ if ( ! is_admin() || acf_get_data( 'acf_inside_rest_call' ) || doing_action( 'wp_ajax_acf/ajax/fetch-block' ) ) {
+ $this->field['pagination'] = false;
+ }
+
+ $this->setup();
+ }
+
+ /**
+ * Sets up the field for rendering.
+ *
+ * @since 6.0.0
+ *
+ * @return void
+ */
+ private function setup() {
+ if ( $this->field['collapsed'] ) {
+ foreach ( $this->sub_fields as &$sub_field ) {
+ // Add target class.
+ if ( $sub_field['key'] == $this->field['collapsed'] ) {
+ $sub_field['wrapper']['class'] .= ' -collapsed-target';
+ }
+ }
+ }
+
+ if ( $this->field['max'] ) {
+ // If max 1 row, don't show order.
+ if ( 1 == $this->field['max'] ) {
+ $this->show_order = false;
+ }
+
+ // If max == min, don't show add or remove buttons.
+ if ( $this->field['max'] <= $this->field['min'] ) {
+ $this->show_remove = false;
+ $this->show_add = false;
+ }
+ }
+
+ if ( empty( $this->field['rows_per_page'] ) ) {
+ $this->field['rows_per_page'] = 20;
+ }
+
+ if ( (int) $this->field['rows_per_page'] < 1 ) {
+ $this->field['rows_per_page'] = 20;
+ }
+
+ $this->value = $this->prepare_value();
+ }
+
+ /**
+ * Prepares the repeater values for rendering.
+ *
+ * @since 6.0.0
+ *
+ * @return array
+ */
+ private function prepare_value() {
+ $value = is_array( $this->field['value'] ) ? $this->field['value'] : array();
+
+ if ( empty( $this->field['pagination'] ) ) {
+ // If there are fewer values than min, populate the extra values.
+ if ( $this->field['min'] ) {
+ $value = array_pad( $value, $this->field['min'], array() );
+ }
+
+ // If there are more values than max, remove some values.
+ if ( $this->field['max'] ) {
+ $value = array_slice( $value, 0, $this->field['max'] );
+ }
+ }
+
+ $value['acfcloneindex'] = array();
+
+ return $value;
+ }
+
+ /**
+ * Renders the full repeater table.
+ *
+ * @since 6.0.0
+ *
+ * @return void
+ */
+ public function render() {
+ // Attributes for main wrapper div.
+ $div = array(
+ 'class' => 'acf-repeater -' . $this->field['layout'],
+ 'data-min' => $this->field['min'],
+ 'data-max' => $this->field['max'],
+ 'data-pagination' => ! empty( $this->field['pagination'] ),
+ 'data-prefix' => $this->field['prefix'],
+ );
+
+ if ( $this->field['pagination'] ) {
+ $div['data-per_page'] = $this->field['rows_per_page'];
+ $div['data-total_rows'] = $this->field['total_rows'];
+ $div['data-orig_name'] = $this->field['orig_name'];
+ $div['data-nonce'] = wp_create_nonce( 'acf_field_' . $this->field['type'] . '_' . $this->field['key'] );
+ }
+
+ if ( empty( $this->value ) ) {
+ $div['class'] .= ' -empty';
+ }
+ ?>
+
+
+
+
+
+
+
+ >
+ $this->field['name'],
+ 'value' => '',
+ 'class' => 'acf-repeater-hidden-input',
+ )
+ );
+ ?>
+
+ thead(); ?>
+
+ rows(); ?>
+
+
+ table_actions(); ?>
+
+ field['layout'] ) {
+ return;
+ }
+ ?>
+
+ ' . $input . $row_num_html . '
';
+ }
+ ?>
+
+ field['button_label'] ); ?>
+ pagination(); ?>
+
+
+ field['pagination'] ) ) {
+ return;
+ }
+
+ $total_rows = isset( $this->field['total_rows'] ) ? (int) $this->field['total_rows'] : 0;
+ $total_pages = ceil( $total_rows / (int) $this->field['rows_per_page'] );
+ $total_pages = max( $total_pages, 1 );
+
+ $html_current_page = sprintf(
+ "%s",
+ '',
+ 1,
+ strlen( $total_pages )
+ );
+
+ $html_total_pages = sprintf( "%s", number_format_i18n( $total_pages ) );
+ ?>
+
+ name = 'block';
+ $this->label = __( 'Block', 'acf' );
+ $this->category = 'forms';
+ $this->object_type = 'block';
+
+ add_filter( 'acf/field_group/list_table_classes', array( $this, 'field_group_list_table_classes' ), 10, 3 );
+ }
+
+ /**
+ * Matches the provided rule against the screen args returning a bool result.
+ *
+ * @date 9/4/20
+ * @since 5.9.0
+ *
+ * @param array $rule The location rule.
+ * @param array $screen The screen args.
+ * @param array $field_group The field group settings.
+ * @return boolean
+ */
+ public function match( $rule, $screen, $field_group ) {
+
+ // Check screen args.
+ if ( isset( $screen['block'] ) ) {
+ $block = $screen['block'];
+ } else {
+ return false;
+ }
+
+ // Compare rule against $block.
+ return $this->compare_to_rule( $block, $rule );
+ }
+
+ /**
+ * Returns an array of possible values for this rule type.
+ *
+ * @date 9/4/20
+ * @since 5.9.0
+ *
+ * @param array $rule A location rule.
+ * @return array
+ */
+ public function get_values( $rule ) {
+ $choices = array();
+
+ // Append block types.
+ $blocks = acf_get_block_types();
+ if ( $blocks ) {
+ $choices['all'] = __( 'All', 'acf' );
+ foreach ( $blocks as $block ) {
+ $choices[ $block['name'] ] = $block['title'];
+ }
+ } else {
+ $choices[''] = __( 'No block types exist', 'acf' );
+ }
+
+ // Return choices.
+ return $choices;
+ }
+
+ /**
+ * Adds block-specific classes to field groups in the Field Groups list table.
+ *
+ * @since 6.2.8
+ *
+ * @param array $classes An array of the classes used by the field group.
+ * @param array $css_class An array of additional classes added to the field group.
+ * @param integer $post_id The ID of the field group.
+ * @return array
+ */
+ public function field_group_list_table_classes( $classes, $css_class, $post_id ) {
+ // Add a CSS class if the field group has a block location.
+ if ( acf_field_group_has_location_type( $post_id, 'block' ) ) {
+ $classes[] = 'acf-has-block-location';
+ }
+
+ return $classes;
+ }
+ }
+
+ // initialize
+ acf_register_location_type( 'ACF_Location_Block' );
+endif; // class_exists check
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/locations/class-acf-location-options-page.php b/wp-content/plugins/advanced-custom-fields-pro/pro/locations/class-acf-location-options-page.php
new file mode 100644
index 00000000..92eec098
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/locations/class-acf-location-options-page.php
@@ -0,0 +1,93 @@
+name = 'options_page';
+ $this->label = __( 'Options Page', 'acf' );
+ $this->category = 'forms';
+ $this->object_type = 'option';
+ }
+
+ /**
+ * Matches the provided rule against the screen args returning a bool result.
+ *
+ * @date 9/4/20
+ * @since 5.9.0
+ *
+ * @param array $rule The location rule.
+ * @param array $screen The screen args.
+ * @param array $field_group The field group settings.
+ * @return boolean
+ */
+ public function match( $rule, $screen, $field_group ) {
+
+ // Check screen args.
+ if ( isset( $screen['options_page'] ) ) {
+ $options_page = $screen['options_page'];
+ } else {
+ return false;
+ }
+
+ // Compare rule against $nav_menu.
+ return $this->compare_to_rule( $options_page, $rule );
+ }
+
+ /**
+ * Returns an array of possible values for this rule type.
+ *
+ * @date 9/4/20
+ * @since 5.9.0
+ *
+ * @param array $rule A location rule.
+ * @return array
+ */
+ public function get_values( $rule ) {
+ $choices = array();
+
+ // Append pages.
+ $pages = acf_get_options_pages();
+ if ( $pages ) {
+ foreach ( $pages as $page ) {
+ $choices[ $page['menu_slug'] ] = $page['page_title'];
+ }
+ } else {
+ $choices[''] = __( 'Select options page...', 'acf' );
+ }
+
+ if ( acf_get_setting( 'enable_options_pages_ui' ) ) {
+ $choices['add_new_options_page'] = __( 'Add New Options Page', 'acf' );
+ }
+
+ // Return choices.
+ return $choices;
+ }
+ }
+
+ // initialize
+ acf_register_location_type( 'ACF_Location_Options_Page' );
+endif; // class_exists check
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/locations/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/locations/index.php
new file mode 100644
index 00000000..97611c0c
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/locations/index.php
@@ -0,0 +1,2 @@
+ $page_title,
+ 'menu_title' => $page_title,
+ 'menu_slug' => 'acf-options',
+ );
+
+ // Allow string to define Options Page name.
+ } elseif ( is_string( $page ) ) {
+ $page_title = $page;
+ $page = array(
+ 'page_title' => $page_title,
+ 'menu_title' => $page_title,
+ );
+ }
+
+ // Apply defaults.
+ $page = wp_parse_args(
+ $page,
+ array(
+ 'page_title' => '',
+ 'menu_title' => '',
+ 'menu_slug' => '',
+ 'capability' => 'edit_posts',
+ 'parent_slug' => '',
+ 'position' => null,
+ 'icon_url' => false,
+ 'redirect' => true,
+ 'post_id' => 'options',
+ 'autoload' => false,
+ 'update_button' => __( 'Update', 'acf' ),
+ 'updated_message' => __( 'Options Updated', 'acf' ),
+ )
+ );
+
+ // Allow compatibility for changed settings.
+ $migrate = array(
+ 'title' => 'page_title',
+ 'menu' => 'menu_title',
+ 'slug' => 'menu_slug',
+ 'parent' => 'parent_slug',
+ );
+ foreach ( $migrate as $old => $new ) {
+ if ( ! empty( $page[ $old ] ) ) {
+ $page[ $new ] = $page[ $old ];
+ }
+ }
+
+ // If no menu_title is set, use the page_title value.
+ if ( empty( $page['menu_title'] ) ) {
+ $page['menu_title'] = $page['page_title'];
+ }
+
+ // If no menu_slug is set, generate one using the menu_title value.
+ if ( empty( $page['menu_slug'] ) ) {
+ $page['menu_slug'] = 'acf-options-' . sanitize_title( $page['menu_title'] );
+ }
+
+ // Standardize on position being either null or int.
+ $page['position'] = is_numeric( $page['position'] ) ? (int) $page['position'] : null;
+
+ /**
+ * Filters the $page array after it has been validated.
+ *
+ * @since 5.5.8
+ * @param array $page The Options Page settings array.
+ */
+ return apply_filters( 'acf/validate_options_page', $page );
+ }
+
+
+ /**
+ * This function will store an options page settings
+ *
+ * @type function
+ * @date 9/6/17
+ * @since 5.6.0
+ *
+ * @param $page (array)
+ * @return n/a
+ */
+ function add_page( $page ) {
+
+ // validate
+ $page = $this->validate_page( $page );
+ $slug = $page['menu_slug'];
+
+ // bail early if already exists
+ if ( isset( $this->pages[ $slug ] ) ) {
+ return false;
+ }
+
+ // append
+ $this->pages[ $slug ] = $page;
+
+ // return
+ return $page;
+ }
+
+
+ /**
+ * description
+ *
+ * @type function
+ * @date 9/6/17
+ * @since 5.6.0
+ *
+ * @param $post_id (int)
+ * @return $post_id (int)
+ */
+ function add_sub_page( $page ) {
+
+ // validate
+ $page = $this->validate_page( $page );
+
+ // default parent
+ if ( ! $page['parent_slug'] ) {
+ $page['parent_slug'] = 'acf-options';
+ }
+
+ // create default parent if not yet exists
+ if ( $page['parent_slug'] == 'acf-options' && ! $this->get_page( 'acf-options' ) ) {
+ $this->add_page( '' );
+ }
+
+ // return
+ return $this->add_page( $page );
+ }
+
+
+ /**
+ * This function will update an options page settings
+ *
+ * @type function
+ * @date 9/6/17
+ * @since 5.6.0
+ *
+ * @param $slug (string)
+ * @param $data (array)
+ * @return (array)
+ */
+ function update_page( $slug = '', $data = array() ) {
+
+ // vars
+ $page = $this->get_page( $slug );
+
+ // bail early if no page
+ if ( ! $page ) {
+ return false;
+ }
+
+ // loop
+ $page = array_merge( $page, $data );
+
+ // set
+ $this->pages[ $slug ] = $page;
+
+ // return
+ return $page;
+ }
+
+
+ /**
+ * This function will return an options page settings
+ *
+ * @type function
+ * @date 6/07/2016
+ * @since 5.4.0
+ *
+ * @param $slug (string)
+ * @return (mixed)
+ */
+ function get_page( $slug ) {
+
+ return isset( $this->pages[ $slug ] ) ? $this->pages[ $slug ] : null;
+ }
+
+
+ /**
+ * This function will return all options page settings
+ *
+ * @type function
+ * @date 6/07/2016
+ * @since 5.4.0
+ *
+ * @param $slug (string)
+ * @return (mixed)
+ */
+ function get_pages() {
+
+ return $this->pages;
+ }
+ }
+
+
+ /*
+ * acf_options_page
+ *
+ * This function will return the options page instance
+ *
+ * @type function
+ * @date 9/6/17
+ * @since 5.6.0
+ *
+ * @param n/a
+ * @return (object)
+ */
+
+ function acf_options_page() {
+
+ global $acf_options_page;
+
+ if ( ! isset( $acf_options_page ) ) {
+ $acf_options_page = new acf_options_page();
+ }
+
+ return $acf_options_page;
+ }
+
+
+ // remove Options Page add-on conflict
+ unset( $GLOBALS['acf_options_page'] );
+
+
+ // initialize
+ acf_options_page();
+endif; // class_exists check
+
+
+/**
+ * alias of acf_options_page()->add_page()
+ *
+ * @type function
+ * @date 24/02/2014
+ * @since 5.0.0
+ *
+ * @param $page (mixed)
+ * @return (array)
+ */
+if ( ! function_exists( 'acf_add_options_page' ) ) :
+
+ function acf_add_options_page( $page = '' ) {
+ return acf_options_page()->add_page( $page );
+ }
+
+endif;
+
+
+/**
+ * alias of acf_options_page()->add_sub_page()
+ *
+ * @type function
+ * @date 24/02/2014
+ * @since 5.0.0
+ *
+ * @param $page (mixed)
+ * @return (array)
+ */
+if ( ! function_exists( 'acf_add_options_sub_page' ) ) :
+
+ function acf_add_options_sub_page( $page = '' ) {
+
+ return acf_options_page()->add_sub_page( $page );
+ }
+
+endif;
+
+
+/**
+ * alias of acf_options_page()->update_page()
+ *
+ * @type function
+ * @date 24/02/2014
+ * @since 5.0.0
+ *
+ * @param $slug (string)
+ * @param $page (mixed)
+ * @return (array)
+ */
+if ( ! function_exists( 'acf_update_options_page' ) ) :
+
+ function acf_update_options_page( $slug = '', $data = array() ) {
+
+ return acf_options_page()->update_page( $slug, $data );
+ }
+
+endif;
+
+
+/**
+ * This function will return an options page settings
+ *
+ * @type function
+ * @date 24/02/2014
+ * @since 5.0.0
+ *
+ * @param $slug (string)
+ * @return (array)
+ */
+if ( ! function_exists( 'acf_get_options_page' ) ) :
+
+ function acf_get_options_page( $slug ) {
+
+ // vars
+ $page = acf_options_page()->get_page( $slug );
+
+ // bail early if no page
+ if ( ! $page ) {
+ return false;
+ }
+
+ // filter
+ $page = apply_filters( 'acf/get_options_page', $page, $slug );
+
+ // return
+ return $page;
+ }
+
+endif;
+
+
+/**
+ * This function will return all options page settings
+ *
+ * @type function
+ * @date 24/02/2014
+ * @since 5.0.0
+ *
+ * @param n/a
+ * @return (array)
+ */
+if ( ! function_exists( 'acf_get_options_pages' ) ) :
+
+ function acf_get_options_pages() {
+
+ // global
+ global $_wp_last_utility_menu;
+
+ // vars
+ $pages = acf_options_page()->get_pages();
+
+ // bail early if no pages
+ if ( empty( $pages ) ) {
+ return false;
+ }
+
+ // apply filter to each page
+ foreach ( $pages as $slug => &$page ) {
+ $page = acf_get_options_page( $slug );
+ }
+
+ // calculate parent => child redirectes
+ foreach ( $pages as $slug => &$page ) {
+
+ // bail early if is child
+ if ( $page['parent_slug'] ) {
+ continue;
+ }
+
+ // add missing position
+ if ( ! $page['position'] ) {
+ ++$_wp_last_utility_menu;
+ $page['position'] = $_wp_last_utility_menu;
+ }
+
+ // bail early if no redirect
+ if ( ! $page['redirect'] ) {
+ continue;
+ }
+
+ // vars
+ $parent = $page['menu_slug'];
+ $child = '';
+
+ // update children
+ foreach ( $pages as &$sub_page ) {
+
+ // bail early if not child of this parent
+ if ( $sub_page['parent_slug'] !== $parent ) {
+ continue;
+ }
+
+ // set child (only once)
+ if ( ! $child ) {
+ $child = $sub_page['menu_slug'];
+ }
+
+ // update parent_slug to the first child
+ $sub_page['parent_slug'] = $child;
+ }
+
+ // finally update parent menu_slug
+ if ( $child ) {
+ $page['_menu_slug'] = $page['menu_slug'];
+ $page['menu_slug'] = $child;
+ }
+ }
+
+ // filter
+ $pages = apply_filters( 'acf/get_options_pages', $pages );
+
+ // return
+ return $pages;
+ }
+
+endif;
+
+
+/**
+ * This function is used to customize the options page admin menu title
+ *
+ * @type function
+ * @date 13/07/13
+ * @since 4.0.0
+ *
+ * @param $title (string)
+ * @return n/a
+ */
+if ( ! function_exists( 'acf_set_options_page_title' ) ) :
+
+ function acf_set_options_page_title( $title = 'Options' ) {
+
+ acf_update_options_page(
+ 'acf-options',
+ array(
+ 'page_title' => $title,
+ 'menu_title' => $title,
+ )
+ );
+ }
+
+endif;
+
+
+/**
+ * This function is used to customize the options page admin menu name
+ *
+ * @type function
+ * @date 13/07/13
+ * @since 4.0.0
+ *
+ * @param $title (string)
+ * @return n/a
+ */
+if ( ! function_exists( 'acf_set_options_page_menu' ) ) :
+
+ function acf_set_options_page_menu( $title = 'Options' ) {
+
+ acf_update_options_page(
+ 'acf-options',
+ array(
+ 'menu_title' => $title,
+ )
+ );
+ }
+
+endif;
+
+
+/**
+ * This function is used to customize the options page capability. Defaults to 'edit_posts'
+ *
+ * @type function
+ * @date 13/07/13
+ * @since 4.0.0
+ *
+ * @param $title (string)
+ * @return n/a
+ */
+if ( ! function_exists( 'acf_set_options_page_capability' ) ) :
+
+ function acf_set_options_page_capability( $capability = 'edit_posts' ) {
+
+ acf_update_options_page(
+ 'acf-options',
+ array(
+ 'capability' => $capability,
+ )
+ );
+ }
+
+endif;
+
+
+/**
+ * This is an old function which is now referencing the new 'acf_add_options_sub_page' function
+ *
+ * @type function
+ * @since 3.0.0
+ * @date 29/01/13
+ *
+ * @param {string} $title
+ * @return N/A
+ */
+if ( ! function_exists( 'register_options_page' ) ) :
+
+ function register_options_page( $page = '' ) {
+
+ acf_add_options_sub_page( $page );
+ }
+
+endif;
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/acf-ui-options-page.php b/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/acf-ui-options-page.php
new file mode 100644
index 00000000..1da28aed
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/acf-ui-options-page.php
@@ -0,0 +1,451 @@
+register_post_type();
+
+ // Include admin classes in admin.
+ if ( is_admin() ) {
+ acf_include( 'includes/admin/admin-internal-post-type-list.php' );
+ acf_include( 'includes/admin/admin-internal-post-type.php' );
+ acf_include( 'pro/admin/post-types/admin-ui-options-page.php' );
+ acf_include( 'pro/admin/post-types/admin-ui-options-pages.php' );
+ }
+
+ $this->setup_local_json();
+
+ parent::__construct();
+
+ add_action( 'acf/init', array( $this, 'register_ui_options_pages' ), 6 );
+ add_action( 'acf/include_options_pages', array( $this, 'include_json_options_pages' ) );
+ }
+
+ /**
+ * Registers the acf-ui-options-page custom post type with WordPress.
+ *
+ * @since 6.2
+ */
+ public function register_post_type() {
+ $cap = acf_get_setting( 'capability' );
+
+ register_post_type(
+ 'acf-ui-options-page',
+ array(
+ 'labels' => array(
+ 'name' => __( 'Options Pages', 'acf' ),
+ 'singular_name' => __( 'Options Pages', 'acf' ),
+ 'add_new' => __( 'Add New', 'acf' ),
+ 'add_new_item' => __( 'Add New Options Page', 'acf' ),
+ 'edit_item' => __( 'Edit Options Page', 'acf' ),
+ 'new_item' => __( 'New Options Page', 'acf' ),
+ 'view_item' => __( 'View Options Page', 'acf' ),
+ 'search_items' => __( 'Search Options Pages', 'acf' ),
+ 'not_found' => __( 'No Options Pages found', 'acf' ),
+ 'not_found_in_trash' => __( 'No Options Pages found in Trash', 'acf' ),
+ ),
+ 'public' => false,
+ 'hierarchical' => true,
+ 'show_ui' => true,
+ 'show_in_menu' => false,
+ '_builtin' => false,
+ 'capability_type' => 'post',
+ 'capabilities' => array(
+ 'edit_post' => $cap,
+ 'delete_post' => $cap,
+ 'edit_posts' => $cap,
+ 'delete_posts' => $cap,
+ ),
+ 'supports' => false,
+ 'rewrite' => false,
+ 'query_var' => false,
+ )
+ );
+ }
+
+ /**
+ * Register activated options pages.
+ *
+ * @since 6.2
+ */
+ public function register_ui_options_pages() {
+ $child_pages = array();
+
+ // Register parent pages first so that child pages can be registered properly.
+ foreach ( $this->get_posts( array( 'active' => true ) ) as $options_page ) {
+ $options_page = $this->get_options_page_args( $options_page );
+
+ if ( empty( $options_page['parent_slug'] ) || 'none' === $options_page['parent_slug'] ) {
+ $options_page['parent_slug'] = '';
+ acf_add_options_page( $options_page );
+ } else {
+ $child_pages[] = $options_page;
+ }
+ }
+
+ foreach ( $child_pages as $child_page ) {
+ acf_add_options_sub_page( $child_page );
+ }
+ }
+
+ /**
+ * Gets the default settings array for an ACF options page.
+ *
+ * @return array
+ */
+ public function get_settings_array() {
+ return array(
+ // ACF internal settings.
+ 'ID' => 0,
+ 'key' => '',
+ 'title' => '',
+ 'active' => true,
+ 'menu_order' => 0,
+ // Basic settings.
+ 'page_title' => '',
+ 'menu_slug' => '',
+ 'parent_slug' => '',
+ 'advanced_configuration' => false,
+ // Visibility tab.
+ 'icon_url' => '',
+ 'menu_title' => '',
+ 'position' => null,
+ 'redirect' => false,
+ 'description' => '',
+ 'menu_icon' => array(),
+ // Labels tab.
+ 'update_button' => __( 'Update', 'acf' ),
+ 'updated_message' => __( 'Options Updated', 'acf' ),
+ // Permissions tab.
+ 'capability' => 'edit_posts',
+ 'data_storage' => 'options',
+ 'post_id' => '',
+ 'autoload' => false,
+ );
+ }
+
+ /**
+ * Validates options page values before allowing save from the global $_POST object.
+ * Errors are added to the form using acf_add_internal_post_type_validation_error().
+ *
+ * @since 6.2
+ *
+ * @return boolean validity status
+ */
+ public function ajax_validate_values() {
+ if ( empty( $_POST['acf_ui_options_page'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified elsewhere.
+ return false;
+ }
+
+ $to_validate = acf_sanitize_request_args( wp_unslash( $_POST['acf_ui_options_page'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified elsewhere.
+ $post_id = acf_request_arg( 'post_id' );
+ $valid = true;
+ $menu_slug = (string) $to_validate['menu_slug'];
+
+ if ( preg_match( '/^[a-z0-9_-]*$/', $menu_slug ) !== 1 ) {
+ $valid = false;
+ acf_add_internal_post_type_validation_error( 'menu_slug', __( 'The menu slug must only contain lower case alphanumeric characters, underscores or dashes.', 'acf' ) );
+ }
+
+ // Check for duplicate menu_slug.
+ $options_pages = acf_get_options_pages();
+ $options_pages = is_array( $options_pages ) ? $options_pages : array();
+ $duplicates = array_filter(
+ $options_pages,
+ function ( $options_page ) use ( $post_id, $menu_slug ) {
+ // Current post is not a duplicate.
+ if ( isset( $options_page['ID'] ) && (int) $post_id === (int) $options_page['ID'] ) {
+ return false;
+ }
+
+ // Menu slugs match, could be a duplicate.
+ if ( $menu_slug === $options_page['menu_slug'] ) {
+ // Unless the matching slug is a parent page redirecting to the child page.
+ if ( isset( $options_page['_menu_slug'] ) && $options_page['_menu_slug'] !== $menu_slug ) {
+ return false;
+ }
+
+ return true;
+ }
+
+ return false;
+ }
+ );
+
+ if ( ! empty( $duplicates ) ) {
+ $valid = false;
+ acf_add_internal_post_type_validation_error(
+ 'menu_slug',
+ __( 'This Menu Slug is already in use by another ACF Options Page.', 'acf' ),
+ 'acf-ui-options-page'
+ );
+ }
+
+ return apply_filters( "acf/{$this->hook_name}/ajax_validate_values", $valid, $_POST['acf_ui_options_page'] ); // phpcs:ignore WordPress.Security -- Raw input send to hook for validation.
+ }
+
+ /**
+ * Updates the settings for ACF UI options pages.
+ *
+ * @since 6.2
+ *
+ * @param array $post The ACF post to update.
+ * @return array
+ */
+ public function update_post( $post ) {
+ if ( isset( $post['parent_slug'] ) && 'none' !== $post['parent_slug'] ) {
+ $ui_options_pages = $this->get_posts();
+
+ foreach ( $ui_options_pages as $options_page ) {
+ if ( $options_page['menu_slug'] === $post['parent_slug'] ) {
+ $post['_parent'] = $options_page['ID'];
+ break;
+ }
+ }
+ }
+
+ return parent::update_post( $post );
+ }
+
+ /**
+ * Sets up the local JSON functionality for options pages.
+ *
+ * @since 6.2
+ *
+ * @param ACF_Local_JSON $local_json The ACF_Local_JSON object.
+ * @return void
+ */
+ public function setup_local_json() {
+ $local_json = acf_get_instance( 'ACF_Local_JSON' );
+
+ // Event listeners.
+ add_action( 'acf/update_ui_options_page', array( $local_json, 'update_internal_post_type' ) );
+ add_action( 'acf/untrash_ui_options_page', array( $local_json, 'update_internal_post_type' ) );
+ add_action( 'acf/trash_ui_options_page', array( $local_json, 'delete_internal_post_type' ) );
+ add_action( 'acf/delete_ui_options_page', array( $local_json, 'delete_internal_post_type' ) );
+ }
+
+ /**
+ * Includes all local JSON options pages.
+ *
+ * @since 6.1
+ */
+ public function include_json_options_pages() {
+ $local_json = acf_get_instance( 'ACF_Local_JSON' );
+
+ // Bail early if disabled.
+ if ( ! $local_json->is_enabled() ) {
+ return;
+ }
+
+ // Get load paths.
+ $files = $local_json->scan_files( 'acf-ui-options-page' );
+ foreach ( $files as $key => $file ) {
+ $json = json_decode( file_get_contents( $file ), true );
+ $json['local'] = 'json';
+ $json['local_file'] = $file;
+ acf_add_local_internal_post_type( $json, 'acf-ui-options-page' );
+ }
+ }
+
+ /**
+ * Returns a string that can be used to create an options page with PHP.
+ *
+ * @since 6.2
+ *
+ * @param array $post The main options page array.
+ * @return string
+ */
+ public function export_post_as_php( $post = array() ) {
+ $return = '';
+ if ( empty( $post ) ) {
+ return $return;
+ }
+
+ // Validate and prepare the post for export.
+ $post = $this->validate_post( $post );
+ $args = $this->get_options_page_args( $post );
+
+ unset( $args['ID'] );
+
+ $code = var_export( $args, true ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions -- Used for PHP export.
+
+ if ( ! $code ) {
+ return $return;
+ }
+
+ $code = $this->format_code_for_export( $code );
+ $return .= "acf_add_options_page( {$code} );\r\n";
+
+ return esc_textarea( $return );
+ }
+
+ /**
+ * This function returns whether the value was saved prior to the icon picker field or not.
+ *
+ * @since 6.3
+ *
+ * @param mixed $args The args for the icon field.
+ * @return boolean
+ */
+ public function value_was_saved_prior_to_icon_picker_field( $args ) {
+ if (
+ ! empty( $args['menu_icon'] ) &&
+ is_array( $args['menu_icon'] ) &&
+ ! empty( $args['menu_icon']['type'] ) &&
+ ! empty( $args['menu_icon']['value'] )
+ ) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Parses ACF options page settings and returns an array of args
+ * to be handled by `acf_add_options_page()`.
+ *
+ * Omits settings that line up with the defaults to reduce the size
+ * of the array passed to `acf_add_options_page()`, which might be exported.
+ *
+ * @since 6.2
+ *
+ * @param array $post The main ACF options page settings array.
+ * @return array
+ */
+ public function get_options_page_args( $post ) {
+ $args = array();
+ $defaults = $this->get_settings_array();
+
+ // UI-specific params that don't need to be passed in.
+ $ui_specific = array(
+ 'key',
+ 'title',
+ 'active',
+ 'menu_order',
+ 'advanced_configuration',
+ 'data_storage',
+ );
+
+ foreach ( $post as $setting => $value ) {
+ // Don't pass in UI specific or unknown settings.
+ if ( in_array( $setting, $ui_specific, true ) || ! array_key_exists( $setting, $defaults ) ) {
+ continue;
+ }
+
+ // Convert types.
+ $default_type = gettype( $defaults[ $setting ] );
+ if ( 'boolean' === $default_type ) {
+ $value = filter_var( $value, FILTER_VALIDATE_BOOLEAN );
+ }
+
+ // Escape HTML.
+ if ( in_array( $setting, array( 'page_title', 'menu_title' ), true ) ) {
+ $value = esc_html( $value );
+ }
+
+ // A `parent_slug` value of "none" is only used in the UI.
+ if ( 'parent_slug' === $setting && 'none' === $value ) {
+ continue;
+ }
+
+ // UI does not default redirect to child to true, but code does.
+ if ( 'redirect' === $setting && ! $value ) {
+ $args[ $setting ] = $value;
+ continue;
+ }
+
+ // Don't need to include if it's the same as a default.
+ if ( $value === $defaults[ $setting ] ) {
+ continue;
+ }
+
+ $args[ $setting ] = $value;
+ }
+
+ // Override the icon_url if the value was saved after the icon picker was added to ACF in 6.3.
+ if ( ! $this->value_was_saved_prior_to_icon_picker_field( $args ) ) {
+ if ( $args['menu_icon']['type'] === 'url' ) {
+ $args['icon_url'] = $args['menu_icon']['value'];
+ }
+ if ( $args['menu_icon']['type'] === 'media_library' ) {
+ $image_url = wp_get_attachment_image_url($args['menu_icon']['value']);
+ $args['icon_url'] = $image_url;
+ }
+ if ( $args['menu_icon']['type'] === 'dashicons' ) {
+ $args['icon_url'] = $args['menu_icon']['value'];
+ }
+ }
+
+ return apply_filters( 'acf/ui_options_page/registration_args', $args, $post );
+ }
+ }
+
+}
+
+acf_new_instance( 'ACF_UI_Options_Page' );
diff --git a/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/index.php b/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/index.php
new file mode 100644
index 00000000..97611c0c
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/pro/post-types/index.php
@@ -0,0 +1,2 @@
+ 'pro',
+ 'key' => acf_pro_get_license_key(),
+ 'slug' => acf_get_setting( 'slug' ),
+ 'basename' => acf_get_setting( 'basename' ),
+ 'version' => acf_get_setting( 'version' ),
+ )
+ );
+
+ if ( is_admin() ) {
+ add_action( 'in_plugin_update_message-' . acf_get_setting( 'basename' ), array( $this, 'modify_plugin_update_message' ), 10, 2 );
+ }
+ }
+
+ /**
+ * Displays an update message for plugin list screens.
+ *
+ * @since 5.3.8
+ *
+ * @param array $plugin_data An array of plugin metadata.
+ * @param object $response An object of metadata about the available plugin update.
+ * @return void
+ */
+ public function modify_plugin_update_message( $plugin_data, $response ) {
+ // Bail early if we have a key.
+ if ( acf_pro_get_license_key() ) {
+ return;
+ }
+
+ if ( is_multisite() ) {
+ /* translators: %1 A link to the updates page. %2 link to the pricing page */
+ $message = __( 'To enable updates, please enter your license key on the Updates page of the main site. If you don\'t have a license key, please see details & pricing.', 'acf' );
+ $updates_page_link = get_admin_url( get_main_site_id(), 'edit.php?post_type=acf-field-group&page=acf-settings-updates' );
+ } else {
+ /* translators: %1 A link to the updates page. %2 link to the pricing page */
+ $message = __( 'To enable updates, please enter your license key on the Updates page. If you don\'t have a license key, please see details & pricing.', 'acf' );
+ $updates_page_link = admin_url( 'edit.php?post_type=acf-field-group&page=acf-settings-updates' );
+ }
+
+ // Display message.
+ echo '' . wp_kses_post( sprintf( $message, $updates_page_link, acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/pro/', 'ACF upgrade', 'updates' ) ) ); + } + } + + new acf_pro_updates(); +endif; // class_exists check + +/** + * Check if a license is defined in wp-config.php and requires activation. + * Also checks if the license key has been changed and reactivates. + * + * @since 5.11.0 + */ +function acf_pro_check_defined_license() { + + // Bail early if we're doing an AJAX call. + if ( acf_is_ajax() ) { + return; + } + + // Bail early if the license is not defined in wp-config. + if ( ! defined( 'ACF_PRO_LICENSE' ) || empty( ACF_PRO_LICENSE ) || ! is_string( ACF_PRO_LICENSE ) ) { + return; + } + + // Bail early if no show_admin. + if ( ! acf_get_setting( 'show_admin' ) ) { + return; + } + + // Check if we've been asked to clear the transient to retry activation. + if ( acf_verify_nonce( 'acf_delete_activation_transient' ) || ( isset( $_REQUEST['acf_retry_nonce'] ) && wp_verify_nonce( sanitize_text_field( wp_unslash( $_REQUEST['acf_retry_nonce'] ) ), 'acf_retry_activation' ) ) ) { + acf_pro_delete_license_transient( 'acf_activation_error' ); + } else { + // If we've failed activation recently, check if the key has been changed, otherwise return. + $activation_data = acf_pro_get_activation_failure_transient(); + if ( $activation_data && $activation_data['license'] === ACF_PRO_LICENSE ) { + return; + } + } + + // If we're already activated, check if the defined license key has changed. + $license = acf_pro_get_license(); + if ( $license ) { + + // Check the saved license key against the defined key. + if ( acf_pro_get_license_key() !== ACF_PRO_LICENSE ) { + + // Deactivate if the key has changed. + $deactivation_response = acf_pro_deactivate_license( true ); + + // A connection error occurred while trying to deactivate. + if ( is_wp_error( $deactivation_response ) ) { + return acf_pro_set_activation_failure_transient( __( 'Your defined license key has changed, but an error occurred when connecting to activation server', 'acf' ) . ' (' . esc_html( $deactivation_response->get_error_message() ) . ').', ACF_PRO_LICENSE ); + // A deactivation error occurred. Display the message returned by our API. + } elseif ( ! $deactivation_response['success'] ) { + return acf_pro_set_activation_failure_transient( __( 'Your defined license key has changed, but an error occurred when deactivating your old license', 'acf' ) . ' (' . $deactivation_response['message'] . ').', ACF_PRO_LICENSE ); + } + } else { + // License key hasn't changed, we are activated and license is still valid, return. + return; + } + } + + // Activate the defined key license. + $activation_response = acf_pro_activate_license( ACF_PRO_LICENSE, true, true ); + + $error_text = false; + + // Activation was prevented by filter. + if ( $activation_response === false ) { + return; + + // A connection error occurred during activation. + } elseif ( is_wp_error( $activation_response ) ) { + $error_text = __( 'An error occurred when connecting to activation server', 'acf' ) . ' (' . esc_html( $activation_response->get_error_message() ) . ').'; + + // A deactivation error occurred. Display the message returned by our API. + } elseif ( ! $activation_response['success'] ) { + $error_text = __( 'There was an issue activating your license key.', 'acf' ) . ' '; + $error_text .= acf_pro_get_translated_connect_message( $activation_response['message'] ); + } else { + + // Delete any previously saved activation error transient. + acf_pro_delete_license_transient( 'acf_activation_error' ); + + // Use our own success message instead of the one from connect so it can be translated. + acf_add_admin_notice( + __( 'ACF PRO — Your license key has been activated successfully. Access to updates, support & PRO features is now enabled.', 'acf' ), + 'success' + ); + + return; + } + + // Clear out old license status if something went wrong. + acf_pro_remove_license_status(); + + return acf_pro_set_activation_failure_transient( $error_text, ACF_PRO_LICENSE ); +} + +/** + * Get translated upstream message + * + * @since 6.2.3 + * @param string $text Server side message string. + * + * @return string a translated (or original, if unavailable), message string. + */ +function acf_pro_get_translated_connect_message( $text ) { + + if ( strpos( $text, 'key activated' ) !== false ) { + return __( 'Your license key has been activated successfully. Access to updates, support & PRO features is now enabled.', 'acf' ); + } elseif ( strpos( $text, 'key deactivated' ) !== false ) { + return __( 'Your license key has been deactivated.', 'acf' ); + } elseif ( strpos( $text, 'key not found' ) !== false ) { + $text = __( 'License key not found. Make sure you have copied your license key exactly as it appears in your receipt or your account.', 'acf' ); + + $text .= sprintf( + ' %2$s', + acf_add_url_utm_tags( + 'https://www.advancedcustomfields.com/my-account/view-licenses/', + 'activation error', + 'license key not found' + ), + __( 'View your licenses', 'acf' ) + ); + + return $text; + } elseif ( strpos( $text, 'key unavailable' ) !== false ) { + $text = __( 'Your license key has expired and cannot be activated.', 'acf' ); + + $text .= sprintf( + ' %2$s', + acf_add_url_utm_tags( + 'https://www.advancedcustomfields.com/my-account/subscriptions/', + 'activation error', + 'license key expired' + ), + __( 'View your subscriptions', 'acf' ) + ); + + return $text; + } elseif ( strpos( $text, 'Activation limit reached' ) !== false ) { + $text = __( 'You have reached the activation limit for the license.', 'acf' ); + + $view_license = sprintf( + '%2$s', + acf_add_url_utm_tags( + 'https://www.advancedcustomfields.com/my-account/view-licenses/', + 'activation error', + 'license limit exceeded' + ), + __( 'View your licenses', 'acf' ) + ); + + // Check again on the updates page if shown, or the field group page if not. + $nonce = wp_create_nonce( 'acf_retry_activation' ); + $base_url = 'edit.php?post_type=acf-field-group'; + if ( acf_pro_is_updates_page_visible() ) { + $base_url .= '&page=acf-settings-updates'; + } + + $check_again = sprintf( + '%2$s', + admin_url( $base_url . '&acf_retry_nonce=' . $nonce ), + __( 'check again', 'acf' ) + ); + + /* translators: %1$s - link to view licenses, %2$s - link to try activating license again */ + $text .= ' ' . sprintf( __( '%1$s or %2$s.', 'acf' ), $view_license, $check_again ); + + return $text; + } elseif ( strpos( $text, 'Invalid Site URL' ) !== false ) { // Support for licenses which are locked to one URL. + return __( 'Your license is not valid for this site URL. Please contact support for assistance.', 'acf' ); + } elseif ( strpos( $text, 'upstream API error' ) !== false ) { + return __( 'An upstream API error occurred when checking your ACF PRO license status. We will retry again shortly.', 'acf' ); + } elseif ( strpos( $text, 'scheduled maintenance' ) !== false ) { + return __( 'The ACF activation service is temporarily unavailable for scheduled maintenance. Please try again later.', 'acf' ); + } elseif ( strpos( $text, 'Something went wrong' ) !== false ) { + return __( 'The ACF activation service is temporarily unavailable. Please try again later.', 'acf' ); + } + + /* translators: %s an untranslatable internal upstream error message */ + return sprintf( __( 'An unknown error occurred while trying to communicate with the ACF activation service: %s.', 'acf' ), $text ); +} + +/** + * Set the automatic activation failure transient + * + * @since 5.11.0 + * + * @param string $error_text string containing the error text message. + * @param string $license_key the license key that was used during the failed activation. + * + * @return void + */ +function acf_pro_set_activation_failure_transient( $error_text, $license_key ) { + acf_pro_set_license_transient( + 'acf_activation_error', + array( + 'error' => $error_text, + 'license' => $license_key, + ), + HOUR_IN_SECONDS + ); +} + +/** + * Get the automatic activation failure transient + * + * @since 5.11.0 + * + * @return array|false Activation failure transient array, or false if it's not set. + */ +function acf_pro_get_activation_failure_transient() { + return acf_pro_get_license_transient( 'acf_activation_error' ); +} + +/** + * Display the stored activation error + * + * @since 5.11.0 + */ +function acf_pro_display_activation_error( $screen ) { + // Return if we're not in admin, or are doing an AJAX request. + if ( ! is_admin() || acf_is_ajax() ) { + return; + } + + // Return if the current user cannot view ACF settings. + if ( ! acf_current_user_can_admin() ) { + return; + } + + // Check if the transient exists. + $activation_data = acf_pro_get_activation_failure_transient(); + + // Return if the transient does not exist. + if ( ! $activation_data ) { + return; + } + + // Return if on an ACF admin screen - we handle those notices differently. + if ( acf_is_acf_admin_screen() ) { + return; + } + + // Check if the license key is defined. If not, delete the transient. + if ( ! defined( 'ACF_PRO_LICENSE' ) || empty( ACF_PRO_LICENSE ) || ! is_string( ACF_PRO_LICENSE ) ) { + acf_pro_delete_license_transient( 'acf_activation_error' ); + return; + } + + // Prepend ACF PRO for context since we're not in an ACF PRO admin screen. + $activation_data['error'] = __( 'ACF PRO —', 'acf' ) . ' ' . $activation_data['error']; + + // Append a retry link if we don't already have a link from upstream. + if ( strpos( $activation_data['error'], 'http' ) === false ) { + $nonce = wp_create_nonce( 'acf_retry_activation' ); + $check_again_url = 'edit.php?post_type=acf-field-group'; + if ( acf_pro_is_updates_page_visible() ) { + $check_again_url .= '&page=acf-settings-updates'; + } + $activation_data['error'] = $activation_data['error'] . ' ' . __( 'Check again', 'acf' ) . ''; + } + + // Add a non-dismissible error message with the activation error. + acf_add_admin_notice( acf_esc_html( $activation_data['error'] ), 'error', false ); +} + +/** + * This function will return the license + * + * @since 5.4.0 + * + * @return array|boolean $license The ACF PRO license array on success, or false on failure. + */ +function acf_pro_get_license() { + // get license data + $license = acf_pro_get_license_option( 'acf_pro_license' ); + + // bail early if no value + if ( ! $license ) { + return false; + } + + // decode + $license = acf_maybe_unserialize( base64_decode( $license ) ); + + // bail early if corrupt + if ( ! is_array( $license ) ) { + return false; + } + + // return + return $license; +} + +/** + * Return the original home url inside ACF's home url getter. + * + * @since 6.0.1 + * + * @param string $home_url The multilingual plugin converted home URL. + * @param string $url The original home URL. + * + * @return string $url + */ +function acf_pro_license_ml_intercept( $home_url, $url ) { + return $url; +} + +/** + * Is the updates page visible. + * + * @since 6.2.4 + * + * @return boolean true if the updates page should be hidden as we're not the primary multisite site. + */ +function acf_pro_is_updates_page_visible() { + // Hide the updates page if we're a multisite subsite, legacy multisite, and the primary site is active. + if ( acf_is_multisite_sub_site() ) { + $status = get_blog_option( get_main_site_id(), 'acf_pro_license_status', array() ); + + if ( acf_pro_is_legacy_multisite( $status ) && acf_pro_is_license_active( $status ) ) { + return false; + } + } + + return acf_get_setting( 'show_updates' ); +} + +/** + * Returns the license key. + * + * @since 5.4.0 + * + * @param boolean $skip_url_check Skip the check of the current site url. + * @return string|boolean License key on success, or false on failure. + */ +function acf_pro_get_license_key( $skip_url_check = false ) { + $license = acf_pro_get_license(); + + // Bail early if empty. + if ( empty( $license['key'] ) ) { + return false; + } + + // Bail if URL has changed since activating license. + if ( ! $skip_url_check && acf_pro_has_license_url_changed( $license ) ) { + return false; + } + + return $license['key']; +} + +/** + * This function will update the DB license + * + * @since 5.4.0 + * + * @param string $key The license key. + * @return boolean The result of the update_option call + */ +function acf_pro_update_license( $key = '' ) { + + // vars + $value = ''; + + // key + if ( $key ) { + + // vars + $data = array( + 'key' => $key, + 'url' => acf_get_home_url(), + ); + + // encode + $value = base64_encode( maybe_serialize( $data ) ); + } + + // re-register update (key has changed) + acf_register_plugin_update( + array( + 'id' => 'pro', + 'key' => $key, + 'slug' => acf_get_setting( 'slug' ), + 'basename' => acf_get_setting( 'basename' ), + 'version' => acf_get_setting( 'version' ), + ) + ); + + // update + return acf_pro_update_license_option( 'acf_pro_license', $value ); +} + +/** + * Get count of registered ACF Blocks + * + * @return integer + */ +function acf_pro_get_registered_block_count() { + return acf_get_store( 'block-types' )->count(); +} + +/** + * Activates the submitted license key + * Formally ACF_Admin_Updates::activate_pro_licence since 5.0.0 + * + * @since 5.11.0 + * + * @param string $license_key License key to activate. + * @param boolean $silent Return errors rather than displaying them. + * @param boolean $automatic True if this activation is happening automatically. + * @return mixed $response A wp-error instance, or an array with a boolean success key, and string message key. + */ +function acf_pro_activate_license( $license_key, $silent = false, $automatic = false ) { + + // Connect to API. + $post = array( + 'acf_license' => trim( $license_key ), + 'acf_version' => acf_get_setting( 'version' ), + 'wp_name' => get_bloginfo( 'name' ), + 'wp_url' => acf_get_home_url(), + 'wp_version' => get_bloginfo( 'version' ), + 'wp_language' => get_bloginfo( 'language' ), + 'wp_timezone' => get_option( 'timezone_string' ), + 'wp_multisite' => (int) is_multisite(), + 'php_version' => PHP_VERSION, + 'block_count' => acf_pro_get_registered_block_count(), + ); + + $activation_url = 'v2/plugins/activate?p=pro'; + if ( $automatic ) { + if ( ! apply_filters( 'acf/automatic_license_reactivation', true ) ) { + return false; + } + $activation_url .= '&automatic=true'; + } + + // Remove the current license status. + acf_pro_delete_license_transient( 'acf_activation_error' ); + acf_pro_remove_license_status(); + + $response = acf_updates()->request( $activation_url, $post ); + $expiration = acf_updates()->get_expiration( $response, DAY_IN_SECONDS ); + + // Check response is expected JSON array (not string). + if ( is_string( $response ) ) { + $response = new WP_Error( 'server_error', esc_html( $response ) ); + } + + // Display error. + if ( is_wp_error( $response ) ) { + if ( ! $silent ) { + acf_pro_display_wp_activation_error( $response ); + } + return $response; + } + + $success = false; + + // On success. + if ( $response['status'] == 1 ) { + + // Update license and clear out existing license status. + acf_pro_update_license( $response['license'] ); + + if ( ! empty( $response['license_status'] ) && is_array( $response['license_status'] ) ) { + $response['license_status']['next_check'] = time() + $expiration; + acf_pro_update_license_status( $response['license_status'] ); + } + + // Refresh plugins transient to fetch new update data. + acf_updates()->refresh_plugins_transient(); + + // Show notice. + if ( ! $silent ) { + acf_add_admin_notice( acf_esc_html( acf_pro_get_translated_connect_message( $response['message'] ) ), 'success' ); + } + + $success = true; + + // On failure. + } else { + + // Show notice. + if ( ! $silent ) { + acf_add_admin_notice( acf_esc_html( acf_pro_get_translated_connect_message( $response['message'] ) ), 'warning' ); + } + } + + // Return status array for automated activation error notices + return array( + 'success' => $success, + 'message' => $response['message'], + ); +} + +/** + * Deactivates the registered license key. + * Formally ACF_Admin_Updates::deactivate_pro_licence since 5.0.0 + * + * @since 5.11.0 + * + * @param boolean $silent Return errors rather than displaying them + * @return mixed $response A wp-error instance, or an array with a boolean success key, and string message key + */ +function acf_pro_deactivate_license( $silent = false ) { + + // Get license key. + $license = acf_pro_get_license_key( true ); + + // Bail early if no key. + if ( ! $license ) { + return false; + } + + // Connect to API. + $post = array( + 'acf_license' => $license, + 'wp_url' => acf_get_home_url(), + ); + $response = acf_updates()->request( 'v2/plugins/deactivate?p=pro', $post ); + + // Remove license key and status from DB. + acf_pro_update_license( '' ); + acf_pro_remove_license_status(); + + // Check response is expected JSON array (not string). + if ( is_string( $response ) ) { + $response = new WP_Error( 'server_error', esc_html( $response ) ); + } + + // Display error. + if ( is_wp_error( $response ) ) { + if ( ! $silent ) { + acf_pro_display_wp_activation_error( $response ); + } + return $response; + } + + // Refresh plugins transient to fetch new update data. + acf_updates()->refresh_plugins_transient(); + + $success = $response['status'] == 1; + + if ( ! $silent ) { + $notice_class = $success ? 'info' : 'warning'; + acf_add_admin_notice( acf_esc_html( acf_pro_get_translated_connect_message( $response['message'] ) ), $notice_class ); + } + + // Return status array for automated activation error notices + return array( + 'success' => $success, + 'message' => $response['message'], + ); +} + + +/** + * Adds an admin notice using the provided WP_Error. + * + * @since 5.7.10 + * + * @param WP_Error $wp_error The error to display. + */ +function acf_pro_display_wp_activation_error( $wp_error ) { + + // Only show one error on page. + if ( acf_has_done( 'display_wp_error' ) ) { + return; + } + + // Create new notice. + acf_new_admin_notice( + array( + 'text' => __( 'Could not connect to the activation server', 'acf' ) . ' (' . esc_html( $wp_error->get_error_message() ) . ').', + 'type' => 'error', + ) + ); +} + +/** + * Returns the status of the current ACF PRO license. + * + * @since 6.2.2 + * + * @param boolean $force_check If we should force a call to the API. + * @return array + */ +function acf_pro_get_license_status( $force_check = false ) { + $store = acf_get_store( 'acf_pro_license_status' ); + $cached = $store->get_data(); + + if ( ! empty( $cached ) && ! $force_check ) { + return $cached; + } + + $license = acf_pro_get_license_key( true ); + + // Defined licenses may not have a license stored in the database. + if ( ! $license && defined( 'ACF_PRO_LICENSE' ) && acf_pro_get_license() ) { + $license = ACF_PRO_LICENSE; + } + + $status = acf_pro_get_license_option( 'acf_pro_license_status', array() ); + $next_check = isset( $status['next_check'] ) ? (int) $status['next_check'] : 0; + + if ( ! is_array( $status ) ) { + $status = array(); + } + + // If we don't have a license, remove any existing status. + if ( empty( $license ) && ! empty( $status ) ) { + acf_pro_remove_license_status(); + $status = array(); + } + + // Call the API if necessary, if we have a license. + if ( ( empty( $status ) || $force_check || time() > $next_check ) && $license ) { + if ( ! get_transient( 'acf_pro_validating_license' ) || $force_check ) { + set_transient( 'acf_pro_validating_license', true, 15 * MINUTE_IN_SECONDS ); + + $post = array( + 'acf_license' => $license, + 'wp_url' => acf_get_home_url(), + ); + + $response = acf_updates()->request( 'v2/plugins/validate?p=pro', $post ); + $expiration = acf_updates()->get_expiration( $response ); + + if ( is_array( $response ) ) { + if ( ! empty( $response['license_status'] ) ) { + $status = $response['license_status']; + } + + // Handle errors from connect. + if ( ! empty( $response['code'] ) && 'activation_not_found' === $response['code'] ) { + + // If our activation is no longer found and the user has a defined license, deactivate the license and let the automatic reactivation attempt happen. + if ( defined( 'ACF_PRO_LICENSE' ) ) { + acf_pro_update_license( '' ); + acf_pro_check_defined_license(); + } else { + $status['error_msg'] = sprintf( + /* translators: %s - URL to ACF updates page */ + __( 'Your license key is valid but not activated on this site. Please deactivate and then reactivate the license.', 'acf' ), + esc_url( admin_url( 'edit.php?post_type=acf-field-group&page=acf-settings-updates#deactivate-license' ) ) + ); + } + } elseif ( ! empty( $response['message'] ) ) { + $status['error_msg'] = acf_esc_html( acf_pro_get_translated_connect_message( $response['message'] ) ); + } + } + + $status['next_check'] = time() + $expiration; + acf_pro_update_license_status( $status ); + } + } + + $status = acf_pro_parse_license_status( $status ); + $store->set( $status ); + + return $status; +} + +/** + * Makes sure the ACF PRO license status is in a format we expect. + * + * @since 6.2.2 + * + * @param array $status The license status. + * @return array + */ +function acf_pro_parse_license_status( $status = array() ) { + $status = is_array( $status ) ? $status : array(); + $default = array( + 'status' => '', + 'created' => 0, + 'expiry' => 0, + 'name' => '', + 'lifetime' => false, + 'refunded' => false, + 'view_licenses_url' => '', + 'manage_subscription_url' => '', + 'error_msg' => '', + 'next_check' => time() + 3 * HOUR_IN_SECONDS, + ); + + return wp_parse_args( $status, $default ); +} + +/** + * Updates the ACF PRO license status. + * + * @since 6.2.2 + * + * @param array $status The current license status. + * @return boolean True if the value was set, false otherwise. + */ +function acf_pro_update_license_status( $status ) { + $status = acf_pro_parse_license_status( $status ); + $store = acf_get_store( 'acf_pro_license_status' ); + + $store->set( $status ); + + return acf_pro_update_license_option( + 'acf_pro_license_status', + $status, + true + ); +} + +/** + * Removes the ACF PRO license status. + * + * @since 6.2 + * + * @return boolean True if the transient was deleted, false otherwise. + */ +function acf_pro_remove_license_status() { + $store = acf_get_store( 'acf_pro_license_status' ); + $store->reset(); + + return acf_pro_delete_license_option( 'acf_pro_license_status' ); +} + +/** + * Checks if the current license is active. + * + * @since 6.2.2 + * + * @param array $status Optional license status array. + * @return boolean True if active, false if not. + */ +function acf_pro_is_license_active( $status = array() ) { + if ( empty( $status ) ) { + $status = acf_pro_get_license_status(); + } + + return 'active' === $status['status']; +} + +/** + * Checks if the current license is expired. + * + * @since 6.2.2 + * + * @param array $status Optional license status array. + * @return boolean True if expired, false if not. + */ +function acf_pro_is_license_expired( $status = array() ) { + if ( empty( $status ) ) { + $status = acf_pro_get_license_status(); + } + + if ( acf_pro_was_license_refunded( $status ) ) { + return false; + } + + return in_array( $status['status'], array( 'expired', 'cancelled' ), true ); +} + +/** + * Checks if the current license was refunded. + * + * @since 6.2.2 + * + * @param array $status Optional license status array. + * @return boolean True if refunded, false if not. + */ +function acf_pro_was_license_refunded( $status = array() ) { + if ( empty( $status ) ) { + $status = acf_pro_get_license_status(); + } + + return ! empty( $status['refunded'] ); +} + +/** + * Checks if the `home_url` has changed since license activation. + * + * @since 6.2.2 + * + * @param array $license Optional ACF license array. + * @param string $url An optional URL to provide. + * @return boolean True if the URL has changed, false otherwise. + */ +function acf_pro_has_license_url_changed( $license = array(), $url = '' ) { + $license = ! empty( $license ) ? $license : acf_pro_get_license(); + $home_url = ! empty( $url ) ? $url : acf_get_home_url(); + + // We can't know without a license, so let's assume not. + if ( ! is_array( $license ) || empty( $license['url'] ) ) { + return false; + } + + // We don't care if the protocol changed. + $license_url = acf_strip_protocol( (string) $license['url'] ); + $home_url = acf_strip_protocol( $home_url ); + + // Treat www the same as non-www. + if ( substr( $license_url, 0, 4 ) === 'www.' ) { + $license_url = substr( $license_url, 4 ); + } + + if ( substr( $home_url, 0, 4 ) === 'www.' ) { + $home_url = substr( $home_url, 4 ); + } + + // URLs do not match. + if ( $license_url !== $home_url ) { + return true; + } + + return false; +} + +/** + * Attempts to reactivate the license if the URL has changed. + * + * @since 6.2.3 + * + * @return void + */ +function acf_pro_maybe_reactivate_license() { + // Defined licenses have separate logic. + if ( defined( 'ACF_PRO_LICENSE' ) ) { + return; + } + + // Bail if we're in an AJAX request, or tried this recently. + if ( acf_is_ajax() || acf_pro_get_license_transient( 'acf_pro_license_reactivated' ) ) { + return; + } + + $license = acf_pro_get_license(); + + // Nothing to do if URL hasn't changed. + if ( empty( $license['key'] ) || empty( $license['url'] ) || ! acf_pro_has_license_url_changed( $license ) ) { + return; + } + + // Set a transient, so we don't keep trying this in a short period. + acf_pro_set_license_transient( 'acf_pro_license_reactivated', true, HOUR_IN_SECONDS ); + + // Prevent subsequent attempts at reactivation by updating the license URL. + acf_pro_update_license( $license['key'] ); + + // Attempt to reactivate the license with the current URL. + $reactivation = acf_pro_activate_license( $license['key'], true, true ); + + // Update license status on failure. + if ( is_wp_error( $reactivation ) || ! is_array( $reactivation ) || empty( $reactivation['success'] ) ) { + $license_status = acf_pro_get_license_status(); + $license_status['status'] = 'inactive'; + + if ( is_array( $reactivation ) && ! empty( $reactivation['message'] ) ) { + $license_status['error_msg'] = sprintf( + /* translators: %s - more details about the error received */ + __( "Your site URL has changed since last activating your license, but we weren't able to automatically reactivate it: %s", 'acf' ), + acf_pro_get_translated_connect_message( $reactivation['message'] ) + ); + } + + acf_pro_update_license_status( $license_status ); + } else { + acf_add_admin_notice( + __( 'ACF PRO —', 'acf' ) . ' ' . __( "Your site URL has changed since last activating your license. We've automatically activated it for this site URL.", 'acf' ), + 'success' + ); + } +} + +/** + * Gets the URL to the "My Account" section for an ACF license. + * + * @since 6.2.3 + * + * @param array $status Optional license status array. + * @return string + */ +function acf_pro_get_manage_license_url( $status = array() ) { + if ( empty( $status ) ) { + $status = acf_pro_get_license_status(); + } + + $url = 'https://www.advancedcustomfields.com/my-account/view-licenses/'; + + if ( ! empty( $status['manage_subscription_url'] ) ) { + $url = $status['manage_subscription_url']; + } elseif ( ! empty( $status['view_licenses_url'] ) ) { + $url = $status['view_licenses_url']; + } + + return $url; +} + +/** + * Returns a multisite compatible licensing data value + * For multisite installs, this is from the main site options if available or the normal option otherwise. + * + * @since 6.2.6 + * + * @param string $option_name The option name to load. + * @param mixed $default_value The default value to return if not set. + * @return mixed the resulting option value from cache or database. + */ +function acf_pro_get_license_option( $option_name, $default_value = false ) { + if ( acf_pro_is_legacy_multisite() ) { + return get_blog_option( get_main_site_id(), $option_name, $default_value ); + } + + return get_option( $option_name, $default_value ); +} + +/** + * Updates a multisite compatible licensing data value + * For multisite installs, this is from the main site options if available or the normal option otherwise. + * + * @since 6.2.6 + * + * @param string $option_name The option name to update. + * @param mixed $value The new value to set. + * @param boolean $autoload True if the option should be autoloaded. + * @return boolean True if the value was updated, false otherwise. + */ +function acf_pro_update_license_option( $option_name, $value = false, $autoload = false ) { + if ( acf_pro_is_legacy_multisite() ) { + $main_site_id = get_main_site_id(); + if ( $main_site_id !== get_current_blog_id() ) { + switch_to_blog( $main_site_id ); + $return = update_option( $option_name, $value, $autoload ); + restore_current_blog(); + return $return; + } + } + + return update_option( $option_name, $value, $autoload ); +} + +/** + * Deletes a multisite compatible licensing data value + * For multisite installs, this is from the main site options if available or the normal option otherwise. + * + * @since 6.2.6 + * + * @param string $option_name The option name to load. + * @return boolean The result of the deletion request. + */ +function acf_pro_delete_license_option( $option_name ) { + if ( acf_pro_is_legacy_multisite() && acf_is_multisite_sub_site() ) { + return delete_blog_option( get_main_site_id(), $option_name ); + } + + return delete_option( $option_name ); +} + +/** + * Returns a license related transient + * For multisite installs, this is from the network, otherwise from the normal transient function. + * + * @since 6.2.6 + * + * @param string $transient_name The name of the transient to return. + * @return mixed the resulting transient value from cache or database. + */ +function acf_pro_get_license_transient( $transient_name ) { + if ( acf_pro_is_legacy_multisite() ) { + return get_site_transient( $transient_name ); + } else { + return get_transient( $transient_name ); + } +} + +/** + * Updates a license related transient + * For multisite installs, this is from the network, otherwise from the normal transient function. + * + * @since 6.2.6 + * + * @param string $name The name of the transient to update. + * @param mixed $value The new value of the transient. + * @return mixed The result of the set function. + */ +function acf_pro_set_license_transient( $name, $value ) { + if ( acf_pro_is_legacy_multisite() ) { + return set_site_transient( $name, $value ); + } else { + return set_transient( $name, $value ); + } +} + +/** + * Deletes a license related transient + * For multisite installs, this is from the network, otherwise from the normal transient function. + * + * @since 6.2.6 + * + * @param string $transient_name The name of the transient to return. + * @return boolean True if the transient was deleted, false otherwise. + */ +function acf_pro_delete_license_transient( $transient_name ) { + if ( acf_pro_is_legacy_multisite() ) { + return delete_site_transient( $transient_name ); + } else { + return delete_transient( $transient_name ); + } +} + +/** + * Checks if the current license allows the legacy multisite behavior if we're on a multisite install. + * + * @since 6.2.6 + * + * @param array $status Optional license status array. + * @return boolean True if legacy multisite, false if not. + */ +function acf_pro_is_legacy_multisite( array $status = array() ) { + if ( ! is_multisite() ) { + return false; + } + + if ( empty( $status ) ) { + $status = get_blog_option( get_main_site_id(), 'acf_pro_license_status', array() ); + } + + if ( ! is_array( $status ) || ! isset( $status['legacy_multisite'] ) ) { + return false; + } + + return $status['legacy_multisite'] === true; +} diff --git a/wp-content/plugins/advanced-custom-fields/readme.txt b/wp-content/plugins/advanced-custom-fields-pro/readme.txt old mode 100755 new mode 100644 similarity index 99% rename from wp-content/plugins/advanced-custom-fields/readme.txt rename to wp-content/plugins/advanced-custom-fields-pro/readme.txt index 780530ce..e740be0b --- a/wp-content/plugins/advanced-custom-fields/readme.txt +++ b/wp-content/plugins/advanced-custom-fields-pro/readme.txt @@ -1,4 +1,4 @@ -=== Advanced Custom Fields (ACF®) === +=== Advanced Custom Fields (ACF®) PRO === Contributors: deliciousbrains, wpengine, elliotcondon, mattshaw, lgladdy, antpb, johnstonphilip, dalewilliams, polevaultweb Tags: acf, fields, custom fields, meta, repeater Requires at least: 6.2 diff --git a/wp-content/plugins/advanced-custom-fields/src/Blocks/Bindings.php b/wp-content/plugins/advanced-custom-fields-pro/src/Blocks/Bindings.php old mode 100755 new mode 100644 similarity index 100% rename from wp-content/plugins/advanced-custom-fields/src/Blocks/Bindings.php rename to wp-content/plugins/advanced-custom-fields-pro/src/Blocks/Bindings.php diff --git a/wp-content/plugins/advanced-custom-fields-pro/src/Blocks/index.php b/wp-content/plugins/advanced-custom-fields-pro/src/Blocks/index.php new file mode 100644 index 00000000..97611c0c --- /dev/null +++ b/wp-content/plugins/advanced-custom-fields-pro/src/Blocks/index.php @@ -0,0 +1,2 @@ +field = $field; + $this->layout = $layout; + $this->order = $order; + $this->value = $value; + $this->disabled = $disabled; + $this->renamed = $renamed; + } + + /** + * Renders the layout. + * + * @since 6.5 + * + * @return void + */ + public function render() { + $id = 'row-' . $this->order; + $class = 'layout'; + + if ( 'acfcloneindex' === $this->order ) { + $id = 'acfcloneindex'; + $class .= ' acf-clone'; + } + + $this->prefix = $this->field['name'] . '[' . $id . ']'; + + $div_attrs = array( + 'class' => $class, + 'data-id' => $id, + 'data-layout' => $this->layout['name'], + 'data-label' => $this->layout['label'], + 'data-min' => $this->layout['min'], + 'data-max' => $this->layout['max'], + 'data-enabled' => $this->disabled ? 0 : 1, + 'data-renamed' => empty( $this->renamed ) ? 0 : 1, + ); + + echo '
'; // Layout wrapper div.
+
+ acf_hidden_input(
+ array(
+ 'name' => $this->prefix . '[acf_fc_layout]',
+ 'value' => $this->layout['name'],
+ )
+ );
+
+ acf_hidden_input(
+ array(
+ 'class' => 'acf-fc-layout-disabled',
+ 'name' => $this->prefix . '[acf_fc_layout_disabled]',
+ 'value' => $this->disabled ? 1 : 0,
+ )
+ );
+
+ acf_hidden_input(
+ array(
+ 'class' => 'acf-fc-layout-custom-label',
+ 'name' => $this->prefix . '[acf_fc_layout_custom_label]',
+ 'value' => $this->renamed,
+ )
+ );
+
+ $this->action_buttons();
+
+ if ( ! empty( $this->layout['sub_fields'] ) ) {
+ if ( 'table' === $this->layout['display'] ) {
+ $this->render_as_table();
+ } else {
+ $this->render_as_div();
+ }
+ }
+
+ echo '
'; // End layout wrapper div.
+ }
+
+ /**
+ * Renders a layout as a table.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function render_as_table() {
+ $sub_fields = $this->layout['sub_fields'];
+ ?>
+ | '; + acf_render_field_label( $sub_field ); + acf_render_field_instructions( $sub_field ); + echo ' | '; + } + ?> +
|---|
';
+ $this->sub_fields();
+ echo '
';
+ }
+
+ /**
+ * Renders the layout actions (Add, Duplicate, Rename).
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function action_buttons() {
+ $title = $this->get_title();
+ $order = is_numeric( $this->order ) ? $this->order + 1 : 0;
+ ?>
+
+
+ layout['sub_fields'] as $sub_field ) {
+
+ // add value
+ if ( isset( $this->value[ $sub_field['key'] ] ) ) {
+
+ // this is a normal value
+ $sub_field['value'] = $this->value[ $sub_field['key'] ];
+ } elseif ( isset( $sub_field['default_value'] ) ) {
+
+ // no value, but this sub field has a default value
+ $sub_field['value'] = $sub_field['default_value'];
+ }
+
+ // update prefix to allow for nested values
+ $sub_field['prefix'] = $this->prefix;
+
+ // Render the input.
+ $el = 'table' === $this->layout['display'] ? 'td' : 'div';
+ acf_render_field_wrap( $sub_field, $el );
+ }
+ }
+
+ /**
+ * Returns the filtered layout title.
+ *
+ * @since 6.5
+ *
+ * @return string
+ */
+ public function get_title() {
+ $rows = array();
+ $rows[ $this->order ] = $this->value;
+
+ acf_add_loop(
+ array(
+ 'selector' => $this->field['name'],
+ 'name' => $this->field['name'],
+ 'value' => $rows,
+ 'field' => $this->field,
+ 'i' => $this->order,
+ 'post_id' => 0,
+ )
+ );
+
+ // Make the title filterable.
+ $title = esc_html( $this->layout['label'] );
+ $title = apply_filters( 'acf/fields/flexible_content/layout_title', $title, $this->field, $this->layout, $this->order );
+ $title = apply_filters( 'acf/fields/flexible_content/layout_title/name=' . $this->field['_name'], $title, $this->field, $this->layout, $this->order );
+ $title = apply_filters( 'acf/fields/flexible_content/layout_title/key=' . $this->field['key'], $title, $this->field, $this->layout, $this->order );
+ $title = acf_esc_html( $title );
+
+ acf_remove_loop();
+ reset_rows(); // TODO: Make sure this is actually where this should go if needed at all.
+
+ return $title;
+ }
+}
diff --git a/wp-content/plugins/advanced-custom-fields-pro/src/Pro/Fields/FlexibleContent/Render.php b/wp-content/plugins/advanced-custom-fields-pro/src/Pro/Fields/FlexibleContent/Render.php
new file mode 100644
index 00000000..8cb8b451
--- /dev/null
+++ b/wp-content/plugins/advanced-custom-fields-pro/src/Pro/Fields/FlexibleContent/Render.php
@@ -0,0 +1,271 @@
+field = $field;
+ $this->layout_meta = $layout_meta;
+ $this->setup();
+ }
+
+ /**
+ * Prepares the field for rendering.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function setup() {
+ $layouts = array();
+
+ if ( ! empty( $this->field['layouts'] ) ) {
+ foreach ( $this->field['layouts'] as $layout ) {
+ $layouts[ $layout['name'] ] = $layout;
+ }
+ }
+
+ $this->layouts = $layouts;
+ }
+
+ /**
+ * Renders the Flexible Content field.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ public function render() {
+ $div_attrs = array(
+ 'class' => 'acf-flexible-content',
+ 'data-min' => $this->field['min'],
+ 'data-max' => $this->field['max'],
+ 'data-button-label' => $this->field['button_label'],
+ );
+
+ if ( empty( $this->field['value'] ) ) {
+ $div_attrs['class'] .= ' -empty';
+ }
+
+ echo '
+
+
+
+ renamed ) ? esc_html( $this->renamed ) : $title; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. ?>
+
+
+ ()
+
+
+
+
+ '; // Main wrapper div.
+
+ acf_hidden_input( array( 'name' => $this->field['name'] ) );
+
+ $this->actions( 'top' );
+ $this->no_value_message();
+ $this->clones();
+ $this->layouts();
+ $this->actions( 'bottom' );
+ $this->add_layout_menu();
+ $this->more_layout_actions();
+
+ echo '
'; // End main wrapper div.
+ }
+
+ /**
+ * Renders the no value message.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function no_value_message() {
+ // translators: %s the button label used for adding a new layout.
+ $no_value_message = __( 'Click the "%s" button below to start creating your layout', 'acf' );
+ $no_value_message = apply_filters( 'acf/fields/flexible_content/no_value_message', $no_value_message, $this->field );
+ $no_value_message = sprintf( $no_value_message, $this->field['button_label'] );
+
+ echo '';
+ }
+
+ /**
+ * Renders the ACF clone indexes for the layouts.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function clones() {
+ echo '';
+
+ if ( ! empty( $this->layouts ) ) {
+ foreach ( $this->layouts as $layout ) {
+ $clone = new Layout( $this->field, $layout, 'acfcloneindex', array() );
+ $clone->render();
+ }
+ }
+
+ echo '
';
+ }
+
+ /**
+ * Renders the layouts for a Flexible Content field.
+ *
+ * @since 6.5
+ *
+ * @return void
+ */
+ private function layouts() {
+ echo '';
+
+ $disabled_layouts = ! empty( $this->layout_meta['disabled'] ) ? $this->layout_meta['disabled'] : array();
+ $renamed_layouts = ! empty( $this->layout_meta['renamed'] ) ? $this->layout_meta['renamed'] : array();
+
+ if ( ! empty( $this->field['value'] ) ) {
+ foreach ( $this->field['value'] as $order => $value ) {
+ if ( ! is_array( $value ) ) {
+ continue;
+ }
+
+ if ( empty( $this->layouts[ $value['acf_fc_layout'] ] ) ) {
+ continue;
+ }
+
+ $layout = new Layout(
+ $this->field,
+ $this->layouts[ $value['acf_fc_layout'] ],
+ $order,
+ $value,
+ in_array( $order, $disabled_layouts, true ),
+ ! empty( $renamed_layouts[ $order ] ) ? $renamed_layouts[ $order ] : '',
+ );
+
+ $layout->render();
+ }
+ }
+
+ echo '
';
+ }
+
+ /**
+ * Renders top-level actions for the Flexible Content field.
+ *
+ * @since 6.5
+ *
+ * @param string $which The location of the actions, either 'top' or 'bottom'.
+ * @return void
+ */
+ private function actions( string $which = '' ) {
+ if ( 'top' === $which ) {
+ ?>
+
+
+
+
+
+
+ field['button_label'] ); ?>
+
+
+
+
+ - ';
+ foreach ( $this->layouts as $layout ) {
+ $safe_label = acf_esc_html( $layout['label'] );
+ $atts = array(
+ 'href' => '#',
+ 'data-layout' => $layout['name'],
+ 'data-min' => $layout['min'],
+ 'data-max' => $layout['max'],
+ 'title' => $safe_label,
+ );
+ printf( '
- %s ', acf_esc_attrs( $atts ), $safe_label ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped above. + } + echo '
-
+
+
- + + + + () + + + +