<h2>File Contents: /home/planet5/.trash/wordpress-seo-premium/vendor/yoast/wordpress-seo/inc/class-wpseo-meta.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/.trash/wordpress-seo-premium/vendor/yoast/wordpress-seo/inc/class-wpseo-meta.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Internals
 * @since   1.5.0
 */

use Yoast\WP\SEO\Config\Schema_Types;
use Yoast\WP\SEO\Helpers\Schema\Article_Helper;
use Yoast\WP\SEO\Repositories\Indexable_Repository;

/**
 * This class implements defaults and value validation for all WPSEO Post Meta values.
 *
 * Some guidelines:
 * - To update a meta value, you can just use update_post_meta() with the full (prefixed) meta key
 *   or the convenience method WPSEO_Meta::set_value() with the internal key.
 *   All updates will be automatically validated.
 *   Meta values will only be saved to the database if they are *not* the same as the default to
 *   keep database load low.
 * - To retrieve a WPSEO meta value, you **must** use WPSEO_Meta::get_value() which will always return a
 *   string value, either the saved value or the default.
 *   This method can also retrieve a complete set of WPSEO meta values for one specific post, see
 *   the method documentation for the parameters.
 *
 * {@internal Unfortunately there isn&#039;t a filter available to hook into before returning the results
 *            for get_post_meta(), get_post_custom() and the likes. That would have been the
 *            preferred solution.}}
 *
 * {@internal All WP native get_meta() results get cached internally, so no need to cache locally.}}
 * {@internal Use $key when the key is the WPSEO internal name (without prefix), $meta_key when it
 *            includes the prefix.}}
 */
class WPSEO_Meta {

	/**
	 * Prefix for all WPSEO meta values in the database.
	 *
	 * {@internal If at any point this would change, quite apart from an upgrade routine,
	 *            this also will need to be changed in the wpml-config.xml file.}}
	 *
	 * @var string
	 */
	public static $meta_prefix = &#039;_yoast_wpseo_&#039;;

	/**
	 * Prefix for all WPSEO meta value form field names and ids.
	 *
	 * @var string
	 */
	public static $form_prefix = &#039;yoast_wpseo_&#039;;

	/**
	 * Allowed length of the meta description.
	 *
	 * @var int
	 */
	public static $meta_length = 156;

	/**
	 * Reason the meta description is not the default length.
	 *
	 * @var string
	 */
	public static $meta_length_reason = &#039;&#039;;

