FileXXXXXXXXXXX

?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? ?????????????? FileXXXXXXXXXXX

File manager - Edit - /home/paocyvk/www/wp-content/plugins/jetpack/modules/seo-tools/class-jetpack-seo-posts.php

Back
<?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 ''; } if ( post_password_required() \|\| ! 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; } // Remove content within wp:query blocks and return. return Jetpack_SEO_Utils::remove_query_blocks( $post->post_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 ), ); } }