Changeset 3798783

Timestamp:

11/12/2026 04:25:55 PM (less than one hour ago)

Author:

andrewmurray

Message:

3.1.7

• New (Pro): "Your Focus Keywords" on the WordPress dashboard widget shows each post's focus keyword with its Google position, a trend line and the change over time, using history SEOMedic already records daily (no extra Google requests). Keywords without a position yet are counted, never given a made-up number.

Location:

seomedic-seo-link-auditor/trunk

Files:

• admin/css/dashboard-widget.css (modified) (1 diff)
• changelog.txt (modified) (1 diff)
• includes/class-dashboard-widget.php (modified) (2 diffs)
• includes/class-seo-integration.php (modified) (1 diff)
• readme.txt (modified) (3 diffs)
• seomedic.php (modified) (3 diffs)
• uninstall.php (modified) (1 diff)

seomedic-seo-link-auditor/trunk/admin/css/dashboard-widget.css

@@ -627 +627 @@
         color: #646970;
 }
+
+/* Your Focus Keywords (3.1.7) — rows reuse .seomedic-mover-row */
+.seomedic-focus-list {
+        margin: 0 0 10px;
+}
+.seomedic-focus-list .seomedic-mover-query a {
+        color: inherit;
+        text-decoration: none;
+}
+.seomedic-focus-list .seomedic-mover-query a:hover {
+        color: #2271b1;
+        text-decoration: underline;
+}
+.seomedic-mover-pill.seomedic-mover-flat {
+        background: #f0f0f1;
+        color: #50575e;
+}

seomedic-seo-link-auditor/trunk/changelog.txt

@@ -6 +6 @@
 
 == Changelog ==
+
+= 3.1.7 =
+* Dashboard widget (Pro): "Your Focus Keywords", under Money Pages. `SEOMedic_GSC_Integration::get_focus_keyword_tracking()` matches each published post's effective focus keyword (Yoast, then Rank Math primary, then ours; `get_focus_keyword_posts()`, ≤ 500 posts, cached an hour in `seomedic_focus_kw_posts`, cleared by `update_focus_keyword()` and both uninstall paths) against the keyword snapshots the daily cron already records — no Google calls. Match is exact after `norm_keyword()` (case, entities, curly quotes, whitespace) or same content words in any order (stopwords mirror `utils/focusKeywordMatch.ts`); related queries and plurals never count; exact beats variant. Pairs in an older snapshot but not the latest are "dropped" and always get a row. Positions are trailing 90-day averages and the block says so; keywords with no data are counted as "no position yet" (below #30, under 10 impressions, or outside the top 500 pairs), never shown as a number. Harness tests/focus-keyword-tracking-harness.php (30).
 
 = 3.1.6 =

seomedic-seo-link-auditor/trunk/includes/class-dashboard-widget.php

@@ -427 +427 @@
                         <?php self::render_top_by_clicks( $top30, $top30_state ); ?>
                         <?php self::render_money_pages(); ?>
+                        <?php self::render_focus_keywords(); ?>
                         <?php self::render_movers( $movers ); ?>
 
@@ -996 +997 @@
         }
 
