golden hour

/home/doctorbruno/public_html/pgmed.org/wp-content/plugins/jetpack/modules/seo-tools

File/Folder	Size	Actions
class-jetpack-seo-admin-columns.php	8.43 KB
class-jetpack-seo-posts.php	8.75 KB
class-jetpack-seo-titles.php	9.87 KB
class-jetpack-seo-utils.php	4.37 KB
class-jetpack-seo.php	9.11 KB

Edit: class-jetpack-seo-posts.php

<?php
/**
 * Class containing utility static methods for managing SEO options for Posts and Pages.
 *
 * @package automattic/jetpack
 */

/**
 * Provides static utility methods for managing SEO options for Posts and Pages.
 */
class Jetpack_SEO_Posts {
	/**
	 * Key of the post meta values that will be used to store post custom data.
	 */
	const DESCRIPTION_META_KEY = 'advanced_seo_description';
	const HTML_TITLE_META_KEY  = 'jetpack_seo_html_title';
	const NOINDEX_META_KEY     = 'jetpack_seo_noindex';
	const SCHEMA_TYPE_META_KEY = 'jetpack_seo_schema_type';
	const POST_META_KEYS_ARRAY = array(
		self::DESCRIPTION_META_KEY,
		self::HTML_TITLE_META_KEY,
		self::NOINDEX_META_KEY,
		self::SCHEMA_TYPE_META_KEY,
	);

/**
	 * Allowed Schema.org types that can be stored in the per-post schema-type
	 * meta. Empty string means "no override" — Schema_Builder picks a sensible
	 * default for the post. Single source of truth for the meta enum, the
	 * block-editor panel options, and Schema_Builder.
	 */
	const ALLOWED_SCHEMA_TYPES = array( '', 'article', 'faq' );

/**
	 * Build meta description for post SEO.
	 *
	 * @param WP_Post|null $post Source of data for custom description.
	 *
	 * @return string Post description or empty string.
	 */
	public static function get_post_description( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return '';
		}

// Check the post being described, not the global one.
		if ( post_password_required( $post ) || ! is_singular() ) {
			return '';
		}

// Business users can overwrite the description.
		$custom_description = self::get_post_custom_description( $post );

if ( ! empty( $custom_description ) ) {
			return $custom_description;
		}

if ( ! empty( $post->post_excerpt ) ) {
			return $post->post_excerpt;
		}

// The fall-through reads raw post_content, which never passes the `the_content` paywall.
		$content = $post->post_content;
		if ( \Automattic\Jetpack\SEO\Content_Gate::is_gated( $post ) ) {
			$content = \Automattic\Jetpack\SEO\Content_Gate::public_teaser( $post );
			if ( '' === $content ) {
				return '';
			}
		}

// Remove content within wp:query blocks and return.
		return Jetpack_SEO_Utils::remove_query_blocks( $content );
	}

/**
	 * Returns post's custom meta description if it is set, and if
	 * SEO tools are enabled for current blog.
	 *
	 * @param WP_Post|null $post Source of data for custom description.
	 *
	 * @return string Custom description or empty string
	 */
	public static function get_post_custom_description( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return '';
		}

$custom_description = get_post_meta( $post->ID, self::DESCRIPTION_META_KEY, true );

if ( empty( $custom_description ) || ! Jetpack_SEO_Utils::is_enabled_jetpack_seo() ) {
			return '';
		}

return $custom_description;
	}

/**
	 * Gets a custom HTML title for a post if one is set, and if
	 * SEO tools are enabled for the current blog.
	 *
	 * @param WP_Post|null $post Source of data for the custom HTML title.
	 *
	 * @return string Custom HTML title or an empty string if not set.
	 */
	public static function get_post_custom_html_title( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return '';
		}

$custom_html_title = get_post_meta( $post->ID, self::HTML_TITLE_META_KEY, true );

if ( empty( $custom_html_title ) || ! Jetpack_SEO_Utils::is_enabled_jetpack_seo() ) {
			return '';
		}

return $custom_html_title;
	}

/**
	 * Gets the `jetpack_seo_noindex` setting for a post, if
	 * SEO tools are enabled for the current blog.
	 *
	 * @param WP_Post|null $post Provided post or defaults to the global post.
	 *
	 * @return bool True if post should be marked as noindex, false otherwise.
	 */
	public static function get_post_noindex_setting( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return false;
		}

$mark_as_noindex = get_post_meta( $post->ID, self::NOINDEX_META_KEY, true );

if ( empty( $mark_as_noindex ) || ! Jetpack_SEO_Utils::is_enabled_jetpack_seo() ) {
			return false;
		}

return (bool) $mark_as_noindex;
	}

