Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-10-27 18:36
📄 parser.php <?php /** * Parser class. * * Parses HTML content into a DOM for SEO analysis. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use DOMDocument; use SureRank\Inc\Traits\Get_Instance; use WP_Error; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } /* * Class Parser * * Parses HTML content into a DOMDocument, optimized for webpage SEO analysis. / class Parser { use Get_Instance; /* * Parse HTML content. * * @param string $html The HTML content to parse. * @return DOMDocument\|WP_Error Parsed DOM or error on critical failure. / public function parse( string $html ) { libxml_use_internal_errors( true ); $dom = new DOMDocument(); if ( ! mb_check_encoding( $html, 'UTF-8' ) ) { $html = mb_convert_encoding( $html, 'UTF-8', 'auto' ); } if ( ! $html ) { return new WP_Error( 'parse_failed', __( 'Failed to parse HTML.', 'surerank' ) ); } $html = $this->pre_process_html( $html ); if ( ! $html ) { return new WP_Error( 'parse_failed', __( 'Failed to pre-process HTML.', 'surerank' ) ); } $html = $this->pre_process_html( $html ); $success = $dom->loadHTML( '<?xml encoding="UTF-8">' . $html, LIBXML_HTML_NOIMPLIED \| LIBXML_HTML_NODEFDTD \| LIBXML_NOBLANKS \| LIBXML_NONET ); libxml_clear_errors(); if ( ! $success \|\| empty( $dom->childNodes ) ) { return new WP_Error( 'parse_failed', __( 'Failed to parse HTML.', 'surerank' ) ); } return $dom; } /* * Pre-process HTML to replace & with & and add doctype. * * @param string $html The raw HTML content. * @return string Pre-processed HTML. / private function pre_process_html( $html ) { if ( ! $html ) { return ''; } $html = preg_replace( '/&(?![A-Za-z0-9#]{1,7};)/', '&', (string) $html ); if ( ! preg_match( '/<!DOCTYPE html>/i', (string) $html ) ) { $html = '<!DOCTYPE html><html><body>' . $html . '</body></html>'; } // Remove handlers and attributes that can cause issues for examples: onerror, onclick, etc. return (string) preg_replace( '/\s+on[a-z]+="[^"]"/i', '', (string) $html ); } }	2.11 KB	2025-10-27 18:36
📄 post-analyzer.php <?php /** * Post Analyzer class. * * Performs SEO checks for WordPress posts like page, post, cpts with consistent output for UI. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use DOMElement; use DOMNodeList; use DOMXPath; use SureRank\Inc\API\Admin; use SureRank\Inc\API\Post; use SureRank\Inc\Frontend\Image_Seo; use SureRank\Inc\Functions\Get; use SureRank\Inc\Functions\Helper; use SureRank\Inc\Functions\Settings; use SureRank\Inc\Functions\Update; use SureRank\Inc\Traits\Get_Instance; use SureRank\Inc\Traits\Logger; use WP_Post; /* * Post Analyzer / class PostAnalyzer { use Get_Instance; use Logger; /* * XPath instance. * * @var DOMXPath\|null / private $xpath; /* * Page title. * * @var string\|null / private $page_title; /* * Page description. * * @var string\|null / private $page_description = ''; /* * Canonical URL. * * @var string\|null / private $canonical_url = ''; /* * Post ID. * * @var int\|null / private $post_id; /* * Post permalink. * * @var string / private $post_permalink = ''; /* * Post content. * * @var string / private $post_content = ''; /* * Constructor. / private function __construct() { if ( ! Settings::get( 'enable_page_level_seo' ) ) { return; } add_action( 'wp_after_insert_post', [ $this, 'save_post' ], 10, 2 ); add_filter( 'surerank_run_post_seo_checks', [ $this, 'run_checks' ], 10, 2 ); } /* * Handle post save to run SEO checks. * * @param int $post_id Post ID. * @param WP_Post $post Post object. * @return void / public function save_post( $post_id, $post ) { if ( wp_is_post_autosave( $post_id ) \|\| wp_is_post_revision( $post_id ) ) { return; } $post_type = get_post_type( $post_id ); if ( ! $post_type ) { return; } $post_type_object = get_post_type_object( $post_type ); if ( ! $post_type_object \|\| ! $post_type_object->public \|\| in_array( $post_type, apply_filters( 'surerank_excluded_post_types_from_seo_checks', [] ), true ) ) { return; } $response = $this->run_checks( $post_id, $post ); if ( isset( $response['status'] ) && 'error' === $response['status'] ) { self::log( $response['message'] ); } } /* * Run SEO checks for the post. * * @param int $post_id Post ID. * @param WP_Post $post Post object. * @return array<string, mixed> / public function run_checks( $post_id, $post ) { $this->post_id = $post_id; if ( ! $this->post_id \|\| ! $post instanceof WP_Post ) { return [ 'status' => 'error', ]; } $meta_data = Post::get_post_data_by_id( $post_id, $post->post_type, false ); $variables = Admin::get_instance()->get_variables( $post_id, null ); $meta_data = Utils::get_meta_data( $meta_data ); foreach ( $meta_data as $key => $value ) { $meta_data[ $key ] = Helper::replacement( $key, $value, $variables ); } $this->page_title = $meta_data['page_title'] ?? ''; $this->page_description = $meta_data['page_description'] ?? ''; $this->canonical_url = $meta_data['canonical_url'] ?? ''; $this->post_permalink = $this->get_original_permalink( $post_id, $post ); $this->post_content = $post->post_content; /* * Parse blocks and render them to get the rendered content. * Commented out because it's not needed for the analyzer. * * Kept here for reference if needed in the future. * * $blocks = parse_blocks( $post_content ); * foreach ( $blocks as $block ) { * $rendered_content .= render_block( $block ); * } / $this->xpath = Utils::get_rendered_xpath( $this->post_content ); $result = $this->analyze( $meta_data ); if ( $this->update_broken_links_status( $result ) && is_array( $result ) ) { $result['broken_links'] = $this->update_broken_links_status( $result ); } $success = Update::post_seo_checks( $post_id, $result ); if ( ! $success ) { return [ 'status' => 'error', 'message' => __( 'Failed to update SEO checks', 'surerank' ), ]; } return $result; } /* * Analyze the post. * * @param array<string, mixed> $meta_data Meta data. * @return array<string, mixed> / private function analyze( array $meta_data ) { // Get focus keyword for keyword checks. $focus_keyword = $meta_data['focus_keyword'] ?? ''; return [ 'h2_subheadings' => $this->check_subheadings(), 'image_alt_text' => $this->check_image_alt_text(), 'media_present' => $this->check_media_present(), 'links_present' => $this->check_links_present(), 'url_length' => Utils::check_url_length( $this->post_permalink ), 'search_engine_title' => Utils::analyze_title( $this->page_title ), 'search_engine_description' => Utils::analyze_description( $this->page_description ), 'canonical_url' => $this->canonical_url(), 'all_links' => $this->get_all_links(), 'open_graph_tags' => Utils::open_graph_tags(), // Keyword checks. 'keyword_in_title' => Utils::analyze_keyword_in_title( $this->page_title, $focus_keyword ), 'keyword_in_description' => Utils::analyze_keyword_in_description( $this->page_description, $focus_keyword ), 'keyword_in_url' => Utils::analyze_keyword_in_url( $this->post_permalink, $focus_keyword ), 'keyword_in_content' => Utils::analyze_keyword_in_content( $this->post_content, $focus_keyword ), ]; } /* * Check for H2 subheadings. * * @return array<string, mixed> / private function check_subheadings() { $headings = [ 'h2', 'h3', 'h4', 'h5', 'h6' ]; $count = 0; foreach ( $headings as $tag ) { $elements = $this->xpath ? $this->xpath->query( "//{$tag}" ) : null; $count += $elements instanceof DOMNodeList ? $elements->length : 0; } if ( $count === 0 ) { return [ 'status' => 'warning', 'message' => __( 'The page does not contain any subheadings.', 'surerank' ), ]; } return [ 'status' => 'success', 'message' => __( 'Page contains at least one subheading.', 'surerank' ), ]; } /* * Check for image alt text. * * @return array<string, mixed> / private function check_image_alt_text(): array { $images = $this->get_images(); if ( ! $images instanceof DOMNodeList \|\| $images->length === 0 ) { return []; } $analysis = $this->analyze_images( $images ); return $this->build_image_alt_response( $analysis ); } /* * Get all images from the content. * * @return \DOMNodeList<\DOMNode>\|null List of image elements. / private function get_images(): ?\DOMNodeList { $result = $this->xpath ? $this->xpath->query( '//img' ) : null; return $result === false ? null : $result; } /* * Analyze images for alt text attributes. * * @param \DOMNodeList<\DOMNode> $images List of image elements. * @return array{total: int, missing_alt: int, missing_alt_images: array<string>} Analysis results. / private function analyze_images( $images ): array { $analysis = [ 'total' => $images->length, 'missing_alt' => 0, 'missing_alt_images' => [], ]; foreach ( $images as $img ) { if ( $this->is_missing_alt_text( $img ) ) { $analysis['missing_alt']++; $src = $this->get_image_src( $img ); if ( $src ) { $analysis['missing_alt_images'][] = $src; } } } return $analysis; } /* * Check if an image element is missing alt text. * * @param \DOMNode $img Image element. * @return bool True if missing alt text. / private function is_missing_alt_text( \DOMNode $img ): bool { if ( ! $img instanceof \DOMElement ) { return false; } return ! $img->hasAttribute( 'alt' ) \|\| empty( trim( $img->getAttribute( 'alt' ) ) ); } /* * Get the src attribute from an image element. * * @param \DOMNode $img Image element. * @return string Image source URL or empty string. / private function get_image_src( \DOMNode $img ): string { if ( ! $img instanceof \DOMElement ) { return ''; } return $img->hasAttribute( 'src' ) ? $img->getAttribute( 'src' ) : ''; } /* * Build the response array for image alt text analysis. * * @param array{total: int, missing_alt: int, missing_alt_images: array<string>} $analysis Analysis results. * @return array<string, mixed> Response array. / private function build_image_alt_response( array $analysis ): array { $exists = $analysis['total'] > 0; $is_optimized = $exists && $analysis['missing_alt'] === 0; $status = $this->get_alt_text_status( $exists, $is_optimized ); $message = $this->get_alt_text_message( $exists, $is_optimized ); return [ 'status' => $status, 'description' => $this->build_image_description( $exists, $analysis['total'], $analysis['missing_alt'], $analysis['missing_alt_images'] ), 'message' => $message, 'show_images' => $exists && $analysis['missing_alt'] > 0, ]; } /* * Get the status for alt text analysis. * * @param bool $exists Whether images exist. * @param bool $is_optimized Whether all images have alt text. * @return string Status string. / private function get_alt_text_status( bool $exists, bool $is_optimized ): string { if ( ! $exists ) { return 'warning'; } if ( Image_Seo::get_instance()->status() ) { return 'suggestion'; } return $is_optimized ? 'success' : 'warning'; } /* * Get the message for alt text analysis. * * @param bool $exists Whether images exist. * @param bool $is_optimized Whether all images have alt text. * @return string Message string. / private function get_alt_text_message( bool $exists, bool $is_optimized ): string { if ( $exists && $is_optimized ) { return __( 'All images on this page have alt text attributes.', 'surerank' ); } $base_message = __( 'One or more images are missing alt text attributes.', 'surerank' ); if ( Image_Seo::get_instance()->status() ) { return $base_message . ' ' . __( 'But don\'t worry, we will add them automatically for you.', 'surerank' ); } return $base_message . ' ' . __( 'You can add them manually or turn on auto-set image title and alt in the settings.', 'surerank' ); } /* * Build image description. * * @param bool $exists Whether images exist. * @param int $total Total number of images. * @param int $missing_alt Number of images missing alt text. * @param array<string> $missing_alt_images Images missing alt text. * @return array<int, array<string, array<int, string>>\|string> / private function build_image_description( bool $exists, int $total, int $missing_alt, array $missing_alt_images ): array { if ( ! $exists ) { return $this->get_no_images_description(); } if ( $missing_alt === 0 ) { return $this->get_optimized_images_description(); } return $this->get_missing_alt_description( $missing_alt_images ); } /* * Get description for pages with no images. * * @return array<int, string> Description array. / private function get_no_images_description(): array { return [ __( 'The page does not contain any images.', 'surerank' ), __( 'Add images to improve the post/page\'s visual appeal and SEO.', 'surerank' ), ]; } /* * Get description for pages with optimized images. * * @return array<int, string> Description array. / private function get_optimized_images_description(): array { return [ __( 'Images on the post/page have alt text attributes', 'surerank' ), ]; } /* * Get description for pages with missing alt text. * * @param array<string> $missing_alt_images Images missing alt text. * @return array<int, array<string, array<int, string>>> Description array. / private function get_missing_alt_description( array $missing_alt_images ): array { if ( empty( $missing_alt_images ) ) { return []; } $list = []; foreach ( array_unique( $missing_alt_images ) as $image ) { $list[] = esc_html( $image ); } return [ [ 'list' => $list ], ]; } /* * Check for media present. * * @return array<string, mixed> / private function check_media_present() { $images = $this->xpath ? $this->xpath->query( '//img' ) : new DOMNodeList(); $videos = $this->xpath ? $this->xpath->query( '//video' ) : new DOMNodeList(); $featured_image = get_post_thumbnail_id( $this->post_id ); $image_length = $images->length ?? 0; $video_length = $videos->length ?? 0; $exists = $image_length > 0 \|\| $video_length > 0 \|\| $featured_image; $message = $exists ? __( 'This page includes images or videos to enhance content.', 'surerank' ) : __( 'No images or videos found on this page.', 'surerank' ); return [ 'status' => $exists ? 'success' : 'warning', 'message' => $message, ]; } /* * Check for links present. * * @return array<string, mixed> / private function check_links_present() { $links = $this->xpath ? $this->xpath->query( '//a[@href]' ) : new DOMNodeList(); if ( ! $links \|\| $links->length === 0 ) { return [ 'status' => 'warning', 'message' => __( 'No links found on the page.', 'surerank' ), ]; } return [ 'status' => 'success', 'message' => __( 'Links are present on the page.', 'surerank' ), ]; } /* * Get canonical URL. * * @return array<string, mixed> / private function canonical_url() { if ( $this->canonical_url === null ) { return [ 'status' => 'error', 'message' => __( 'No canonical URL provided.', 'surerank' ), ]; } $permalink = get_permalink( (int) $this->post_id ); if ( ! $permalink ) { return [ 'status' => 'error', 'message' => __( 'No permalink provided.', 'surerank' ), ]; } return Utils::analyze_canonical_url( $this->canonical_url, $permalink ); } /* * Update broken links status. * * @param array<string, mixed> $result Result. * @return array<string, mixed>\|false / private function update_broken_links_status( $result ) { $links = $this->xpath ? $this->xpath->query( '//a[@href]' ) : new DOMNodeList(); $empty_message = [ 'status' => 'success', 'message' => __( 'No broken links found on the page.', 'surerank' ), ]; if ( ! $links \|\| $links->length === 0 ) { return $empty_message; } $urls = []; foreach ( $links as $link ) { if ( $link instanceof DOMElement ) { if ( ! in_array( $link->getAttribute( 'href' ), $urls ) ) { $urls[] = $link->getAttribute( 'href' ); } } } $broken_links = Get::post_meta( (int) $this->post_id, SURERANK_SEO_CHECKS, true ); $broken_links = $broken_links['broken_links'] ?? []; $existing_broken_links = Utils::existing_broken_links( $broken_links, $urls ); if ( empty( $existing_broken_links ) ) { return $empty_message; } return false; } /* * Get all links from the rendered post content. * * @return array<string> / private function get_all_links() { if ( ! $this->xpath ) { return []; } $links = []; $anchor_nodes = $this->xpath->query( '//a[@href]' ); if ( ! $anchor_nodes instanceof DOMNodeList ) { return []; } foreach ( $anchor_nodes as $anchor ) { if ( $anchor instanceof DOMElement ) { $href = trim( $anchor->getAttribute( 'href' ) ); // Skip empty hrefs and duplicates. if ( $href === '' \|\| in_array( $href, $links, true ) ) { continue; } // Use the shared helper to decide if this URL should be skipped. if ( ! self::should_skip_url( $href ) ) { $links[] = $href; } } } return $links; } /* * Determine whether a URL should be skipped. We use an inclusive check: * - Allow absolute http/https URLs * - Allow relative URLs (no scheme) * - Skip everything else (mailto:, tel:, sms:, geo:, javascript:, data:, etc.) * * @param string $href URL or href attribute value. * @return bool True if the URL should be skipped. / public static function should_skip_url( string $href ): bool { $href = trim( $href ); if ( $href === '' ) { return true; } // Skip anchors like #section. if ( strpos( $href, '#' ) === 0 ) { return true; } // If the URL contains a scheme, parse it and allow only http/https. // Examples: mailto:, tel:, sms:, geo:, javascript:, data: will be skipped. $parts = wp_parse_url( $href ); $scheme = null; if ( is_array( $parts ) && ! empty( $parts['scheme'] ) ) { $scheme = strtolower( $parts['scheme'] ); // Allow only http and https schemes. return ! in_array( $scheme, [ 'http', 'https' ], true ); } // If parse_url returned null/false, check if it contains a colon early on // (which would indicate a scheme we can't parse). Otherwise treat as relative (allow). return strpos( $href, ':' ) !== false; } /* * Get the original permalink for a post, even if it's set as homepage. * * @param int $post_id Post ID. * @param WP_Post $post Post object. * @return string Original permalink or empty string. / private function get_original_permalink( $post_id, $post ) { $homepage_id = (int) get_option( 'page_on_front' ); if ( $homepage_id === $post_id ) { return $this->generate_original_page_url( $post ); } $permalink = get_permalink( $post_id ); return $permalink !== false ? $permalink : ''; } /* * Generate original page URL for a post that's set as homepage. * * @param WP_Post $post Post object. * @return string Original page URL. */ private function generate_original_page_url( $post ) { if ( empty( $post->post_name ) ) { return ''; } return trailingslashit( home_url() ) . $post->post_name . '/'; } }	17.32 KB	2025-10-27 18:36
📄 scraper.php <?php /** * Scraper class. * * Handles HTTP requests for SEO analysis. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use SureRank\Inc\Functions\Requests; use SureRank\Inc\Traits\Get_Instance; use WP_Error; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } /* * Class Scraper * * Fetches HTML content from URLs. / class Scraper { use Get_Instance; /* * Last HTTP response. * * @var array<string,mixed>\|WP_Error\|null / private $last_response = null; /* * Last response body. * * @var string\|WP_Error\|null / private $last_body = null; /* * Last response code. * * @var int\|null / private $response_code = null; /* * Fetch HTML content from a URL. * * @param string $url The URL to scrape. * @return string\|WP_Error HTML content or error on failure. / public function fetch( string $url ) { $this->last_response = $this->call_request( $url ); if ( is_wp_error( $this->last_response ) ) { return $this->last_response; } $this->last_body = wp_remote_retrieve_body( $this->last_response ); if ( empty( $this->last_body ) ) { $this->last_body = new WP_Error( 'empty_response', __( 'Empty response from URL.', 'surerank' ) ); } return $this->last_body; } /* * Get a specific header from the last HTTP response. * * @param string $header The header name. * @return string\|WP_Error Header value or WP_Error if unavailable. / public function get_header( string $header ) { if ( ! $this->last_response \|\| is_wp_error( $this->last_response ) ) { return new WP_Error( 'no_response', __( 'No response available to retrieve header.', 'surerank' ) ); } $value = wp_remote_retrieve_header( $this->last_response, $header ); return is_string( $value ) ? $value : ''; } /* * Get the body from the last HTTP response. * * @return string\|WP_Error Response body or WP_Error if unavailable. / public function get_body() { if ( ! $this->last_body ) { return new WP_Error( 'no_body', __( 'No response body available.', 'surerank' ) ); } return $this->last_body; } /* * Make HTTP request to URL. * * @param string $url The URL to request. * @return array<string,mixed>\|WP_Error HTTP response or WP_Error on failure. / public function call_request( string $url ) { return Requests::get( $url, apply_filters( 'surerank_scraper_headers', [] ) ); } /* * Fetch HTTP status code from a URL. * * @param string $url The URL to check status for. * @return int\|WP_Error Status code or WP_Error on failure. */ public function fetch_status( string $url ) { $this->last_response = $this->call_request( $url ); if ( is_wp_error( $this->last_response ) ) { return new WP_Error( 'no_response', __( 'No response available to retrieve status.', 'surerank' ) ); } $this->response_code = (int) wp_remote_retrieve_response_code( $this->last_response ); return $this->response_code; } }	2.95 KB	2025-10-27 18:36
📄 seo-analyzer.php <?php /** * SEO Analyzer class. * * Performs SEO checks on HTML content with consistent output for UI. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use DOMAttr; use DOMDocument; use DOMElement; use DOMNodeList; use DOMXPath; use SureRank\Inc\API\Analyzer; use SureRank\Inc\Functions\Get; use WP_Error; /* * Class SeoAnalyzer * * Analyzes HTML content for SEO metrics with standardized output. / class SeoAnalyzer { /* * Instance object. * * @var self\|null / private static $instance = null; /* * DOMDocument instance containing parsed HTML. * * @var DOMDocument\|null / private $dom = null; /* * Array of error messages encountered during analysis. * * @var array<string> / private $errors = []; /* * Base URL being analyzed. * * @var string / private $base_url = ''; /* * Scraper instance for fetching content. * * @var Scraper / private $scraper; /* * Parser instance for parsing HTML. * * @var Parser / private $parser; /* * Cached HTML content. * * @var string\|WP_Error / private $html_content = ''; /* * Constructor. * * @param string $url The URL to analyze. * @return void / public function __construct( string $url ) { $this->scraper = Scraper::get_instance(); $this->parser = Parser::get_instance(); $this->initialize( $url ); } /* * Initiator. * * @since 1.0.0 * @param string $url The URL to analyze. * @return self initialized object of class. / public static function get_instance( $url ) { if ( null === self::$instance ) { self::$instance = new self( $url ); } return self::$instance; } /* * Get XPath instance for DOMDocument. * * @return DOMXPath\|array<string, mixed> / public function get_xpath() { if ( $this->dom === null ) { return [ 'exists' => true, 'status' => 'error', 'details' => $this->errors, 'message' => __( 'Failed to load DOM for analysis.', 'surerank' ), ]; } return new DOMXPath( $this->dom ); } /* * Analyze page title. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_title( DOMXPath $xpath ) { $helptext = [ __( "Your homepage title is one of the most important signals you can give to search engines — and to people. It’s the main clickable headline that appears in search results. Think of it like your site/'s headline on Google.", 'surerank' ), __( 'This is often the first thing someone sees before they visit your site. A well-crafted title tells them what your site is about and encourages them to click. It also helps search engines understand what your homepage represents.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'Your SEO title is a key part of how search engines decide what your homepage is about. It also sets expectations for visitors. If your title is missing or unclear, it can reduce your visibility or cause users to scroll past your site.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can include:', 'surerank' ) ), __( 'Mention your site or brand name and a clear description of what it offers. You don’t need to be fancy — just accurate and helpful.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Example:', 'surerank' ) ), __( '“Bright Bakes – Easy Baking Recipes for Everyone”', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Where to add this:', 'surerank' ) ), sprintf( / translators: %s is the URL of the surerank settings page / __( "If your homepage is a static page, this <a href='%s' target='_blank'>link</a> will navigate you to the relevant page.", 'surerank' ), $this->get_homepage_settings_url() ), sprintf( / translators: %s is the URL of the surerank settings page / __( "If your homepage shows your latest posts, you can add the title directly by editing from the <a href='%s' target='_blank'>Home Page Settings</a>.", 'surerank' ), $this->get_homepage_settings_url() ), ]; $titles = $xpath->query( '//title' ); if ( ! $titles instanceof DOMNodeList ) { return $this->build_error_response( __( 'Search engine title is missing on the homepage.', 'surerank' ), $helptext, __( 'Search engine title is missing on the homepage.', 'surerank' ), 'error' ); } $exists = $titles->length > 0; $content = ''; $length = 0; if ( $exists ) { $title_node = $titles->item( 0 ); if ( $title_node instanceof DOMElement ) { $content = trim( $title_node->textContent ); $length = mb_strlen( $content ); } } if ( ! $exists ) { $status = 'error'; } elseif ( $length > Get::TITLE_LENGTH ) { $status = 'warning'; } else { $status = 'success'; } return [ 'exists' => $exists, 'status' => $status, 'description' => $helptext, 'message' => $this->get_title_message( $exists, $length, $status ), ]; } /* * Analyze meta description. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_meta_description( DOMXPath $xpath ) { $description = [ __( 'Your homepage description is like a one-sentence pitch that appears below your homepage title in search results. It’s a quick summary that helps people decide whether to visit your site.', 'surerank' ), __( 'It’s like a one-sentence pitch — short, clear, and focused on what your site offers. This is your chance to make a strong first impression.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'A good description tells Google and your potential visitors what your homepage is about. It can directly influence how many people click through to your site. When written well, it improves visibility and makes your search result more appealing.', 'surerank' ), sprintf( '<b> %s </b>', __( 'To keep things clear and visible, try to keep your homepage description between 150 to 160 characters. That’s usually enough to say something meaningful, without getting cut off in search results.</b>', 'surerank' ) ), sprintf( '<h6> %s </h6>', __( 'What to write:', 'surerank' ) ), __( 'Think about how you’d describe your site to someone who’s never seen it before. What is it about? Who is it for? What can they expect when they visit?', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Example:', 'surerank' ) ), __( '“Discover simple, healthy meals that you can cook at home — even if you’re just getting started.”', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Where to add this:', 'surerank' ) ), sprintf( / translators: %s is the URL of the surerank settings page / __( "If your homepage is a static page, this <a href='%s' target='_blank'>link</a> will navigate you to the relevant page.", 'surerank' ), $this->get_homepage_settings_url() ), sprintf( / translators: %s is the URL of the surerank settings page / __( "If your homepage shows your latest posts, you can add the title directly by editing from the <a href='%s' target='_blank'>Home Page Settings</a>.", 'surerank' ), $this->get_homepage_settings_url() ), ]; $meta_desc = $xpath->query( '//meta[@name="description"]/@content' ); if ( ! $meta_desc instanceof DOMNodeList ) { return $this->build_error_response( __( 'Search engine description is missing on the homepage.', 'surerank' ), $description, __( 'Search engine description is missing on the homepage.', 'surerank' ), 'warning' ); } $exists = $meta_desc->length > 0; $content = ''; $length = 0; if ( $exists ) { $meta_node = $meta_desc->item( 0 ); if ( $meta_node instanceof DOMAttr ) { $content = trim( $meta_node->value ); $length = mb_strlen( $content ); } } if ( ! $exists ) { $status = 'warning'; } elseif ( $length > Get::DESCRIPTION_LENGTH ) { $status = 'warning'; } else { $status = 'success'; } return [ 'exists' => $exists, 'status' => $status, 'description' => $description, 'message' => $this->get_meta_description_message( $exists, $length, $status ), ]; } /* * Analyze headings (H1). * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_heading_h1( DOMXPath $xpath ) { $h1_analysis = $this->analyze_h1( $xpath ); $exists = $h1_analysis['exists']; $status = 'success'; $title = __( 'Homepage contains one H1 heading', 'surerank' ); $descriptions = [ __( 'The H1 heading is usually the main title that appears visually on your homepage. It tells both visitors and search engines what the page is all about.', 'surerank' ), __( 'Think of it like the front cover of a book. It should quickly explain what someone has landed on, and help guide their next step.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'Search engines look at the H1 to understand the main topic of a page. Visitors use it to quickly decide whether they’re in the right place. If it’s missing or unclear, your site may feel incomplete or hard to understand.', 'surerank' ), __( 'Every page should have just one H1 — especially the homepage. Using multiple H1s can confuse search engines and reduce the clarity of your site’s structure.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What makes a good H1:', 'surerank' ) ), __( 'It should be clear, specific, and match what your site is about. Avoid vague or generic text. A short sentence or phrase that describes what you do works best.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Example:', 'surerank' ) ), __( '“Helping You Learn to Code from Scratch”', 'surerank' ), __( '“Creative Interior Design for Modern Spaces”', 'surerank' ), ]; if ( ! $h1_analysis['exists'] ) { $status = 'warning'; $title = __( 'No H1 heading found on the homepage.', 'surerank' ); } elseif ( ! $h1_analysis['is_optimized'] ) { $status = 'warning'; $title = __( 'Multiple H1 headings found on the homepage.', 'surerank' ); } else { $title = __( 'Homepage contains one H1 heading.', 'surerank' ); } return [ 'exists' => $exists, 'status' => $status, 'description' => $descriptions, 'message' => $title, 'not_fixable' => true, ]; } /* * Analyze H2 headings. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_heading_h2( DOMXPath $xpath ) { $descriptions = [ __( 'H2 headings act like section titles that break your homepage into clear parts. Think of them as signposts that guide visitors through your content. Instead of reading everything line by line, people scan — and H2s help them quickly spot what matters most.', 'surerank' ), __( 'Search engines also pay attention to these subheadings. They use them to understand the structure of your page and what each section is about.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'Subheadings make your content easier to scan for humans and easier to understand for search engines. A homepage without any H2s can feel flat and confusing. Just a few well-placed H2s can give your content more structure and impact.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What to write:', 'surerank' ) ), __( 'Each H2 should introduce a new section — like your services, your process, your values, or key offerings. Keep them short and helpful.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Examples:', 'surerank' ) ), __( 'What We Do', 'surerank' ), __( 'How It Works', 'surerank' ), __( 'Trusted by 100+ Clients', 'surerank' ), ]; $h2_analysis = $this->analyze_h2( $xpath ); $exists = $h2_analysis['exists']; $status = 'success'; $title = __( 'Homepage contains at least one H2 heading', 'surerank' ); if ( ! $h2_analysis['exists'] ) { $status = 'warning'; $title = __( 'Homepage does not contain at least one H2 heading', 'surerank' ); } return [ 'exists' => $exists, 'status' => $status, 'description' => $descriptions, 'message' => $title, 'not_fixable' => true, ]; } /* * Analyze images for ALT attributes. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_images( DOMXPath $xpath ) { $images = $xpath->query( '//img' ); if ( ! $images instanceof DOMNodeList ) { return [ 'exists' => false, 'status' => 'warning', 'description' => $this->build_image_description( false, 0, 0, [] ), 'message' => __( 'No images found on the homepage.', 'surerank' ), ]; } $total = $images->length; $missing_alt = 0; $missing_alt_images = []; foreach ( $images as $img ) { if ( $img instanceof DOMElement ) { $src = $img->hasAttribute( 'src' ) ? trim( $img->getAttribute( 'src' ) ) : __( 'Unnamed image', 'surerank' ); if ( ! $img->hasAttribute( 'alt' ) \|\| empty( trim( $img->getAttribute( 'alt' ) ) ) ) { $missing_alt++; $missing_alt_images[] = $src; } } } $exists = $total > 0; $is_optimized = $missing_alt === 0; if ( ! $exists ) { return [ 'exists' => false, 'status' => 'warning', 'description' => [ __( 'The homepage does not contain any images.', 'surerank' ) ], 'message' => __( 'No images found on the homepage.', 'surerank' ), ]; } $title = $is_optimized ? __( 'Images on the homepage have alt text attributes.', 'surerank' ) : __( 'Images on the homepage do not have alt text attributes.', 'surerank' ); return [ 'exists' => $exists, 'status' => $is_optimized ? 'success' : 'warning', 'description' => $this->build_image_description( $exists, $total, $missing_alt, $missing_alt_images ), 'message' => $title, ]; } /* * Analyze internal links if any. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_links( DOMXPath $xpath ) { $links = $xpath->query( '//a[@href]' ); $helptext = [ __( 'Your homepage is usually the first place visitors land. From here, they should be able to quickly jump to the most important parts of your site — whether that’s a service page, your blog, or a contact form.', 'surerank' ), __( 'Internal links help people find what they need and help search engines understand the structure of your site. They also pass link value (or “SEO juice”) from your homepage to other key pages.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'Without internal links, your homepage becomes a dead end. Visitors might not explore further, and search engines won’t know which pages matter most.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What to link to:', 'surerank' ) ), __( 'Include links to things like: ', 'surerank' ), __( 'About or Team page', 'surerank' ), __( 'Services or product pages', 'surerank' ), __( 'Blog or recent posts', 'surerank' ), __( 'Contact or booking page', 'surerank' ), __( 'You can do this with buttons, menus, or even simple text links.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Where to add them:', 'surerank' ) ), __( 'Edit your homepage and look for natural spots to add links — like under short introductions, in feature sections, or at the end of content blocks.', 'surerank' ), ]; if ( ! $links instanceof DOMNodeList ) { return [ 'exists' => false, 'status' => 'warning', 'description' => [ $helptext, ], 'message' => __( 'Home Page does not contain internal links to other pages on the site.', 'surerank' ), 'not_fixable' => true, ]; } $internal = 0; $internal_links = []; foreach ( $links as $link ) { if ( $link instanceof DOMElement ) { $href = $link->getAttribute( 'href' ); if ( empty( $href ) \|\| strpos( $href, '#' ) === 0 ) { continue; } $host = wp_parse_url( $href, PHP_URL_HOST ); if ( ! is_string( $host ) \|\| $host === $this->base_url ) { $internal++; $internal_links[] = $href; } } } $exists = $internal > 0; $title = $exists ? __( 'Home Page contains internal links to other pages on the site.', 'surerank' ) : __( 'Home Page does not contain internal links to other pages on the site.', 'surerank' ); return [ 'exists' => $exists, 'status' => $exists ? 'success' : 'warning', 'description' => $helptext, 'message' => $title, 'not_fixable' => true, ]; } /* * Analyze canonical tag. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_canonical( DOMXPath $xpath ) { $helptext = [ __( 'Sometimes, your homepage can be accessed through more than one URL — for example, with or without a trailing slash, or with tracking parameters like ?ref=newsletter. A canonical tag tells search engines which version is the “main” one.', 'surerank' ), __( 'This helps avoid confusion and ensures that all ranking signals point to the correct version of your homepage.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'If search engines see multiple versions of the same page, they may treat them as duplicates. That can split your SEO value and reduce your visibility in search results. A canonical tag keeps everything focused and clear.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'Add a canonical tag to your homepage that points to your preferred URL (e.g., https://example.com/). This tells search engines, “This is the official version to index.”', 'surerank' ), ]; $canonical = $xpath->query( '//link[@rel="canonical"]/@href' ); if ( ! $canonical instanceof DOMNodeList ) { return $this->build_error_response( __( 'Canonical tag is not present on the homepage.', 'surerank' ), $helptext, __( 'Canonical tag is not present on the homepage.', 'surerank' ), 'warning' ); } $exists = $canonical->length > 0; $title = $exists ? __( 'Canonical tag is present on the homepage.', 'surerank' ) : __( 'Canonical tag is not present on the homepage.', 'surerank' ); return [ 'exists' => $exists, 'status' => $exists ? 'success' : 'warning', 'description' => $helptext, 'message' => $title, ]; } /* * Analyze indexing meta tag. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function analyze_indexing( DOMXPath $xpath ) { $robots = $xpath->query( '//meta[@name="robots"]/@content' ); $description = [ __( 'For your website to appear in search results, your homepage must be allowed to be indexed. Indexing simply means giving search engines permission to include your page in their listings.', 'surerank' ), __( 'Sometimes indexing gets turned off by accident — during site setup, through theme settings, or by certain plugins. When that happens, your homepage becomes invisible to search engines, even if the rest of your site is working fine.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'Your homepage is the front door to your website. It’s usually the first page people find when they search for your brand or business. If indexing is blocked, search engines can’t list it — which means potential visitors may never reach your site at all.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'You can do this by reviewing your page\'s SEO settings, your site\'s global visibility settings, or the Advanced settings of the homepage in the SureRank plugin.', 'surerank' ), __( 'Once indexing is enabled, search engines will be able to include your homepage in search results — helping more people discover what you offer.', 'surerank' ), ]; if ( ! $robots instanceof DOMNodeList ) { return [ 'exists' => false, 'status' => 'warning', 'description' => $description, 'message' => __( 'Homepage is not indexable by search engines.', 'surerank' ), ]; } $exists = $robots->length > 0; $content = ''; if ( $exists ) { $robots_node = $robots->item( 0 ); if ( $robots_node instanceof DOMAttr ) { $content = trim( $robots_node->value ); } } $is_indexable = $exists ? strpos( $content, 'noindex' ) === false : true; $title = $is_indexable ? __( 'Homepage is indexable by search engines.', 'surerank' ) : __( 'Homepage is not indexable by search engines.', 'surerank' ); return [ 'exists' => $exists, 'status' => $is_indexable ? 'success' : 'error', 'description' => $description, 'message' => $title, ]; } /* * Analyze homepage reachability. * * @return array<string, mixed> / public function analyze_reachability() { $home_url = home_url(); $is_reachable = $this->base_url === wp_parse_url( $home_url, PHP_URL_HOST ) && ! is_wp_error( $this->html_content ); $working_label = __( 'Home Page is loading correctly.', 'surerank' ); $not_working_label = __( 'Home Page is not loading correctly.', 'surerank' ); $description = [ __( 'Your homepage is the front door to your website — it’s often the first page people see, and the one search engines visit first. If your homepage doesn’t load or returns an error, both visitors and search engines may have trouble accessing your content.', 'surerank' ), __( 'This can happen if your homepage was moved, deleted, or misconfigured — especially if your homepage is set to display your latest posts or a custom page.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why it matters:', 'surerank' ) ), __( "If your homepage isn’t reachable, it can affect how your entire site is crawled, indexed, and understood by search engines. It's also the first impression for your visitors — so it needs to be available and working.", 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( "Open your homepage in a browser and make sure it loads without errors. In WordPress, go to Settings → Reading and check that the right homepage is selected. If you're using a static page, ensure that page still exists and is published.", 'surerank' ), ]; if ( ! $is_reachable ) { $response = $this->scraper->fetch( $home_url ); $is_reachable = ! is_wp_error( $response ); } $title = $is_reachable ? $working_label : $not_working_label; return [ 'exists' => true, 'status' => $is_reachable ? 'success' : 'error', 'description' => $description, 'message' => $title, 'not_fixable' => true, ]; } /* * Analyze secure HTTPS connection. * * @return array<string, mixed> / public function analyze_secure_connection(): array { $header_url = $this->fetch_header( 'x-final-url' ); $effective_url = $header_url !== '' ? $header_url : home_url(); $working_label = __( 'Site is served over a secure HTTPS connection.', 'surerank' ); $not_working_label = __( 'Site is not served over a secure HTTPS connection.', 'surerank' ); $description = [ __( 'A secure connection means your website uses HTTPS — the little padlock icon next to your site’s address in a browser. This shows visitors (and search engines) that your site is safe and their information is protected.', 'surerank' ), __( 'Having a secure site isn’t just about safety — it’s also a trust signal. Search engines are more likely to rank secure sites higher, and modern browsers may even warn visitors when a site is not using HTTPS.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why it matters:', 'surerank' ) ), __( 'Security is important for everyone — even if your site doesn’t collect sensitive info. Using HTTPS protects your visitors and boosts your site’s credibility with search engines and users alike.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'Make sure your website uses HTTPS and shows a padlock icon in the address bar. You can enable HTTPS with an SSL certificate — many hosting providers offer this for free. Once set up, your connection will be secure, and your site will appear safer to both search engines and people.', 'surerank' ), ]; $is_https = strpos( $effective_url, 'https://' ) === 0; $title = $is_https ? $working_label : $not_working_label; return [ 'exists' => true, 'status' => $is_https ? 'success' : 'warning', 'description' => $description, 'message' => $title, 'not_fixable' => true, ]; } /* * Analyze open graph tags. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function open_graph_tags( DOMXPath $xpath ): array { $og_tags = $xpath->query( "//meta[starts-with(@property, 'og:')]" ); $working_label = __( 'Open Graph tags are present on your homepage.', 'surerank' ); $not_working_label = __( 'Open Graph tags are not present on your homepage.', 'surerank' ); $helptext = [ __( 'When someone shares your homepage on social media or messaging apps, platforms try to pull a title, description, and image. Without Open Graph tags, they may choose random content — or display nothing at all.', 'surerank' ), __( 'Open Graph tags let you decide exactly what people see when your homepage is shared.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'A good preview makes your site more clickable and professional. A missing or messy preview can make it harder for people to trust or engage with your content.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'Add Open Graph tags that define: ', 'surerank' ), __( 'A short title for your homepage', 'surerank' ), __( 'A brief description', 'surerank' ), __( 'A clear image that represents your site or brand', 'surerank' ), __( 'This ensures your homepage always looks polished when it’s shared.', 'surerank' ), sprintf( / translators: %s is the URL of the home page / __( 'Configure your Home Page Social settings. Depending on your homepage setup, <a href="%s">this link</a> will take you to the relevant page.', 'surerank' ), $this->get_homepage_settings_url() ), ]; if ( ! $og_tags instanceof DOMNodeList ) { return [ 'exists' => false, 'status' => 'warning', 'description' => $helptext, 'message' => $not_working_label, ]; } $details = []; $required_tags = [ 'og:title', 'og:description' ]; $found_required = [ 'og:title' => false, 'og:description' => false, ]; foreach ( $og_tags as $tag ) { if ( $tag instanceof DOMElement ) { $property = $tag->getAttribute( 'property' ); $content = $tag->getAttribute( 'content' ); $details[] = $property . ':' . $content; if ( in_array( $property, $required_tags, true ) ) { $found_required[ $property ] = true; } } } $missing_required = array_keys( array_filter( $found_required, static fn( $found) => ! $found ) ); if ( ! empty( $missing_required ) ) { return [ 'exists' => ! empty( $details ), 'status' => 'warning', 'description' => $helptext, 'message' => $not_working_label, ]; } return [ 'exists' => true, 'status' => 'success', 'description' => $helptext, 'message' => $working_label, ]; } /* * Analyze schema meta data. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / public function schema_meta_data( DOMXPath $xpath ) { $schema_meta_data = $xpath->query( "//script[@type='application/ld+json' and @id='surerank-schema']" ); $working_label = __( 'Structured data (schema) is present on the home page.', 'surerank' ); $not_working_label = __( 'Structured data (schema) is not present on the home page.', 'surerank' ); $helptext = [ __( 'Think of schema as a little “cheat sheet” your homepage shares with search engines. It quietly tells them what kind of content your homepage contains — like whether it\'s a website, a blog, or something else. This extra detail helps search engines understand your page better and sometimes display richer information in search results.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why it matters:', 'surerank' ) ), __( 'Search engines don’t just look at text — they look for signals. Schema gives them those signals. With it, your homepage can show up more clearly and attractively in search results, with added details like a breadcrumb path or your site name.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'Make sure your homepage includes basic structured data like WebPage schema. It helps search engines recognize your homepage as a core part of your site.', 'surerank' ), __( 'You don’t have to add anything manually — SureRank handles this in the background, as long as the feature is active and enabled.', 'surerank' ), ]; if ( ! $schema_meta_data instanceof DOMNodeList ) { return [ 'exists' => false, 'status' => 'suggestion', 'description' => $helptext, 'message' => $not_working_label, ]; } if ( ! $schema_meta_data->length ) { return [ 'exists' => false, 'status' => 'suggestion', 'description' => $helptext, 'message' => $not_working_label, ]; } return [ 'exists' => true, 'status' => 'success', 'description' => $helptext, 'message' => $working_label, ]; } /* * Analyze WWW canonicalization. * * @return array<string, mixed> / public function analyze_www_canonicalization(): array { $home_url = home_url(); $parsed = wp_parse_url( $home_url ); $helptext = [ __( 'Your website can usually be visited in two ways: https://example.com and https://www.example.com.', 'surerank' ), __( 'Both may work, but unless one redirects to the other, search engines treat them as separate websites — even though they look the same.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'If your site runs under both versions without redirection, it creates duplicate versions of every page. That splits your SEO value and may confuse search engines about which version to prioritize.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What you can do:', 'surerank' ) ), __( 'Pick your preferred domain (with or without www) and set up a redirect so all visitors and search engines are sent to that version. This makes your SEO stronger and avoids unnecessary duplication.', 'surerank' ), ]; $working_label = __( 'Site correctly redirects between www and non-www versions.', 'surerank' ); $not_working_label = __( 'Site does not correctly redirect between www and non-www versions.', 'surerank' ); if ( ! is_array( $parsed ) \|\| ! isset( $parsed['host'], $parsed['scheme'] ) ) { return [ 'exists' => false, 'status' => 'error', 'description' => $helptext, 'message' => $not_working_label, 'not_fixable' => true, ]; } $host = (string) $parsed['host']; $scheme = (string) $parsed['scheme']; $timeout = 8; $is_www = str_starts_with( $host, 'www.' ); $alternate = $is_www ? preg_replace( '/^www\./', '', $host ) : "www.{$host}"; $test_url = "{$scheme}://{$alternate}"; // Pull the Location header (empty string on failure). $response = wp_safe_remote_head( $test_url, [ 'redirection' => 5, 'timeout' => $timeout, ] ); if ( is_wp_error( $response ) ) { return [ 'exists' => false, 'status' => 'error', 'description' => $helptext, 'message' => $not_working_label, 'not_fixable' => true, ]; } $status_code = (int) wp_remote_retrieve_response_code( $response ); $raw_location = wp_remote_retrieve_header( $response, 'location' ); $location = is_array( $raw_location ) ? ( $raw_location[0] ?? '' ) : ( ! empty( $raw_location ) ? $raw_location : '' ); // Normalize the final URL. if ( str_starts_with( $location, '/' ) ) { $final_url = "{$scheme}://{$host}{$location}"; } elseif ( $location !== '' ) { $final_url = $location; } else { $final_url = $test_url; } $final_host = (string) ( wp_parse_url( $final_url, PHP_URL_HOST ) ?? '' ); $redirect_happened = $location !== ''; $redirect_ok = $redirect_happened ? $final_host === $host : true; $request_ok = $status_code >= 200 && $status_code < 300; $all_good = $redirect_ok && $request_ok; $title = $all_good ? $working_label : $not_working_label; return [ 'exists' => true, 'status' => $all_good ? 'success' : 'warning', 'description' => $helptext, 'message' => $title, 'not_fixable' => true, ]; } /* * Initialize the analyzer by fetching and parsing the URL. * * @param string $url The URL to analyze. * @return void / private function initialize( string $url ) { if ( ! filter_var( $url, FILTER_VALIDATE_URL ) ) { $this->errors[] = __( 'Invalid URL.', 'surerank' ); return; } $parsed_url = wp_parse_url( $url, PHP_URL_HOST ); $this->base_url = is_string( $parsed_url ) ? $parsed_url : ''; $this->html_content = $this->scraper->fetch( $url ); if ( is_wp_error( $this->html_content ) ) { $this->errors[] = $this->html_content->get_error_message(); return; } $parsed_dom = $this->parser->parse( $this->html_content ); if ( is_wp_error( $parsed_dom ) ) { $this->errors[] = $parsed_dom->get_error_message(); return; } $this->dom = $parsed_dom; } /* * Get title analysis message. * * @param bool $exists Whether title exists. * @param int $length Title length. * @param string $status Status of the analysis. * @return string / private function get_title_message( bool $exists, int $length, string $status ) { if ( ! $exists ) { return __( 'Search engine title is missing on the homepage.', 'surerank' ); } if ( $status === 'warning' ) { / translators: %1$d is the maximum recommended length of the title. / $message = __( 'Search engine title of the home page exceeds %1$d characters.', 'surerank' ); return sprintf( $message, Get::TITLE_LENGTH ); } if ( $status === 'success' ) { return __( 'Search engine title of the home page is present and under 60 characters.', 'surerank' ); } return __( 'Search engine title is present and under 60 characters.', 'surerank' ); } /* * Get meta description analysis message. * * @param bool $exists Whether meta description exists. * @param int $length Meta description length. * @param string $status Status of the analysis. * @return string / private function get_meta_description_message( bool $exists, int $length, string $status ) { if ( ! $exists ) { return __( 'Search engine description is missing on the homepage.', 'surerank' ); } if ( $status === 'warning' ) { / translators: %1$d is the maximum length of the meta description. / $message = __( 'Search engine description of the home page exceeds %1$d characters.', 'surerank' ); return sprintf( $message, Get::DESCRIPTION_LENGTH ); } if ( $status === 'success' ) { return __( 'Search engine description of the home page is present and under 160 characters.', 'surerank' ); } return __( 'Search engine description is missing on the homepage.', 'surerank' ); } /* * Analyze H1 headings. * * @param DOMXPath $xpath XPath instance. * @return array{ * exists: bool, * is_optimized: bool, * details: array{ * count: int, * contents: array<string> * } * } / private function analyze_h1( DOMXPath $xpath ): array { $h1s = $xpath->query( '//h1' ); if ( ! $h1s instanceof DOMNodeList ) { return [ 'exists' => false, 'is_optimized' => false, 'details' => [ 'count' => 0, 'contents' => [], ], ]; } $exists = $h1s->length > 0; $count = $h1s->length; $contents = []; if ( $exists ) { foreach ( $h1s as $h1_node ) { if ( $h1_node instanceof DOMElement ) { $contents[] = trim( $h1_node->textContent ); } } } return [ 'exists' => $exists, 'is_optimized' => $count === 1, 'details' => [ 'count' => $count, 'contents' => $contents, ], ]; } /* * Analyze H2 headings. * * @param DOMXPath $xpath XPath instance. * @return array<string, mixed> / private function analyze_h2( DOMXPath $xpath ) { $h2s = $xpath->query( '//h2' ); if ( ! $h2s instanceof DOMNodeList ) { return [ 'exists' => false, 'is_optimized' => false, 'details' => [ 'count' => 0, 'contents' => [], ], ]; } $exists = $h2s->length > 0; $count = $h2s->length; $contents = []; if ( $exists ) { foreach ( $h2s as $h2_node ) { if ( $h2_node instanceof DOMElement ) { $contents[] = trim( $h2_node->textContent ); } } } return [ 'exists' => $exists, 'is_optimized' => $count >= 1, 'details' => [ 'count' => $count, 'contents' => $contents, ], ]; } /* * Build image analysis description. * * @param bool $exists Whether images exist. * @param int $total Total number of images. * @param int $missing_alt Number of images missing ALT. * @param array<string> $missing_alt_images Images missing ALT attributes. * @return array<int, array<string, array<int, string>\|string>\|string> / private function build_image_description( bool $exists, int $total, int $missing_alt, array $missing_alt_images ) { $list = []; if ( $missing_alt !== 0 ) { foreach ( $missing_alt_images as $image ) { if ( ! in_array( $image, $list ) ) { $list[] = esc_html( $image ); } } } return [ __( 'Images add personality and style to your homepage — but search engines can’t “see” them unless you describe what they are. That’s where ALT text comes in.', 'surerank' ), __( 'ALT (alternative) text is a short description added to each image. It helps with accessibility for users using screen readers, and it helps search engines understand what the image is about. That can help your content appear in image search results too.', 'surerank' ), [ 'list' => $list ], [ 'img' => 'true' ], sprintf( '<h6> %s </h6>', __( 'Why this matters:', 'surerank' ) ), __( 'ALT text improves accessibility, makes your site more inclusive, and helps with SEO. It’s especially important on your homepage, where your most important content and images usually live.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'What to write:', 'surerank' ) ), __( 'Just describe what the image is about. If it’s decorative, you can skip it — but for key images, write a short, clear summary.', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Examples:', 'surerank' ) ), __( 'Woman doing yoga in a sunny room', 'surerank' ), __( 'Handmade ceramic mug on a wooden table', 'surerank' ), sprintf( '<h6> %s </h6>', __( 'Where to add it:', 'surerank' ) ), __( 'When uploading or editing images in WordPress, you’ll see an “ALT text” field in the media settings. Fill this out for each image on your homepage.', 'surerank' ), ]; } /* * Build error response for invalid queries. * * @param string $title Error title. * @param array<string\|array<string>> $helptext Error description (HTML). * @param string $message Error message. * @param string $status Error status. * @return array<string, mixed> / private function build_error_response( string $title, array $helptext, string $message, string $status = 'error' ) { return [ 'exists' => false, 'status' => $status, 'description' => $helptext, 'message' => $message, ]; } /* * Get the given header from the last fetched response. * * @param string $header The header name to retrieve. * @return string Header value, or '' if unavailable. / private function fetch_header( string $header ): string { if ( is_wp_error( $this->html_content ) \|\| empty( $this->scraper->get_body() ) ) { return ''; } $value = $this->scraper->get_header( $header ); return is_string( $value ) ? $value : ''; } /* * Get the URL of the home page social settings page. * * @return string */ private function get_homepage_settings_url() { $page_on_front = intval( Get::option( 'page_on_front' ) ); if ( get_edit_post_link( $page_on_front ) ) { return get_edit_post_link( $page_on_front ); } return Analyzer::get_instance()->get_surerank_settings_url( 'homepage', 'general' ); } }	40.32 KB	2025-10-27 18:36
📄 term-analyzer.php <?php /** * Term Analyzer class. * * Performs SEO checks for WordPress terms with consistent output for UI. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use SureRank\Inc\API\Admin; use SureRank\Inc\API\Term; use SureRank\Inc\Functions\Helper; use SureRank\Inc\Functions\Settings; use SureRank\Inc\Functions\Update; use SureRank\Inc\Traits\Get_Instance; use SureRank\Inc\Traits\Logger; use WP_Term; /* * Term Analyzer class. / class TermAnalyzer { use Get_Instance; use Logger; /* * Term title. * * @var string\|null / private $term_title = ''; /* * Term description. * * @var string\|null / private $term_description = ''; /* * Canonical URL. * * @var string\|null / private $canonical_url = ''; /* * Term ID. * * @var int\|null / private $term_id; /* * Term permalink. * * @var string / private $term_permalink = ''; /* * Term content. * * @var string / private $term_content = ''; /* * Constructor. / private function __construct() { if ( ! Settings::get( 'enable_page_level_seo' ) ) { return; } add_action( 'edited_term', [ $this, 'save_term' ], 10, 3 ); add_action( 'save_term', [ $this, 'save_term' ], 10, 3 ); add_filter( 'surerank_run_term_seo_checks', [ $this, 'run_checks' ], 10, 2 ); } /* * Handle term save to run SEO checks. * * @param int $term_id Term ID. * @param int $tt_id Term taxonomy ID. * @param string $taxonomy Taxonomy slug. * @return void / public function save_term( $term_id, $tt_id, $taxonomy ) { $term = get_term( $term_id, $taxonomy ); if ( is_wp_error( $term ) \|\| ! $term instanceof WP_Term ) { return; } if ( in_array( $term->taxonomy, apply_filters( 'surerank_excluded_taxonomies_from_seo_checks', [] ), true ) ) { return; } $response = $this->run_checks( $term_id, $term ); if ( isset( $response['status'] ) && 'error' === $response['status'] ) { self::log( $response['message'] ); } Update::term_meta( $term_id, 'surerank_taxonomy_updated_at', time() ); } /* * Run SEO checks for the term. * * @param int $term_id Term ID. * @param WP_Term $term Term object. * @return array<string, mixed> / public function run_checks( $term_id, $term ) { $this->term_id = $term_id; if ( ! $this->term_id \|\| ! $term instanceof WP_Term ) { return [ 'status' => 'error', 'message' => __( 'Invalid term ID or term object.', 'surerank' ), ]; } $meta_data = Term::get_term_data_by_id( $term_id, $term->taxonomy, false ); $variables = Admin::get_instance()->get_variables( null, $term_id ); $meta_data = Utils::get_meta_data( $meta_data ); foreach ( $meta_data as $key => $value ) { $meta_data[ $key ] = Helper::replacement( $key, $value, $variables ); } $this->term_title = $meta_data['page_title'] ?? ''; // we are keeping meta_data['page_title'] as we are using this globally. $this->term_description = $meta_data['page_description'] ?? ''; // same for meta_data['page_description'] as above. $this->canonical_url = $meta_data['canonical_url'] ?? ''; $this->term_permalink = ! is_wp_error( get_term_link( (int) $term_id ) ) ? get_term_link( (int) $term_id ) : ''; $this->term_content = $term->description; $rendered_content = $term->description; $result = $this->analyze( $meta_data ); $success = Update::taxonomy_seo_checks( $term_id, $result ); if ( ! $success ) { return [ 'status' => 'error', 'message' => __( 'Failed to update SEO checks', 'surerank' ), ]; } return $result; } /* * Analyze the term. * * @param array<string, mixed> $meta_data Meta data. * @return array<string, mixed> / private function analyze( array $meta_data ) { // Get focus keyword for keyword checks. $focus_keyword = $meta_data['focus_keyword'] ?? ''; return [ 'url_length' => Utils::check_url_length( $this->term_permalink ), 'search_engine_title' => Utils::analyze_title( $this->term_title ), 'search_engine_description' => Utils::analyze_description( $this->term_description ), 'canonical_url' => $this->canonical_url(), 'open_graph_tags' => Utils::open_graph_tags(), // Keyword checks. 'keyword_in_title' => Utils::analyze_keyword_in_title( $this->term_title, $focus_keyword ), 'keyword_in_description' => Utils::analyze_keyword_in_description( $this->term_description, $focus_keyword ), 'keyword_in_url' => Utils::analyze_keyword_in_url( $this->term_permalink, $focus_keyword ), 'keyword_in_content' => Utils::analyze_keyword_in_content( $this->term_content, $focus_keyword ), ]; } /* * Get canonical URL. * * @return array<string, mixed> */ private function canonical_url() { if ( $this->canonical_url === null ) { return [ 'status' => 'error', 'message' => __( 'No canonical URL provided.', 'surerank' ), ]; } $permalink = get_term_link( (int) $this->term_id ); if ( ! $permalink \|\| is_wp_error( $permalink ) ) { return [ 'status' => 'error', 'message' => __( 'No permalink provided.', 'surerank' ), ]; } return Utils::analyze_canonical_url( $this->canonical_url, $permalink ); } }	5.18 KB	2025-10-27 18:36
📄 utils.php <?php /** * Abstract Analyzer class. * * Base class for performing SEO checks for WordPress entities with consistent output for UI. * * @package SureRank\Inc\Analyzer / namespace SureRank\Inc\Analyzer; use DOMDocument; use DOMXPath; use SureRank\Inc\Functions\Get; /* * Abstract Analyzer class. / class Utils { /* * Get rendered XPath. * * @param string $rendered_content Rendered content. * @return DOMXPath\|null / public static function get_rendered_xpath( $rendered_content ) { if ( empty( $rendered_content ) ) { return null; } $dom = new DOMDocument(); libxml_use_internal_errors( true ); $encoded_content = mb_encode_numericentity( htmlspecialchars_decode( htmlentities( $rendered_content, ENT_NOQUOTES, 'UTF-8', false ), ENT_NOQUOTES ), [ 0x80, 0x10FFFF, 0, ~0 ], /* * Conversion map for mb_encode_numericentity: * 0x80 (128) is the first non-ASCII Unicode code point. * 0x10FFFF (1,114,111) is the highest valid Unicode code point. * 0 is the bitmask for the first byte (no filtering). * ~0 is the bitmask to include all characters in the range. / 'UTF-8' ); if ( empty( $encoded_content ) ) { return null; } $dom->loadHTML( $encoded_content ); libxml_clear_errors(); return new DOMXPath( $dom ); } /* * Check for search engine title. * * @param string\|null $title Title. * @return array<string, mixed> / public static function analyze_title( $title ) { if ( $title === null ) { return [ 'status' => 'error', 'message' => __( 'Search engine title is missing on the page.', 'surerank' ), ]; } $length = mb_strlen( $title ); $exists = ! empty( $title ); $is_optimized = $exists && $length <= Get::TITLE_LENGTH; // translators: %s is the search engine title length. $working_message = sprintf( __( 'Search engine title is present and under %s characters.', 'surerank' ), Get::TITLE_LENGTH ); // translators: %s is the search engine title length. $exceeding_message = sprintf( __( 'Search engine title exceeds %s characters.', 'surerank' ), Get::TITLE_LENGTH ); // translators: %s is the search engine title length. $missing_message = __( 'Search engine title is missing on the page.', 'surerank' ); $message = $exists ? ( $length <= Get::TITLE_LENGTH ? $working_message : $exceeding_message ) : $missing_message; $description = $exists && ! $is_optimized ? [ // translators: %s is the search engine title. sprintf( __( 'The search engine title for the page is: "%s"', 'surerank' ), $title ), ] : []; return [ 'status' => $exists ? ( $is_optimized ? 'success' : 'warning' ) : 'error', 'message' => $message, ]; } /* * Check for search engine description. * * @param string\|null $description Description. * @return array<string, mixed> / public static function analyze_description( $description ) { if ( $description === null ) { return [ 'status' => 'warning', 'message' => __( 'Search engine description is missing on the page.', 'surerank' ), ]; } $length = mb_strlen( $description ); $exists = ! empty( $description ); $is_optimized = $exists && $length >= Get::DESCRIPTION_MIN_LENGTH && $length <= Get::DESCRIPTION_LENGTH; // translators: %s is the search engine description length. $working_message = sprintf( __( 'Search engine description is present and under %s characters.', 'surerank' ), Get::DESCRIPTION_LENGTH ); // translators: %s is the search engine description length. $exceeding_message = sprintf( __( 'Search engine description exceeds %s characters.', 'surerank' ), Get::DESCRIPTION_LENGTH ); // translators: %s is the search engine description length. $missing_message = __( 'Search engine description is missing on the page.', 'surerank' ); $message = $exists ? ( $length <= Get::DESCRIPTION_LENGTH ? $working_message : $exceeding_message ) : $missing_message; / translators: %s is the search engine description / $description = $exists && ! $is_optimized ? [ sprintf( __( 'The search engine description for the page is: "%s"', 'surerank' ), $description ) ] : []; return [ 'status' => $exists && $length <= Get::DESCRIPTION_LENGTH ? 'success' : 'warning', 'message' => $message, ]; } /* * Check for canonical URL. * * @param string\|null $canonical Canonical URL. * @param string\|null $permalink Permalink URL. * @return array<string, mixed> / public static function analyze_canonical_url( $canonical, $permalink ) { if ( $canonical === null && $permalink === null ) { return [ 'status' => 'warning', 'message' => __( 'Canonical tag is not present on the page.', 'surerank' ), ]; } return [ 'status' => 'success', 'message' => __( 'Canonical tag is present on the page.', 'surerank' ), ]; } /* * Check for URL length. * * @param string\|null $url URL. * @return array<string, mixed> / public static function check_url_length( $url ) { if ( $url === null ) { return [ 'status' => 'warning', 'message' => __( 'No URL provided.', 'surerank' ), ]; } $length = mb_strlen( $url ); $exists = ! empty( $url ); $is_optimized = $exists && $length <= Get::URL_LENGTH; $working_message = __( 'Page URL is short and SEO-friendly.', 'surerank' ); / translators: %s is the URL length. / $exceeding_message = sprintf( __( 'Page URL is longer than %s characters and may affect SEO and readability.', 'surerank' ), Get::URL_LENGTH ); $missing_message = __( 'No URL provided.', 'surerank' ); $message = $exists ? ( $is_optimized ? $working_message : $exceeding_message ) : $missing_message; return [ 'status' => $exists ? ( $is_optimized ? 'success' : 'warning' ) : 'warning', 'message' => $message, ]; } /* * Get meta data. * * @param array<string, mixed> $meta Meta data. * @return array<string, mixed> / public static function get_meta_data( array $meta ) { $meta_data = $meta['data'] ?? []; $global_data = $meta['global_default'] ?? []; if ( empty( $meta_data['page_title'] ) ) { $meta_data['page_title'] = $global_data['page_title'] ?? ''; $meta_data['page_title'] = str_replace( '%title%', '%term_title%', $meta_data['page_title'] ); } if ( empty( $meta_data['page_description'] ) ) { $meta_data['page_description'] = $global_data['page_description'] ?? ''; $meta_data['page_description'] = str_replace( '%excerpt%', '%term_description%', $meta_data['page_description'] ); } return $meta_data; } /* * Get existing broken links. * * @param array<string, mixed> $broken_links Broken links. * @param array<string> $urls URLs. * @return array<string, array<string, mixed>> / public static function existing_broken_links( $broken_links, $urls ) { $description = $broken_links['description'] ?? []; $existing_broken_links = []; foreach ( $description as $item ) { if ( is_array( $item ) && isset( $item['list'] ) ) { $existing_broken_links = $item['list']; break; } } $filtered_broken_links = []; if ( is_array( $existing_broken_links ) ) { foreach ( $existing_broken_links as $key => $existing_link ) { if ( is_string( $existing_link ) ) { if ( in_array( $existing_link, $urls, true ) ) { $filtered_broken_links[ $key ] = [ 'url' => $existing_link, 'status' => 'error', 'details' => __( 'The link is broken.', 'surerank' ), ]; } } elseif ( is_array( $existing_link ) && isset( $existing_link['url'] ) ) { if ( in_array( $existing_link['url'], $urls, true ) ) { $filtered_broken_links[ $key ] = $existing_link; } } } } return $filtered_broken_links; } /* * Check for open graph tags. * * @return array<string, mixed> / public static function open_graph_tags() { if ( apply_filters( 'surerank_disable_open_graph_tags', false ) ) { return [ 'status' => 'suggestion', 'message' => __( 'Open Graph tags are not present on the page.', 'surerank' ), ]; } return [ 'status' => 'success', 'message' => __( 'Open Graph tags are present on the page.', 'surerank' ), ]; } /* * Check if keyword exists in text (case-insensitive). * * @param string $text Text to search in. * @param string $keyword Keyword to search for. * @return bool / private static function keyword_exists_in_text( $text, $keyword ) { if ( empty( $text ) \|\| empty( $keyword ) ) { return false; } return stripos( $text, $keyword ) !== false; } /* * Analyze focus keyword in SEO title. * * @param string\|null $title SEO title. * @param string $keyword Focus keyword. * @return array<string, mixed> / public static function analyze_keyword_in_title( $title, $keyword ) { if ( empty( $keyword ) ) { return [ 'status' => 'suggestion', 'message' => __( 'No focus keyword set to analyze title.', 'surerank' ), ]; } if ( empty( $title ) ) { return [ 'status' => 'warning', 'message' => __( 'No SEO title found to analyze.', 'surerank' ), ]; } if ( self::keyword_exists_in_text( $title, $keyword ) ) { return [ 'status' => 'success', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" found in SEO title.', 'surerank' ), $keyword ), ]; } return [ 'status' => 'warning', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" not found in SEO title.', 'surerank' ), $keyword ), ]; } /* * Analyze focus keyword in meta description. * * @param string\|null $description Meta description. * @param string $keyword Focus keyword. * @return array<string, mixed> / public static function analyze_keyword_in_description( $description, $keyword ) { if ( empty( $keyword ) ) { return [ 'status' => 'suggestion', 'message' => __( 'No focus keyword set to analyze meta description.', 'surerank' ), ]; } if ( empty( $description ) ) { return [ 'status' => 'warning', 'message' => __( 'No meta description found to analyze.', 'surerank' ), ]; } if ( self::keyword_exists_in_text( $description, $keyword ) ) { return [ 'status' => 'success', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" found in meta description.', 'surerank' ), $keyword ), ]; } return [ 'status' => 'warning', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" not found in meta description.', 'surerank' ), $keyword ), ]; } /* * Analyze focus keyword in URL. * * @param string $url Page URL. * @param string $keyword Focus keyword. * @return array<string, mixed> / public static function analyze_keyword_in_url( $url, $keyword ) { if ( empty( $keyword ) ) { return [ 'status' => 'suggestion', 'message' => __( 'No focus keyword set to analyze URL.', 'surerank' ), ]; } if ( empty( $url ) ) { return [ 'status' => 'warning', 'message' => __( 'No URL found to analyze.', 'surerank' ), ]; } // Convert keyword to URL-friendly format (lowercase, spaces to hyphens). $url_friendly_keyword = strtolower( str_replace( ' ', '-', $keyword ) ); $url_lower = strtolower( $url ); if ( strpos( $url_lower, $url_friendly_keyword ) !== false \|\| self::keyword_exists_in_text( $url, $keyword ) ) { return [ 'status' => 'success', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" found in URL.', 'surerank' ), $keyword ), ]; } return [ 'status' => 'warning', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" not found in URL.', 'surerank' ), $keyword ), ]; } /* * Analyze focus keyword in content. * * @param string $content Page content. * @param string $keyword Focus keyword. * @return array<string, mixed> */ public static function analyze_keyword_in_content( $content, $keyword ) { if ( empty( $keyword ) ) { return [ 'status' => 'suggestion', 'message' => __( 'No focus keyword set to analyze content.', 'surerank' ), ]; } if ( empty( $content ) ) { return [ 'status' => 'warning', 'message' => __( 'No content found to analyze.', 'surerank' ), ]; } // Clean content of HTML tags for better analysis. $clean_content = wp_strip_all_tags( $content ); $clean_content = preg_replace( '/\s+/', ' ', $clean_content ); $clean_content = trim( (string) $clean_content ); if ( self::keyword_exists_in_text( $clean_content, $keyword ) ) { return [ 'status' => 'success', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" found in content.', 'surerank' ), $keyword ), ]; } return [ 'status' => 'warning', // translators: %s is the focus keyword. 'message' => sprintf( __( 'Focus keyword "%s" not found in content.', 'surerank' ), $keyword ), ]; } }	12.84 KB	2025-10-27 18:36

Terminal