summaryrefslogtreecommitdiff
blob: 82c9b0a58228501b25b14249bfb6305e62145b0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?php

/**
 * Class containing utility static 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' );
		}
	}
}