wp/wp-admin/includes/class-wp-privacy-policy-content.php
changeset 16 a86126ab1dd4
child 18 be944660c56a
equal deleted inserted replaced
15:3d4e9c994f10 16:a86126ab1dd4
       
     1 <?php
       
     2 /**
       
     3  * WP_Privacy_Policy_Content class.
       
     4  *
       
     5  * @package WordPress
       
     6  * @subpackage Administration
       
     7  * @since 4.9.6
       
     8  */
       
     9 
       
    10 final class WP_Privacy_Policy_Content {
       
    11 
       
    12 	private static $policy_content = array();
       
    13 
       
    14 	/**
       
    15 	 * Constructor
       
    16 	 *
       
    17 	 * @since 4.9.6
       
    18 	 */
       
    19 	private function __construct() {}
       
    20 
       
    21 	/**
       
    22 	 * Add content to the postbox shown when editing the privacy policy.
       
    23 	 *
       
    24 	 * Plugins and themes should suggest text for inclusion in the site's privacy policy.
       
    25 	 * The suggested text should contain information about any functionality that affects user privacy,
       
    26 	 * and will be shown in the Suggested Privacy Policy Content postbox.
       
    27 	 *
       
    28 	 * Intended for use from `wp_add_privacy_policy_content()`.
       
    29 	 *
       
    30 	 * @since 4.9.6
       
    31 	 *
       
    32 	 * @param string $plugin_name The name of the plugin or theme that is suggesting content for the site's privacy policy.
       
    33 	 * @param string $policy_text The suggested content for inclusion in the policy.
       
    34 	 */
       
    35 	public static function add( $plugin_name, $policy_text ) {
       
    36 		if ( empty( $plugin_name ) || empty( $policy_text ) ) {
       
    37 			return;
       
    38 		}
       
    39 
       
    40 		$data = array(
       
    41 			'plugin_name' => $plugin_name,
       
    42 			'policy_text' => $policy_text,
       
    43 		);
       
    44 
       
    45 		if ( ! in_array( $data, self::$policy_content, true ) ) {
       
    46 			self::$policy_content[] = $data;
       
    47 		}
       
    48 	}
       
    49 
       
    50 	/**
       
    51 	 * Quick check if any privacy info has changed.
       
    52 	 *
       
    53 	 * @since 4.9.6
       
    54 	 */
       
    55 	public static function text_change_check() {
       
    56 
       
    57 		$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
       
    58 
       
    59 		// The site doesn't have a privacy policy.
       
    60 		if ( empty( $policy_page_id ) ) {
       
    61 			return false;
       
    62 		}
       
    63 
       
    64 		if ( ! current_user_can( 'edit_post', $policy_page_id ) ) {
       
    65 			return false;
       
    66 		}
       
    67 
       
    68 		$old = (array) get_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content' );
       
    69 
       
    70 		// Updates are not relevant if the user has not reviewed any suggestions yet.
       
    71 		if ( empty( $old ) ) {
       
    72 			return false;
       
    73 		}
       
    74 
       
    75 		$cached = get_option( '_wp_suggested_policy_text_has_changed' );
       
    76 
       
    77 		/*
       
    78 		 * When this function is called before `admin_init`, `self::$policy_content`
       
    79 		 * has not been populated yet, so use the cached result from the last
       
    80 		 * execution instead.
       
    81 		 */
       
    82 		if ( ! did_action( 'admin_init' ) ) {
       
    83 			return 'changed' === $cached;
       
    84 		}
       
    85 
       
    86 		$new = self::$policy_content;
       
    87 
       
    88 		// Remove the extra values added to the meta.
       
    89 		foreach ( $old as $key => $data ) {
       
    90 			if ( ! empty( $data['removed'] ) ) {
       
    91 				unset( $old[ $key ] );
       
    92 				continue;
       
    93 			}
       
    94 
       
    95 			$old[ $key ] = array(
       
    96 				'plugin_name' => $data['plugin_name'],
       
    97 				'policy_text' => $data['policy_text'],
       
    98 			);
       
    99 		}
       
   100 
       
   101 		// Normalize the order of texts, to facilitate comparison.
       
   102 		sort( $old );
       
   103 		sort( $new );
       
   104 
       
   105 		// The == operator (equal, not identical) was used intentionally.
       
   106 		// See http://php.net/manual/en/language.operators.array.php
       
   107 		if ( $new != $old ) {
       
   108 			// A plugin was activated or deactivated, or some policy text has changed.
       
   109 			// Show a notice on the relevant screens to inform the admin.
       
   110 			add_action( 'admin_notices', array( 'WP_Privacy_Policy_Content', 'policy_text_changed_notice' ) );
       
   111 			$state = 'changed';
       
   112 		} else {
       
   113 			$state = 'not-changed';
       
   114 		}
       
   115 
       
   116 		// Cache the result for use before `admin_init` (see above).
       
   117 		if ( $cached !== $state ) {
       
   118 			update_option( '_wp_suggested_policy_text_has_changed', $state );
       
   119 		}
       
   120 
       
   121 		return 'changed' === $state;
       
   122 	}
       
   123 
       
   124 	/**
       
   125 	 * Output a warning when some privacy info has changed.
       
   126 	 *
       
   127 	 * @since 4.9.6
       
   128 	 */
       
   129 	public static function policy_text_changed_notice() {
       
   130 		global $post;
       
   131 
       
   132 		$screen = get_current_screen()->id;
       
   133 
       
   134 		if ( 'privacy' !== $screen ) {
       
   135 			return;
       
   136 		}
       
   137 
       
   138 		?>
       
   139 		<div class="policy-text-updated notice notice-warning is-dismissible">
       
   140 			<p>
       
   141 			<?php
       
   142 				printf(
       
   143 					/* translators: %s: Privacy Policy Guide URL. */
       
   144 					__( 'The suggested privacy policy text has changed. Please <a href="%s">review the guide</a> and update your privacy policy.' ),
       
   145 					esc_url( admin_url( 'privacy-policy-guide.php' ) )
       
   146 				);
       
   147 			?>
       
   148 			</p>
       
   149 		</div>
       
   150 		<?php
       
   151 	}
       
   152 
       
   153 	/**
       
   154 	 * Update the cached policy info when the policy page is updated.
       
   155 	 *
       
   156 	 * @since 4.9.6
       
   157 	 * @access private
       
   158 	 *
       
   159 	 * @param int $post_id The ID of the updated post.
       
   160 	 */
       
   161 	public static function _policy_page_updated( $post_id ) {
       
   162 		$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
       
   163 
       
   164 		if ( ! $policy_page_id || $policy_page_id !== (int) $post_id ) {
       
   165 			return;
       
   166 		}
       
   167 
       
   168 		// Remove updated|removed status.
       
   169 		$old          = (array) get_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content' );
       
   170 		$done         = array();
       
   171 		$update_cache = false;
       
   172 
       
   173 		foreach ( $old as $old_key => $old_data ) {
       
   174 			if ( ! empty( $old_data['removed'] ) ) {
       
   175 				// Remove the old policy text.
       
   176 				$update_cache = true;
       
   177 				continue;
       
   178 			}
       
   179 
       
   180 			if ( ! empty( $old_data['updated'] ) ) {
       
   181 				// 'updated' is now 'added'.
       
   182 				$done[]       = array(
       
   183 					'plugin_name' => $old_data['plugin_name'],
       
   184 					'policy_text' => $old_data['policy_text'],
       
   185 					'added'       => $old_data['updated'],
       
   186 				);
       
   187 				$update_cache = true;
       
   188 			} else {
       
   189 				$done[] = $old_data;
       
   190 			}
       
   191 		}
       
   192 
       
   193 		if ( $update_cache ) {
       
   194 			delete_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content' );
       
   195 			// Update the cache.
       
   196 			foreach ( $done as $data ) {
       
   197 				add_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content', $data );
       
   198 			}
       
   199 		}
       
   200 	}
       
   201 
       
   202 	/**
       
   203 	 * Check for updated, added or removed privacy policy information from plugins.
       
   204 	 *
       
   205 	 * Caches the current info in post_meta of the policy page.
       
   206 	 *
       
   207 	 * @since 4.9.6
       
   208 	 *
       
   209 	 * @return array The privacy policy text/information added by core and plugins.
       
   210 	 */
       
   211 	public static function get_suggested_policy_text() {
       
   212 		$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
       
   213 		$checked        = array();
       
   214 		$time           = time();
       
   215 		$update_cache   = false;
       
   216 		$new            = self::$policy_content;
       
   217 		$old            = array();
       
   218 
       
   219 		if ( $policy_page_id ) {
       
   220 			$old = (array) get_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content' );
       
   221 		}
       
   222 
       
   223 		// Check for no-changes and updates.
       
   224 		foreach ( $new as $new_key => $new_data ) {
       
   225 			foreach ( $old as $old_key => $old_data ) {
       
   226 				$found = false;
       
   227 
       
   228 				if ( $new_data['policy_text'] === $old_data['policy_text'] ) {
       
   229 					// Use the new plugin name in case it was changed, translated, etc.
       
   230 					if ( $old_data['plugin_name'] !== $new_data['plugin_name'] ) {
       
   231 						$old_data['plugin_name'] = $new_data['plugin_name'];
       
   232 						$update_cache            = true;
       
   233 					}
       
   234 
       
   235 					// A plugin was re-activated.
       
   236 					if ( ! empty( $old_data['removed'] ) ) {
       
   237 						unset( $old_data['removed'] );
       
   238 						$old_data['added'] = $time;
       
   239 						$update_cache      = true;
       
   240 					}
       
   241 
       
   242 					$checked[] = $old_data;
       
   243 					$found     = true;
       
   244 				} elseif ( $new_data['plugin_name'] === $old_data['plugin_name'] ) {
       
   245 					// The info for the policy was updated.
       
   246 					$checked[]    = array(
       
   247 						'plugin_name' => $new_data['plugin_name'],
       
   248 						'policy_text' => $new_data['policy_text'],
       
   249 						'updated'     => $time,
       
   250 					);
       
   251 					$found        = true;
       
   252 					$update_cache = true;
       
   253 				}
       
   254 
       
   255 				if ( $found ) {
       
   256 					unset( $new[ $new_key ], $old[ $old_key ] );
       
   257 					continue 2;
       
   258 				}
       
   259 			}
       
   260 		}
       
   261 
       
   262 		if ( ! empty( $new ) ) {
       
   263 			// A plugin was activated.
       
   264 			foreach ( $new as $new_data ) {
       
   265 				if ( ! empty( $new_data['plugin_name'] ) && ! empty( $new_data['policy_text'] ) ) {
       
   266 					$new_data['added'] = $time;
       
   267 					$checked[]         = $new_data;
       
   268 				}
       
   269 			}
       
   270 			$update_cache = true;
       
   271 		}
       
   272 
       
   273 		if ( ! empty( $old ) ) {
       
   274 			// A plugin was deactivated.
       
   275 			foreach ( $old as $old_data ) {
       
   276 				if ( ! empty( $old_data['plugin_name'] ) && ! empty( $old_data['policy_text'] ) ) {
       
   277 					$data = array(
       
   278 						'plugin_name' => $old_data['plugin_name'],
       
   279 						'policy_text' => $old_data['policy_text'],
       
   280 						'removed'     => $time,
       
   281 					);
       
   282 
       
   283 					$checked[] = $data;
       
   284 				}
       
   285 			}
       
   286 			$update_cache = true;
       
   287 		}
       
   288 
       
   289 		if ( $update_cache && $policy_page_id ) {
       
   290 			delete_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content' );
       
   291 			// Update the cache.
       
   292 			foreach ( $checked as $data ) {
       
   293 				add_post_meta( $policy_page_id, '_wp_suggested_privacy_policy_content', $data );
       
   294 			}
       
   295 		}
       
   296 
       
   297 		return $checked;
       
   298 	}
       
   299 
       
   300 	/**
       
   301 	 * Add a notice with a link to the guide when editing the privacy policy page.
       
   302 	 *
       
   303 	 * @since 4.9.6
       
   304 	 * @since 5.0.0 The `$post` parameter was made optional.
       
   305 	 *
       
   306 	 * @param WP_Post|null $post The currently edited post. Default null.
       
   307 	 */
       
   308 	public static function notice( $post = null ) {
       
   309 		if ( is_null( $post ) ) {
       
   310 			global $post;
       
   311 		} else {
       
   312 			$post = get_post( $post );
       
   313 		}
       
   314 
       
   315 		if ( ! ( $post instanceof WP_Post ) ) {
       
   316 			return;
       
   317 		}
       
   318 
       
   319 		if ( ! current_user_can( 'manage_privacy_options' ) ) {
       
   320 			return;
       
   321 		}
       
   322 
       
   323 		$current_screen = get_current_screen();
       
   324 		$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
       
   325 
       
   326 		if ( 'post' !== $current_screen->base || $policy_page_id !== $post->ID ) {
       
   327 			return;
       
   328 		}
       
   329 
       
   330 		$message = __( 'Need help putting together your new Privacy Policy page? Check out our guide for recommendations on what content to include, along with policies suggested by your plugins and theme.' );
       
   331 		$url     = esc_url( admin_url( 'privacy-policy-guide.php' ) );
       
   332 		$label   = __( 'View Privacy Policy Guide.' );
       
   333 
       
   334 		if ( get_current_screen()->is_block_editor() ) {
       
   335 			wp_enqueue_script( 'wp-notices' );
       
   336 			$action = array(
       
   337 				'url'   => $url,
       
   338 				'label' => $label,
       
   339 			);
       
   340 			wp_add_inline_script(
       
   341 				'wp-notices',
       
   342 				sprintf(
       
   343 					'wp.data.dispatch( "core/notices" ).createWarningNotice( "%s", { actions: [ %s ], isDismissible: false } )',
       
   344 					$message,
       
   345 					wp_json_encode( $action )
       
   346 				),
       
   347 				'after'
       
   348 			);
       
   349 		} else {
       
   350 			?>
       
   351 			<div class="notice notice-warning inline wp-pp-notice">
       
   352 				<p>
       
   353 				<?php
       
   354 				echo $message;
       
   355 				printf(
       
   356 					' <a href="%s" target="_blank">%s <span class="screen-reader-text">%s</span></a>',
       
   357 					$url,
       
   358 					$label,
       
   359 					/* translators: Accessibility text. */
       
   360 					__( '(opens in a new tab)' )
       
   361 				);
       
   362 				?>
       
   363 				</p>
       
   364 			</div>
       
   365 			<?php
       
   366 		}
       
   367 	}
       
   368 
       
   369 	/**
       
   370 	 * Output the privacy policy guide together with content from the theme and plugins.
       
   371 	 *
       
   372 	 * @since 4.9.6
       
   373 	 */
       
   374 	public static function privacy_policy_guide() {
       
   375 
       
   376 		$content_array = self::get_suggested_policy_text();
       
   377 		$content       = '';
       
   378 		$toc           = array( '<li><a href="#wp-privacy-policy-guide-introduction">' . __( 'Introduction' ) . '</a></li>' );
       
   379 		$date_format   = __( 'F j, Y' );
       
   380 
       
   381 		foreach ( $content_array as $section ) {
       
   382 			$class   = '';
       
   383 			$meta    = '';
       
   384 			$removed = '';
       
   385 
       
   386 			if ( ! empty( $section['removed'] ) ) {
       
   387 				$class = 'text-removed';
       
   388 				$date  = date_i18n( $date_format, $section['removed'] );
       
   389 				/* translators: %s: Date of plugin deactivation. */
       
   390 				$meta = sprintf( __( 'Removed %s.' ), $date );
       
   391 
       
   392 				/* translators: %s: Date of plugin deactivation. */
       
   393 				$removed = __( 'You deactivated this plugin on %s and may no longer need this policy.' );
       
   394 				$removed = '<div class="notice notice-info inline"><p>' . sprintf( $removed, $date ) . '</p></div>';
       
   395 			} elseif ( ! empty( $section['updated'] ) ) {
       
   396 				$class = 'text-updated';
       
   397 				$date  = date_i18n( $date_format, $section['updated'] );
       
   398 				/* translators: %s: Date of privacy policy text update. */
       
   399 				$meta = sprintf( __( 'Updated %s.' ), $date );
       
   400 			}
       
   401 
       
   402 			if ( $meta ) {
       
   403 				$meta = '<br><span class="privacy-text-meta">' . $meta . '</span>';
       
   404 			}
       
   405 
       
   406 			$plugin_name = esc_html( $section['plugin_name'] );
       
   407 			$toc_id      = 'wp-privacy-policy-guide-' . sanitize_title( $plugin_name );
       
   408 			$toc[]       = sprintf( '<li><a href="#%1$s">%2$s</a>' . $meta . '</li>', $toc_id, $plugin_name );
       
   409 
       
   410 			$content .= '<div class="privacy-text-section ' . $class . '">';
       
   411 			$content .= '<a id="' . $toc_id . '">&nbsp;</a>';
       
   412 			/* translators: %s: Plugin name. */
       
   413 			$content .= '<h2>' . sprintf( __( 'Source: %s' ), $plugin_name ) . '</h2>';
       
   414 			$content .= $removed;
       
   415 
       
   416 			$content .= '<div class="policy-text">' . $section['policy_text'] . '</div>';
       
   417 
       
   418 			if ( empty( $section['removed'] ) ) {
       
   419 				$content .= '<div class="privacy-text-actions">';
       
   420 				$content .= '<button type="button" class="privacy-text-copy button">';
       
   421 				$content .= __( 'Copy this section to clipboard' );
       
   422 				$content .= '</button>';
       
   423 				$content .= '<span class="success" aria-hidden="true">' . __( 'Copied!' ) . '</span>';
       
   424 				$content .= '</div>';
       
   425 			}
       
   426 
       
   427 			$content .= '<a href="#wpbody" class="return-to-top"><span aria-hidden="true">&uarr; </span> ' . __( 'Return to top' ) . '</a>';
       
   428 
       
   429 			$content .= '</div>'; // End of .privacy-text-section.
       
   430 		}
       
   431 
       
   432 		if ( count( $toc ) > 2 ) {
       
   433 			?>
       
   434 			<div class="privacy-text-box-toc">
       
   435 				<p><?php _e( 'Table of Contents' ); ?></p>
       
   436 				<ol>
       
   437 					<?php echo implode( $toc ); ?>
       
   438 				</ol>
       
   439 			</div>
       
   440 			<?php
       
   441 		}
       
   442 
       
   443 		?>
       
   444 		<div class="privacy-text-box">
       
   445 			<div class="privacy-text-box-head">
       
   446 				<a id="wp-privacy-policy-guide-introduction">&nbsp;</a>
       
   447 				<h2><?php _e( 'Introduction' ); ?></h2>
       
   448 				<p><?php _e( 'Hello,' ); ?></p>
       
   449 				<p><?php _e( 'This text template will help you to create your web site&#8217;s privacy policy.' ); ?></p>
       
   450 				<p><?php _e( 'We have suggested the sections you will need. Under each section heading you will find a short summary of what information you should provide, which will help you to get started. Some sections include suggested policy content, others will have to be completed with information from your theme and plugins.' ); ?></p>
       
   451 				<p><?php _e( 'Please edit your privacy policy content, making sure to delete the summaries, and adding any information from your theme and plugins. Once you publish your policy page, remember to add it to your navigation menu.' ); ?></p>
       
   452 				<p><?php _e( 'It is your responsibility to write a comprehensive privacy policy, to make sure it reflects all national and international legal requirements on privacy, and to keep your policy current and accurate.' ); ?></p>
       
   453 			</div>
       
   454 
       
   455 			<div class="privacy-text-box-body">
       
   456 				<?php echo $content; ?>
       
   457 			</div>
       
   458 		</div>
       
   459 		<?php
       
   460 	}
       
   461 
       
   462 	/**
       
   463 	 * Return the default suggested privacy policy content.
       
   464 	 *
       
   465 	 * @since 4.9.6
       
   466 	 * @since 5.0.0 Added the `$blocks` parameter.
       
   467 	 *
       
   468 	 * @param bool $description Whether to include the descriptions under the section headings. Default false.
       
   469 	 * @param bool $blocks      Whether to format the content for the block editor. Default true.
       
   470 	 * @return string The default policy content.
       
   471 	 */
       
   472 	public static function get_default_content( $description = false, $blocks = true ) {
       
   473 		$suggested_text = $description ? '<strong class="privacy-policy-tutorial">' . __( 'Suggested text:' ) . ' </strong>' : '';
       
   474 		$content        = '';
       
   475 		$strings        = array();
       
   476 
       
   477 		// Start of the suggested privacy policy text.
       
   478 		if ( $description ) {
       
   479 			$strings[] = '<div class="wp-suggested-text">';
       
   480 		}
       
   481 
       
   482 		/* translators: Default privacy policy heading. */
       
   483 		$strings[] = '<h2>' . __( 'Who we are' ) . '</h2>';
       
   484 
       
   485 		if ( $description ) {
       
   486 			/* translators: Privacy policy tutorial. */
       
   487 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should note your site URL, as well as the name of the company, organization, or individual behind it, and some accurate contact information.' ) . '</p>';
       
   488 			/* translators: Privacy policy tutorial. */
       
   489 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'The amount of information you may be required to show will vary depending on your local or national business regulations. You may, for example, be required to display a physical address, a registered address, or your company registration number.' ) . '</p>';
       
   490 		}
       
   491 
       
   492 		/* translators: Default privacy policy text. %s: Site URL. */
       
   493 		$strings[] = '<p>' . $suggested_text . sprintf( __( 'Our website address is: %s.' ), get_bloginfo( 'url', 'display' ) ) . '</p>';
       
   494 
       
   495 		/* translators: Default privacy policy heading. */
       
   496 		$strings[] = '<h2>' . __( 'What personal data we collect and why we collect it' ) . '</h2>';
       
   497 
       
   498 		if ( $description ) {
       
   499 			/* translators: Privacy policy tutorial. */
       
   500 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should note what personal data you collect from users and site visitors. This may include personal data, such as name, email address, personal account preferences; transactional data, such as purchase information; and technical data, such as information about cookies.' ) . '</p>';
       
   501 			/* translators: Privacy policy tutorial. */
       
   502 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'You should also note any collection and retention of sensitive personal data, such as data concerning health.' ) . '</p>';
       
   503 			/* translators: Privacy policy tutorial. */
       
   504 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In addition to listing what personal data you collect, you need to note why you collect it. These explanations must note either the legal basis for your data collection and retention or the active consent the user has given.' ) . '</p>';
       
   505 			/* translators: Privacy policy tutorial. */
       
   506 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'Personal data is not just created by a user&#8217;s interactions with your site. Personal data is also generated from technical processes such as contact forms, comments, cookies, analytics, and third party embeds.' ) . '</p>';
       
   507 			/* translators: Privacy policy tutorial. */
       
   508 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'By default WordPress does not collect any personal data about visitors, and only collects the data shown on the User Profile screen from registered users. However some of your plugins may collect personal data. You should add the relevant information below.' ) . '</p>';
       
   509 		}
       
   510 
       
   511 		/* translators: Default privacy policy heading. */
       
   512 		$strings[] = '<h3>' . __( 'Comments' ) . '</h3>';
       
   513 
       
   514 		if ( $description ) {
       
   515 			/* translators: Privacy policy tutorial. */
       
   516 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this subsection you should note what information is captured through comments. We have noted the data which WordPress collects by default.' ) . '</p>';
       
   517 		}
       
   518 
       
   519 		/* translators: Default privacy policy text. */
       
   520 		$strings[] = '<p>' . $suggested_text . __( 'When visitors leave comments on the site we collect the data shown in the comments form, and also the visitor&#8217;s IP address and browser user agent string to help spam detection.' ) . '</p>';
       
   521 		/* translators: Default privacy policy text. */
       
   522 		$strings[] = '<p>' . __( 'An anonymized string created from your email address (also called a hash) may be provided to the Gravatar service to see if you are using it. The Gravatar service privacy policy is available here: https://automattic.com/privacy/. After approval of your comment, your profile picture is visible to the public in the context of your comment.' ) . '</p>';
       
   523 
       
   524 		/* translators: Default privacy policy heading. */
       
   525 		$strings[] = '<h3>' . __( 'Media' ) . '</h3>';
       
   526 
       
   527 		if ( $description ) {
       
   528 			/* translators: Privacy policy tutorial. */
       
   529 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this subsection you should note what information may be disclosed by users who can upload media files. All uploaded files are usually publicly accessible.' ) . '</p>';
       
   530 		}
       
   531 
       
   532 		/* translators: Default privacy policy text. */
       
   533 		$strings[] = '<p>' . $suggested_text . __( 'If you upload images to the website, you should avoid uploading images with embedded location data (EXIF GPS) included. Visitors to the website can download and extract any location data from images on the website.' ) . '</p>';
       
   534 
       
   535 		/* translators: Default privacy policy heading. */
       
   536 		$strings[] = '<h3>' . __( 'Contact forms' ) . '</h3>';
       
   537 
       
   538 		if ( $description ) {
       
   539 			/* translators: Privacy policy tutorial. */
       
   540 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'By default, WordPress does not include a contact form. If you use a contact form plugin, use this subsection to note what personal data is captured when someone submits a contact form, and how long you keep it. For example, you may note that you keep contact form submissions for a certain period for customer service purposes, but you do not use the information submitted through them for marketing purposes.' ) . '</p>';
       
   541 		}
       
   542 
       
   543 		/* translators: Default privacy policy heading. */
       
   544 		$strings[] = '<h3>' . __( 'Cookies' ) . '</h3>';
       
   545 
       
   546 		if ( $description ) {
       
   547 			/* translators: Privacy policy tutorial. */
       
   548 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this subsection you should list the cookies your web site uses, including those set by your plugins, social media, and analytics. We have provided the cookies which WordPress installs by default.' ) . '</p>';
       
   549 		}
       
   550 
       
   551 		/* translators: Default privacy policy text. */
       
   552 		$strings[] = '<p>' . $suggested_text . __( 'If you leave a comment on our site you may opt-in to saving your name, email address and website in cookies. These are for your convenience so that you do not have to fill in your details again when you leave another comment. These cookies will last for one year.' ) . '</p>';
       
   553 		/* translators: Default privacy policy text. */
       
   554 		$strings[] = '<p>' . __( 'If you visit our login page, we will set a temporary cookie to determine if your browser accepts cookies. This cookie contains no personal data and is discarded when you close your browser.' ) . '</p>';
       
   555 		/* translators: Default privacy policy text. */
       
   556 		$strings[] = '<p>' . __( 'When you log in, we will also set up several cookies to save your login information and your screen display choices. Login cookies last for two days, and screen options cookies last for a year. If you select &quot;Remember Me&quot;, your login will persist for two weeks. If you log out of your account, the login cookies will be removed.' ) . '</p>';
       
   557 		/* translators: Default privacy policy text. */
       
   558 		$strings[] = '<p>' . __( 'If you edit or publish an article, an additional cookie will be saved in your browser. This cookie includes no personal data and simply indicates the post ID of the article you just edited. It expires after 1 day.' ) . '</p>';
       
   559 
       
   560 		/* translators: Default privacy policy heading. */
       
   561 		$strings[] = '<h3>' . __( 'Embedded content from other websites' ) . '</h3>';
       
   562 		/* translators: Default privacy policy text. */
       
   563 		$strings[] = '<p>' . $suggested_text . __( 'Articles on this site may include embedded content (e.g. videos, images, articles, etc.). Embedded content from other websites behaves in the exact same way as if the visitor has visited the other website.' ) . '</p>';
       
   564 		/* translators: Default privacy policy text. */
       
   565 		$strings[] = '<p>' . __( 'These websites may collect data about you, use cookies, embed additional third-party tracking, and monitor your interaction with that embedded content, including tracking your interaction with the embedded content if you have an account and are logged in to that website.' ) . '</p>';
       
   566 
       
   567 		/* translators: Default privacy policy heading. */
       
   568 		$strings[] = '<h3>' . __( 'Analytics' ) . '</h3>';
       
   569 
       
   570 		if ( $description ) {
       
   571 			/* translators: Privacy policy tutorial. */
       
   572 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this subsection you should note what analytics package you use, how users can opt out of analytics tracking, and a link to your analytics provider&#8217;s privacy policy, if any.' ) . '</p>';
       
   573 			/* translators: Privacy policy tutorial. */
       
   574 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'By default WordPress does not collect any analytics data. However, many web hosting accounts collect some anonymous analytics data. You may also have installed a WordPress plugin that provides analytics services. In that case, add information from that plugin here.' ) . '</p>';
       
   575 		}
       
   576 
       
   577 		/* translators: Default privacy policy heading. */
       
   578 		$strings[] = '<h2>' . __( 'Who we share your data with' ) . '</h2>';
       
   579 
       
   580 		if ( $description ) {
       
   581 			/* translators: Privacy policy tutorial. */
       
   582 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should name and list all third party providers with whom you share site data, including partners, cloud-based services, payment processors, and third party service providers, and note what data you share with them and why. Link to their own privacy policies if possible.' ) . '</p>';
       
   583 			/* translators: Privacy policy tutorial. */
       
   584 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'By default WordPress does not share any personal data with anyone.' ) . '</p>';
       
   585 		}
       
   586 
       
   587 		/* translators: Default privacy policy heading. */
       
   588 		$strings[] = '<h2>' . __( 'How long we retain your data' ) . '</h2>';
       
   589 
       
   590 		if ( $description ) {
       
   591 			/* translators: Privacy policy tutorial. */
       
   592 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should explain how long you retain personal data collected or processed by the web site. While it is your responsibility to come up with the schedule of how long you keep each dataset for and why you keep it, that information does need to be listed here. For example, you may want to say that you keep contact form entries for six months, analytics records for a year, and customer purchase records for ten years.' ) . '</p>';
       
   593 		}
       
   594 
       
   595 		/* translators: Default privacy policy text. */
       
   596 		$strings[] = '<p>' . $suggested_text . __( 'If you leave a comment, the comment and its metadata are retained indefinitely. This is so we can recognize and approve any follow-up comments automatically instead of holding them in a moderation queue.' ) . '</p>';
       
   597 		/* translators: Default privacy policy text. */
       
   598 		$strings[] = '<p>' . __( 'For users that register on our website (if any), we also store the personal information they provide in their user profile. All users can see, edit, or delete their personal information at any time (except they cannot change their username). Website administrators can also see and edit that information.' ) . '</p>';
       
   599 
       
   600 		/* translators: Default privacy policy heading. */
       
   601 		$strings[] = '<h2>' . __( 'What rights you have over your data' ) . '</h2>';
       
   602 
       
   603 		if ( $description ) {
       
   604 			/* translators: Privacy policy tutorial. */
       
   605 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should explain what rights your users have over their data and how they can invoke those rights.' ) . '</p>';
       
   606 		}
       
   607 
       
   608 		/* translators: Default privacy policy text. */
       
   609 		$strings[] = '<p>' . $suggested_text . __( 'If you have an account on this site, or have left comments, you can request to receive an exported file of the personal data we hold about you, including any data you have provided to us. You can also request that we erase any personal data we hold about you. This does not include any data we are obliged to keep for administrative, legal, or security purposes.' ) . '</p>';
       
   610 
       
   611 		/* translators: Default privacy policy heading. */
       
   612 		$strings[] = '<h2>' . __( 'Where we send your data' ) . '</h2>';
       
   613 
       
   614 		if ( $description ) {
       
   615 			/* translators: Privacy policy tutorial. */
       
   616 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should list all transfers of your site data outside the European Union and describe the means by which that data is safeguarded to European data protection standards. This could include your web hosting, cloud storage, or other third party services.' ) . '</p>';
       
   617 			/* translators: Privacy policy tutorial. */
       
   618 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'European data protection law requires data about European residents which is transferred outside the European Union to be safeguarded to the same standards as if the data was in Europe. So in addition to listing where data goes, you should describe how you ensure that these standards are met either by yourself or by your third party providers, whether that is through an agreement such as Privacy Shield, model clauses in your contracts, or binding corporate rules.' ) . '</p>';
       
   619 		}
       
   620 
       
   621 		/* translators: Default privacy policy text. */
       
   622 		$strings[] = '<p>' . $suggested_text . __( 'Visitor comments may be checked through an automated spam detection service.' ) . '</p>';
       
   623 
       
   624 		/* translators: Default privacy policy heading. */
       
   625 		$strings[] = '<h2>' . __( 'Your contact information' ) . '</h2>';
       
   626 
       
   627 		if ( $description ) {
       
   628 			/* translators: Privacy policy tutorial. */
       
   629 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should provide a contact method for privacy-specific concerns. If you are required to have a Data Protection Officer, list their name and full contact details here as well.' ) . '</p>';
       
   630 		}
       
   631 
       
   632 		/* translators: Default privacy policy heading. */
       
   633 		$strings[] = '<h2>' . __( 'Additional information' ) . '</h2>';
       
   634 
       
   635 		if ( $description ) {
       
   636 			/* translators: Privacy policy tutorial. */
       
   637 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'If you use your site for commercial purposes and you engage in more complex collection or processing of personal data, you should note the following information in your privacy policy in addition to the information we have already discussed.' ) . '</p>';
       
   638 		}
       
   639 
       
   640 		/* translators: Default privacy policy heading. */
       
   641 		$strings[] = '<h3>' . __( 'How we protect your data' ) . '</h3>';
       
   642 
       
   643 		if ( $description ) {
       
   644 			/* translators: Privacy policy tutorial. */
       
   645 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should explain what measures you have taken to protect your users&#8217; data. This could include technical measures such as encryption; security measures such as two factor authentication; and measures such as staff training in data protection. If you have carried out a Privacy Impact Assessment, you can mention it here too.' ) . '</p>';
       
   646 		}
       
   647 
       
   648 		/* translators: Default privacy policy heading. */
       
   649 		$strings[] = '<h3>' . __( 'What data breach procedures we have in place' ) . '</h3>';
       
   650 
       
   651 		if ( $description ) {
       
   652 			/* translators: Privacy policy tutorial. */
       
   653 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'In this section you should explain what procedures you have in place to deal with data breaches, either potential or real, such as internal reporting systems, contact mechanisms, or bug bounties.' ) . '</p>';
       
   654 		}
       
   655 
       
   656 		/* translators: Default privacy policy heading. */
       
   657 		$strings[] = '<h3>' . __( 'What third parties we receive data from' ) . '</h3>';
       
   658 
       
   659 		if ( $description ) {
       
   660 			/* translators: Privacy policy tutorial. */
       
   661 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'If your web site receives data about users from third parties, including advertisers, this information must be included within the section of your privacy policy dealing with third party data.' ) . '</p>';
       
   662 		}
       
   663 
       
   664 		/* translators: Default privacy policy heading. */
       
   665 		$strings[] = '<h3>' . __( 'What automated decision making and/or profiling we do with user data' ) . '</h3>';
       
   666 
       
   667 		if ( $description ) {
       
   668 			/* translators: Privacy policy tutorial. */
       
   669 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'If your web site provides a service which includes automated decision making - for example, allowing customers to apply for credit, or aggregating their data into an advertising profile - you must note that this is taking place, and include information about how that information is used, what decisions are made with that aggregated data, and what rights users have over decisions made without human intervention.' ) . '</p>';
       
   670 		}
       
   671 
       
   672 		/* translators: Default privacy policy heading. */
       
   673 		$strings[] = '<h3>' . __( 'Industry regulatory disclosure requirements' ) . '</h3>';
       
   674 
       
   675 		if ( $description ) {
       
   676 			/* translators: Privacy policy tutorial. */
       
   677 			$strings[] = '<p class="privacy-policy-tutorial">' . __( 'If you are a member of a regulated industry, or if you are subject to additional privacy laws, you may be required to disclose that information here.' ) . '</p>';
       
   678 			$strings[] = '</div>';
       
   679 		}
       
   680 
       
   681 		if ( $blocks ) {
       
   682 			foreach ( $strings as $key => $string ) {
       
   683 				if ( 0 === strpos( $string, '<p>' ) ) {
       
   684 					$strings[ $key ] = '<!-- wp:paragraph -->' . $string . '<!-- /wp:paragraph -->';
       
   685 				}
       
   686 
       
   687 				if ( 0 === strpos( $string, '<h2>' ) ) {
       
   688 					$strings[ $key ] = '<!-- wp:heading -->' . $string . '<!-- /wp:heading -->';
       
   689 				}
       
   690 
       
   691 				if ( 0 === strpos( $string, '<h3>' ) ) {
       
   692 					$strings[ $key ] = '<!-- wp:heading {"level":3} -->' . $string . '<!-- /wp:heading -->';
       
   693 				}
       
   694 			}
       
   695 		}
       
   696 
       
   697 		$content = implode( '', $strings );
       
   698 		// End of the suggested privacy policy text.
       
   699 
       
   700 		/**
       
   701 		 * Filters the default content suggested for inclusion in a privacy policy.
       
   702 		 *
       
   703 		 * @since 4.9.6
       
   704 		 * @since 5.0.0 Added the `$strings`, `$description`, and `$blocks` parameters.
       
   705 		 *
       
   706 		 * @param string   $content     The default policy content.
       
   707 		 * @param string[] $strings     An array of privacy policy content strings.
       
   708 		 * @param bool     $description Whether policy descriptions should be included.
       
   709 		 * @param bool     $blocks      Whether the content should be formatted for the block editor.
       
   710 		 */
       
   711 		return apply_filters( 'wp_get_default_privacy_policy_content', $content, $strings, $description, $blocks );
       
   712 	}
       
   713 
       
   714 	/**
       
   715 	 * Add the suggested privacy policy text to the policy postbox.
       
   716 	 *
       
   717 	 * @since 4.9.6
       
   718 	 */
       
   719 	public static function add_suggested_content() {
       
   720 		$content = self::get_default_content( true, false );
       
   721 		wp_add_privacy_policy_content( __( 'WordPress' ), $content );
       
   722 	}
       
   723 }