+        /**
+         * "Your Focus Keywords": each post's focus keyword with its Google position
+         * and trend, read from the keyword snapshots the daily cron already records
+         * (SEOMedic_GSC_Integration::get_focus_keyword_tracking()). No Google call.
+         *
+         * Positions are trailing 90-day averages, which the hint line says, and a
+         * keyword missing from the data is "no position yet", never a number: the
+         * snapshot also leaves out pairs under 10 impressions or outside the site's
+         * top 500, so "below #30" would overclaim.
+         * Renders nothing when no post has a focus keyword: no nagging.
+         */
+        private static function render_focus_keywords() {
+                if ( ! method_exists( 'SEOMedic_GSC_Integration', 'get_focus_keyword_tracking' ) ) {
+                        return;
+                }
+                $t = SEOMedic_GSC_Integration::get_focus_keyword_tracking();
+                if ( empty( $t['set'] ) ) {
+                        return;
+                }
+                $rows    = isset( $t['rows'] ) && is_array( $t['rows'] ) ? $t['rows'] : array();
+                $tracked = array_values( array_filter( $rows, function ( $r ) {
+                        return 'tracked' === $r['status'];
+                } ) );
+                $dropped = array_values( array_filter( $rows, function ( $r ) {
+                        return 'dropped' === $r['status'];
+                } ) );
+                // Up to two that fell out of the data always get a row: they are the
+                // ones worth noticing, and sorting by impressions would bury them.
+                $show_dropped = array_slice( $dropped, 0, 2 );
+                $show         = array_merge( array_slice( $tracked, 0, self::FOCUS_ROWS - count( $show_dropped ) ), $show_dropped );
+                $missing      = max( 0, (int) $t['set'] - count( $tracked ) - count( $dropped ) );
+                ?>
+                <h4 class="seomedic-widget-section-title">
+                        <?php esc_html_e( 'Your Focus Keywords', 'seomedic-seo-link-auditor' ); ?>
+                        <span class="seomedic-money-count">
+                                <?php
+                                echo esc_html( sprintf(
+                                        /* translators: 1: posts with a focus keyword, 2: how many of those have position data */
+                                        __( '%1$s set · %2$s with a position', 'seomedic-seo-link-auditor' ),
+                                        number_format_i18n( (int) $t['set'] ),
+                                        number_format_i18n( count( $tracked ) )
+                                ) );
+                                ?>
+                        </span>
+                </h4>
+                <?php if ( '' === $t['asOf'] ) : ?>
+                        <p class="seomedic-movers-empty">
+                                <?php esc_html_e( 'Positions appear here after the first daily sync with Google.', 'seomedic-seo-link-auditor' ); ?>
+                        </p>
+                        <?php
+                        return;
+                endif;
+                ?>
+                <p class="seomedic-widget-hint">
+                        <?php esc_html_e( 'Average Google position over the last 90 days, recorded daily, for the keyword each post targets.', 'seomedic-seo-link-auditor' ); ?>
+                </p>
+                <?php if ( empty( $show ) ) : ?>
+                        <p class="seomedic-movers-empty">
+                                <?php esc_html_e( 'No position for these keywords yet. Google shows their pages for them below #30, fewer than 10 times, or not at all.', 'seomedic-seo-link-auditor' ); ?>
+                        </p>
+                <?php else : ?>
+                        <div class="seomedic-focus-list">
+                                <?php foreach ( $show as $r ) : ?>
+                                        <?php self::render_focus_row( $r ); ?>
+                                <?php endforeach; ?>
+                        </div>
+                <?php endif; ?>
+                <?php if ( $missing > 0 && ! empty( $show ) ) : ?>
+                        <p class="seomedic-fresh-more">
+                                <?php
+                                echo esc_html( sprintf(
+                                        /* translators: %s: number of focus keywords */
+                                        _n(
+                                                '%s other focus keyword has no position yet (below #30, fewer than 10 impressions, or not shown at all).',
+                                                '%s other focus keywords have no position yet (below #30, fewer than 10 impressions, or not shown at all).',
+                                                $missing,
+                                                'seomedic-seo-link-auditor'
+                                        ),
+                                        number_format_i18n( $missing )
+                                ) );
+                                ?>
+                        </p>
+                <?php endif; ?>
+                <?php
+        }
+
+        /** Rows in "Your Focus Keywords". */
+        const FOCUS_ROWS = 6;
+
+        /**
+         * One focus-keyword row: keyword (links to the editor), sparkline, position
+         * and change. Shares the Biggest Movers row styles.
+         *
+         * @param array $r One row from get_focus_keyword_tracking().
+         */
+        private static function render_focus_row( $r ) {
+                $id      = (int) $r['postId'];
+                $title   = html_entity_decode( get_the_title( $id ), ENT_QUOTES | ENT_HTML5, 'UTF-8' );
+                $keyword = html_entity_decode( (string) $r['keyword'], ENT_QUOTES | ENT_HTML5, 'UTF-8' );
+                $edit    = get_edit_post_link( $id, 'raw' );
+                $delta   = isset( $r['delta'] ) ? $r['delta'] : null;
+                $points  = isset( $r['points'] ) && is_array( $r['points'] ) ? $r['points'] : array();
+                $dropped = 'dropped' === $r['status'];
+
+                $tip = $title;
+                if ( 'variant' === $r['match'] ) {
+                        /* translators: %s: the Google search the position belongs to */
+                        $tip .= ' — ' . sprintf( __( 'Google search “%s” (same words, different order)', 'seomedic-seo-link-auditor' ), $r['query'] );
+                }
+                if ( $dropped ) {
+                        /* translators: 1: last position, 2: date */
+                        $tip .= ' — ' . sprintf( __( 'Dropped out of the data: now below #30 or under 10 impressions. Last seen at #%1$s on %2$s.', 'seomedic-seo-link-auditor' ), number_format_i18n( (float) $r['position'], 1 ), $r['lastSeen'] );
+                } elseif ( null !== $delta ) {
+                        /* translators: %s: date the history starts */
+                        $tip .= ' — ' . sprintf( __( 'Change since %s', 'seomedic-seo-link-auditor' ), $r['since'] );
+                }
+
+                // Lower position number = higher in Google, so a negative delta is up.
+                if ( $dropped ) {
+                        $dir   = 'down';
+                        $pill  = __( 'dropped', 'seomedic-seo-link-auditor' );
+                        $color = '#d63638';
+                } elseif ( null === $delta ) {
+                        $dir   = 'flat';
+                        $pill  = __( 'new', 'seomedic-seo-link-auditor' );
+                        $color = '#8c8f94';
+                } elseif ( abs( $delta ) < 0.5 ) {
+                        $dir   = 'flat';
+                        $pill  = '=';
+                        $color = '#8c8f94';
+                } else {
+                        $dir   = $delta < 0 ? 'up' : 'down';
+                        $pill  = ( $delta < 0 ? '▲ ' : '▼ ' ) . number_format_i18n( abs( $delta ), 1 );
+                        $color = $delta < 0 ? '#00a32a' : '#d63638';
+                }
+                ?>
+                <div class="seomedic-mover-row" title="<?php echo esc_attr( $tip ); ?>">
+                        <span class="seomedic-mover-query">
+                                <?php if ( $edit ) : ?>
+                                        <a href="<?php echo esc_url( $edit ); ?>"><?php echo esc_html( $keyword ); ?></a>
+                                <?php else : ?>
+                                        <?php echo esc_html( $keyword ); ?>
+                                <?php endif; ?>
+                        </span>
+                        <span class="seomedic-mover-spark"><?php echo self::position_sparkline_svg( $points, $color ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_kses'd inside the helper. ?></span>
+                        <span class="seomedic-mover-pos"><?php echo esc_html( $dropped ? '—' : '#' . number_format_i18n( round( (float) $r['position'] ) ) ); ?></span>
+                        <span class="seomedic-mover-pill seomedic-mover-<?php echo esc_attr( $dir ); ?>"><?php echo esc_html( $pill ); ?></span>
+                </div>
+                <?php
+        }
+
         private static function render_movers( $movers ) {
                 $gainers  = isset( $movers['gainers'] )  ? $movers['gainers']  : array();

seomedic-seo-link-auditor/trunk/includes/class-seo-integration.php

@@ -215 +215 @@
                 // as updated whenever we made it to the meta-update line above.
                 $changes['updated'] = true;
+                // The dashboard widget's focus-keyword list caches post → keyword for an
+                // hour (SEOMedic_GSC_Integration::TRANSIENT_FOCUS_KEYWORDS, Pro). Named
+                // as a string so this core file never touches the Pro class.
+                delete_transient( 'seomedic_focus_kw_posts' );
                 return $changes;
         }

seomedic-seo-link-auditor/trunk/readme.txt

@@ -5 +5 @@
 Requires at least: 5.8
 Tested up to: 7.1
-Stable tag: 3.1.6
+Stable tag: 3.1.7
 Requires PHP: 7.4
 License: GPLv2 or later
@@ -206 +206 @@
 with the plugin in changelog.txt.
 
+= 3.1.7 =
+* New (Pro): "Your Focus Keywords" on the WordPress dashboard widget shows each post's focus keyword with its Google position, a trend line and the change over time, using history SEOMedic already records daily (no extra Google requests). Keywords without a position yet are counted, never given a made-up number.
+
 = 3.1.6 =
 * Improved (Pro): the dashboard widget's Top 10 pages by clicks and Just Started Ranking now load by themselves a moment after the WordPress dashboard opens, instead of asking you to press Sync.
@@ -214 +217 @@
 * New (Pro): the editor sidebar shows whether Google has indexed the post, its clicks and impressions, and the top searches it's found for, as soon as you open it (no Analyze needed), with a Check button. For an old post Google never indexed (or looked at and declined), it suggests redirecting it and lets you pick the post to redirect to right there.
 
-= 3.1.4 =
-* Improved: the Redirects list explains what each fix changes, and flags old archive pages (like /category/news/page/4) that redirect to a single post, with a one-click option to point them at the archive instead.
-
 == Upgrade Notice ==
+
+= 3.1.7 =
+Your Focus Keywords on the dashboard widget: each post's focus keyword with its Google position and trend.
 
 = 3.1.6 =

seomedic-seo-link-auditor/trunk/seomedic.php

@@ -4 +4 @@
  * Plugin URI: https://getseomedic.com/
  * Description: Audit broken links, fix missing meta descriptions, detect H1 issues, repair YouTube embeds, audit Schema.org markup, and clean up internal linking — all from one dashboard.
- * Version: 3.1.6
+ * Version: 3.1.7
  * Author: Andrew Murray
  * Author URI: https://getseomedic.com
@@ -174 +174 @@
                 delete_transient( 'seomedic_dataforseo_balance' );
                 delete_transient( 'seomedic_serp_last_raw' );
+                delete_transient( 'seomedic_focus_kw_posts' );
                 delete_option( 'seomedic_seo_tasklist' );
                 delete_metadata( 'user', 0, 'seomedic_review_notice', '', true );
@@ -192 +193 @@
  */
 if ( ! defined( 'SEOMEDIC_VERSION' ) ) {
-        define( 'SEOMEDIC_VERSION', '3.1.6' );
+        define( 'SEOMEDIC_VERSION', '3.1.7' );
         define( 'SEOMEDIC_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
         define( 'SEOMEDIC_PLUGIN_URL', plugin_dir_url( __FILE__ ) );

seomedic-seo-link-auditor/trunk/uninstall.php

@@ -119 +119 @@
 delete_transient( 'seomedic_mixed_content_audit' );
 delete_transient( 'seomedic_post_index' );
+delete_transient( 'seomedic_focus_kw_posts' );
 
 // Per-user dismissal meta for the upgrade + review-request notices.