*/ namespace RankMath\Abilities\Content_Analysis; use WP_Post; use RankMath\Helper; use RankMath\Helpers\Str; use RankMath\Helpers\Url; use RankMath\Traits\Hooker; defined( 'ABSPATH' ) || exit; /** * Builds the raw content payload an AI agent needs to evaluate the on-page SEO tests itself. * * This class does NOT score or judge anything — the actual test logic (Analyzer/Paper/Researcher) * only exists client-side in JS and has no PHP port. Instead, it assembles the same facts the JS * engine reads off the `Paper` object, so the calling agent can run the per-test evaluation. */ class Content_Analysis_Data { use Hooker; /** * Canonical on-page test IDs for a post, mirroring Post_Screen::get_analysis(). * * @var array */ const DEFAULT_TESTS = [ 'contentHasTOC' => true, 'contentHasShortParagraphs' => true, 'contentHasAssets' => true, 'keywordInTitle' => true, 'keywordInMetaDescription' => true, 'keywordInPermalink' => true, 'keywordIn10Percent' => true, 'keywordInContent' => true, 'keywordInSubheadings' => true, 'keywordInImageAlt' => true, 'keywordDensity' => true, 'keywordNotUsed' => true, 'lengthContent' => true, 'lengthPermalink' => true, 'linksHasInternal' => true, 'linksHasExternals' => true, 'linksNotAllExternals' => true, 'titleStartWithKeyword' => true, 'titleSentiment' => true, 'titleHasPowerWords' => true, 'titleHasNumber' => true, 'hasContentAI' => true, ]; /** * Build the content analysis payload for a post. * * @param WP_Post $post Post to analyze. * @param string $keyword Optional focus keyword override. * @return array */ public function get( WP_Post $post, string $keyword = '' ): array { $post_id = $post->ID; $body = $this->get_plain_text( $post->post_content ); $first_tenth = (int) ceil( mb_strlen( $body ) * 0.1 ); $title = Helper::get_post_meta( 'title', $post_id ); $description = Helper::get_post_meta( 'description', $post_id ); return [ 'tests_to_run' => array_keys( $this->get_tests( $post->post_type ) ), 'content' => [ 'title' => ! empty( $title ) ? $title : get_the_title( $post_id ), 'description' => ! empty( $description ) ? $description : '', 'permalink' => str_replace( home_url(), '', (string) get_permalink( $post_id ) ), 'focus_keyword' => '' !== $keyword ? $keyword : $this->get_primary_keyword( $post_id ), 'body' => $body, 'word_count' => str_word_count( $body ), 'excerpt_10pct' => Str::substr( $body, 0, $first_tenth ), 'headings' => $this->get_headings( $post->post_content ), 'images' => $this->get_images( $post->post_content ), 'links' => $this->get_links( $post->post_content ), ], ]; } /** * Get the on-page test IDs registered for a post type. * * @param string $post_type Post type slug. * @return array */ private function get_tests( string $post_type ): array { return $this->do_filter( 'researches/tests', self::DEFAULT_TESTS, $post_type ); } /** * Strip a post's content down to plain text. * * @param string $content Raw post content (may contain blocks/shortcodes/HTML). * @return string */ private function get_plain_text( string $content ): string { $content = strip_shortcodes( $content ); $content = wp_strip_all_tags( $content ); return trim( preg_replace( '/\s+/', ' ', $content ) ); } /** * Extract heading text grouped by level (H1-H6). * * @param string $content Raw post content. * @return array */ private function get_headings( string $content ): array { $headings = []; if ( ! preg_match_all( '/]*>(.*?)<\/h\1>/is', $content, $matches, PREG_SET_ORDER ) ) { return $headings; } foreach ( $matches as $match ) { $headings[] = [ 'level' => 'h' . $match[1], 'text' => trim( wp_strip_all_tags( $match[2] ) ), ]; } return $headings; } /** * Extract image alt text from post content. * * @param string $content Raw post content. * @return array */ private function get_images( string $content ): array { $images = []; if ( ! preg_match_all( '/]+>/i', $content, $matches ) ) { return $images; } foreach ( $matches[0] as $tag ) { $alt = preg_match( '/alt=["\']([^"\']*)["\']/i', $tag, $alt_match ) ? $alt_match[1] : ''; $images[] = [ 'alt' => $alt ]; } return $images; } /** * Extract links from post content, classified as internal or external. * * @param string $content Raw post content. * @return array */ private function get_links( string $content ): array { $links = []; if ( ! preg_match_all( '/]*href=["\']([^"\']+)["\'][^>]*>/i', $content, $matches ) ) { return $links; } foreach ( $matches[1] as $href ) { if ( Str::starts_with( '#', $href ) ) { continue; } $links[] = [ 'url' => $href, 'external' => Url::is_external( $href ), ]; } return $links; } /** * Get the primary focus keyword for the post. * * @param int $post_id Post ID. * @return string */ private function get_primary_keyword( int $post_id ): string { $keywords = get_post_meta( $post_id, 'rank_math_focus_keyword', true ); if ( empty( $keywords ) ) { return ''; } $parts = explode( ',', $keywords ); return trim( $parts[0] ); } }