# thinkrank/2.14.1/includes/seo/email-report-sections/class-position-summary-section.php

ThinkRank AI SEO – AI SEO Plugin for WordPress: Schema, XML Sitemaps, Meta Tags, Search Console & Local SEO, version 2.14.1. 131 lines.

- Page: https://pluginprobe.com/plugins/thinkrank/2.14.1/code/includes/seo/email-report-sections/class-position-summary-section.php
- Raw: https://pluginprobe.com/plugins/thinkrank/2.14.1/raw/includes/seo/email-report-sections/class-position-summary-section.php
- Modified: 2026-10-07T07:08:48+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/thinkrank/2.14.1/code/includes/seo/email-report-sections/class-position-summary-section.php#L10-L20`.

```php
<?php
/**
 * Position Summary Section — "Where your keywords rank".
 *
 * Buckets the period's queries into Top 3 / 4–10 / 11–50 / 51–100 and draws
 * them as bars. Source: GSC `position_distribution` already computed by
 * Analytics_Manager over the whole property (#913), with queries ranked
 * past 100 in `over_100`.
 *
 * @package ThinkRank
 * @subpackage SEO\Email_Report_Sections
 * @since 1.9.0
 */

declare(strict_types=1);

namespace ThinkRank\SEO\Email_Report_Sections;

if (!defined('ABSPATH')) {
    exit;
}

final class Position_Summary_Section implements Email_Report_Section_Interface {

    public function key(): string {
        return 'position_summary';
    }

    public function label(): string {
        return __('Where your keywords rank', 'thinkrank');
    }

    public function default_enabled(): bool {
        return true;
    }

    public function requires_capability(): ?string {
        return null;
    }

    public function renders_own_heading(): bool {
        return true;
    }

    public function collect(array $context): array {
        $shared = $context['shared'] ?? [];
        if (empty($shared['available'])) {
            return [];
        }
        $dist = $shared['current']['search_performance']['position_distribution'] ?? [];
        if (!is_array($dist) || empty($dist)) {
            return [];
        }
        return [
            'top_3'    => (int) ($dist['top_3']   ?? 0),
            '4_10'     => (int) ($dist['4_10']    ?? 0),
            '11_50'    => (int) ($dist['10_50']   ?? 0), // GSC's `10_50` bucket starts at 11
            '51_100'   => (int) ($dist['51_100']  ?? 0),
            // Counted over the whole property since #913. A payload cached
            // before then has neither key and reads as before.
            'over_100' => (int) ($dist['over_100'] ?? 0),
            'complete' => (bool) ($dist['complete'] ?? true),
        ];
    }

    public function has_data(array $payload): bool {
        $counts = array_intersect_key($payload, array_flip(['top_3', '4_10', '11_50', '51_100', 'over_100']));
        return array_sum(array_map('intval', $counts)) > 0;
    }

    public function render(array $payload): string {
        $counts = [
            'top_3'  => (int) ($payload['top_3'] ?? 0),
            '4_10'   => (int) ($payload['4_10'] ?? 0),
            '11_50'  => (int) ($payload['11_50'] ?? 0),
            '51_100' => (int) ($payload['51_100'] ?? 0),
        ];
        // The bars share out the top 100; queries ranked past it still had
        // an impression, so they count toward the headline total (#913).
        $ranked   = array_sum($counts);
        $over_100 = max(0, (int) ($payload['over_100'] ?? 0));
        $total    = $ranked + $over_100;
        if ($total === 0) {
            return '';
        }
        $page_one = $counts['top_3'] + $counts['4_10'];

        // Incomplete means Search Console could not be paged to the end, so
        // the count covers the top of the property by clicks, not all of it.
        $subtitle = (bool) ($payload['complete'] ?? true)
            ? sprintf(
                /* translators: %s: number of queries. */
                _n('%s query got at least one impression this period', '%s queries got at least one impression this period', $total, 'thinkrank'),
                number_format_i18n($total)
            )
            : sprintf(
                /* translators: %s: number of queries counted. */
                _n('Counted over your top %s query by clicks this period', 'Counted over your top %s queries by clicks this period', $total, 'thinkrank'),
                number_format_i18n($total)
            );

        $html = Email_Report_Html::heading($this->label(), $subtitle);
        $html .= '<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin-top:14px;">'
            . Email_Report_Html::bar_row(__('Top 3', 'thinkrank'), $counts['top_3'], $ranked, Email_Report_Html::PRIMARY)
            . Email_Report_Html::bar_row(__('Positions 4–10', 'thinkrank'), $counts['4_10'], $ranked, '#6e79ff')
            . Email_Report_Html::bar_row(__('Positions 11–50', 'thinkrank'), $counts['11_50'], $ranked, '#b3b9ff')
            . Email_Report_Html::bar_row(__('Positions 51–100', 'thinkrank'), $counts['51_100'], $ranked, '#dcdfff')
            . '</table>';
        if ($over_100 > 0) {
            $html .= Email_Report_Html::note(sprintf(
                /* translators: 1: queries ranking in the top 100, 2: queries ranking beyond position 100. */
                _n('%1$s rank in the top 100 and %2$s ranks beyond position 100.', '%1$s rank in the top 100 and %2$s rank beyond position 100.', $over_100, 'thinkrank'),
                number_format_i18n($ranked),
                number_format_i18n($over_100)
            ));
        }
        $html .= Email_Report_Html::note(sprintf(
            /* translators: %s: number of queries ranking in positions 1–10. */
            _n('%s query is on page one.', '%s queries are on page one.', $page_one, 'thinkrank'),
            number_format_i18n($page_one)
        ));
        $html .= Email_Report_Html::link(__('See all keywords', 'thinkrank'), Email_Report_Html::admin_link('analytics', 'keywords'));

        return $html;
    }

    public function fallback_html(): string {
        return '';
    }
}

```