/**
	 * Filter callback for `jetpack_sitemap_skip_post`; if a post has `jetpack_seo_noindex` set to true,
	 * then exclude that post from the Jetpack sitemap.
	 *
	 * @param bool    $skip Whether to skip the post in the sitemap.
	 * @param WP_Post $post The post to check.
	 *
	 * @return bool
	 */
	public static function exclude_noindex_posts_from_jetpack_sitemap( $skip, $post ) {
		$exclude = self::get_post_noindex_setting( $post );
		if ( $exclude ) {
			$skip = true;
		}
		return $skip;
	}

/**
	 * Registers the SEO post meta keys for use in the REST API:
	 *   - self::DESCRIPTION_META_KEY
	 *   - self::HTML_TITLE_META_KEY
	 *   - self::NOINDEX_META_KEY
	 *   - self::SCHEMA_TYPE_META_KEY
	 */
	public static function register_post_meta() {
		$description_args = array(
			'type'         => 'string',
			'description'  => __( 'Custom post description to be used in HTML <meta /> tag.', 'jetpack' ),
			'single'       => true,
			'default'      => '',
			'show_in_rest' => array(
				'name' => self::DESCRIPTION_META_KEY,
			),
		);

$html_title_args = array(
			'type'         => 'string',
			'description'  => __( 'Custom title to be used in HTML <title /> tag.', 'jetpack' ),
			'single'       => true,
			'default'      => '',
			'show_in_rest' => array(
				'name' => self::HTML_TITLE_META_KEY,
			),
		);

$noindex_args = array(
			'type'         => 'boolean',
			'description'  => __( 'Whether to hide the post from search engines and the Jetpack sitemap.', 'jetpack' ),
			'single'       => true,
			'default'      => false,
			'show_in_rest' => array(
				'name' => self::NOINDEX_META_KEY,
			),
		);

$schema_type_args = array(
			'type'              => 'string',
			'description'       => __( 'Schema.org type to emit as JSON-LD for this post.', 'jetpack' ),
			'single'            => true,
			'default'           => '',
			'sanitize_callback' => array( __CLASS__, 'sanitize_schema_type' ),
			'show_in_rest'      => array(
				'name'   => self::SCHEMA_TYPE_META_KEY,
				// Enum so core REST rejects an unknown schema type with a proper
				// rest_invalid_param error; the sanitize_callback is the
				// defense-in-depth fallback for non-REST writes.
				'schema' => array(
					'type' => 'string',
					'enum' => self::ALLOWED_SCHEMA_TYPES,
				),
			),
		);

register_meta( 'post', self::DESCRIPTION_META_KEY, $description_args );
		register_meta( 'post', self::HTML_TITLE_META_KEY, $html_title_args );
		register_meta( 'post', self::NOINDEX_META_KEY, $noindex_args );
		register_meta( 'post', self::SCHEMA_TYPE_META_KEY, $schema_type_args );
	}

/**
	 * Sanitize a schema type to the allowed list. Unknown values become ''
	 * (no override) rather than erroring, so a non-REST write can't store junk.
	 *
	 * @param string $value The submitted value.
	 * @return string A value from self::ALLOWED_SCHEMA_TYPES.
	 */
	public static function sanitize_schema_type( $value ) {
		$value = is_string( $value ) ? sanitize_key( $value ) : '';
		return in_array( $value, self::ALLOWED_SCHEMA_TYPES, true ) ? $value : '';
	}

/**
	 * Get the per-post schema-type override, if any.
	 *
	 * @param WP_Post|int|null $post Post or post ID.
	 * @return string A value from self::ALLOWED_SCHEMA_TYPES ('' = no override).
	 */
	public static function get_post_schema_type( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return '';
		}
		return self::sanitize_schema_type( (string) get_post_meta( $post->ID, self::SCHEMA_TYPE_META_KEY, true ) );
	}

/**
	 * Factual per-post SEO field coverage — presence/state only, never a score.
	 *
	 * Single source of truth shared by the Content tab, the edit.php columns,
	 * and the Overview coverage card so the three never drift. Reports whether
	 * each field has been *set*, independent of whether SEO tools are currently
	 * active (this is an authoring/audit view, not front-end emission).
	 *
	 * @param WP_Post|int|null $post Post or post ID.
	 * @return array{has_custom_title:bool,has_description:bool,has_schema_type:bool,noindex:bool}
	 */
	public static function get_post_seo_coverage( $post = null ) {
		$post = get_post( $post );
		if ( ! ( $post instanceof WP_Post ) ) {
			return array(
				'has_custom_title' => false,
				'has_description'  => false,
				'has_schema_type'  => false,
				'noindex'          => false,
			);
		}

return array(
			'has_custom_title' => '' !== (string) get_post_meta( $post->ID, self::HTML_TITLE_META_KEY, true ),
			'has_description'  => '' !== (string) get_post_meta( $post->ID, self::DESCRIPTION_META_KEY, true ),
			'has_schema_type'  => '' !== self::get_post_schema_type( $post ),
			'noindex'          => (bool) get_post_meta( $post->ID, self::NOINDEX_META_KEY, true ),
		);
	}
}