97 lines
2.4 KiB
PHP
97 lines
2.4 KiB
PHP
<?php
|
|
/**
|
|
* Class containing utility static methods for managing SEO custom descriptions for Posts and Pages.
|
|
*
|
|
* @package automattic/jetpack
|
|
*/
|
|
|
|
/**
|
|
* Provides static utility methods for managing SEO custom descriptions for Posts and Pages.
|
|
*/
|
|
class Jetpack_SEO_Posts {
|
|
/**
|
|
* Key of the post meta value that will be used to store post custom description.
|
|
*/
|
|
const DESCRIPTION_META_KEY = 'advanced_seo_description';
|
|
|
|
/**
|
|
* Build meta description for post SEO.
|
|
*
|
|
* @param WP_Post $post Source of data for custom description.
|
|
*
|
|
* @return string Post description or empty string.
|
|
*/
|
|
public static function get_post_description( $post ) {
|
|
if ( empty( $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;
|
|
}
|
|
|
|
return $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 $post Source of data for custom description.
|
|
*
|
|
* @return string Custom description or empty string
|
|
*/
|
|
public static function get_post_custom_description( $post ) {
|
|
if ( empty( $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;
|
|
}
|
|
|
|
/**
|
|
* Registers the self::DESCRIPTION_META_KEY post_meta for use in the REST API.
|
|
*/
|
|
public static function register_post_meta() {
|
|
$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,
|
|
),
|
|
);
|
|
|
|
register_meta( 'post', self::DESCRIPTION_META_KEY, $args );
|
|
}
|
|
|
|
/**
|
|
* Register the Advanced SEO Gutenberg extension
|
|
*/
|
|
public static function register_gutenberg_extension() {
|
|
if ( Jetpack_SEO_Utils::is_enabled_jetpack_seo() ) {
|
|
Jetpack_Gutenberg::set_extension_available( 'jetpack-seo' );
|
|
} else {
|
|
Jetpack_Gutenberg::set_extension_unavailable( 'jetpack-seo', 'jetpack_seo_disabled' );
|
|
}
|
|
}
|
|
}
|