	/**
	 * Meta box field definitions for the meta box form.
	 *
	 * {@internal
	 * - Titles, help texts, description text and option labels are added via a translate_meta_boxes() method
	 *   in the relevant child classes (WPSEO_Metabox and WPSEO_Social_admin) as they are only needed there.
	 * - Beware: even though the meta keys are divided into subsets, they still have to be uniquely named!}}
	 *
	 * @var array
	 *            Array format:
	 *                (required)       &#039;type&#039;          =&gt; (string) field type. i.e. text / textarea / checkbox /
	 *                                                    radio / select / multiselect / upload etc.
	 *                (required)       &#039;title&#039;         =&gt; (string) table row title.
	 *                (recommended)    &#039;default_value&#039; =&gt; (string|array) default value for the field.
	 *                                                    IMPORTANT:
	 *                                                    - if the field has options, the default has to be the
	 *                                                      key of one of the options.
	 *                                                    - if the field is a text field, the default **has** to be
	 *                                                      an empty string as otherwise the user can&#039;t save
	 *                                                      an empty value/delete the meta value.
	 *                                                    - if the field is a checkbox, the only valid values
	 *                                                      are &#039;on&#039; or &#039;off&#039;.
	 *                (semi-required)   &#039;options&#039;      =&gt; (array) options for used with (multi-)select and radio
	 *                                                    fields, required if that&#039;s the field type.
	 *                                                    key = (string) value which will be saved to db.
	 *                                                    value = (string) text label for the option.
	 *                (optional)        &#039;autocomplete&#039; =&gt; (bool) whether autocomplete is on for text fields,
	 *                                                    defaults to true.
	 *                (optional)        &#039;class&#039;        =&gt; (string) classname(s) to add to the actual &lt;input&gt; tag.
	 *                (optional)        &#039;description&#039;  =&gt; (string) description to show underneath the field.
	 *                (optional)        &#039;expl&#039;         =&gt; (string) label for a checkbox.
	 *                (optional)        &#039;help&#039;         =&gt; (string) help text to show on mouse over ? image.
	 *                (optional)        &#039;rows&#039;         =&gt; (int) number of rows for a textarea, defaults to 3.
	 *                (optional)        &#039;placeholder&#039;  =&gt; (string) Currently only used by add-on plugins.
	 *                (optional)        &#039;serialized&#039;   =&gt; (bool) whether the value is expected to be serialized,
	 *                                                     i.e. an array or object, defaults to false.
	 *                                                     Currently only used by add-on plugins.
	 */
	public static $meta_fields = [
		&#039;general&#039;  =&gt; [
			&#039;focuskw&#039; =&gt; [
				&#039;type&#039;  =&gt; &#039;hidden&#039;,
				&#039;title&#039; =&gt; &#039;&#039;,
			],
			&#039;title&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
				&#039;help&#039;          =&gt; &#039;&#039;, // Translation added later.
			],
			&#039;metadesc&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;class&#039;         =&gt; &#039;metadesc&#039;,
				&#039;rows&#039;          =&gt; 2,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
				&#039;help&#039;          =&gt; &#039;&#039;, // Translation added later.
			],
			&#039;linkdex&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;linkdex&#039;,
				&#039;default_value&#039; =&gt; &#039;0&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;,
			],
			&#039;content_score&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;content_score&#039;,
				&#039;default_value&#039; =&gt; &#039;0&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;,
			],
			&#039;inclusive_language_score&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;inclusive_language_score&#039;,
				&#039;default_value&#039; =&gt; &#039;0&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;,
			],
			&#039;is_cornerstone&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;is_cornerstone&#039;,
				&#039;default_value&#039; =&gt; &#039;false&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;,
			],
		],
		&#039;advanced&#039; =&gt; [
			&#039;meta-robots-noindex&#039;  =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;0&#039;, // = post-type default.
				&#039;options&#039;       =&gt; [
					&#039;0&#039; =&gt; &#039;&#039;, // Post type default - translation added later.
					&#039;2&#039; =&gt; &#039;&#039;, // Index - translation added later.
					&#039;1&#039; =&gt; &#039;&#039;, // No-index - translation added later.
				],
			],
			&#039;meta-robots-nofollow&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;0&#039;, // = follow.
				&#039;options&#039;       =&gt; [
					&#039;0&#039; =&gt; &#039;&#039;, // Follow - translation added later.
					&#039;1&#039; =&gt; &#039;&#039;, // No-follow - translation added later.
				],
			],
			&#039;meta-robots-adv&#039;      =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
				&#039;options&#039;       =&gt; [
					&#039;noimageindex&#039; =&gt; &#039;&#039;, // Translation added later.
					&#039;noarchive&#039;    =&gt; &#039;&#039;, // Translation added later.
					&#039;nosnippet&#039;    =&gt; &#039;&#039;, // Translation added later.
				],
			],
			&#039;bctitle&#039;              =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
			],
			&#039;canonical&#039;            =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
			],
			&#039;redirect&#039;             =&gt; [
				&#039;type&#039;          =&gt; &#039;url&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
				&#039;default_value&#039; =&gt; &#039;&#039;,
				&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
			],
		],
		&#039;social&#039;   =&gt; [],
		&#039;schema&#039;   =&gt; [
			&#039;schema_page_type&#039;    =&gt; [
				&#039;type&#039;    =&gt; &#039;hidden&#039;,
				&#039;title&#039;   =&gt; &#039;&#039;,
				&#039;options&#039; =&gt; Schema_Types::PAGE_TYPES,
			],
			&#039;schema_article_type&#039; =&gt; [
				&#039;type&#039;          =&gt; &#039;hidden&#039;,
				&#039;title&#039;         =&gt; &#039;&#039;,
				&#039;hide_on_pages&#039; =&gt; true,
				&#039;options&#039;       =&gt; Schema_Types::ARTICLE_TYPES,
			],
		],
		/* Fields we should validate &amp; save, but not show on any form. */
		&#039;non_form&#039; =&gt; [
			&#039;linkdex&#039; =&gt; [
				&#039;type&#039;          =&gt; null,
				&#039;default_value&#039; =&gt; &#039;0&#039;,
			],
			&#039;zapier_trigger_sent&#039; =&gt; [
				&#039;type&#039;          =&gt; null,
				&#039;default_value&#039; =&gt; &#039;0&#039;,
			],
		],
	];

	/**
	 * Helper property - reverse index of the definition array.
	 *
	 * Format: [full meta key including prefix]    =&gt; array
	 *         [&#039;subset&#039;]    =&gt; (string) primary index
	 *         [&#039;key&#039;]       =&gt; (string) internal key
	 *
	 * @var array
	 */
	public static $fields_index = [];

	/**
	 * Helper property - array containing only the defaults in the format:
	 * [full meta key including prefix]    =&gt; (string) default value
	 *
	 * @var array
	 */
	public static $defaults = [];

	/**
	 * Helper property to define the social network meta field definitions - networks.
	 *
	 * @var array
	 */
	private static $social_networks = [
		&#039;opengraph&#039;  =&gt; &#039;opengraph&#039;,
		&#039;twitter&#039;    =&gt; &#039;twitter&#039;,
	];

	/**
	 * Helper property to define the social network meta field definitions - fields and their type.
	 *
	 * @var array
	 */
	private static $social_fields = [
		&#039;title&#039;       =&gt; &#039;hidden&#039;,
		&#039;description&#039; =&gt; &#039;hidden&#039;,
		&#039;image&#039;       =&gt; &#039;hidden&#039;,
		&#039;image-id&#039;    =&gt; &#039;hidden&#039;,
	];

	/**
	 * Register our actions and filters.
	 *
	 * @return void
	 */
	public static function init() {
		foreach ( self::$social_networks as $option =&gt; $network ) {
			if ( WPSEO_Options::get( $option, false ) === true ) {
				foreach ( self::$social_fields as $box =&gt; $type ) {
					self::$meta_fields[&#039;social&#039;][ $network . &#039;-&#039; . $box ] = [
						&#039;type&#039;          =&gt; $type,
						&#039;title&#039;         =&gt; &#039;&#039;, // Translation added later.
						&#039;default_value&#039; =&gt; &#039;&#039;,
						&#039;description&#039;   =&gt; &#039;&#039;, // Translation added later.
					];
				}
			}
		}
		unset( $option, $network, $box, $type );

		/**
		 * Allow add-on plugins to register their meta fields for management by this class.
		 * Calls to add_filter() must be made before plugins_loaded prio 14.
		 */
		$extra_fields = apply_filters( &#039;add_extra_wpseo_meta_fields&#039;, [] );
		if ( is_array( $extra_fields ) ) {
			self::$meta_fields = self::array_merge_recursive_distinct( $extra_fields, self::$meta_fields );
		}
		unset( $extra_fields );

		foreach ( self::$meta_fields as $subset =&gt; $field_group ) {
			foreach ( $field_group as $key =&gt; $field_def ) {

				register_meta(
					&#039;post&#039;,
					self::$meta_prefix . $key,
					[ &#039;sanitize_callback&#039; =&gt; [ __CLASS__, &#039;sanitize_post_meta&#039; ] ]
				);

				// Set the $fields_index property for efficiency.
				self::$fields_index[ self::$meta_prefix . $key ] = [
					&#039;subset&#039; =&gt; $subset,
					&#039;key&#039;    =&gt; $key,
				];

				// Set the $defaults property for efficiency.
				if ( isset( $field_def[&#039;default_value&#039;] ) ) {
					self::$defaults[ self::$meta_prefix . $key ] = $field_def[&#039;default_value&#039;];
				}
				else {
					// Meta will always be a string, so let&#039;s make the meta meta default also a string.
					self::$defaults[ self::$meta_prefix . $key ] = &#039;&#039;;
				}
			}
		}
		unset( $subset, $field_group, $key, $field_def );

		self::filter_schema_article_types();

		add_filter( &#039;update_post_metadata&#039;, [ __CLASS__, &#039;remove_meta_if_default&#039; ], 10, 5 );
		add_filter( &#039;add_post_metadata&#039;, [ __CLASS__, &#039;dont_save_meta_if_default&#039; ], 10, 4 );
	}

	/**
	 * Retrieve the meta box form field definitions for the given tab and post type.
	 *
	 * @param string $tab       Tab for which to retrieve the field definitions.
	 * @param string $post_type Post type of the current post.
	 *
	 * @return array Array containing the meta box field definitions.
	 */
	public static function get_meta_field_defs( $tab, $post_type = &#039;post&#039; ) {
		if ( ! isset( self::$meta_fields[ $tab ] ) ) {
			return [];
		}

		$field_defs = self::$meta_fields[ $tab ];

		switch ( $tab ) {
			case &#039;non-form&#039;:
				// Prevent non-form fields from being passed to forms.
				$field_defs = [];
				break;

			case &#039;advanced&#039;:
				global $post;

				if ( ! WPSEO_Capability_Utils::current_user_can( &#039;wpseo_edit_advanced_metadata&#039; ) &amp;&amp; WPSEO_Options::get( &#039;disableadvanced_meta&#039; ) ) {
					return [];
				}

				$post_type = &#039;&#039;;
				if ( isset( $post-&gt;post_type ) ) {
					$post_type = $post-&gt;post_type;
				}
				elseif ( ! isset( $post-&gt;post_type ) &amp;&amp; isset( $_GET[&#039;post_type&#039;] ) ) {
					$post_type = sanitize_text_field( $_GET[&#039;post_type&#039;] );
				}

				if ( $post_type === &#039;&#039; ) {
					return [];
				}

				/* Adjust the no-index text strings based on the post type. */
				$post_type_object = get_post_type_object( $post_type );

				$field_defs[&#039;meta-robots-noindex&#039;][&#039;title&#039;]        = sprintf( $field_defs[&#039;meta-robots-noindex&#039;][&#039;title&#039;], $post_type_object-&gt;labels-&gt;singular_name );
				$field_defs[&#039;meta-robots-noindex&#039;][&#039;options&#039;][&#039;0&#039;] = sprintf( $field_defs[&#039;meta-robots-noindex&#039;][&#039;options&#039;][&#039;0&#039;], ( ( WPSEO_Options::get( &#039;noindex-&#039; . $post_type, false ) === true ) ? $field_defs[&#039;meta-robots-noindex&#039;][&#039;options&#039;][&#039;1&#039;] : $field_defs[&#039;meta-robots-noindex&#039;][&#039;options&#039;][&#039;2&#039;] ), $post_type_object-&gt;label );
				$field_defs[&#039;meta-robots-nofollow&#039;][&#039;title&#039;]       = sprintf( $field_defs[&#039;meta-robots-nofollow&#039;][&#039;title&#039;], $post_type_object-&gt;labels-&gt;singular_name );

				/* Don&#039;t show the breadcrumb title field if breadcrumbs aren&#039;t enabled. */
				if ( WPSEO_Options::get( &#039;breadcrumbs-enable&#039;, false ) !== true &amp;&amp; ! current_theme_supports( &#039;yoast-seo-breadcrumbs&#039; ) ) {
					unset( $field_defs[&#039;bctitle&#039;] );
				}

				if ( empty( $post-&gt;ID ) || ( ! empty( $post-&gt;ID ) &amp;&amp; self::get_value( &#039;redirect&#039;, $post-&gt;ID ) === &#039;&#039; ) ) {
					unset( $field_defs[&#039;redirect&#039;] );
				}
				break;

			case &#039;schema&#039;:
				if ( ! WPSEO_Capability_Utils::current_user_can( &#039;wpseo_edit_advanced_metadata&#039; ) &amp;&amp; WPSEO_Options::get( &#039;disableadvanced_meta&#039; ) ) {
					return [];
				}

				$field_defs[&#039;schema_page_type&#039;][&#039;default&#039;] = WPSEO_Options::get( &#039;schema-page-type-&#039; . $post_type );

				$article_helper = new Article_Helper();
				if ( $article_helper-&gt;is_article_post_type( $post_type ) ) {
					$default_schema_article_type = WPSEO_Options::get( &#039;schema-article-type-&#039; . $post_type );

					/** This filter is documented in inc/options/class-wpseo-option-titles.php */
					$allowed_article_types = apply_filters( &#039;wpseo_schema_article_types&#039;, Schema_Types::ARTICLE_TYPES );

					if ( ! \array_key_exists( $default_schema_article_type, $allowed_article_types ) ) {
						$default_schema_article_type = WPSEO_Options::get_default( &#039;wpseo_titles&#039;, &#039;schema-article-type-&#039; . $post_type );
					}
					$field_defs[&#039;schema_article_type&#039;][&#039;default&#039;] = $default_schema_article_type;
				}
				else {
					unset( $field_defs[&#039;schema_article_type&#039;] );
				}

				break;
		}

		/**
		 * Filter the WPSEO metabox form field definitions for a tab.
		 * {tab} can be &#039;general&#039;, &#039;advanced&#039; or &#039;social&#039;.
		 *
		 * @param array  $field_defs Metabox form field definitions.
		 * @param string $post_type  Post type of the post the metabox is for, defaults to &#039;post&#039;.
		 *
		 * @return array
		 */
		return apply_filters( &#039;wpseo_metabox_entries_&#039; . $tab, $field_defs, $post_type );
	}

	/**
	 * Validate the post meta values.
	 *
	 * @param mixed  $meta_value The new value.
	 * @param string $meta_key   The full meta key (including prefix).
	 *
	 * @return string Validated meta value.
	 */
	public static function sanitize_post_meta( $meta_value, $meta_key ) {
		$field_def = self::$meta_fields[ self::$fields_index[ $meta_key ][&#039;subset&#039;] ][ self::$fields_index[ $meta_key ][&#039;key&#039;] ];
		$clean     = self::$defaults[ $meta_key ];

		switch ( true ) {
			case ( $meta_key === self::$meta_prefix . &#039;linkdex&#039; ):
				$int = WPSEO_Utils::validate_int( $meta_value );
				if ( $int !== false &amp;&amp; $int &gt;= 0 ) {
					$clean = strval( $int ); // Convert to string to make sure default check works.
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;checkbox&#039; ):
				// Only allow value if it&#039;s one of the predefined options.
				if ( in_array( $meta_value, [ &#039;on&#039;, &#039;off&#039; ], true ) ) {
					$clean = $meta_value;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;select&#039; || $field_def[&#039;type&#039;] === &#039;radio&#039; ):
				// Only allow value if it&#039;s one of the predefined options.
				if ( isset( $field_def[&#039;options&#039;][ $meta_value ] ) ) {
					$clean = $meta_value;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;hidden&#039; &amp;&amp; $meta_key === self::$meta_prefix . &#039;meta-robots-adv&#039; ):
				$clean = self::validate_meta_robots_adv( $meta_value );
				break;

			case ( $field_def[&#039;type&#039;] === &#039;url&#039; || $meta_key === self::$meta_prefix . &#039;canonical&#039; ):
				// Validate as url(-part).
				$url = WPSEO_Utils::sanitize_url( $meta_value );
				if ( $url !== &#039;&#039; ) {
					$clean = $url;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;upload&#039; &amp;&amp; in_array( $meta_key, [ self::$meta_prefix . &#039;opengraph-image&#039;, self::$meta_prefix . &#039;twitter-image&#039; ], true ) ):
				// Validate as url.
				$url = WPSEO_Utils::sanitize_url( $meta_value, [ &#039;http&#039;, &#039;https&#039;, &#039;ftp&#039;, &#039;ftps&#039; ] );
				if ( $url !== &#039;&#039; ) {
					$clean = $url;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;hidden&#039; &amp;&amp; $meta_key === self::$meta_prefix . &#039;is_cornerstone&#039; ):
				$clean = $meta_value;

				/*
				 * This used to be a checkbox, then became a hidden input.
				 * To make sure the value remains consistent, we cast &#039;true&#039; to &#039;1&#039;.
				 */
				if ( $meta_value === &#039;true&#039; ) {
					$clean = &#039;1&#039;;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;hidden&#039; &amp;&amp; isset( $field_def[&#039;options&#039;] ) ):
				// Only allow value if it&#039;s one of the predefined options.
				if ( isset( $field_def[&#039;options&#039;][ $meta_value ] ) ) {
					$clean = $meta_value;
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;textarea&#039; ):
				if ( is_string( $meta_value ) ) {
					// Remove line breaks and tabs.
					// @todo [JRF =&gt; Yoast] Verify that line breaks and the likes aren&#039;t allowed/recommended in meta header fields.
					$meta_value = str_replace( [ &quot;\n&quot;, &quot;\r&quot;, &quot;\t&quot;, &#039;  &#039; ], &#039; &#039;, $meta_value );
					$clean      = WPSEO_Utils::sanitize_text_field( trim( $meta_value ) );
				}
				break;

			case ( $field_def[&#039;type&#039;] === &#039;multiselect&#039; ):
				$clean = $meta_value;
				break;

			case ( $field_def[&#039;type&#039;] === &#039;text&#039; ):
			default:
				if ( is_string( $meta_value ) ) {
					$clean = WPSEO_Utils::sanitize_text_field( trim( $meta_value ) );
				}

				break;
		}

		$clean = apply_filters( &#039;wpseo_sanitize_post_meta_&#039; . $meta_key, $clean, $meta_value, $field_def, $meta_key );

		return $clean;
	}

	/**
	 * Validate a meta-robots-adv meta value.
	 *
	 * @todo [JRF =&gt; Yoast] Verify that this logic for the prioritisation is correct.
	 *
	 * @param array|string $meta_value The value to validate.
	 *
	 * @return string Clean value.
	 */
	public static function validate_meta_robots_adv( $meta_value ) {
		$clean   = self::$meta_fields[&#039;advanced&#039;][&#039;meta-robots-adv&#039;][&#039;default_value&#039;];
		$options = self::$meta_fields[&#039;advanced&#039;][&#039;meta-robots-adv&#039;][&#039;options&#039;];

		if ( is_string( $meta_value ) ) {
			$meta_value = explode( &#039;,&#039;, $meta_value );
		}

		if ( is_array( $meta_value ) &amp;&amp; $meta_value !== [] ) {
			$meta_value = array_map( &#039;trim&#039;, $meta_value );

			// Individual selected entries.
			$cleaning = [];
			foreach ( $meta_value as $value ) {
				if ( isset( $options[ $value ] ) ) {
					$cleaning[] = $value;
				}
			}

			if ( $cleaning !== [] ) {
				$clean = implode( &#039;,&#039;, $cleaning );
			}
			unset( $cleaning, $value );
		}

		return $clean;
	}

	/**
	 * Prevent saving of default values and remove potential old value from the database if replaced by a default.
	 *
	 * @param bool   $check      The current status to allow updating metadata for the given type.
	 * @param int    $object_id  ID of the current object for which the meta is being updated.
	 * @param string $meta_key   The full meta key (including prefix).
	 * @param string $meta_value New meta value.
	 * @param string $prev_value The old meta value.
	 *
	 * @return bool|null True = stop saving, null = continue saving.
	 */
	public static function remove_meta_if_default( $check, $object_id, $meta_key, $meta_value, $prev_value = &#039;&#039; ) {
		/* If it&#039;s one of our meta fields, check against default. */
		if ( isset( self::$fields_index[ $meta_key ] ) &amp;&amp; self::meta_value_is_default( $meta_key, $meta_value ) === true ) {
			if ( $prev_value !== &#039;&#039; ) {
				delete_post_meta( $object_id, $meta_key, $prev_value );
			}
			else {
				delete_post_meta( $object_id, $meta_key );
			}

			return true; // Stop saving the value.
		}

		return $check; // Go on with the normal execution (update) in meta.php.
	}

	/**
	 * Prevent adding of default values to the database.
	 *
	 * @param bool   $check      The current status to allow adding metadata for the given type.
	 * @param int    $object_id  ID of the current object for which the meta is being added.
	 * @param string $meta_key   The full meta key (including prefix).
	 * @param string $meta_value New meta value.
	 *
	 * @return bool|null True = stop saving, null = continue saving.
	 */
	public static function dont_save_meta_if_default( $check, $object_id, $meta_key, $meta_value ) {
		/* If it&#039;s one of our meta fields, check against default. */
		if ( isset( self::$fields_index[ $meta_key ] ) &amp;&amp; self::meta_value_is_default( $meta_key, $meta_value ) === true ) {
			return true; // Stop saving the value.
		}

		return $check; // Go on with the normal execution (add) in meta.php.
	}

	/**
	 * Is the given meta value the same as the default value ?
	 *
	 * @param string $meta_key   The full meta key (including prefix).
	 * @param mixed  $meta_value The value to check.
	 *
	 * @return bool
	 */
	public static function meta_value_is_default( $meta_key, $meta_value ) {
		return ( isset( self::$defaults[ $meta_key ] ) &amp;&amp; $meta_value === self::$defaults[ $meta_key ] );
	}

	/**
	 * Get a custom post meta value.
	 *
	 * Returns the default value if the meta value has not been set.
	 *
	 * {@internal Unfortunately there isn&#039;t a filter available to hook into before returning
	 *            the results for get_post_meta(), get_post_custom() and the likes. That
	 *            would have been the preferred solution.}}
	 *
	 * @param string $key    Internal key of the value to get (without prefix).
	 * @param int    $postid Post ID of the post to get the value for.
	 *
	 * @return string All &#039;normal&#039; values returned from get_post_meta() are strings.
	 *                Objects and arrays are possible, but not used by this plugin
	 *                and therefore discarted (except when the special &#039;serialized&#039; field def
	 *                value is set to true - only used by add-on plugins for now).
	 *                Will return the default value if no value was found.
	 *                Will return empty string if no default was found (not one of our keys) or
	 *                if the post does not exist.
	 */
	public static function get_value( $key, $postid = 0 ) {
		global $post;

		$postid = absint( $postid );
		if ( $postid === 0 ) {
			if ( ( isset( $post ) &amp;&amp; is_object( $post ) ) &amp;&amp; ( isset( $post-&gt;post_status ) &amp;&amp; $post-&gt;post_status !== &#039;auto-draft&#039; ) ) {
				$postid = $post-&gt;ID;
			}
			else {
				return &#039;&#039;;
			}
		}

		$custom    = get_post_custom( $postid ); // Array of strings or empty array.
		$table_key = self::$meta_prefix . $key;

		// Populate the field_def using the field_index lookup array.
		$field_def = [];
		if ( isset( self::$fields_index[ $table_key ] ) ) {
			$field_def = self::$meta_fields[ self::$fields_index[ $table_key ][&#039;subset&#039;] ][ self::$fields_index[ $table_key ][&#039;key&#039;] ];
		}

		// Check if we have a custom post meta entry.
		if ( isset( $custom[ $table_key ][0] ) ) {
			$unserialized = maybe_unserialize( $custom[ $table_key ][0] );

			// Check if it is already unserialized.
			if ( $custom[ $table_key ][0] === $unserialized ) {
				return $custom[ $table_key ][0];
			}

			// Check whether we need to unserialize it.
			if ( isset( $field_def[&#039;serialized&#039;] ) &amp;&amp; $field_def[&#039;serialized&#039;] === true ) {
				// Ok, serialize value expected/allowed.
				return $unserialized;
			}
		}

		// Meta was either not found or found, but object/array while not allowed to be.
		if ( isset( self::$defaults[ self::$meta_prefix . $key ] ) ) {
			// Update the default value to the current post type.
			switch ( $key ) {
				case &#039;schema_page_type&#039;:
				case &#039;schema_article_type&#039;:
					return &#039;&#039;;
			}

			return self::$defaults[ self::$meta_prefix . $key ];
		}

		/*
		 * Shouldn&#039;t ever happen, means not one of our keys as there will always be a default available
		 * for all our keys.
		 */
		return &#039;&#039;;
	}

	/**
	 * Update a meta value for a post.
	 *
	 * @param string $key        The internal key of the meta value to change (without prefix).
	 * @param mixed  $meta_value The value to set the meta to.
	 * @param int    $post_id    The ID of the post to change the meta for.
	 *
	 * @return bool Whether the value was changed.
	 */
	public static function set_value( $key, $meta_value, $post_id ) {
		/*
		 * Slash the data, because `update_metadata` will unslash it and we have already unslashed it.
		 * Related issue: https://github.com/Yoast/YoastSEO.js/issues/2158
		 */
		$meta_value = wp_slash( $meta_value );

		return update_post_meta( $post_id, self::$meta_prefix . $key, $meta_value );
	}

	/**
	 * Deletes a meta value for a post.
	 *
	 * @param string $key     The internal key of the meta value to change (without prefix).
	 * @param int    $post_id The ID of the post to delete the meta for.
	 *
	 * @return bool Whether the delete was successful or not.
	 */
	public static function delete( $key, $post_id ) {
		return delete_post_meta( $post_id, self::$meta_prefix . $key );
	}

	/**
	 * Used for imports, this functions imports the value of $old_metakey into $new_metakey for those post
	 * where no WPSEO meta data has been set.
	 * Optionally deletes the $old_metakey values.
	 *
	 * @param string $old_metakey The old key of the meta value.
	 * @param string $new_metakey The new key, usually the WPSEO meta key (including prefix).
	 * @param bool   $delete_old  Whether to delete the old meta key/value-sets.
	 *
	 * @return void
	 */
	public static function replace_meta( $old_metakey, $new_metakey, $delete_old = false ) {
		global $wpdb;

		/*
		 * Get only those rows where no wpseo meta values exist for the same post
		 * (with the exception of linkdex as that will be set independently of whether the post has been edited).
		 *
		 * {@internal Query is pretty well optimized this way.}}
		 */
		$query  = $wpdb-&gt;prepare(
			&quot;
				SELECT `a`.*
				FROM {$wpdb-&gt;postmeta} AS a
				WHERE `a`.`meta_key` = %s
					AND NOT	EXISTS (
						SELECT DISTINCT `post_id` , count( `meta_id` ) AS count
						FROM {$wpdb-&gt;postmeta} AS b
						WHERE `a`.`post_id` = `b`.`post_id`
							AND `meta_key` LIKE %s
							AND `meta_key` &lt;&gt; %s
						GROUP BY `post_id`
					)
				;&quot;,
			$old_metakey,
			$wpdb-&gt;esc_like( self::$meta_prefix . &#039;%&#039; ),
			self::$meta_prefix . &#039;linkdex&#039;
		);
		$oldies = $wpdb-&gt;get_results( $query );

		if ( is_array( $oldies ) &amp;&amp; $oldies !== [] ) {
			foreach ( $oldies as $old ) {
				update_post_meta( $old-&gt;post_id, $new_metakey, $old-&gt;meta_value );
			}
		}

		// Delete old keys.
		if ( $delete_old === true ) {
			delete_post_meta_by_key( $old_metakey );
		}
	}

	/**
	 * General clean-up of the saved meta values.
	 * - Remove potentially lingering old meta keys;
	 * - Remove all default and invalid values.
	 *
	 * @return void
	 */
	public static function clean_up() {
		global $wpdb;

		/*
		 * Clean up &#039;_yoast_wpseo_meta-robots&#039;.
		 *
		 * Retrieve all &#039;_yoast_wpseo_meta-robots&#039; meta values and convert if no new values found.
		 *
		 * {@internal Query is pretty well optimized this way.}}
		 *
		 * @todo [JRF =&gt; Yoast] Find out all possible values which the old &#039;_yoast_wpseo_meta-robots&#039; could contain
		 * to convert the data correctly.
		 */
		$query  = $wpdb-&gt;prepare(
			&quot;
				SELECT `a`.*
				FROM {$wpdb-&gt;postmeta} AS a
				WHERE `a`.`meta_key` = %s
					AND NOT	EXISTS (
						SELECT DISTINCT `post_id` , count( `meta_id` ) AS count
						FROM {$wpdb-&gt;postmeta} AS b
						WHERE `a`.`post_id` = `b`.`post_id`
							AND ( `meta_key` = %s
							OR `meta_key` = %s )
						GROUP BY `post_id`
					)
				;&quot;,
			self::$meta_prefix . &#039;meta-robots&#039;,
			self::$meta_prefix . &#039;meta-robots-noindex&#039;,
			self::$meta_prefix . &#039;meta-robots-nofollow&#039;
		);
		$oldies = $wpdb-&gt;get_results( $query );

		if ( is_array( $oldies ) &amp;&amp; $oldies !== [] ) {
			foreach ( $oldies as $old ) {
				$old_values = explode( &#039;,&#039;, $old-&gt;meta_value );
				foreach ( $old_values as $value ) {
					if ( $value === &#039;noindex&#039; ) {
						update_post_meta( $old-&gt;post_id, self::$meta_prefix . &#039;meta-robots-noindex&#039;, 1 );
					}
					elseif ( $value === &#039;nofollow&#039; ) {
						update_post_meta( $old-&gt;post_id, self::$meta_prefix . &#039;meta-robots-nofollow&#039;, 1 );
					}
				}
			}
		}
		unset( $query, $oldies, $old, $old_values, $value );

		// Delete old keys.
		delete_post_meta_by_key( self::$meta_prefix . &#039;meta-robots&#039; );

		/*
		 * Remove all default values and (most) invalid option values.
		 * Invalid option values for the multiselect (meta-robots-adv) field will be dealt with seperately.
		 *
		 * {@internal Some of the defaults have changed in v1.5, but as the defaults will
		 *            be removed and new defaults will now automatically be passed when no
		 *            data found, this update is automatic (as long as we remove the old
		 *            values which we do in the below routine).}}
		 *
		 * {@internal Unfortunately we can&#039;t use the normal delete_meta() with key/value combination
		 *            as &#039;&#039; (empty string) values will be ignored and would result in all metas
		 *            with that key being deleted, not just the empty fields.
		 *            Still, the below implementation is largely based on the delete_meta() function.}}
		 */
		$query = [];

		foreach ( self::$meta_fields as $subset =&gt; $field_group ) {
			foreach ( $field_group as $key =&gt; $field_def ) {
				if ( ! isset( $field_def[&#039;default_value&#039;] ) ) {
					continue;
				}

				if ( isset( $field_def[&#039;options&#039;] ) &amp;&amp; is_array( $field_def[&#039;options&#039;] ) &amp;&amp; $field_def[&#039;options&#039;] !== [] ) {
					$valid = $field_def[&#039;options&#039;];
					// Remove the default value from the valid options.
					unset( $valid[ $field_def[&#039;default_value&#039;] ] );
					$valid = array_keys( $valid );

					$query[] = $wpdb-&gt;prepare(
						&quot;( meta_key = %s AND meta_value NOT IN ( &#039;&quot; . implode( &quot;&#039;,&#039;&quot;, esc_sql( $valid ) ) . &quot;&#039; ) )&quot;,
						self::$meta_prefix . $key
					);
					unset( $valid );
				}
				elseif ( is_string( $field_def[&#039;default_value&#039;] ) &amp;&amp; $field_def[&#039;default_value&#039;] !== &#039;&#039; ) {
					$query[] = $wpdb-&gt;prepare(
						&#039;( meta_key = %s AND meta_value = %s )&#039;,
						self::$meta_prefix . $key,
						$field_def[&#039;default_value&#039;]
					);
				}
				else {
					$query[] = $wpdb-&gt;prepare(
						&quot;( meta_key = %s AND meta_value = &#039;&#039; )&quot;,
						self::$meta_prefix . $key
					);
				}
			}
		}
		unset( $subset, $field_group, $key, $field_def );

		$query    = &quot;SELECT meta_id FROM {$wpdb-&gt;postmeta} WHERE &quot; . implode( &#039; OR &#039;, $query ) . &#039;;&#039;;
		$meta_ids = $wpdb-&gt;get_col( $query );

		if ( is_array( $meta_ids ) &amp;&amp; $meta_ids !== [] ) {
			// WP native action.
			do_action( &#039;delete_post_meta&#039;, $meta_ids, null, null, null );

			$query = &quot;DELETE FROM {$wpdb-&gt;postmeta} WHERE meta_id IN( &quot; . implode( &#039;,&#039;, $meta_ids ) . &#039; )&#039;;
			$count = $wpdb-&gt;query( $query );

			if ( $count ) {
				foreach ( $meta_ids as $object_id ) {
					wp_cache_delete( $object_id, &#039;post_meta&#039; );
				}

				// WP native action.
				do_action( &#039;deleted_post_meta&#039;, $meta_ids, null, null, null );
			}
		}
		unset( $query, $meta_ids, $count, $object_id );

		/*
		 * Deal with the multiselect (meta-robots-adv) field.
		 *
		 * Removes invalid option combinations, such as &#039;none,noarchive&#039;.
		 *
		 * Default values have already been removed, so we should have a small result set and
		 * (hopefully) even smaller set of invalid results.
		 */
		$query  = $wpdb-&gt;prepare(
			&quot;SELECT meta_id, meta_value FROM {$wpdb-&gt;postmeta} WHERE meta_key = %s&quot;,
			self::$meta_prefix . &#039;meta-robots-adv&#039;
		);
		$oldies = $wpdb-&gt;get_results( $query );

		if ( is_array( $oldies ) &amp;&amp; $oldies !== [] ) {
			foreach ( $oldies as $old ) {
				$clean = self::validate_meta_robots_adv( $old-&gt;meta_value );

				if ( $clean !== $old-&gt;meta_value ) {
					if ( $clean !== self::$meta_fields[&#039;advanced&#039;][&#039;meta-robots-adv&#039;][&#039;default_value&#039;] ) {
						update_metadata_by_mid( &#039;post&#039;, $old-&gt;meta_id, $clean );
					}
					else {
						delete_metadata_by_mid( &#039;post&#039;, $old-&gt;meta_id );
					}
				}
			}
		}
		unset( $query, $oldies, $old, $clean );

		do_action( &#039;wpseo_meta_clean_up&#039; );
	}

	/**
	 * Recursively merge a variable number of arrays, using the left array as base,
	 * giving priority to the right array.
	 *
	 * Difference with native array_merge_recursive():
	 * array_merge_recursive converts values with duplicate keys to arrays rather than
	 * overwriting the value in the first array with the duplicate value in the second array.
	 *
	 * array_merge_recursive_distinct does not change the data types of the values in the arrays.
	 * Matching keys&#039; values in the second array overwrite those in the first array, as is the
	 * case with array_merge.
	 *
	 * Freely based on information found on http://www.php.net/manual/en/function.array-merge-recursive.php
	 *
	 * {@internal Should be moved to a general utility class.}}
	 *
	 * @return array
	 */
	public static function array_merge_recursive_distinct() {

		$arrays = func_get_args();
		if ( count( $arrays ) &lt; 2 ) {
			if ( $arrays === [] ) {
				return [];
			}
			else {
				return $arrays[0];
			}
		}

		$merged = array_shift( $arrays );

		foreach ( $arrays as $array ) {
			foreach ( $array as $key =&gt; $value ) {
				if ( is_array( $value ) &amp;&amp; ( isset( $merged[ $key ] ) &amp;&amp; is_array( $merged[ $key ] ) ) ) {
					$merged[ $key ] = self::array_merge_recursive_distinct( $merged[ $key ], $value );
				}
				else {
					$merged[ $key ] = $value;
				}
			}
			unset( $key, $value );
		}

		return $merged;
	}

	/**
	 * Counts the total of all the keywords being used for posts except the given one.
	 *
	 * @param string $keyword The keyword to be counted.
	 * @param int    $post_id The id of the post to which the keyword belongs.
	 *
	 * @return array
	 */
	public static function keyword_usage( $keyword, $post_id ) {

		if ( empty( $keyword ) ) {
			return [];
		}

		/**
		 * The indexable repository.
		 *
		 * @var Indexable_Repository
		 */
		$repository = YoastSEO()-&gt;classes-&gt;get( Indexable_Repository::class );

		$post_ids = $repository-&gt;query()
			-&gt;select( &#039;object_id&#039; )
			-&gt;where( &#039;primary_focus_keyword&#039;, $keyword )
			-&gt;where( &#039;object_type&#039;, &#039;post&#039; )
			-&gt;where_not_equal( &#039;object_id&#039;, $post_id )
			-&gt;where_not_equal( &#039;post_status&#039;, &#039;trash&#039; )
			-&gt;limit( 2 )    // Limit to 2 results to save time and resources.
			-&gt;find_array();

		// Get object_id from each subarray in $post_ids.
		$post_ids = ( is_array( $post_ids ) ) ? array_column( $post_ids, &#039;object_id&#039; ) : [];

		/*
		 * If Premium is installed, get the additional keywords as well.
		 * We only check for the additional keywords if we&#039;ve not already found two.
		 * In that case there&#039;s no use for an additional query as we already know
		 * that the keyword has been used multiple times before.
		 */
		if ( count( $post_ids ) &lt; 2 ) {
			/**
			 * Allows enhancing the array of posts&#039; that share their focus keywords with the post&#039;s focus keywords.
			 *
			 * @param array  $post_ids The array of posts&#039; ids that share their related keywords with the post.
			 * @param string $keyword  The keyword to search for.
			 * @param int    $post_id  The id of the post the keyword is associated to.
			 */
			$post_ids = apply_filters( &#039;wpseo_posts_for_focus_keyword&#039;, $post_ids, $keyword, $post_id );
		}

		return $post_ids;
	}

	/**
	 * Returns the post types for the given post ids.
	 *
	 * @param array $post_ids The post ids to get the post types for.
	 *
	 * @return array The post types.
	 */
	public static function post_types_for_ids( $post_ids ) {

		/**
		 * The indexable repository.
		 *
		 * @var Indexable_Repository
		 */
		$repository = YoastSEO()-&gt;classes-&gt;get( Indexable_Repository::class );

		// Check if post ids is not empty.
		if ( ! empty( $post_ids ) ) {
			// Get the post subtypes for the posts that share the keyword.
			$post_types = $repository-&gt;query()
				-&gt;select( &#039;object_sub_type&#039; )
				-&gt;where_in( &#039;object_id&#039;, $post_ids )
				-&gt;find_array();

			// Get object_sub_type from each subarray in $post_ids.
			$post_types = array_column( $post_types, &#039;object_sub_type&#039; );
		}
		else {
			$post_types = [];
		}

		return $post_types;
	}

	/**
	 * Filter the schema article types.
	 *
	 * @return void
	 */
	public static function filter_schema_article_types() {
		/** This filter is documented in inc/options/class-wpseo-option-titles.php */
		self::$meta_fields[&#039;schema&#039;][&#039;schema_article_type&#039;][&#039;options&#039;] = apply_filters( &#039;wpseo_schema_article_types&#039;, self::$meta_fields[&#039;schema&#039;][&#039;schema_article_type&#039;][&#039;options&#039;] );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2F.trash%2Fwordpress-seo-premium%2Fvendor%2Fyoast%2Fwordpress-seo%2Finc'>⬅ Back to Directory</a>