Deploying version 6.2.6

Author: mattgrshaw

acf.php

@@ -9,7 +9,7 @@
  * Plugin Name:       Advanced Custom Fields
  * Plugin URI:        https://www.advancedcustomfields.com
  * Description:       Customize WordPress with powerful, professional and intuitive fields.
- * Version:           6.2.5
+ * Version:           6.2.6
  * Author:            WP Engine
  * Author URI:        https://wpengine.com/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=plugin_directory&utm_content=advanced_custom_fields
  * Text Domain:       acf
@@ -35,7 +35,7 @@ class ACF {
 		 *
 		 * @var string
 		 */
-		public $version = '6.2.5';
+		public $version = '6.2.6';
 
 		/**
 		 * The plugin settings array.
@@ -89,6 +89,9 @@ public function initialize() {
 			$this->define( 'ACF_FIELD_API_VERSION', 5 );
 			$this->define( 'ACF_UPGRADE_VERSION', '5.5.0' ); // Highest version with an upgrade routine. See upgrades.php.
 
+			// Register activation hook.
+			register_activation_hook( __FILE__, array( $this, 'acf_plugin_activated' ) );
+
 			// Define settings.
 			$this->settings = array(
 				'name'                    => __( 'Advanced Custom Fields', 'acf' ),
@@ -214,12 +217,6 @@ public function initialize() {
 				acf_include( 'includes/admin/admin-upgrade.php' );
 			}
 
-			// Include polyfill for < PHP7 unserialize.
-			if ( PHP_VERSION_ID < 70000 ) {
-				acf_include( 'vendor/polyfill-unserialize/src/Unserialize.php' );
-				acf_include( 'vendor/polyfill-unserialize/src/DisallowedClassesSubstitutor.php' );
-			}
-
 			// Include legacy.
 			acf_include( 'includes/legacy/legacy-locations.php' );
 
@@ -616,7 +613,7 @@ public function posts_where( $where, $wp_query ) {
 		 * @date    3/5/17
 		 * @since   5.5.13
 		 *
-		 * @param   string $name The constant name.
+		 * @param   string $name  The constant name.
 		 * @param   mixed  $value The constant value.
 		 * @return  void
 		 */
@@ -658,7 +655,7 @@ public function get_setting( $name ) {
 		 * @date    28/09/13
 		 * @since   5.0.0
 		 *
-		 * @param   string $name The setting name.
+		 * @param   string $name  The setting name.
 		 * @param   mixed  $value The setting value.
 		 * @return  true
 		 */
@@ -686,7 +683,7 @@ public function get_data( $name ) {
 		 * @date    28/09/13
 		 * @since   5.0.0
 		 *
-		 * @param   string $name The data name.
+		 * @param   string $name  The data name.
 		 * @param   mixed  $value The data value.
 		 * @return  void
 		 */
@@ -731,7 +728,7 @@ public function new_instance( $class ) {
 		 * @since   5.9.0
 		 *
 		 * @param   string $key Key name.
-		 * @return  bool
+		 * @return  boolean
 		 */
 		public function __isset( $key ) {
 			return in_array( $key, array( 'locations', 'json' ), true );
@@ -755,6 +752,21 @@ public function __get( $key ) {
 			}
 			return null;
 		}
+
+		/**
+		 * Plugin Activation Hook
+		 *
+		 * @since 6.2.6
+		 */
+		public function acf_plugin_activated() {
+			// Set the first activated version of ACF.
+			if ( null === get_option( 'acf_first_activated_version', null ) ) {
+				// If acf_version is set, this isn't the first activated version, so leave it unset so it's legacy.
+				if ( null === get_option( 'acf_version', null ) ) {
+					update_option( 'acf_first_activated_version', ACF_VERSION, true );
+				}
+			}
+		}
 	}
 
 	/**

assets/build/css/acf-field-group.css

@@ -659,11 +659,7 @@ function acf_sanitize_files_value_array( $array, $sanitize_function ) {
  */
 function acf_maybe_unserialize( $data ) {
 	if ( is_serialized( $data ) ) { // Don't attempt to unserialize data that wasn't serialized going in.
-		if ( PHP_VERSION_ID >= 70000 ) {
-			return @unserialize( trim( $data ), array( 'allowed_classes' => false ) ); //phpcs:ignore -- code only runs on PHP7+
-		} else {
-			return @\ACF\Brumann\Polyfill\unserialize::unserialize( trim( $data ), array( 'allowed_classes' => false ) );
-		}
+		return @unserialize( trim( $data ), array( 'allowed_classes' => false ) ); //phpcs:ignore -- allowed classes is false.
 	}
 
 	return $data;

assets/build/css/acf-field-group.css.map

@@ -130,16 +130,15 @@ function acf_get_value( $post_id, $field ) {
 acf_add_filter_variations( 'acf/load_value', array( 'type', 'name', 'key' ), 2 );
 
 /**
- * acf_format_value
- *
  * Returns a formatted version of the provided value.
  *
  * @since   5.0.0
  *
- * @param mixed          $value     The field value.
- * @param integer|string $post_id   The post id.
- * @param array          $field     The field array.
+ * @param mixed          $value       The field value.
+ * @param integer|string $post_id     The post id.
+ * @param array          $field       The field array.
  * @param boolean        $escape_html Ask the field for a HTML safe version of it's output.
+ *
  * @return mixed
  */
 function acf_format_value( $value, $post_id, $field, $escape_html = false ) {
@@ -169,7 +168,6 @@ function acf_format_value( $value, $post_id, $field, $escape_html = false ) {
 	 * @param string  $post_id     The post ID for this value.
 	 * @param array   $field       The field array.
 	 * @param boolean $escape_html Ask the field for a HTML safe version of it's output.
-	 *                             This parameter will not guarantee the result is escaped, only if the field type supports it.
 	 */
 	$value = apply_filters( 'acf/format_value', $value, $post_id, $field, $escape_html );
 

assets/build/css/acf-field-group.min.css

@@ -92,6 +92,9 @@ public function admin_menu() {}
 		 * @return  string
 		 */
 		public function get_admin_url( $params = '' ) {
+			if ( isset( $_GET['paged'] ) ) { //phpcs:ignore WordPress.Security.NonceVerification.Recommended -- used as intval to return a page.
+				$params .= '&paged=' . intval( $_GET['paged'] ); //phpcs:ignore WordPress.Security.NonceVerification.Recommended -- used as intval to return a page.
+			}
 			return admin_url( "edit.php?post_type={$this->post_type}{$params}" );
 		}
 

assets/build/css/acf-global.css

@@ -63,8 +63,8 @@ public function admin_enqueue_scripts() {
 				'acf_escaped_html_notice',
 				array(
 					'nonce'        => wp_create_nonce( 'acf/dismiss_escaped_html_notice' ),
-					'show_details' => __( 'Show details', 'acf' ),
-					'hide_details' => __( 'Hide details', 'acf' ),
+					'show_details' => __( 'Show details', 'acf' ),
+					'hide_details' => __( 'Hide details', 'acf' ),
 				)
 			);
 		}

assets/build/css/acf-global.css.map

@@ -21,9 +21,11 @@
 	$div_attrs['class'] .= ' acf-field-is-endpoint';
 }
 
+
 // Misc template vars.
-$field_label      = acf_get_field_label( $field, 'admin' );
-$field_type_label = acf_get_field_type_label( $field['type'] );
+$field_label         = acf_get_field_label( $field, 'admin' );
+$field_type_label    = acf_get_field_type_label( $field['type'] );
+$field_type_supports = acf_get_field_type_prop( $field['type'], 'supports' );
 
 if ( acf_is_pro() && acf_get_field_type_prop( $field['type'], 'pro' ) && ! acf_pro_is_license_active() ) {
 	$field_type_label .= '<span class="acf-pro-label acf-pro-label-field-type">PRO</span>';
@@ -189,20 +191,6 @@
 								<?php
 								break;
 							case 'validation':
-								// required
-								acf_render_field_setting(
-									$field,
-									array(
-										'label'        => __( 'Required', 'acf' ),
-										'instructions' => '',
-										'type'         => 'true_false',
-										'name'         => 'required',
-										'ui'           => 1,
-										'class'        => 'field-required',
-									),
-									true
-								);
-
 								do_action( "acf/field_group/render_field_settings_tab/{$tab_key}", $field );
 								?>
 								<div class="acf-field-type-settings" data-parent-tab="<?php echo esc_attr( $tab_key ); ?>">

assets/build/css/acf-global.min.css

@@ -2,24 +2,24 @@
 
 $acf_plugin_name      = acf_is_pro() ? 'ACF PRO' : 'ACF';
 $acf_plugin_name      = '<strong>' . $acf_plugin_name . ' &mdash;</strong>';
-$acf_learn_how_to_fix = '<a href="' . acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/escaping-the-field/', 'docs', '6-2-5-security-changes' ) . '" target="_blank">' . __( 'Learn how to fix', 'acf' ) . '</a>';
+$acf_learn_how_to_fix = '<a href="' . acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/escaping-the-field/', 'docs', '6-2-5-security-changes' ) . '" target="_blank">' . __( 'Learn&nbsp;more', 'acf' ) . '</a>';
 $acf_class            = '';
 $acf_user_can_acf     = false;
 
 if ( current_user_can( acf_get_setting( 'capability' ) ) ) {
 	$acf_user_can_acf = true;
-	$acf_show_details = ' <a class="acf-show-more-details" href="#">' . __( 'Show details', 'acf' ) . '</a>';
+	$acf_show_details = ' <a class="acf-show-more-details" href="#">' . __( 'Show&nbsp;details', 'acf' ) . '</a>';
 	$acf_class        = ' is-dismissible';
 } else {
-	$acf_show_details = __( 'Please contact your site admin for more details.', 'acf' );
+	$acf_show_details = __( 'Please contact your site administrator or developer for more details.', 'acf' );
 }
 
 if ( ! empty( $acf_will_escape ) ) {
 	$acf_escaped   = $acf_will_escape;
 	$acf_class    .= ' notice-warning acf-will-escape';
 	$acf_error_msg = sprintf(
 		/* translators: %1$s - name of the ACF plugin. %2$s - Link to documentation. %3$s - Link to show more details about the error */
-		__( '%1$s ACF will soon escape unsafe HTML that is rendered by <code>the_field()</code>. We\'ve detected the output of some of your fields will be modified by this change. %2$s. %3$s', 'acf' ),
+		__( '%1$s ACF will soon escape unsafe HTML that is rendered by <code>the_field()</code>. We\'ve detected the output of some of your fields will be modified by this change, but this may not be a breaking change. %2$s. %3$s.', 'acf' ),
 		$acf_plugin_name,
 		$acf_learn_how_to_fix,
 		$acf_show_details
@@ -30,15 +30,15 @@
 	if ( apply_filters( 'acf/the_field/escape_html_optin', false ) ) {
 		$acf_error_msg = sprintf(
 		/* translators: %1$s - name of the ACF plugin. %2$s - Link to documentation. %3$s - Link to show more details about the error */
-			__( '%1$s ACF now automatically escapes unsafe HTML when rendered by <code>the_field</code> or the ACF shortcode. We\'ve detected the output of some of your fields will be modified by this change. %2$s. %3$s', 'acf' ),
+			__( '%1$s ACF now automatically escapes unsafe HTML when rendered by <code>the_field</code> or the ACF shortcode. We\'ve detected the output of some of your fields has been modified by this change, but this may not be a breaking change. %2$s. %3$s.', 'acf' ),
 			$acf_plugin_name,
 			$acf_learn_how_to_fix,
 			$acf_show_details
 		);
 	} else {
 		$acf_error_msg = sprintf(
 		/* translators: %1$s - name of the ACF plugin. %2$s - Link to documentation. %3$s - Link to show more details about the error */
-			__( '%1$s ACF now automatically escapes unsafe HTML when rendered by the ACF shortcode. We\'ve detected the output of some of your fields will be modified by this change. %2$s. %3$s', 'acf' ),
+			__( '%1$s ACF now automatically escapes unsafe HTML when rendered by the ACF shortcode. We\'ve detected the output of some of your fields has been modified by this change, but this may not be a breaking change. %2$s. %3$s.', 'acf' ),
 			$acf_plugin_name,
 			$acf_learn_how_to_fix,
 			$acf_show_details

assets/build/js/acf-field-group.js.map

@@ -3939,7 +3939,7 @@ function acf_is_block_editor() {
  * @return array The WordPress reserved terms list.
  */
 function acf_get_wp_reserved_terms() {
-	return array( 'action', 'attachment', 'attachment_id', 'author', 'author_name', 'calendar', 'cat', 'category', 'category__and', 'category__in', 'category__not_in', 'category_name', 'comments_per_page', 'comments_popup', 'custom', 'customize_messenger_channel', 'customized', 'cpage', 'day', 'debug', 'embed', 'error', 'exact', 'feed', 'fields', 'hour', 'link_category', 'm', 'minute', 'monthnum', 'more', 'name', 'nav_menu', 'nonce', 'nopaging', 'offset', 'order', 'orderby', 'p', 'page', 'page_id', 'paged', 'pagename', 'pb', 'perm', 'post', 'post__in', 'post__not_in', 'post_format', 'post_mime_type', 'post_status', 'post_tag', 'post_type', 'posts', 'posts_per_archive_page', 'posts_per_page', 'preview', 'robots', 's', 'search', 'second', 'sentence', 'showposts', 'static', 'status', 'subpost', 'subpost_id', 'tag', 'tag__and', 'tag__in', 'tag__not_in', 'tag_id', 'tag_slug__and', 'tag_slug__in', 'taxonomy', 'tb', 'term', 'terms', 'theme', 'title', 'type', 'types', 'w', 'withcomments', 'withoutcomments', 'year' );
+	return array( 'action', 'attachment', 'attachment_id', 'author', 'author_name', 'calendar', 'cat', 'category', 'category__and', 'category__in', 'category__not_in', 'category_name', 'comments_per_page', 'comments_popup', 'custom', 'customize_messenger_channel', 'customized', 'cpage', 'day', 'debug', 'embed', 'error', 'exact', 'feed', 'fields', 'hour', 'link', 'link_category', 'm', 'minute', 'monthnum', 'more', 'name', 'nav_menu', 'nonce', 'nopaging', 'offset', 'order', 'orderby', 'p', 'page', 'page_id', 'paged', 'pagename', 'pb', 'perm', 'post', 'post__in', 'post__not_in', 'post_format', 'post_mime_type', 'post_status', 'post_tag', 'post_type', 'posts', 'posts_per_archive_page', 'posts_per_page', 'preview', 'robots', 's', 'search', 'second', 'sentence', 'showposts', 'static', 'status', 'subpost', 'subpost_id', 'tag', 'tag__and', 'tag__in', 'tag__not_in', 'tag_id', 'tag_slug__and', 'tag_slug__in', 'taxonomy', 'tb', 'term', 'terms', 'theme', 'title', 'type', 'types', 'w', 'withcomments', 'withoutcomments', 'year' );
 }
 
 /**