class-jetpack-seo-posts.php
2 years ago
class-jetpack-seo-titles.php
3 years ago
class-jetpack-seo-utils.php
2 years ago
class-jetpack-seo.php
2 years ago
class-jetpack-seo.php
254 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 from 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 | // Exclude posts with 'jetpack_seo_noindex' set true from the Jetpack sitemap. |
| 59 | add_filter( 'jetpack_sitemap_skip_post', array( 'Jetpack_SEO_Posts', 'exclude_noindex_posts_from_jetpack_sitemap' ), 10, 2 ); |
| 60 | } |
| 61 | |
| 62 | /** |
| 63 | * Helper method to fetch authors. |
| 64 | */ |
| 65 | private function get_authors() { |
| 66 | global $wp_query; |
| 67 | |
| 68 | $authors = array(); |
| 69 | |
| 70 | foreach ( $wp_query->posts as $post ) { |
| 71 | $authors[] = get_the_author_meta( 'display_name', (int) $post->post_author ); |
| 72 | } |
| 73 | |
| 74 | $authors = array_unique( $authors ); |
| 75 | |
| 76 | return $authors; |
| 77 | } |
| 78 | |
| 79 | /** |
| 80 | * Constructs open graph tag data. |
| 81 | * |
| 82 | * @param array $tags Array of tag data. |
| 83 | * @return array of tag data. |
| 84 | */ |
| 85 | public function set_custom_og_tags( $tags ) { |
| 86 | $custom_title = Jetpack_SEO_Titles::get_custom_title(); |
| 87 | |
| 88 | if ( ! empty( $custom_title ) ) { |
| 89 | $tags['og:title'] = $custom_title; |
| 90 | } |
| 91 | |
| 92 | $post_custom_description = Jetpack_SEO_Posts::get_post_custom_description( get_post() ); |
| 93 | $front_page_meta = Jetpack_SEO_Utils::get_front_page_meta_description(); |
| 94 | |
| 95 | if ( class_exists( 'woocommerce' ) && is_shop() ) { |
| 96 | $shop_page_id = get_option( 'woocommerce_shop_page_id' ); |
| 97 | if ( $shop_page_id ) { |
| 98 | $post_custom_description = Jetpack_SEO_Posts::get_post_custom_description( get_post( $shop_page_id ) ); |
| 99 | } |
| 100 | } |
| 101 | |
| 102 | if ( is_front_page() && ! empty( $front_page_meta ) ) { |
| 103 | $tags['og:description'] = $front_page_meta; |
| 104 | } elseif ( ! empty( $post_custom_description ) ) { |
| 105 | $tags['og:description'] = $post_custom_description; |
| 106 | } |
| 107 | |
| 108 | return $tags; |
| 109 | } |
| 110 | |
| 111 | /** |
| 112 | * Outputs Jetpack's SEO <meta> tags. |
| 113 | */ |
| 114 | public function meta_tags() { |
| 115 | global $wp_query; |
| 116 | |
| 117 | $post_count = is_countable( $wp_query->posts ) ? count( $wp_query->posts ) : 0; |
| 118 | $period = ''; |
| 119 | $template = ''; |
| 120 | $meta = array(); |
| 121 | |
| 122 | /** |
| 123 | * Can be used to specify a list of themes that set their own meta tags. |
| 124 | * |
| 125 | * If current site is using one of the themes listed as conflicting, inserting Jetpack SEO |
| 126 | * meta tags will be prevented. |
| 127 | * |
| 128 | * @module seo-tools |
| 129 | * |
| 130 | * @since 4.4.0 |
| 131 | * |
| 132 | * @param array List of conflicted theme names. Defaults to empty array. |
| 133 | */ |
| 134 | $conflicted_themes = apply_filters( 'jetpack_seo_meta_tags_conflicted_themes', array() ); |
| 135 | |
| 136 | if ( isset( $conflicted_themes[ get_option( 'template' ) ] ) ) { |
| 137 | return; |
| 138 | } |
| 139 | |
| 140 | $front_page_meta = Jetpack_SEO_Utils::get_front_page_meta_description(); |
| 141 | $description = $front_page_meta ? $front_page_meta : get_bloginfo( 'description' ); |
| 142 | $meta['description'] = trim( $description ); |
| 143 | |
| 144 | // Try to target things if we're on a "specific" page of any kind. |
| 145 | if ( is_singular() ) { |
| 146 | if ( ! ( is_front_page() && Jetpack_SEO_Utils::get_front_page_meta_description() ) ) { |
| 147 | $description = Jetpack_SEO_Posts::get_post_description( get_post() ); |
| 148 | |
| 149 | if ( $description ) { |
| 150 | $description = wp_trim_words( |
| 151 | strip_shortcodes( |
| 152 | wp_strip_all_tags( $description, true ) |
| 153 | ) |
| 154 | ); |
| 155 | $meta['description'] = $description; |
| 156 | } |
| 157 | } |
| 158 | } elseif ( is_author() ) { |
| 159 | $obj = get_queried_object(); |
| 160 | |
| 161 | $meta['description'] = sprintf( |
| 162 | /* translators: first property is an user's display name, the second is the site's title. */ |
| 163 | _x( 'Read all of the posts by %1$s on %2$s', 'Read all of the posts by Author Name on Blog Title', 'jetpack' ), |
| 164 | isset( $obj->display_name ) ? $obj->display_name : __( 'the author', 'jetpack' ), |
| 165 | get_bloginfo( 'title' ) |
| 166 | ); |
| 167 | } elseif ( is_tag() || is_category() || is_tax() ) { |
| 168 | $obj = get_queried_object(); |
| 169 | $description = ''; |
| 170 | |
| 171 | if ( isset( $obj->term_id ) && isset( $obj->taxonomy ) ) { |
| 172 | $description = get_term_field( 'description', $obj->term_id, $obj->taxonomy, 'raw' ); |
| 173 | } |
| 174 | |
| 175 | if ( ! is_wp_error( $description ) && $description ) { |
| 176 | $meta['description'] = wp_trim_words( $description ); |
| 177 | } else { |
| 178 | $authors = $this->get_authors(); |
| 179 | |
| 180 | $meta['description'] = wp_sprintf( |
| 181 | /* translators: %1$s: A post category. %2$l: Post authors. */ |
| 182 | _x( 'Posts about %1$s written by %2$l', 'Posts about Category written by John and Bob', 'jetpack' ), |
| 183 | single_term_title( '', false ), |
| 184 | $authors |
| 185 | ); |
| 186 | } |
| 187 | } elseif ( is_date() ) { |
| 188 | if ( is_year() ) { |
| 189 | $period = get_query_var( 'year' ); |
| 190 | |
| 191 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A year date. */ |
| 192 | $template = _nx( |
| 193 | '%1$s post published by %2$l in the year %3$s', // Singular. |
| 194 | '%1$s posts published by %2$l in the year %3$s', // Plural. |
| 195 | $post_count, // Number. |
| 196 | '10 posts published by John in the year 2012', // Context. |
| 197 | 'jetpack' |
| 198 | ); |
| 199 | } elseif ( is_month() ) { |
| 200 | $period = gmdate( 'F Y', mktime( 0, 0, 0, get_query_var( 'monthnum' ), 1, get_query_var( 'year' ) ) ); |
| 201 | |
| 202 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A month/year date. */ |
| 203 | $template = _nx( |
| 204 | '%1$s post published by %2$l during %3$s', // Singular. |
| 205 | '%1$s posts published by %2$l during %3$s', // Plural. |
| 206 | $post_count, // Number. |
| 207 | '10 posts publishes by John during May 2012', // Context. |
| 208 | 'jetpack' |
| 209 | ); |
| 210 | } elseif ( is_day() ) { |
| 211 | $period = gmdate( |
| 212 | 'F j, Y', |
| 213 | mktime( 0, 0, 0, get_query_var( 'monthnum' ), get_query_var( 'day' ), get_query_var( 'year' ) ) |
| 214 | ); |
| 215 | |
| 216 | /* translators: %1$s: Number of posts published. %2$l: Post author. %3$s: A month/day/year date. */ |
| 217 | $template = _nx( |
| 218 | '%1$s post published by %2$l on %3$s', // Singular. |
| 219 | '%1$s posts published by %2$l on %3$s', // Plural. |
| 220 | $post_count, // Number. |
| 221 | '10 posts published by John on May 30, 2012', // Context. |
| 222 | 'jetpack' |
| 223 | ); |
| 224 | } |
| 225 | |
| 226 | $authors = $this->get_authors(); |
| 227 | $meta['description'] = wp_sprintf( $template, $post_count, $authors, $period ); |
| 228 | } |
| 229 | |
| 230 | $mark_as_noindex = Jetpack_SEO_Posts::get_post_noindex_setting( get_post() ); |
| 231 | if ( $mark_as_noindex ) { |
| 232 | $meta['robots'] = 'noindex'; |
| 233 | } |
| 234 | |
| 235 | /** |
| 236 | * Can be used to edit the default SEO tools meta tags. |
| 237 | * |
| 238 | * @module seo-tools |
| 239 | * |
| 240 | * @since 4.4.0 |
| 241 | * |
| 242 | * @param array Array that consists of meta name and meta content pairs. |
| 243 | */ |
| 244 | $meta = apply_filters( 'jetpack_seo_meta_tags', $meta ); |
| 245 | |
| 246 | // Output them. |
| 247 | foreach ( $meta as $name => $content ) { |
| 248 | if ( ! empty( $content ) ) { |
| 249 | echo '<meta name="' . esc_attr( $name ) . '" content="' . esc_attr( $content ) . '" />' . "\n"; |
| 250 | } |
| 251 | } |
| 252 | } |
| 253 | } |
| 254 |