class-jetpack-seo-posts.php
3 years ago
class-jetpack-seo-titles.php
3 years ago
class-jetpack-seo-utils.php
4 years ago
class-jetpack-seo.php
3 years ago
class-jetpack-seo.php
255 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Main class file for the SEO Tools module. |
| 4 | * |
| 5 | * @package automattic/jetpack |
| 6 | */ |
| 7 | |
| 8 | /** |
| 9 | * An SEO expert walks into a bar, bars, pub, public house, Irish pub, drinks, beer, wine, liquor, Grey Goose, Cristal... |
| 10 | */ |
| 11 | class Jetpack_SEO { |
| 12 | /** |
| 13 | * Constructor. |
| 14 | */ |
| 15 | public function __construct() { |
| 16 | add_action( 'init', array( $this, 'init' ) ); |
| 17 | } |
| 18 | |
| 19 | /** |
| 20 | * Initialization method for Jetpack_SEO. |
| 21 | */ |
| 22 | public function init() { |
| 23 | /** |
| 24 | * Can be used to prevent SEO tools from inserting custom meta tags. |
| 25 | * |
| 26 | * @module seo-tools |
| 27 | * |
| 28 | * @since 4.4.0 |
| 29 | * |
| 30 | * @param bool true Should Jetpack's SEO Meta Tags be enabled. Defaults to true. |
| 31 | */ |
| 32 | if ( apply_filters( 'jetpack_seo_meta_tags_enabled', true ) ) { |
| 33 | add_action( 'wp_head', array( $this, 'meta_tags' ) ); |
| 34 | |
| 35 | // Add support for editing page excerpts in pages, regardless of theme support. |
| 36 | add_post_type_support( 'page', 'excerpt' ); |
| 37 | } |
| 38 | |
| 39 | /** |
| 40 | * Can be used to prevent SEO tools form modifying site titles. |
| 41 | * |
| 42 | * @module seo-tools |
| 43 | * |
| 44 | * @since 4.4.0 |
| 45 | * |
| 46 | * @param bool true Should Jetpack SEO modify site titles. Defaults to true. |
| 47 | */ |
| 48 | if ( apply_filters( 'jetpack_seo_custom_titles', true ) ) { |
| 49 | // Overwrite page title with custom SEO meta title for themes that support title-tag. |
| 50 | add_filter( 'pre_get_document_title', array( 'Jetpack_SEO_Titles', 'get_custom_title' ) ); |
| 51 | |
| 52 | // Add overwrite support for themes that don't support title-tag. |
| 53 | add_filter( 'wp_title', array( 'Jetpack_SEO_Titles', 'get_custom_title' ) ); |
| 54 | } |
| 55 | |
| 56 | add_filter( 'jetpack_open_graph_tags', array( $this, 'set_custom_og_tags' ) ); |
| 57 | Jetpack_SEO_Posts::register_post_meta(); |
| 58 | Jetpack_SEO_Posts::register_gutenberg_extension(); |
| 59 | // Exclude posts with 'jetpack_seo_noindex' set true from the Jetpack sitemap. |
| 60 | add_filter( 'jetpack_sitemap_skip_post', array( 'Jetpack_SEO_Posts', 'exclude_noindex_posts_from_jetpack_sitemap' ), 10, 2 ); |
| 61 | } |
| 62 | |
| 63 | /** |
| 64 | * Helper method to fetch authors. |
| 65 | */ |
| 66 | private function get_authors() { |
| 67 | global $wp_query; |
| 68 | |
| 69 | $authors = array(); |
| 70 | |
| 71 | foreach ( $wp_query->posts as $post ) { |
| 72 | $authors[] = get_the_author_meta( 'display_name', (int) $post->post_author ); |
| 73 | } |
| 74 | |
| 75 | $authors = array_unique( $authors ); |
| 76 | |
| 77 | return $authors; |
| 78 | } |
| 79 | |
| 80 | /** |
| 81 | * Constructs open graph tag data. |
| 82 | * |
| 83 | * @param array $tags Array of tag data. |
| 84 | * @return array of tag data. |
| 85 | */ |
| 86 | public function set_custom_og_tags( $tags ) { |
| 87 | $custom_title = Jetpack_SEO_Titles::get_custom_title(); |
| 88 | |
| 89 | if ( ! empty( $custom_title ) ) { |
| 90 | $tags['og:title'] = $custom_title; |
| 91 | } |
| 92 | |
| 93 | $post_custom_description = Jetpack_SEO_Posts::get_post_custom_description( get_post() ); |
| 94 | $front_page_meta = Jetpack_SEO_Utils::get_front_page_meta_description(); |
| 95 | |
| 96 | if ( class_exists( 'woocommerce' ) && is_shop() ) { |
| 97 | $shop_page_id = get_option( 'woocommerce_shop_page_id' ); |
| 98 | if ( $shop_page_id ) { |
| 99 | $post_custom_description = Jetpack_SEO_Posts::get_post_custom_description( get_post( $shop_page_id ) ); |
| 100 | } |
| 101 | } |
| 102 | |
| 103 | if ( is_front_page() && ! empty( $front_page_meta ) ) { |
| 104 | $tags['og:description'] = $front_page_meta; |
| 105 | } elseif ( ! empty( $post_custom_description ) ) { |
| 106 | $tags['og:description'] = $post_custom_description; |
| 107 | } |
| 108 | |
| 109 | return $tags; |
| 110 | } |
| 111 | |
| 112 | /** |
| 113 | * Outputs Jetpack's SEO <meta> tags. |
| 114 | */ |
| 115 | public function meta_tags() { |
| 116 | global $wp_query; |
| 117 | |
| 118 | $post_count = is_countable( $wp_query->posts ) ? count( $wp_query->posts ) : 0; |
| 119 | $period = ''; |
| 120 | $template = ''; |
| 121 | $meta = array(); |
| 122 | |
| 123 | /** |
| 124 | * Can be used to specify a list of themes that set their own meta tags. |
| 125 | * |
| 126 | * If current site is using one of the themes listed as conflicting, inserting Jetpack SEO |
| 127 | * meta tags will be prevented. |
| 128 | * |
| 129 | * @module seo-tools |
| 130 | * |
| 131 | * @since 4.4.0 |
| 132 | * |
| 133 | * @param array List of conflicted theme names. Defaults to empty array. |
| 134 | */ |
| 135 | $conflicted_themes = apply_filters( 'jetpack_seo_meta_tags_conflicted_themes', array() ); |
| 136 | |
| 137 | if ( isset( $conflicted_themes[ get_option( 'template' ) ] ) ) { |
| 138 | return; |
| 139 | } |
| 140 | |
| 141 | $front_page_meta = Jetpack_SEO_Utils::get_front_page_meta_description(); |
| 142 | $description = $front_page_meta ? $front_page_meta : get_bloginfo( 'description' ); |
| 143 | $meta['description'] = trim( $description ); |
| 144 | |
| 145 | // Try to target things if we're on a "specific" page of any kind. |
| 146 | if ( is_singular() ) { |
| 147 | if ( ! ( is_front_page() && Jetpack_SEO_Utils::get_front_page_meta_description() ) ) { |
| 148 | $description = Jetpack_SEO_Posts::get_post_description( get_post() ); |
| 149 | |
| 150 | if ( $description ) { |
| 151 | $description = wp_trim_words( |
| 152 | strip_shortcodes( |
| 153 | wp_strip_all_tags( $description, true ) |
| 154 | ) |
| 155 | ); |
| 156 | $meta['description'] = $description; |
| 157 | } |
| 158 | } |
| 159 | } elseif ( is_author() ) { |
| 160 | $obj = get_queried_object(); |
| 161 | |
| 162 | $meta['description'] = sprintf( |
| 163 | /* translators: first property is an user's display name, the second is the site's title. */ |
| 164 | _x( 'Read all of the posts by %1$s on %2$s', 'Read all of the posts by Author Name on Blog Title', 'jetpack' ), |
| 165 | isset( $obj->display_name ) ? $obj->display_name : __( 'the author', 'jetpack' ), |
| 166 | get_bloginfo( 'title' ) |
| 167 | ); |
| 168 | } elseif ( is_tag() || is_category() || is_tax() ) { |
| 169 | $obj = get_queried_object(); |
| 170 | $description = ''; |
| 171 | |
| 172 | if ( isset( $obj->term_id ) && isset( $obj->taxonomy ) ) { |
| 173 | $description = get_term_field( 'description', $obj->term_id, $obj->taxonomy, 'raw' ); |
| 174 | } |
| 175 | |
| 176 | if ( ! is_wp_error( $description ) && $description ) { |
| 177 | $meta['description'] = wp_trim_words( $description ); |
| 178 | } else { |
| 179 | $authors = $this->get_authors(); |
| 180 | |
| 181 | $meta['description'] = wp_sprintf( |
| 182 | /* translators: %1$s: A post category. %2$l: Post authors. */ |
| 183 | _x( 'Posts about %1$s written by %2$l', 'Posts about Category written by John and Bob', 'jetpack' ), |
| 184 | single_term_title( '', false ), |
| 185 | $authors |
| 186 | ); |
| 187 | } |
| 188 | } elseif ( is_date() ) { |
| 189 | if ( is_year() ) { |
| 190 | $period = get_query_var( 'year' ); |
| 191 | |
| 192 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A year date. */ |
| 193 | $template = _nx( |
| 194 | '%1$s post published by %2$l in the year %3$s', // Singular. |
| 195 | '%1$s posts published by %2$l in the year %3$s', // Plural. |
| 196 | $post_count, // Number. |
| 197 | '10 posts published by John in the year 2012', // Context. |
| 198 | 'jetpack' |
| 199 | ); |
| 200 | } elseif ( is_month() ) { |
| 201 | $period = gmdate( 'F Y', mktime( 0, 0, 0, get_query_var( 'monthnum' ), 1, get_query_var( 'year' ) ) ); |
| 202 | |
| 203 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A month/year date. */ |
| 204 | $template = _nx( |
| 205 | '%1$s post published by %2$l during %3$s', // Singular. |
| 206 | '%1$s posts published by %2$l during %3$s', // Plural. |
| 207 | $post_count, // Number. |
| 208 | '10 posts publishes by John during May 2012', // Context. |
| 209 | 'jetpack' |
| 210 | ); |
| 211 | } elseif ( is_day() ) { |
| 212 | $period = gmdate( |
| 213 | 'F j, Y', |
| 214 | mktime( 0, 0, 0, get_query_var( 'monthnum' ), get_query_var( 'day' ), get_query_var( 'year' ) ) |
| 215 | ); |
| 216 | |
| 217 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A month/day/year date. */ |
| 218 | $template = _nx( |
| 219 | '%1$s post published by %2$l on %3$s', // Singular. |
| 220 | '%1$s posts published by %2$l on %3$s', // Plural. |
| 221 | $post_count, // Number. |
| 222 | '10 posts published by John on May 30, 2012', // Context. |
| 223 | 'jetpack' |
| 224 | ); |
| 225 | } |
| 226 | |
| 227 | $authors = $this->get_authors(); |
| 228 | $meta['description'] = wp_sprintf( $template, $post_count, $authors, $period ); |
| 229 | } |
| 230 | |
| 231 | $mark_as_noindex = Jetpack_SEO_Posts::get_post_noindex_setting( get_post() ); |
| 232 | if ( $mark_as_noindex ) { |
| 233 | $meta['robots'] = 'noindex'; |
| 234 | } |
| 235 | |
| 236 | /** |
| 237 | * Can be used to edit the default SEO tools meta tags. |
| 238 | * |
| 239 | * @module seo-tools |
| 240 | * |
| 241 | * @since 4.4.0 |
| 242 | * |
| 243 | * @param array Array that consists of meta name and meta content pairs. |
| 244 | */ |
| 245 | $meta = apply_filters( 'jetpack_seo_meta_tags', $meta ); |
| 246 | |
| 247 | // Output them. |
| 248 | foreach ( $meta as $name => $content ) { |
| 249 | if ( ! empty( $content ) ) { |
| 250 | echo '<meta name="' . esc_attr( $name ) . '" content="' . esc_attr( $content ) . '" />' . "\n"; |
| 251 | } |
| 252 | } |
| 253 | } |
| 254 | } |
| 255 |