PluginProbe
ThinkRank AI SEO – AI SEO Plugin for WordPress: Schema, XML Sitemaps, Meta Tags, Search Console & Local SEO / 2.12.0
ThinkRank AI SEO – AI SEO Plugin for WordPress: Schema, XML Sitemaps, Meta Tags, Search Console & Local SEO v2.12.0
2.14.0 2.13.0 2.12.0 2.11.0 2.10.0 2.9.0 2.8.0 2.7.0 2.6.0 2.5.0 2.4.0 2.3.0 2.2.0 2.1.1 2.1.0 2.0.2 2.0.1 2.0.0 1.32.0 1.31.0 1.30.0 1.29.0 1.28.0 1.27.0 1.26.0 All 55 releases
← All changes | includes/seo/class-social-meta-manager.php +517 -91 1.30.0 → 2.12.0 View file →
@@ -74,9 +74,12 @@
74 74 'image_min_width' => 600,
75 75 'image_min_height' => 900,
76 76 'image_recommended_ratio' => 0.67, // 2:3 ratio
77 77 'title_max_length' => 100,
78 - 'description_max_length' => 500
78 + // Pinterest has no tag of its own: it reads og:description, which
79 + // the frontend caps at max_description_length. Previewing 500
80 + // promised up to 340 characters that are never emitted.
81 + 'description_max_length' => 160
79 82 ],
80 83 'whatsapp' => [
81 84 'og_required' => ['og:title', 'og:type', 'og:image', 'og:url'],
82 85 'og_recommended' => ['og:description'],
@@ -130,10 +133,16 @@
130 133
131 134 $platform_spec = $this->supported_platforms[$platform];
132 135 $og_tags = [];
133 136
134 - // Determine OG type based on context
135 - $og_type = $this->determine_og_type($context, $data);
137 + // OG type: the type the user explicitly chose, otherwise derived from
138 + // the context. This used to call determine_og_type() unconditionally,
139 + // overwriting the value extract_social_content_data() had already read
140 + // from the setting — so the Content Type dropdown, the abilities API
141 + // and every imported og:type were silently discarded (#398).
142 + $og_type = ($data['type'] ?? '') !== ''
143 + ? $data['type']
144 + : $this->determine_og_type($context, $data);
136 145 $og_tags['og:type'] = $og_type;
137 146
138 147 // Required OG tags
139 148 // og:title must render the full resolved Open Graph title. The 60-char
@@ -139,10 +148,23 @@
139 148 // og:title must render the full resolved Open Graph title. The 60-char
140 149 // cap in optimize_title_for_platform() is an SEO-title recommendation for
141 150 // search results and does not apply to the og:title social tag, so use the
142 151 // resolved title verbatim (falling back to the site name when empty).
143 - $og_tags['og:title'] = ($data['title'] ?? '') !== '' ? $data['title'] : get_bloginfo('name');
144 - $og_tags['og:url'] = $data['url'] ?? $this->get_current_url();
152 + // Stripped: a title carrying markup is attribute-escaped into this tag,
153 + // so the reader sees a literal `<em>` rather than emphasis (#640).
154 + $og_tags['og:title'] = \ThinkRank\Frontend\SEO_Manager::strip_title_tags(
155 + ($data['title'] ?? '') !== '' ? (string) $data['title'] : (string) get_bloginfo('name')
156 + );
157 + // `?:` rather than `??`: the key is always present, seeded as '', so the
158 + // null-coalesce could never reach the fallback. og:url was emitted empty
159 + // and then dropped by the !empty() guard in output_social_og_tags(),
160 + // which is why archives carried no og:url at all (#388).
161 + // Normalized for the site's scheme preference, so og:url and the
162 + // canonical can never disagree about http vs https (#638); the same
163 + // consistency #182 was about.
164 + $og_tags['og:url'] = \ThinkRank\SEO\Url_Scheme::apply(
165 + ($data['url'] ?? '') !== '' ? $data['url'] : $this->get_current_url()
166 + );
145 167
146 168 // Image handling with optimization
147 169 if (!empty($data['image'])) {
148 170 $optimized_image = $this->optimize_image_for_platform($data['image'], $platform);
@@ -209,17 +231,26 @@
209 231 // to the resolved og:title/SEO title. Render it in full — the length cap
210 232 // in optimize_title_for_platform() is an SEO-title recommendation for
211 233 // search results, not a rule for the twitter:title social tag.
212 234 $twitter_title = ($data['twitter_title'] ?? '') !== '' ? $data['twitter_title'] : ($data['title'] ?? '');
213 - $twitter_tags['twitter:title'] = $twitter_title !== '' ? $twitter_title : get_bloginfo('name');
235 + $twitter_tags['twitter:title'] = \ThinkRank\Frontend\SEO_Manager::strip_title_tags(
236 + $twitter_title !== '' ? (string) $twitter_title : (string) get_bloginfo('name')
237 + );
214 238
215 - // Recommended tags
216 - if (!empty($data['description'])) {
217 - $twitter_tags['twitter:description'] = $this->optimize_description_for_platform($data['description'], 'twitter');
239 + // Recommended tags. Prefer a per-object Twitter-specific description,
240 + // falling back to the resolved OG/meta description — mirroring the
241 + // twitter:title cascade above. This lookup did not exist, so a Twitter
242 + // description saved on the Social tab persisted, read back, and was
243 + // then dropped in favour of the OG description (#406).
244 + $twitter_description = ($data['twitter_description'] ?? '') !== ''
245 + ? $data['twitter_description']
246 + : (string) ($data['description'] ?? '');
247 + if ($twitter_description !== '') {
248 + $twitter_tags['twitter:description'] = $this->optimize_description_for_platform($twitter_description, 'twitter');
218 249 }
219 250
220 251 // Image handling - prioritize Twitter-specific image
221 - $twitter_image = !empty($data['twitter_image']) ? $data['twitter_image'] : $data['image'];
252 + $twitter_image = !empty($data['twitter_image']) ? $data['twitter_image'] : ($data['image'] ?? '');
222 253 if (!empty($twitter_image)) {
223 254 $optimized_image = $this->optimize_image_for_platform($twitter_image, 'twitter');
224 255 $twitter_tags['twitter:image'] = $optimized_image['url'];
225 256 if (!empty($optimized_image['alt'])) {
@@ -937,8 +968,12 @@
937 968
938 969 $settings = $this->get_settings($context_type, $context_id);
939 970 $output = [
940 971 'og_tags' => [],
972 + // Secondary og:image entries. A separate list because $og_tags is
973 + // keyed by property name and so can hold exactly one 'og:image'
974 + // (#636); the emitter writes these straight after the primary.
975 + 'og_extra_images' => [],
941 976 'twitter_tags' => [],
942 977 'meta_tags' => [],
943 978 'platform_tags' => [],
944 979 // Per-feature flags so each emitter can honor its own toggle. The
@@ -972,8 +1007,18 @@
972 1007 // Add custom OG tags
973 1008 if (!empty($settings['custom_og_tags'])) {
974 1009 $output['og_tags'] = array_merge($output['og_tags'], $settings['custom_og_tags']);
975 1010 }
1011 +
1012 + // Alternatives to offer after the primary image. Collected from the
1013 + // resolved primary rather than re-deriving it, so the two can never
1014 + // disagree about which image is the main one.
1015 + if (!empty($settings['og_multiple_images'])) {
1016 + $output['og_extra_images'] = Social_Images::additional(
1017 + (int) $context_id,
1018 + (string) ($output['og_tags']['og:image'] ?? '')
1019 + );
1020 + }
976 1021 }
977 1022
978 1023 // Generate Twitter Card tags if enabled
979 1024 if ($twitter_enabled) {
@@ -1009,8 +1054,33 @@
1009 1054 'default_image',
1010 1055 ];
1011 1056
1012 1057 /**
1058 + * Site-wide switches with no per-context equivalent.
1059 + *
1060 + * Unlike INHERITED_SITE_KEYS above, these must inherit their site value
1061 + * even when it is FALSE. The empty()-guarded loop used for images can only
1062 + * ever propagate "on", which is right for an image URL (empty means "not
1063 + * configured") and wrong for a boolean, where false is a deliberate choice.
1064 + *
1065 + * Without this the master Open Graph / Twitter Cards switches were honoured
1066 + * on the homepage (mapped to the `site` context) and ignored on every post
1067 + * and page, which read as though the toggle had worked (#557).
1068 + *
1069 + * @since 2.2.0
1070 + * @var string[]
1071 + */
1072 + private const SITE_ONLY_KEYS = [
1073 + 'enable_open_graph',
1074 + 'enable_twitter_cards',
1075 + // Same shape as the two above and the same trap: a site-wide switch
1076 + // with no per-context equivalent. Left out, it read as on while the
1077 + // homepage rendered and as off on every post and page — which is where
1078 + // the alternatives it controls actually come from (#636).
1079 + 'og_multiple_images',
1080 + ];
1081 +
1082 + /**
1013 1083 * Get settings for a context, inheriting the site-wide default images
1014 1084 *
1015 1085 * Two corrections over the generic lookup:
1016 1086 *
@@ -1043,8 +1113,18 @@
1043 1113 return $settings;
1044 1114 }
1045 1115
1046 1116 $site_settings = parent::get_settings('site', null);
1117 +
1118 + // Site-wide switches: the site value is authoritative, false included.
1119 + // array_key_exists, not empty() — '' is how a disabled toggle is stored.
1120 + foreach (self::SITE_ONLY_KEYS as $key) {
1121 + if (array_key_exists($key, $site_settings)) {
1122 + $settings[$key] = $site_settings[$key];
1123 + }
1124 + }
1125 +
1126 + // Default images: inherit only when this context has none of its own.
1047 1127 foreach (self::INHERITED_SITE_KEYS as $key) {
1048 1128 if (empty($settings[$key]) && !empty($site_settings[$key])) {
1049 1129 $settings[$key] = $site_settings[$key];
1050 1130 }
@@ -1071,12 +1151,21 @@
1071 1151 'enable_open_graph' => true,
1072 1152 'og_site_name' => $site_name,
1073 1153 'og_description' => $site_description,
1074 1154 'og_type' => 'website',
1075 - 'og_locale' => 'en_US',
1155 + // Empty by design: og:locale is resolved from the site locale via
1156 + // get_og_locale(), which is where the thinkrank_og_locale filter (and
1157 + // therefore the WPML/Polylang/TranslatePress integration) applies. A
1158 + // hardcoded default was merged into every settings read, so the
1159 + // resolver was unreachable and every install advertised en_US.
1160 + 'og_locale' => '',
1076 1161 'default_og_image' => '',
1077 1162 'og_image_width' => 1200,
1078 1163 'og_image_height' => 630,
1164 + // Offer alternative og:image tags after the primary one (#636).
1165 + // Off by default: a page that shares with one image today must
1166 + // keep sharing with that image after an update.
1167 + 'og_multiple_images' => false,
1079 1168
1080 1169 // Twitter Cards settings
1081 1170 'enable_twitter_cards' => true,
1082 1171 'twitter_username' => '',
@@ -1116,8 +1205,15 @@
1116 1205 'fallback_to_excerpt' => true,
1117 1206 'strip_html_tags' => true,
1118 1207 'max_description_length' => 160,
1119 1208
1209 + // oEmbed card (#637). All three default off: this rewrites what
1210 + // other people's sites display, so an upgrade must not silently
1211 + // change a card an existing embed has been showing for months.
1212 + 'oembed_use_seo_title' => false,
1213 + 'oembed_use_social_image' => false,
1214 + 'oembed_remove_author' => false,
1215 +
1120 1216 // Legacy format for backward compatibility (only when needed)
1121 1217 'custom_og_tags' => [],
1122 1218 'image_optimization' => true,
1123 1219 'auto_generate' => true
@@ -1174,10 +1270,10 @@
1174 1270 ],
1175 1271 'og_locale' => [
1176 1272 'type' => 'string',
1177 1273 'title' => 'Locale',
1178 - 'description' => 'The locale for Open Graph tags',
1179 - 'default' => 'en_US'
1274 + 'description' => 'Optional override for og:locale. Leave empty to follow the site language.',
1275 + 'default' => ''
1180 1276 ],
1181 1277 'default_og_image' => [
1182 1278 'type' => 'string',
1183 1279 'title' => 'Default Open Graph Image',
@@ -1401,10 +1497,15 @@
1401 1497 'description' => '',
1402 1498 'url' => '',
1403 1499 'image' => '',
1404 1500 'twitter_title' => '', // Separate field for a Twitter-specific title
1501 + 'twitter_description' => '', // Separate field for a Twitter-specific description
1405 1502 'twitter_image' => '', // Separate field for Twitter-specific images
1406 - 'type' => 'website',
1503 + // '' rather than 'website' means "derive it from the context".
1504 + // Seeding a concrete type here made an explicit choice
1505 + // indistinguishable from the shipped default (#398).
1506 + 'type' => '',
1507 + 'twitter_card_type' => '',
1407 1508 'author' => [],
1408 1509 'published_time' => '',
1409 1510 'modified_time' => '',
1410 1511 'site_name' => $settings['og_site_name'] ?? get_bloginfo('name')
@@ -1409,8 +1510,12 @@
1409 1510 'modified_time' => '',
1410 1511 'site_name' => $settings['og_site_name'] ?? get_bloginfo('name')
1411 1512 ];
1412 1513
1514 + // Explicit type choices, resolved once for whichever context this is.
1515 + $data['type'] = $this->configured_og_type($settings);
1516 + $data['twitter_card_type'] = $this->configured_twitter_card_type($settings);
1517 +
1413 1518 if ($context_type === 'site') {
1414 1519 // Site-wide data with Social Media tab settings priority.
1415 1520 //
1416 1521 // og:title priority: an explicitly-configured OG Site Name wins;
@@ -1433,12 +1538,32 @@
1433 1538 // Use home_url('/') so og:url matches the homepage canonical
1434 1539 // (class-seo-manager.php) and the WebSite schema, which both include
1435 1540 // the trailing slash. A bare home_url() would key a different URL in
1436 1541 // social caches than the canonical.
1437 - $data['url'] = home_url('/');
1438 - $data['type'] = $settings['og_type'] ?? 'website';
1439 - $data['locale'] = $settings['og_locale'] ?? null;
1542 + //
1543 + // Except when this is not the site home. detect_current_context()
1544 + // collapses is_home() && !is_front_page() into 'homepage', so a
1545 + // static posts page — and page 2 of any blog listing — advertised
1546 + // the site home as its og:url while its own canonical said
1547 + // otherwise (#397).
1548 + $data['url'] = self::current_home_url();
1440 1549
1550 + // Leaving this null lets generate_og_tags() fall through to
1551 + // get_og_locale(), which is what every other context already does.
1552 + //
1553 + // A stored 'en_US' is deliberately treated as "not set". It was the
1554 + // hardcoded default on every install and there has never been a UI
1555 + // control for this field, so it cannot represent a deliberate choice
1556 + // — it is the old default persisted by an unrelated save of the
1557 + // Social Media tab. Honouring it would leave every already-saved
1558 + // site broken after this fix. Any other stored value is a genuine
1559 + // override and still wins; a site that really wants to force en_US
1560 + // can do so through the thinkrank_og_locale filter.
1561 + $stored_locale = trim((string) ($settings['og_locale'] ?? ''));
1562 + $data['locale'] = ('' !== $stored_locale && 'en_US' !== $stored_locale)
1563 + ? $stored_locale
1564 + : null;
1565 +
1441 1566 // Set Open Graph image with proper fallback
1442 1567 $data['image'] = $this->get_og_image_for_context($settings, null);
1443 1568
1444 1569 // Set Twitter image with proper fallback
@@ -1471,8 +1596,18 @@
1471 1596 (string) get_post_meta($post->ID, '_thinkrank_twitter_title', true),
1472 1597 $post->ID
1473 1598 );
1474 1599
1600 + // Per-post Twitter-specific description. twitter:description
1601 + // falls back to the OG/meta description when this is empty, so
1602 + // only capture it here; generate_twitter_tags() applies the
1603 + // fallback. There was no counterpart to the title lookup above,
1604 + // so the stored value never entered $data at all (#406).
1605 + $data['twitter_description'] = \ThinkRank\SEO\Pattern_Resolver::resolve_value(
1606 + (string) get_post_meta($post->ID, '_thinkrank_twitter_description', true),
1607 + $post->ID
1608 + );
1609 +
1475 1610 // Title priority: per-post OG override > effective SEO title
1476 1611 // (document <title> / metabox preview) > post title.
1477 1612 if ($og_title_override !== '') {
1478 1613 $data['title'] = $og_title_override;
@@ -1489,10 +1624,14 @@
1489 1624 $data['description'] = $fallback_description;
1490 1625 } else {
1491 1626 $data['description'] = $this->get_social_description($post);
1492 1627 }
1493 - $data['url'] = get_permalink($post);
1494 - $data['type'] = $settings['og_type'] ?? $this->determine_og_type($context_type, []);
1628 + // The canonical carries the <!--nextpage--> sub-page and the
1629 + // comment page; og:url said page 1 regardless, which is the
1630 + // same contradiction #397 fixed for the blog listing, one page
1631 + // type over (#397 review).
1632 + $data['url'] = self::with_singular_page((string) get_permalink($post));
1633 +
1495 1634 $data['published_time'] = get_the_date('c', $post);
1496 1635 $data['modified_time'] = get_the_modified_date('c', $post);
1497 1636 $data['post_id'] = $post->ID;
1498 1637
@@ -1520,8 +1659,93 @@
1520 1659 // logo/site-icon fallback in generate_og_tags() and ignored a
1521 1660 // configured default OG image.
1522 1661 $data['image'] = $this->get_og_image_for_context($settings, null);
1523 1662 $data['twitter_image'] = $this->get_twitter_image_for_context($settings, null);
1663 +
1664 + // A term archive owns SEO values of its own, and the caller has
1665 + // already resolved them into the fallbacks — the same strings
1666 + // rendered as the document <title> and the description tag. Leaving
1667 + // title and description empty here published the bare site name as
1668 + // og:title on every archive and no og:description at all, so a term
1669 + // SEO title never reached a social surface (#386).
1670 + // Archives have a URL of their own. The seed leaves it '', and the
1671 + // og:url emitter could not fall through to get_current_url() while
1672 + // the key existed, so no archive carried an og:url at all (#388).
1673 + // A search archive's URL is the search link, not the bare request
1674 + // path — get_current_url() reads $wp->request, which is empty for a
1675 + // search served from the front page, so og:url pointed at the site
1676 + // home while the page was a search result.
1677 + // The non-search archive URL is the page's own canonical, so og:url
1678 + // and <link rel="canonical"> agree on the paginated page rather than
1679 + // both claiming page 1 (#397).
1680 + // `?:` keeps the #388 guarantee that an archive always carries an
1681 + // og:url: get_non_singular_canonical_url() returns '' for a view it
1682 + // has no canonical rule for, and the request URL is still better
1683 + // than no tag at all.
1684 + $data['url'] = is_search()
1685 + ? get_search_link()
1686 + : (self::current_archive_url() ?: $this->get_current_url());
1687 +
1688 + $term = get_queried_object();
1689 + $term_id = ($term instanceof \WP_Term) ? (int) $term->term_id : 0;
1690 +
1691 + $og_title_override = '';
1692 + $og_description_override = '';
1693 +
1694 + if ($term_id > 0) {
1695 + // Terms carry the same social override keys as posts — the
1696 + // abilities API and the metabox both write them.
1697 + $og_title_override = Pattern_Resolver::resolve_term_value(
1698 + (string) get_term_meta($term_id, '_thinkrank_og_title', true),
1699 + $term_id
1700 + );
1701 + $og_description_override = Pattern_Resolver::resolve_term_value(
1702 + (string) get_term_meta($term_id, '_thinkrank_og_description', true),
1703 + $term_id
1704 + );
1705 +
1706 + // Twitter Cards fall back to og:title when this is empty, so
1707 + // only capture it; generate_twitter_tags() applies the fallback.
1708 + $data['twitter_title'] = Pattern_Resolver::resolve_term_value(
1709 + (string) get_term_meta($term_id, '_thinkrank_twitter_title', true),
1710 + $term_id
1711 + );
1712 + $data['twitter_description'] = Pattern_Resolver::resolve_term_value(
1713 + (string) get_term_meta($term_id, '_thinkrank_twitter_description', true),
1714 + $term_id
1715 + );
1716 +
1717 + $term_og_image = (string) get_term_meta($term_id, '_thinkrank_og_image', true);
1718 + if ('' !== $term_og_image) {
1719 + $data['image'] = $term_og_image;
1720 + }
1721 +
1722 + $term_twitter_image = (string) get_term_meta($term_id, '_thinkrank_twitter_image', true);
1723 + if ('' !== $term_twitter_image) {
1724 + $data['twitter_image'] = $term_twitter_image;
1725 + }
1726 + }
1727 +
1728 + // Author, date and search archives have no ThinkRank-managed title
1729 + // to inherit — Author_Archives_Manager owns the author one, and the
1730 + // rest have no template — so the caller's fallback arrives empty and
1731 + // og:title used to collapse to the bare site name. Fall through to
1732 + // what the page itself is called (#388).
1733 + if ($og_title_override !== '') {
1734 + $data['title'] = $og_title_override;
1735 + } elseif ($fallback_title !== null && $fallback_title !== '') {
1736 + $data['title'] = $fallback_title;
1737 + } else {
1738 + $data['title'] = $this->archive_fallback_title();
1739 + }
1740 +
1741 + if ($og_description_override !== '') {
1742 + $data['description'] = $og_description_override;
1743 + } elseif ($fallback_description !== null && $fallback_description !== '') {
1744 + $data['description'] = $fallback_description;
1745 + } else {
1746 + $data['description'] = $this->archive_fallback_description($term_id);
1747 + }
1524 1748 }
1525 1749
1526 1750 return $data;
1527 1751 }
@@ -1526,8 +1750,85 @@
1526 1750 return $data;
1527 1751 }
1528 1752
1529 1753 /**
1754 + * The canonical URL of the archive currently being rendered.
1755 + *
1756 + * Deliberately the same value class-seo-manager.php puts in
1757 + * <link rel="canonical">: an og:url that disagrees with the canonical is
1758 + * the bug this is fixing, so the two read from one source.
1759 + *
1760 + * @since 2.0.1
1761 + *
1762 + * @return string Archive URL, '' when there is none (search, 404).
1763 + */
1764 + private static function current_archive_url(): string {
1765 + if (!class_exists('\ThinkRank\Frontend\SEO_Manager')) {
1766 + return '';
1767 + }
1768 +
1769 + return \ThinkRank\Frontend\SEO_Manager::get_non_singular_canonical_url();
1770 + }
1771 +
1772 + /**
1773 + * A permalink with the current sub-page or comment page appended.
1774 + *
1775 + * @since 2.0.1
1776 + *
1777 + * @param string $url Permalink.
1778 + * @return string
1779 + */
1780 + private static function with_singular_page(string $url): string {
1781 + if ('' === $url || !class_exists('\ThinkRank\Frontend\SEO_Manager')) {
1782 + return $url;
1783 + }
1784 +
1785 + return \ThinkRank\Frontend\SEO_Manager::with_singular_page($url);
1786 + }
1787 +
1788 + /**
1789 + * The URL of the page the 'site' context is actually being rendered for.
1790 + *
1791 + * home_url('/') for the front page, the posts page's own permalink when the
1792 + * site uses a static front page, and the paginated variant on page 2+.
1793 + *
1794 + * @since 2.0.1
1795 + *
1796 + * @return string
1797 + */
1798 + private static function current_home_url(): string {
1799 + $url = home_url('/');
1800 +
1801 + if (function_exists('is_home') && is_home() && !is_front_page()) {
1802 + $posts_page = (int) get_option('page_for_posts');
1803 +
1804 + if ($posts_page > 0) {
1805 + $permalink = get_permalink($posts_page);
1806 +
1807 + if (is_string($permalink) && '' !== $permalink) {
1808 + $url = $permalink;
1809 + }
1810 + }
1811 + }
1812 +
1813 + if (!class_exists('\ThinkRank\Frontend\SEO_Manager')) {
1814 + return $url;
1815 + }
1816 +
1817 + // A static front page is a singular view, so its page number lives in
1818 + // `page`, not `paged` — the canonical already reads it that way, and
1819 + // og:url has to agree or the two describe different URLs.
1820 + if (function_exists('is_singular') && is_singular()) {
1821 + return \ThinkRank\Frontend\SEO_Manager::with_singular_page($url);
1822 + }
1823 +
1824 + return \ThinkRank\Frontend\SEO_Manager::with_pagination(
1825 + $url,
1826 + \ThinkRank\Frontend\SEO_Manager::current_page_number()
1827 + );
1828 + }
1829 +
1830 + /**
1530 1831 * Get Open Graph image for context with proper fallback
1531 1832 *
1532 1833 * @since 1.0.0
1533 1834 *
@@ -1541,8 +1842,12 @@
1541 1842 $image_id = get_post_thumbnail_id($post);
1542 1843 if ($image_id) {
1543 1844 $image_data = wp_get_attachment_image_src($image_id, 'large');
1544 1845 if (!empty($image_data[0])) {
1846 + // The ID is in hand here and gone once this returns a
1847 + // bare URL; say so rather than have the tag builders look
1848 + // it up again, twice, with a URL core cannot match (#847).
1849 + Attachment_Lookup::remember((string) $image_data[0], (int) $image_id);
1545 1850 return $image_data[0];
1546 1851 }
1547 1852 }
1548 1853 }
@@ -1589,8 +1894,12 @@
1589 1894 $image_id = get_post_thumbnail_id($post);
1590 1895 if ($image_id) {
1591 1896 $image_data = wp_get_attachment_image_src($image_id, 'large');
1592 1897 if (!empty($image_data[0])) {
1898 + // The ID is in hand here and gone once this returns a
1899 + // bare URL; say so rather than have the tag builders look
1900 + // it up again, twice, with a URL core cannot match (#847).
1901 + Attachment_Lookup::remember((string) $image_data[0], (int) $image_id);
1593 1902 return $image_data[0];
1594 1903 }
1595 1904 }
1596 1905 }
@@ -1621,15 +1930,33 @@
1621 1930 * @param \WP_Post $post Post object
1622 1931 * @return string Social media description
1623 1932 */
1624 1933 private function get_social_description(\WP_Post $post): string {
1625 - // Try excerpt first
1626 - $description = get_the_excerpt($post);
1934 + // A password-gated body must never become a social description. Core
1935 + // answers get_the_excerpt() with its "There is no excerpt because this
1936 + // is a protected post." placeholder rather than the body, so today the
1937 + // derive-from-content fallback below is unreachable here — but it is one
1938 + // core change away from leaking, and that placeholder sentence is not a
1939 + // description worth publishing to every crawler and unfurler either.
1940 + // An authored post_excerpt is written for public consumption, so it
1941 + // still stands (#363).
1942 + if (function_exists('post_password_required') && post_password_required($post)) {
1943 + return '' !== $post->post_excerpt ? $post->post_excerpt : get_bloginfo('description');
1944 + }
1627 1945
1628 - // If no excerpt, generate from content
1946 + // Try excerpt first. On a Bricks page core would derive that excerpt
1947 + // from the `post_content` Bricks throws away, so the visible body is
1948 + // used instead — a hand-written excerpt still wins (#651).
1949 + $superseding = Builder_Content::superseding_excerpt_source($post);
1950 + $description = '' !== $superseding
1951 + ? Pattern_Resolver::derive_excerpt($superseding, 30)
1952 + : get_the_excerpt($post);
1953 +
1954 + // If no excerpt, generate from content. Shortcodes and block delimiters
1955 + // are removed the way core's wp_trim_excerpt() does, so a shortcode-built
1956 + // page does not publish its source as og:description (#387).
1629 1957 if (empty($description)) {
1630 - $content = wp_strip_all_tags($post->post_content);
1631 - $description = wp_trim_words($content, 30, '...');
1958 + $description = Pattern_Resolver::derive_excerpt(Builder_Content::visible_content($post), 30);
1632 1959 }
1633 1960
1634 1961 // If still empty, use site description
1635 1962 if (empty($description)) {
@@ -1670,8 +1997,16 @@
1670 1997 * @param string $context Context type
1671 1998 * @return string Twitter Card type
1672 1999 */
1673 2000 private function determine_twitter_card_type(array $data, string $context): string {
2001 + // An explicitly chosen card type wins. Without this the setting was
2002 + // inert and the `app` and `player` options in the UI could never be
2003 + // emitted at all (#398).
2004 + $chosen = (string) ($data['twitter_card_type'] ?? '');
2005 + if ('' !== $chosen) {
2006 + return $chosen;
2007 + }
2008 +
1674 2009 // Use a large-image card when a Twitter image will actually be emitted.
1675 2010 // twitter:image resolves to the twitter-specific image first, then the OG
1676 2011 // image, so key the card type off the same precedence.
1677 2012 $twitter_image = !empty($data['twitter_image']) ? $data['twitter_image'] : ($data['image'] ?? '');
@@ -1678,8 +2013,105 @@
1678 2013 return !empty($twitter_image) ? 'summary_large_image' : 'summary';
1679 2014 }
1680 2015
1681 2016 /**
2017 + * What an archive calls itself, for the og:title of last resort.
2018 + *
2019 + * Deliberately not wp_get_document_title(): that re-enters the
2020 + * pre_get_document_title filter this plugin short-circuits, so it would
2021 + * recurse. get_the_archive_title() wraps its subject in a <span>, hence the
2022 + * strip.
2023 + *
2024 + * @since 2.0.1
2025 + *
2026 + * @return string Archive title, or '' when there is nothing sensible to say.
2027 + */
2028 + private function archive_fallback_title(): string {
2029 + if (is_search()) {
2030 + /* translators: %s: search query. */
2031 + return trim(sprintf(__('Search Results for "%s"', 'thinkrank'), get_search_query()));
2032 + }
2033 +
2034 + if (!function_exists('get_the_archive_title')) {
2035 + return '';
2036 + }
2037 +
2038 + return trim(wp_strip_all_tags((string) get_the_archive_title()));
2039 + }
2040 +
2041 + /**
2042 + * What an archive says about itself, for the og:description of last resort.
2043 + *
2044 + * @since 2.0.1
2045 + *
2046 + * @param int $term_id Queried term, or 0 when the archive is not a term.
2047 + * @return string Archive description, or '' when there is none.
2048 + */
2049 + private function archive_fallback_description(int $term_id): string {
2050 + if ($term_id > 0) {
2051 + $description = trim(wp_strip_all_tags((string) term_description($term_id)));
2052 +
2053 + if ('' !== $description) {
2054 + return $description;
2055 + }
2056 + }
2057 +
2058 + if (is_author()) {
2059 + $bio = trim(wp_strip_all_tags((string) get_the_author_meta('description', (int) get_query_var('author'))));
2060 +
2061 + if ('' !== $bio) {
2062 + return $bio;
2063 + }
2064 + }
2065 +
2066 + return '';
2067 + }
2068 +
2069 + /**
2070 + * The Open Graph type the user explicitly chose, or '' when they did not.
2071 + *
2072 + * `og_type` ships a default of 'website' that is merged into every settings
2073 + * read, so a stored 'website' cannot be told apart from "never touched" —
2074 + * the same trap the `og_locale` note above documents. Treating it as unset
2075 + * keeps determine_og_type() reachable, so a post is still `article`, while
2076 + * any other stored value is a genuine override and wins.
2077 + *
2078 + * @since 2.0.1
2079 + *
2080 + * @param array $settings Social meta settings.
2081 + * @return string The chosen type, or '' for "derive it".
2082 + */
2083 + private function configured_og_type(array $settings): string {
2084 + $type = trim((string) ($settings['og_type'] ?? ''));
2085 +
2086 + return ('' === $type || 'website' === $type) ? '' : $type;
2087 + }
2088 +
2089 + /**
2090 + * The Twitter card type the user explicitly chose, or '' when they did not.
2091 + *
2092 + * Same reasoning as configured_og_type(): the shipped default is
2093 + * 'summary_large_image', which is also what the automatic rule produces
2094 + * whenever an image is available, so it is treated as "not chosen" and the
2095 + * automatic rule stays in charge. `summary`, `app` and `player` are real
2096 + * choices and are honoured.
2097 + *
2098 + * @since 2.0.1
2099 + *
2100 + * @param array $settings Social meta settings.
2101 + * @return string The chosen card type, or '' for "derive it".
2102 + */
2103 + private function configured_twitter_card_type(array $settings): string {
2104 + $type = trim((string) ($settings['twitter_card_type'] ?? ''));
2105 +
2106 + if (!in_array($type, ['summary', 'app', 'player'], true)) {
2107 + return '';
2108 + }
2109 +
2110 + return $type;
2111 + }
2112 +
2113 + /**
1682 2114 * Optimize title for platform requirements
1683 2115 *
1684 2116 * @since 1.0.0
1685 2117 *
@@ -1699,16 +2131,13 @@
1699 2131 if (mb_strlen($title) <= $max_length) {
1700 2132 return $title;
1701 2133 }
1702 2134
1703 - // Truncate at word boundary
1704 - $truncated = wp_trim_words($title, 10, '');
1705 - if (mb_strlen($truncated) <= $max_length) {
1706 - return $truncated;
1707 - }
1708 -
1709 - // Hard truncate if necessary
1710 - return mb_substr($title, 0, $max_length - 3) . '...';
2135 + // Truncate at a word boundary where there is one, and hard-cut where
2136 + // there is not. This used to try wp_trim_words() first, which counts
2137 + // CHARACTERS on th/ja/zh_* — so it returned ~10 characters, passed the
2138 + // $max_length check below, and that was accepted as the title (#687).
2139 + return \ThinkRank\Core\Seo_Text::trim_to_length($title, $max_length);
1711 2140 }
1712 2141
1713 2142 /**
1714 2143 * Optimize description for platform requirements
@@ -1731,16 +2160,14 @@
1731 2160 if (mb_strlen($description) <= $max_length) {
1732 2161 return $description;
1733 2162 }
1734 2163
1735 - // Truncate at word boundary
1736 - $truncated = wp_trim_words($description, 25, '');
1737 - if (mb_strlen($truncated) <= $max_length) {
1738 - return $truncated;
1739 - }
1740 -
1741 - // Hard truncate if necessary
1742 - return mb_substr($description, 0, $max_length - 3) . '...';
2164 + // Truncate at a word boundary where there is one, and hard-cut where
2165 + // there is not. This used to try wp_trim_words() first, which counts
2166 + // words in English but CHARACTERS in th/ja/zh_* — so on those locales
2167 + // it returned ~25 characters, comfortably under $max_length, and that
2168 + // was accepted as the answer (#687).
2169 + return \ThinkRank\Core\Seo_Text::trim_to_length($description, $max_length);
1743 2170 }
1744 2171
1745 2172 /**
1746 2173 * Optimize image for platform requirements
@@ -1765,21 +2192,23 @@
1765 2192 if (empty($image_url)) {
1766 2193 return $image_data;
1767 2194 }
1768 2195
1769 - // Get image metadata
1770 - $attachment_id = attachment_url_to_postid($image_url);
2196 + // Get image metadata. The dimensions are those of the file this URL
2197 + // names — usually a generated size — not of the original upload, so
2198 + // the width and height published beside it describe the same image.
2199 + $attachment_id = Attachment_Lookup::id_from_url($image_url);
1771 2200 if ($attachment_id) {
1772 2201 $image_meta = wp_get_attachment_metadata($attachment_id);
1773 2202 $image_alt = get_post_meta($attachment_id, '_wp_attachment_image_alt', true);
1774 - $mime_type = get_post_mime_type($attachment_id);
2203 + $image_file = Attachment_Lookup::describe($attachment_id, $image_url);
1775 2204
1776 2205 if ($image_meta && isset($image_meta['width'], $image_meta['height'])) {
1777 - $width = (int) $image_meta['width'];
1778 - $height = (int) $image_meta['height'];
2206 + $width = $image_file['width'];
2207 + $height = $image_file['height'];
1779 2208
1780 2209 $image_data['alt'] = $image_alt ?: '';
1781 - $image_data['type'] = $mime_type ?: '';
2210 + $image_data['type'] = $image_file['type'];
1782 2211
1783 2212 // SVGs and other vector uploads store 0x0 metadata. Dimension
1784 2213 // checks are meaningless there and dividing by 0 is fatal.
1785 2214 if ($width > 0 && $height > 0) {
@@ -1831,8 +2260,9 @@
1831 2260 $custom_logo_id = get_theme_mod('custom_logo');
1832 2261 if ($custom_logo_id) {
1833 2262 $logo_data = wp_get_attachment_image_src($custom_logo_id, 'large');
1834 2263 if ($logo_data) {
2264 + Attachment_Lookup::remember((string) $logo_data[0], (int) $custom_logo_id);
1835 2265 return $logo_data[0];
1836 2266 }
1837 2267 }
1838 2268
@@ -1840,8 +2270,9 @@
1840 2270 $site_icon_id = get_option('site_icon');
1841 2271 if ($site_icon_id) {
1842 2272 $icon_data = wp_get_attachment_image_src($site_icon_id, 'large');
1843 2273 if ($icon_data) {
2274 + Attachment_Lookup::remember((string) $icon_data[0], (int) $site_icon_id);
1844 2275 return $icon_data[0];
1845 2276 }
1846 2277 }
1847 2278
@@ -2268,12 +2699,13 @@
2268 2699 private function make_description_catchy(string $description): string {
2269 2700 // TikTok prefers short, catchy descriptions
2270 2701 $catchy_words = ['viral', 'trending', 'must-see', 'epic', 'mind-blowing'];
2271 2702
2272 - // Limit to 100 characters for TikTok
2273 - if (strlen($description) > 100) {
2274 - $description = substr($description, 0, 97) . '...';
2275 - }
2703 + // Limit to 100 characters for TikTok. strlen()/substr() count BYTES,
2704 + // so this both fired three times too early on Thai/CJK text and cut
2705 + // mid-character, emitting a broken UTF-8 sequence rather than a short
2706 + // description (#687).
2707 + $description = \ThinkRank\Core\Seo_Text::trim_to_length($description, 100);
2276 2708
2277 2709 if (!preg_match('/\b(' . implode('|', $catchy_words) . ')\b/i', $description)) {
2278 2710 $description = '🔥 ' . $description;
2279 2711 }
@@ -2466,8 +2898,16 @@
2466 2898 private function generate_platform_meta_tags(array $settings): array {
2467 2899 $platform_tags = [];
2468 2900
2469 2901 $core = \ThinkRank\Core\Settings::instance();
2902 +
2903 + // One query for all seven instead of one query each. They are
2904 + // autoload=off like every thinkrank_* option, so WordPress cannot
2905 + // batch them out of `alloptions`, and this runs on every anonymous
2906 + // front-end request — on most sites to discover that all seven are
2907 + // empty and no tag is emitted at all (#393).
2908 + $core->prime(array_keys(self::PLATFORM_META_KEYS));
2909 +
2470 2910 // Core Settings (decrypted for sensitive keys) wins; the table value is a
2471 2911 // backward-compat fallback for installs that saved these before the UI
2472 2912 // moved to the Social Platforms tab.
2473 2913 $resolve = static function (string $key) use ($core, $settings): string {
@@ -2477,53 +2917,38 @@
2477 2917 }
2478 2918 return $value;
2479 2919 };
2480 2920
2481 - // Facebook meta tags
2482 - $facebook_app_id = $resolve('facebook_app_id');
2483 - if ('' !== $facebook_app_id) {
2484 - $platform_tags['fb:app_id'] = $facebook_app_id;
2485 - }
2921 + foreach (self::PLATFORM_META_KEYS as $key => $meta_name) {
2922 + $value = $resolve($key);
2486 2923
2487 - $facebook_admins = $resolve('facebook_admins');
2488 - if ('' !== $facebook_admins) {
2489 - $platform_tags['fb:admins'] = $facebook_admins;
2924 + if ('' !== $value) {
2925 + $platform_tags[$meta_name] = $value;
2926 + }
2490 2927 }
2491 2928
2492 - // Pinterest site verification
2493 - $pinterest = $resolve('pinterest_site_verification');
2494 - if ('' !== $pinterest) {
2495 - $platform_tags['pinterest-site-verification'] = $pinterest;
2496 - }
2497 -
2498 - // Instagram verification
2499 - $instagram = $resolve('instagram_verification');
2500 - if ('' !== $instagram) {
2501 - $platform_tags['instagram-site-verification'] = $instagram;
2502 - }
2503 -
2504 - // TikTok verification
2505 - $tiktok = $resolve('tiktok_verification');
2506 - if ('' !== $tiktok) {
2507 - $platform_tags['tiktok-site-verification'] = $tiktok;
2508 - }
2509 -
2510 - // YouTube channel verification
2511 - $youtube = $resolve('youtube_channel_id');
2512 - if ('' !== $youtube) {
2513 - $platform_tags['youtube-channel-id'] = $youtube;
2514 - }
2515 -
2516 - // WhatsApp Business verification
2517 - $whatsapp = $resolve('whatsapp_business_id');
2518 - if ('' !== $whatsapp) {
2519 - $platform_tags['whatsapp-business-id'] = $whatsapp;
2520 - }
2521 -
2522 2929 return $platform_tags;
2523 2930 }
2524 2931
2525 2932 /**
2933 + * Platform verification settings, mapped to the meta name each is emitted
2934 + * under. One list so the batch primed in generate_platform_meta_tags() and
2935 + * the keys it then reads cannot drift apart.
2936 + *
2937 + * @since 2.1.0
2938 + * @var array<string,string>
2939 + */
2940 + private const PLATFORM_META_KEYS = [
2941 + 'facebook_app_id' => 'fb:app_id',
2942 + 'facebook_admins' => 'fb:admins',
2943 + 'pinterest_site_verification' => 'pinterest-site-verification',
2944 + 'instagram_verification' => 'instagram-site-verification',
2945 + 'tiktok_verification' => 'tiktok-site-verification',
2946 + 'youtube_channel_id' => 'youtube-channel-id',
2947 + 'whatsapp_business_id' => 'whatsapp-business-id',
2948 + ];
2949 +
2950 + /**
2526 2951 * Convert OG, Twitter, and Platform tags to HTML meta tags
2527 2952 *
2528 2953 * @since 1.0.0
2529 2954 *
@@ -2604,13 +3029,14 @@
2604 3029 return $validation;
2605 3030 }
2606 3031
2607 3032 // Get image metadata if it's a local attachment
2608 - $attachment_id = attachment_url_to_postid($image_url);
3033 + $attachment_id = Attachment_Lookup::id_from_url($image_url);
2609 3034 if ($attachment_id) {
2610 3035 $image_meta = wp_get_attachment_metadata($attachment_id);
2611 - $meta_width = isset($image_meta['width']) ? (int) $image_meta['width'] : 0;
2612 - $meta_height = isset($image_meta['height']) ? (int) $image_meta['height'] : 0;
3036 + $image_file = Attachment_Lookup::describe($attachment_id, $image_url);
3037 + $meta_width = $image_file['width'];
3038 + $meta_height = $image_file['height'];
2613 3039
2614 3040 // SVGs and other vector uploads store 0x0 metadata — skip the
2615 3041 // dimension/ratio checks instead of dividing by 0.
2616 3042 if ($image_meta && $meta_width > 0 && $meta_height > 0) {