Файловый менеджер

Файловый менеджер - Редактировать - /home/beautybuzzbeyond/public_html/wp-content/plugins/advanced-custom-fields/includes/acf-field-functions.php

Назад
<?php // Register store. acf_register_store( 'fields' )->prop( 'multisite', true ); /** * acf_get_field * * Retrieves a field for the given identifier. * * @date 17/1/19 * @since 5.7.10 * * @param (int\|string) $id The field ID, key or name. * @return (array\|false) The field array. / function acf_get_field( $id = 0 ) { // Allow WP_Post to be passed. if ( is_object( $id ) ) { $id = $id->ID; } // Check store. $store = acf_get_store( 'fields' ); if ( $store->has( $id ) ) { return $store->get( $id ); } // Check local fields first. if ( acf_is_local_field( $id ) ) { $field = acf_get_local_field( $id ); // Then check database. } else { $field = acf_get_raw_field( $id ); } // Bail early if no field. if ( ! $field ) { return false; } // Validate field. $field = acf_validate_field( $field ); // Set input prefix. $field['prefix'] = 'acf'; /* * Filters the $field array after it has been loaded. * * @date 12/02/2014 * @since 5.0.0 * * @param array The field array. / $field = apply_filters( 'acf/load_field', $field ); // Store field using aliasses to also find via key, ID and name. $store->set( $field['key'], $field ); $store->alias( $field['key'], $field['ID'], $field['name'] ); // Return. return $field; } // Register variation. acf_add_filter_variations( 'acf/load_field', array( 'type', 'name', 'key' ), 0 ); /* * acf_get_raw_field * * Retrieves raw field data for the given identifier. * * @date 18/1/19 * @since 5.7.10 * * @param (int\|string) $id The field ID, key or name. * @return (array\|false) The field array. / function acf_get_raw_field( $id = 0 ) { // Get raw field from database. $post = acf_get_field_post( $id ); if ( ! $post ) { return false; } // Bail early if incorrect post type. if ( $post->post_type !== 'acf-field' ) { return false; } // Unserialize post_content. $field = (array) acf_maybe_unserialize( $post->post_content ); // update attributes $field['ID'] = $post->ID; $field['key'] = $post->post_name; $field['label'] = $post->post_title; $field['name'] = $post->post_excerpt; $field['menu_order'] = $post->menu_order; $field['parent'] = $post->post_parent; // Return field. return $field; } /* * acf_get_field_post * * Retrieves the field's WP_Post object. * * @date 18/1/19 * @since 5.7.10 * * @param (int\|string) $id The field ID, key or name. * @return (array\|false) The field array. / function acf_get_field_post( $id = 0 ) { // Get post if numeric. if ( is_numeric( $id ) ) { return get_post( $id ); // Search posts if is string. } elseif ( is_string( $id ) ) { // Determine id type. $type = acf_is_field_key( $id ) ? 'key' : 'name'; // Try cache. $cache_key = acf_cache_key( "acf_get_field_post:$type:$id" ); $post_id = wp_cache_get( $cache_key, 'acf' ); if ( $post_id === false ) { // Query posts. $posts = get_posts( array( 'posts_per_page' => 1, 'post_type' => 'acf-field', 'orderby' => 'menu_order title', 'order' => 'ASC', 'suppress_filters' => false, 'cache_results' => true, 'update_post_meta_cache' => false, 'update_post_term_cache' => false, "acf_field_$type" => $id, ) ); // Update $post_id with a non false value. $post_id = $posts ? $posts[0]->ID : 0; // Update cache. wp_cache_set( $cache_key, $post_id, 'acf' ); } // Check $post_id and return the post when possible. if ( $post_id ) { return get_post( $post_id ); } } // Return false by default. return false; } /* * acf_is_field_key * * Returns true if the given identifier is a field key. * * @date 6/12/2013 * @since 5.0.0 * * @param string $id The identifier. * @return boolean / function acf_is_field_key( $id = '' ) { // Check if $id is a string starting with "field_". if ( is_string( $id ) && substr( $id, 0, 6 ) === 'field_' ) { return true; } /* * Filters whether the $id is a field key. * * @date 23/1/19 * @since 5.7.10 * * @param bool $bool The result. * @param string $id The identifier. / return apply_filters( 'acf/is_field_key', false, $id ); } /* * acf_validate_field * * Ensures the given field valid. * * @date 18/1/19 * @since 5.7.10 * * @param array $field The field array. * @return array / function acf_validate_field( $field = array() ) { // Bail early if already valid. if ( is_array( $field ) && ! empty( $field['_valid'] ) ) { return $field; } // Apply defaults. $field = wp_parse_args( $field, array( 'ID' => 0, 'key' => '', 'label' => '', 'name' => '', 'aria-label' => '', 'prefix' => '', 'type' => 'text', 'value' => null, 'menu_order' => 0, 'instructions' => '', 'required' => false, 'id' => '', 'class' => '', 'conditional_logic' => false, 'parent' => 0, 'wrapper' => array(), // 'attributes' => array() ) ); // Convert types. $field['ID'] = (int) $field['ID']; $field['menu_order'] = (int) $field['menu_order']; // Add backwards compatibility for wrapper attributes. // Todo: Remove need for this. $field['wrapper'] = wp_parse_args( $field['wrapper'], array( 'width' => '', 'class' => '', 'id' => '', ) ); // Store backups. $field['_name'] = $field['name']; $field['_valid'] = 1; /* * Filters the $field array to validate settings. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / $field = apply_filters( 'acf/validate_field', $field ); // return return $field; } // Register variation. acf_add_filter_variations( 'acf/validate_field', array( 'type' ), 0 ); /* * acf_get_valid_field * * Ensures the given field valid. * * @date 28/09/13 * @since 5.0.0 * * @param array $field The field array. * @return array / function acf_get_valid_field( $field = false ) { return acf_validate_field( $field ); } /* * acf_translate_field * * Translates a field's settings. * * @date 8/03/2016 * @since 5.3.2 * * @param array $field The field array. * @return array / function acf_translate_field( $field = array() ) { // Get settings. $l10n = acf_get_setting( 'l10n' ); $l10n_textdomain = acf_get_setting( 'l10n_textdomain' ); // Translate field settings if textdomain is set. if ( $l10n && $l10n_textdomain ) { $field['label'] = acf_translate( $field['label'] ); $field['instructions'] = acf_translate( $field['instructions'] ); /* * Filters the $field array to translate strings. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / $field = apply_filters( 'acf/translate_field', $field ); } // Return field. return $field; } // Register variation. acf_add_filter_variations( 'acf/translate_field', array( 'type' ), 0 ); // Translate fields passing through validation. add_action( 'acf/validate_field', 'acf_translate_field' ); /* * acf_get_fields * * Returns and array of fields for the given $parent. * * @date 30/09/13 * @since 5.0.0 * * @param (int\|string\|array) $parent The field group or field settings. Also accepts the field group ID or key. * @return array / function acf_get_fields( $parent ) { // Allow field group selector as $parent. if ( ! is_array( $parent ) ) { $parent = acf_get_field_group( $parent ); if ( ! $parent ) { return array(); } } // Vars. $fields = array(); // Check local fields first. if ( acf_have_local_fields( $parent['key'] ) ) { $raw_fields = acf_get_local_fields( $parent['key'] ); foreach ( $raw_fields as $raw_field ) { $fields[] = acf_get_field( $raw_field['key'] ); } // Then check database. } else { $raw_fields = acf_get_raw_fields( $parent['ID'] ); foreach ( $raw_fields as $raw_field ) { $fields[] = acf_get_field( $raw_field['ID'] ); } } /* * Filters the $fields array. * * @date 12/02/2014 * @since 5.0.0 * * @param array $fields The array of fields. / $fields = apply_filters( 'acf/load_fields', $fields, $parent ); // Return fields return $fields; } /* * acf_get_raw_fields * * Returns and array of raw field data for the given parent id. * * @date 18/1/19 * @since 5.7.10 * * @param integer $id The field group or field id. * @return array / function acf_get_raw_fields( $id = 0 ) { // Try cache. $cache_key = acf_cache_key( "acf_get_field_posts:$id" ); $post_ids = wp_cache_get( $cache_key, 'acf' ); if ( $post_ids === false ) { // Query posts. $posts = get_posts( array( 'posts_per_page' => -1, 'post_type' => 'acf-field', 'orderby' => 'menu_order', 'order' => 'ASC', 'suppress_filters' => true, // DO NOT allow WPML to modify the query 'cache_results' => true, 'update_post_meta_cache' => false, 'update_post_term_cache' => false, 'post_parent' => $id, 'post_status' => array( 'publish', 'trash' ), ) ); // Update $post_ids with a non false value. $post_ids = array(); foreach ( $posts as $post ) { $post_ids[] = $post->ID; } // Update cache. wp_cache_set( $cache_key, $post_ids, 'acf' ); } // Loop over ids and populate array of fields. $fields = array(); foreach ( $post_ids as $post_id ) { $fields[] = acf_get_raw_field( $post_id ); } // Return fields. return $fields; } /* * acf_get_field_count * * Return the number of fields for the given field group. * * @date 17/10/13 * @since 5.0.0 * * @param array $parent The field group or field array. * @return integer / function acf_get_field_count( $parent ) { // Check local fields first. if ( acf_have_local_fields( $parent['key'] ) ) { $raw_fields = acf_get_local_fields( $parent['key'] ); // Then check database. } else { $raw_fields = acf_get_raw_fields( $parent['ID'] ); } /* * Filters the counted number of fields. * * @date 12/02/2014 * @since 5.0.0 * * @param int $count The number of fields. * @param array $parent The field group or field array. / return apply_filters( 'acf/get_field_count', count( $raw_fields ), $parent ); } /* * acf_clone_field * * Allows customization to a field when it is cloned. Used by the clone field. * * @date 8/03/2016 * @since 5.3.2 * * @param array $field The field being cloned. * @param array $clone_field The clone field. * @return array / function acf_clone_field( $field, $clone_field ) { // Add reference to the clone field. $field['_clone'] = $clone_field['key']; /* * Filters the $field array when it is being cloned. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. * @param array $clone_field The clone field array. / $field = apply_filters( 'acf/clone_field', $field, $clone_field ); // Return field. return $field; } // Register variation. acf_add_filter_variations( 'acf/clone_field', array( 'type' ), 0 ); /* * acf_prepare_field * * Prepare a field for input. * * @date 20/1/19 * @since 5.7.10 * * @param array $field The field array. * @return array / function acf_prepare_field( $field ) { // Bail early if already prepared. if ( ! empty( $field['_prepare'] ) ) { return $field; } // Use field key to override input name. if ( $field['key'] ) { $field['name'] = $field['key']; } // Use field prefix to modify input name. if ( ! empty( $field['prefix'] ) ) { $field['name'] = "{$field['prefix']}[{$field['name']}]"; } // Generate id attribute from name. $field['id'] = acf_idify( $field['name'] ); // Add state to field. $field['_prepare'] = true; /* * Filters the $field array. * * Allows developers to modify field settings or return false to remove field. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / $field = apply_filters( 'acf/prepare_field', $field ); // return return $field; } // Register variation. acf_add_filter_variations( 'acf/prepare_field', array( 'type', 'name', 'key' ), 0 ); /* * acf_render_fields * * Renders an array of fields. Also loads the field's value. * * @date 8/10/13 * @since 5.0.0 * @since 5.6.9 Changed parameter order. * * @param array $fields An array of fields. * @param (int\|string) $post_id The post ID to load values from. * @param string $element The wrapping element type. * @param string $instruction The instruction render position (label\|field). * @return void / function acf_render_fields( $fields, $post_id = 0, $el = 'div', $instruction = 'label' ) { // Parameter order changed in ACF 5.6.9. if ( is_array( $post_id ) ) { $args = func_get_args(); $fields = $args[1]; $post_id = $args[0]; } /* * Filters the $fields array before they are rendered. * * @date 12/02/2014 * @since 5.0.0 * * @param array $fields An array of fields. * @param (int\|string) $post_id The post ID to load values from. / $fields = apply_filters( 'acf/pre_render_fields', $fields, $post_id ); // Filter our false results. $fields = array_filter( $fields ); // Loop over and render fields. if ( $fields ) { foreach ( $fields as $field ) { $field = apply_filters( 'acf/pre_render_field', $field, $post_id ); // Load value if not already loaded. if ( $field['value'] === null ) { $field['value'] = acf_get_value( $post_id, $field ); } // Render wrap. acf_render_field_wrap( $field, $el, $instruction ); } } /* * Fires after fields have been rendered. * * @date 12/02/2014 * @since 5.0.0 * * @param array $fields An array of fields. * @param (int\|string) $post_id The post ID to load values from. / do_action( 'acf/render_fields', $fields, $post_id ); } /* * Render the wrapping element for a given field. * * @since 5.0.0 * * @param array $field The field array. * @param string $element The wrapping element type. * @param string $instruction The instruction render position (label\|field). * @param boolean $field_setting If a field setting is being rendered. * @return void / function acf_render_field_wrap( $field, $element = 'div', $instruction = 'label', $field_setting = false ) { // Ensure field is complete (adds all settings). $field = acf_validate_field( $field ); // Prepare field for input (modifies settings). $field = acf_prepare_field( $field ); // Allow filters to cancel render. if ( ! $field ) { return; } // Determine wrapping element. $elements = array( 'div' => 'div', 'tr' => 'td', 'td' => 'div', 'ul' => 'li', 'ol' => 'li', 'dl' => 'dt', ); if ( isset( $elements[ $element ] ) ) { $inner_element = $elements[ $element ]; } else { $element = $inner_element = 'div'; } // Generate wrapper attributes. $wrapper = array( 'id' => '', 'class' => 'acf-field', 'width' => '', 'style' => '', 'data-name' => $field['_name'], 'data-type' => $field['type'], 'data-key' => $field['key'], ); // Add field type attributes. $wrapper['class'] .= " acf-field-{$field['type']}"; // add field key attributes if ( $field['key'] ) { $wrapper['class'] .= " acf-field-{$field['key']}"; } // Add required attributes. // Todo: Remove data-required if ( $field['required'] ) { $wrapper['class'] .= ' is-required'; $wrapper['data-required'] = 1; } // Support custom attributes. if ( ! empty( $field['data'] ) && is_array( $field['data'] ) ) { foreach ( $field['data'] as $name => $attr ) { $wrapper[ 'data-' . $name ] = $attr; } unset( $field['data'] ); } // Clean up class attribute. $wrapper['class'] = str_replace( '_', '-', $wrapper['class'] ); $wrapper['class'] = str_replace( 'field-field-', 'field-', $wrapper['class'] ); // Merge in field 'wrapper' setting without destroying class and style. if ( $field['wrapper'] ) { $wrapper = acf_merge_attributes( $wrapper, $field['wrapper'] ); } // Extract wrapper width and generate style. // Todo: Move from $wrapper out into $field. $width = acf_extract_var( $wrapper, 'width' ); if ( $width ) { $width = acf_numval( $width ); if ( $element !== 'tr' && $element !== 'td' ) { $wrapper['data-width'] = $width; $wrapper['style'] .= " width:{$width}%;"; } } // Clean up all attributes. $wrapper = array_map( 'trim', $wrapper ); $wrapper = array_filter( $wrapper ); /* * Filters the $wrapper array before rendering. * * @date 21/1/19 * @since 5.7.10 * * @param array $wrapper The wrapper attributes array. * @param array $field The field array. / $wrapper = apply_filters( 'acf/field_wrapper_attributes', $wrapper, $field ); // Append conditional logic attributes. if ( ! empty( $field['conditional_logic'] ) ) { $wrapper['data-conditions'] = $field['conditional_logic']; } if ( ! empty( $field['conditions'] ) ) { $wrapper['data-conditions'] = $field['conditions']; } // Escaped vars for render. $attributes_html = acf_esc_attrs( $wrapper ); $element = esc_attr( $element ); $inner_element = esc_attr( $inner_element ); // Render HTML echo "<$element $attributes_html>\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. if ( $element !== 'td' ) { echo "<$inner_element class=\"acf-label\">\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. acf_render_field_label( $field ); if ( $instruction == 'label' ) { acf_render_field_instructions( $field, $field_setting ); } echo "</$inner_element>\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. } echo "<$inner_element class=\"acf-input\">\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. acf_render_field( $field ); if ( ! $field_setting && $instruction == 'field' ) { acf_render_field_instructions( $field ); } echo "</$inner_element>\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. if ( $field_setting && $instruction === 'field' ) { acf_render_field_instructions( $field ); } echo "</$element>\n"; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. } /* * acf_render_field * * Render the input element for a given field. * * @date 21/1/19 * @since 5.7.10 * * @param array $field The field array. * @return void / function acf_render_field( $field ) { // Ensure field is complete (adds all settings). $field = acf_validate_field( $field ); // Prepare field for input (modifies settings). $field = acf_prepare_field( $field ); // Allow filters to cancel render. if ( ! $field ) { return; } /* * Fires when rendering a field. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / do_action( 'acf/render_field', $field ); } // Register variation. acf_add_action_variations( 'acf/render_field', array( 'type', 'name', 'key' ), 0 ); /* * acf_render_field_label * * Renders the field's label. * * @date 19/9/17 * @since 5.6.3 * * @param array $field The field array. * @return void / function acf_render_field_label( $field ) { // Get label. $label = acf_get_field_label( $field ); // Output label. if ( $label ) { echo '<label' . ( $field['id'] ? ' for="' . esc_attr( $field['id'] ) . '"' : '' ) . '>' . acf_esc_html( $label ) . '</label>'; } } /* * acf_get_field_label * * Returns the field's label with appropriate required label. * * @date 4/11/2013 * @since 5.0.0 * * @param array $field The field array. * @param string $context The output context (admin). * @return string The field label in HTML format. / function acf_get_field_label( $field, $context = '' ) { // Get label. $label = $field['label']; // Display empty text when editing field. if ( $context == 'admin' && $label === '' ) { $label = __( '(no label)', 'acf' ); } // Add required HTML. if ( $field['required'] ) { $label .= ' <span class="acf-required"></span>'; } /** * Filters the field's label HTML. * * @date 21/1/19 * @since 5.7.10 * * @param string The label HTML. * @param array $field The field array. * @param string $context The output context (admin). / $label = apply_filters( 'acf/get_field_label', $label, $field, $context ); // Return label. return $label; } /* * Renders the field's instructions. * * @since 5.6.3 * * @param array $field The field array. * @param boolean $tooltip If the instructions are being rendered as a tooltip. * @return void / function acf_render_field_instructions( $field, $tooltip = false ) { if ( $field['instructions'] ) { $instructions = acf_esc_html( $field['instructions'] ); if ( $tooltip ) { printf( '<div class="acf-tip"><i tabindex="0" class="acf-icon acf-icon-help acf-js-tooltip" title="%s">?</i></div>', esc_attr( $instructions ) ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. } else { printf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. } } elseif ( ! empty( $field['hint'] ) ) { $instructions = acf_esc_html( $field['hint'] ); printf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function. } } /* * acf_render_field_setting * * Renders a field setting used in the admin edit screen. * * @date 21/1/19 * @since 5.7.10 * * @param array $field The field array. * @param array $setting The settings field array. * @param boolean $global Whether this setting is a global or field type specific one. * @return void / function acf_render_field_setting( $field, $setting, $global = false ) { // Validate field. $setting = acf_validate_field( $setting ); // Add custom attributes to setting wrapper. $setting['wrapper']['data-key'] = $setting['name']; $setting['wrapper']['class'] .= ' acf-field-setting-' . $setting['name']; if ( ! $global ) { $setting['wrapper']['data-setting'] = $field['type']; } // Add classes for appended and prepended fields. if ( ! empty( $setting['append'] ) ) { $setting['wrapper']['class'] .= ' acf-field-appended'; } if ( ! empty( $setting['prepend'] ) ) { $setting['wrapper']['class'] .= ' acf-field-prepended'; } // Copy across prefix. $setting['prefix'] = $field['prefix']; // Find setting value from field. if ( $setting['value'] === null ) { // Name. if ( isset( $field[ $setting['name'] ] ) ) { $setting['value'] = $field[ $setting['name'] ]; // Default value. } elseif ( isset( $setting['default_value'] ) ) { $setting['value'] = $setting['default_value']; } } // Add append attribute used by JS to join settings. if ( isset( $setting['_append'] ) ) { $setting['wrapper']['data-append'] = $setting['_append']; } // If we're using a hint, set the label location as field so it appears after. $label_location = ! empty( $setting['instructions'] ) ? 'field' : 'label'; // If we're a true false field, force label location to label. if ( $setting['type'] === 'true_false' ) { $label_location = 'label'; } // Render setting. acf_render_field_wrap( $setting, 'div', $label_location ); } /* * acf_update_field * * Updates a field in the database. * * @date 21/1/19 * @since 5.7.10 * * @param array $field The field array. * @param array $specific An array of specific field attributes to update. * @return array / function acf_update_field( $field, $specific = array() ) { // Validate field. $field = acf_validate_field( $field ); // May have been posted. Remove slashes. $field = wp_unslash( $field ); // Parse types (converts string '0' to int 0). $field = acf_parse_types( $field ); // Clean up conditional logic keys. if ( $field['conditional_logic'] ) { // Remove empty values and convert to associated array. $field['conditional_logic'] = array_filter( $field['conditional_logic'] ); $field['conditional_logic'] = array_values( $field['conditional_logic'] ); $field['conditional_logic'] = array_map( 'array_filter', $field['conditional_logic'] ); $field['conditional_logic'] = array_map( 'array_values', $field['conditional_logic'] ); } // Parent may be provided as a field key. if ( $field['parent'] && ! is_numeric( $field['parent'] ) ) { $parent = acf_get_field_post( $field['parent'] ); $field['parent'] = $parent ? $parent->ID : 0; } /* * Filters the $field array before it is updated. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / $field = apply_filters( 'acf/update_field', $field ); // Make a backup of field data and remove some args. $_field = $field; acf_extract_vars( $_field, array( 'ID', 'key', 'label', 'name', 'prefix', 'value', 'menu_order', 'id', 'class', 'parent', '_name', '_prepare', '_valid' ) ); // Create array of data to save. $save = array( 'ID' => $field['ID'], 'post_status' => 'publish', 'post_type' => 'acf-field', 'post_title' => $field['label'], 'post_name' => $field['key'], 'post_excerpt' => $field['name'], 'post_content' => maybe_serialize( $_field ), 'post_parent' => $field['parent'], 'menu_order' => $field['menu_order'], ); // Reduce save data if specific key list is provided. if ( $specific ) { $specific[] = 'ID'; $save = acf_get_sub_array( $save, $specific ); } // Unhook wp_targeted_link_rel() filter from WP 5.1 corrupting serialized data. remove_filter( 'content_save_pre', 'wp_targeted_link_rel' ); // Slash data. // WP expects all data to be slashed and will unslash it (fixes '\' character issues). $save = wp_slash( $save ); // Update or Insert. if ( $field['ID'] ) { wp_update_post( $save ); } else { $field['ID'] = wp_insert_post( $save ); } // Flush field cache. acf_flush_field_cache( $field ); /* * Fires after a field has been updated, and the field cache has been cleaned. * * @date 24/1/19 * @since 5.7.10 * * @param array $field The field array. / do_action( 'acf/updated_field', $field ); // Return field. return $field; } // Register variation. acf_add_filter_variations( 'acf/update_field', array( 'type', 'name', 'key' ), 0 ); /* * _acf_apply_unique_field_slug * * Allows full control over 'acf-field' slugs. * * @date 21/1/19 * @since 5.7.10 * * @param string $slug The post slug. * @param integer $post_ID Post ID. * @param string $post_status The post status. * @param string $post_type Post type. * @param integer $post_parent Post parent ID * @param string $original_slug The original post slug. / function _acf_apply_unique_field_slug( $slug, $post_ID, $post_status, $post_type, $post_parent, $original_slug ) { // Check post type and reset to original value. if ( $post_type === 'acf-field' ) { return $original_slug; } // Return slug. return $slug; } // Hook into filter. add_filter( 'wp_unique_post_slug', '_acf_apply_unique_field_slug', 999, 6 ); /* * acf_flush_field_cache * * Deletes all caches for this field. * * @date 22/1/19 * @since 5.7.10 * * @param array $field The field array. * @return void / function acf_flush_field_cache( $field ) { // Delete stored data. acf_get_store( 'fields' )->remove( $field['key'] ); // Flush cached post_id for this field's name and key. wp_cache_delete( acf_cache_key( "acf_get_field_post:name:{$field['name']}" ), 'acf' ); wp_cache_delete( acf_cache_key( "acf_get_field_post:key:{$field['key']}" ), 'acf' ); // Flush cached array of post_ids for this field's parent. wp_cache_delete( acf_cache_key( "acf_get_field_posts:{$field['parent']}" ), 'acf' ); } /* * acf_delete_field * * Deletes a field from the database. * * @date 21/1/19 * @since 5.7.10 * * @param (int\|string) $id The field ID, key or name. * @return boolean True if field was deleted. / function acf_delete_field( $id = 0 ) { // Get the field. $field = acf_get_field( $id ); // Bail early if field was not found. if ( ! $field \|\| ! $field['ID'] ) { return false; } // Delete post. wp_delete_post( $field['ID'], true ); // Flush field cache. acf_flush_field_cache( $field ); /* * Fires immediately after a field has been deleted. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / do_action( 'acf/delete_field', $field ); // Return true. return true; } // Register variation. acf_add_action_variations( 'acf/delete_field', array( 'type', 'name', 'key' ), 0 ); /* * acf_trash_field * * Trashes a field from the database. * * @date 2/10/13 * @since 5.0.0 * * @param (int\|string) $id The field ID, key or name. * @return boolean True if field was trashed. / function acf_trash_field( $id = 0 ) { // Get the field. $field = acf_get_field( $id ); // Bail early if field was not found. if ( ! $field \|\| ! $field['ID'] ) { return false; } // Trash post. wp_trash_post( $field['ID'], true ); /* * Fires immediately after a field has been trashed. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / do_action( 'acf/trash_field', $field ); // Return true. return true; } /* * acf_untrash_field * * Restores a field from the trash. * * @date 2/10/13 * @since 5.0.0 * * @param (int\|string) $id The field ID, key or name. * @return boolean True if field was trashed. / function acf_untrash_field( $id = 0 ) { // Get the field. $field = acf_get_field( $id ); // Bail early if field was not found. if ( ! $field \|\| ! $field['ID'] ) { return false; } // Untrash post. wp_untrash_post( $field['ID'], true ); // Flush field cache. acf_flush_field_cache( $field ); /* * Fires immediately after a field has been trashed. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / do_action( 'acf/untrash_field', $field ); // Return true. return true; } /* * Filter callback which returns the previous post_status instead of "draft" for the "acf-field" post type. * * Prior to WordPress 5.6.0, this filter was not needed as restored posts were always assigned their original status. * * @since 5.9.5 * * @param string $new_status The new status of the post being restored. * @param integer $post_id The ID of the post being restored. * @param string $previous_status The status of the post at the point where it was trashed. * @return string. / function _acf_untrash_field_post_status( $new_status, $post_id, $previous_status ) { return ( get_post_type( $post_id ) === 'acf-field' ) ? $previous_status : $new_status; } add_action( 'wp_untrash_post_status', '_acf_untrash_field_post_status', 10, 3 ); /* * acf_prefix_fields * * Changes the prefix for an array of fields by reference. * * @date 5/9/17 * @since 5.6.0 * * @param array $fields An array of fields. * @param string $prefix The new prefix. * @return void / function acf_prefix_fields( &$fields, $prefix = 'acf' ) { // Loopover fields. foreach ( $fields as &$field ) { // Replace 'acf' with $prefix. $field['prefix'] = $prefix . substr( $field['prefix'], 3 ); } } /* * acf_get_sub_field * * Searches a field for sub fields matching the given selector. * * @date 21/1/19 * @since 5.7.10 * * @param (int\|string) $id The field ID, key or name. * @param array $field The parent field array. * @return (array\|false) / function acf_get_sub_field( $id, $field ) { // Vars. $sub_field = false; // Search sub fields. if ( isset( $field['sub_fields'] ) ) { $sub_field = acf_search_fields( $id, $field['sub_fields'] ); } /* * Filters the $sub_field found. * * @date 12/02/2014 * @since 5.0.0 * * @param array $sub_field The found sub field array. * @param string $selector The selector used to search. * @param array $field The parent field array. / $sub_field = apply_filters( 'acf/get_sub_field', $sub_field, $id, $field ); // return return $sub_field; } // Register variation. acf_add_filter_variations( 'acf/get_sub_field', array( 'type' ), 2 ); /* * acf_search_fields * * Searches an array of fields for one that matches the given identifier. * * @date 12/2/19 * @since 5.7.11 * * @param (int\|string) $id The field ID, key or name. * @param array $haystack The array of fields. * @return (int\|false) / function acf_search_fields( $id, $fields ) { // Loop over searchable keys in order of priority. // Important to search "name" on all fields before "_name" backup. foreach ( array( 'key', 'name', '_name', '__name' ) as $key ) { // Loop over fields and compare. foreach ( $fields as $field ) { if ( isset( $field[ $key ] ) && $field[ $key ] === $id ) { return $field; } } } // Return not found. return false; } /* * acf_is_field * * Returns true if the given params match a field. * * @date 21/1/19 * @since 5.7.10 * * @param array $field The field array. * @param mixed $id An optional identifier to search for. * @return boolean / function acf_is_field( $field = false, $id = '' ) { return ( is_array( $field ) && isset( $field['key'] ) && isset( $field['name'] ) ); } /* * acf_get_field_ancestors * * Returns an array of ancestor field ID's or keys. * * @date 22/06/2016 * @since 5.3.8 * * @param array $field The field array. * @return array / function acf_get_field_ancestors( $field ) { // Vars. $ancestors = array(); // Loop over parents. while ( $field['parent'] && $field = acf_get_field( $field['parent'] ) ) { $ancestors[] = $field['ID'] ? $field['ID'] : $field['key']; } // return return $ancestors; } /* * acf_duplicate_fields * * Duplicate an array of fields. * * @date 16/06/2014 * @since 5.0.0 * * @param array $fields An array of fields. * @param integer $parent_id The new parent ID. * @return array / function acf_duplicate_fields( $fields = array(), $parent_id = 0 ) { // Generate keys for all new fields // - Needed to alter conditional logic rules // - Use usleep() to ensure unique keys. $keys = array(); foreach ( $fields as $field ) { usleep( 1 ); $keys[ $field['key'] ] = uniqid( 'field_' ); } acf_append_data( 'generated_keys', $keys ); $duplicates = array(); // Duplicate fields. foreach ( $fields as $field ) { $field_id = $field['ID'] ? $field['ID'] : $field['key']; $duplicates[] = acf_duplicate_field( $field_id, $parent_id ); } // Return. return $duplicates; } /* * acf_duplicate_field * * Duplicates a field. * * @date 16/06/2014 * @since 5.0.0 * * @param (int\|string) $id The field ID, key or name. * @param integer $parent_id The new parent ID. * @return boolean True if field was duplicated. / function acf_duplicate_field( $id = 0, $parent_id = 0 ) { // Get the field. $field = acf_get_field( $id ); // Bail early if field was not found. if ( ! $field ) { return false; } // Remove ID to avoid update. $field['ID'] = 0; // Generate key. $keys = acf_get_data( 'generated_keys' ); if ( isset( $keys[ $field['key'] ] ) ) { $field['key'] = $keys[ $field['key'] ]; } else { $field['key'] = uniqid( 'field_' ); } // Set parent. if ( $parent_id ) { $field['parent'] = $parent_id; } // Update conditional logic references because field keys have changed. if ( $field['conditional_logic'] ) { // Loop over groups foreach ( $field['conditional_logic'] as $group_i => $group ) { // Loop over rules foreach ( $group as $rule_i => $rule ) { $field['conditional_logic'][ $group_i ][ $rule_i ]['field'] = isset( $keys[ $rule['field'] ] ) ? $keys[ $rule['field'] ] : $rule['field']; } } } /* * Filters the $field array after it has been duplicated. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / $field = apply_filters( 'acf/duplicate_field', $field ); // Update and return. return acf_update_field( $field ); } // Register variation. acf_add_filter_variations( 'acf/duplicate_field', array( 'type' ), 0 ); /* * acf_prepare_fields_for_export * * Returns a modified array of fields ready for export. * * @date 11/03/2014 * @since 5.0.0 * * @param array $fields An array of fields. * @return array / function acf_prepare_fields_for_export( $fields = array() ) { // Map function and return. return array_map( 'acf_prepare_field_for_export', $fields ); } /* * acf_prepare_field_for_export * * Returns a modified field ready for export. * * @date 11/03/2014 * @since 5.0.0 * * @param array $field The field array. * @return array / function acf_prepare_field_for_export( $field ) { // Remove args. acf_extract_vars( $field, array( 'ID', 'prefix', 'value', 'menu_order', 'id', 'class', 'parent', '_name', '_prepare', '_valid' ) ); /* * Filters the $field array before being returned to the export tool. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. / return apply_filters( 'acf/prepare_field_for_export', $field ); } // Register variation. acf_add_filter_variations( 'acf/prepare_field_for_export', array( 'type' ), 0 ); /* * acf_prepare_field_for_import * * Returns a modified array of fields ready for import. * * @date 11/03/2014 * @since 5.0.0 * * @param array $fields An array of fields. * @return array / function acf_prepare_fields_for_import( $fields = array() ) { // Ensure array is sequential. $fields = array_values( $fields ); // Prepare each field for import making sure to detect additional sub fields. $i = 0; while ( $i < count( $fields ) ) { // Prepare field. $field = acf_prepare_field_for_import( $fields[ $i ] ); // Update single field. if ( isset( $field['key'] ) ) { $fields[ $i ] = $field; // Insert multiple fields. } else { array_splice( $fields, $i, 1, $field ); } // Iterate. ++$i; } /* * Filters the $fields array before being returned to the import tool. * * @date 12/02/2014 * @since 5.0.0 * * @param array $fields The array of fields. / return apply_filters( 'acf/prepare_fields_for_import', $fields ); } /* * acf_prepare_field_for_import * * Returns a modified field ready for import. * Allows parent fields to modify themselves and also return sub fields. * * @date 11/03/2014 * @since 5.0.0 * * @param array $field The field array. * @return array / function acf_prepare_field_for_import( $field ) { /* * Filters the $field array before being returned to the import tool. * * @date 12/02/2014 * @since 5.0.0 * * @param array $field The field array. */ return apply_filters( 'acf/prepare_field_for_import', $field ); } // Register variation. acf_add_filter_variations( 'acf/prepare_field_for_import', array( 'type' ), 0 );

| ver. 1.4 | Github | . | PHP 8.0.30 | Генерация страницы: 0 | proxy | phpinfo | Настройка