Changeset 3793353

Timestamp:

11/09/2026 10:20:28 PM (41 hours ago)

Author:

businesskiai

Message:

Release 1.0.12

• Loading time: set a starting point after optimising the website – from then on only new measurements count, earlier values stay visible for comparison.
• Broken links: new "AI briefing" – a ready-made text for an AI chat that guides you step by step through repairing the links.

Location:

smartengin-analytics/trunk

Files:

• assets/css/admin.css (modified) (1 diff)
• assets/js/admin-tech.js (modified) (1 diff)
• help/en.php (modified) (2 diffs)
• includes/admin/class-sean-link-brief.php (added)
• includes/admin/class-sean-tech-tab.php (modified) (3 diffs)
• includes/class-sean-extras.php (modified) (6 diffs)
• includes/class-sean-link-check.php (modified) (3 diffs)
• includes/class-sean-vitals.php (modified) (5 diffs)
• readme.txt (modified) (2 diffs)
• smartengin-analytics.php (modified) (4 diffs)
• uninstall.php (modified) (1 diff)

smartengin-analytics/trunk/assets/css/admin.css

@@ -425 +425 @@
 /* 1.0.11: filter dropdowns never wider than the screen (long result names on phones). */
 .sean-filters select { max-width: 100%; }
+
+/* Loading time: starting point after an optimisation (1.0.12). */
+.sean-cwv-before { display: block; font-size: 12px; margin-top: 2px; }
+.sean-vitals-start { margin-top: 16px; padding: 12px 14px; border: 1px solid var(--sean-border); border-radius: 6px; background: #f8fafb; }
+.sean-vitals-start p { margin: 0 0 8px; }
+.sean-vitals-start p:last-child { margin-bottom: 0; }
+.sean-vitals-start--set { margin: 0 0 14px; border-color: #b9d8c6; background: #f3faf6; }
+.sean-vitals-start input[type="date"] { margin-left: 4px; }
+.sean-vitals-start__done { color: #1e8a4f; font-weight: 600; margin: 0 0 8px; }
+
+/* AI briefing for the broken links (1.0.12). */
+.sean-brief { margin-top: 14px; padding: 10px 14px; border: 1px solid #c9d6e2; border-radius: 6px; background: #f6f9fc; }
+.sean-brief summary { cursor: pointer; font-weight: 600; color: #11314a; }
+.sean-brief__buttons .button { margin: 0 6px 6px 0; }
+.sean-brief__text { width: 100%; font-size: 12px; line-height: 1.5; min-height: 260px; }

smartengin-analytics/trunk/assets/js/admin-tech.js

@@ -76 +76 @@
         }
 })();
+
+/* AI briefing for the broken links (1.0.12): built on request, then copy or save as a Markdown file. */
+(function () {
+        'use strict';
+        var btn = document.querySelector('[data-sean-brief]');
+        if (!btn || !window.fetch) { return; }
+        var cfg;
+        try { cfg = JSON.parse(btn.getAttribute('data-sean-brief')); } catch (e) { return; }
+        var box = document.getElementById('sean-brief-text');
+        var copy = document.getElementById('sean-brief-copy');
+        var save = document.getElementById('sean-brief-save');
+        var status = document.getElementById('sean-brief-status');
+        function say(t) { if (status) { status.textContent = t; } }
+
+        btn.addEventListener('click', function () {
+                btn.disabled = true;
+                say(cfg.busy);
+                var body = new URLSearchParams();
+                body.append('action', 'sean_link_brief');
+                body.append('_ajax_nonce', cfg.nonce);
+                fetch(cfg.url, { method: 'POST', credentials: 'same-origin', body: body })
+                        .then(function (r) { return r.json(); })
+                        .then(function (res) {
+                                if (!res || !res.success || !res.data || typeof res.data.text !== 'string') { throw new Error('brief'); }
+                                box.value = res.data.text;
+                                box.hidden = false;
+                                copy.hidden = false;
+                                save.hidden = false;
+                                btn.disabled = false;
+                                say(cfg.ready);
+                        })
+                        .catch(function () { btn.disabled = false; say(cfg.failed); });
+        });
+
+        if (copy) {
+                copy.addEventListener('click', function () {
+                        function done() { say(cfg.copied); }
+                        if (navigator.clipboard && navigator.clipboard.writeText) {
+                                navigator.clipboard.writeText(box.value).then(done, function () { box.select(); try { document.execCommand('copy'); } catch (e) {} done(); });
+                        } else {
+                                box.select();
+                                try { document.execCommand('copy'); } catch (e) {}
+                                done();
+                        }
+                });
+        }
+        if (save) {
+                save.addEventListener('click', function () {
+                        var blob = new Blob([box.value], { type: 'text/markdown;charset=utf-8' });
+                        var a = document.createElement('a');
+                        a.href = URL.createObjectURL(blob);
+                        a.download = cfg.file;
+                        document.body.appendChild(a);
+                        a.click();
+                        setTimeout(function () { URL.revokeObjectURL(a.href); a.remove(); }, 1000);
+                });
+        }
+})();

smartengin-analytics/trunk/help/en.php

@@ -89 +89 @@
                 '<p>The tab <a href="{technical}">Technical</a> shows what needs care on the website. Choose the period at the top, as in the dashboard.</p>
                 <ul>
-                        <li><strong>Broken links</strong> – links in your posts, pages and menus – with a block theme also in the site editor’s templates (the front page, for example), header and footer, patterns and navigation menus – that lead nowhere, with where they are, “Edit” and “Show on page” (opens the page exactly at this link, highlighted – handy when a page has several similar buttons; very old browsers just open the page). Buttons of blocks that build their content only when the page is shown (hero, tile, banner or the header button of a block plugin, for example) are found too. <strong>Elementor:</strong> pages and Elementor templates are read the way Elementor shows them to visitors – buttons, headings, icon lists, text fields, image links, embedded templates and shortcodes. “Edit” then opens the Elementor editor. With <strong>Elementor Pro</strong> also headers and footers from the Theme Builder, popups, global widgets, the “Template” widget, Pro widgets like Call to Action or Price Table, and dynamic links (“Post URL”, for example). Headers, footers and other Theme Builder templates without display conditions are seen by no visitor – their links are not checked; as soon as you set a condition, they are included. <strong>WooCommerce:</strong> products are checked with their description and short description, external (affiliate) products also with the address of their buy button – it often breaks when the other shop removes the product. Plus the descriptions of product categories and product tags. “Edit” opens the product or category. Note: with a block theme, WooCommerce’s default product template shows the short description as plain text – a link in it cannot be clicked there, but it is reported anyway (it is in the short description and shows as soon as the theme or template displays it). Customer reviews and comments are not checked. A jump mark without a page address (just “#contact”) in an Elementor template is not checked, as the template can be on different pages. Checked in the background, one portion an hour; every link again after a week, broken ones after a day. When many links are due (the first time, for example), the next portion follows every minute until all are checked. “Check now” collects all links of the website afresh (including one changed a minute ago) and checks every one right away while the page stays open, with a progress display. Links to a jump mark (for example …/#contact) are checked on the target page: if there is no element with that name (in Elementor: “CSS ID” or the widget “Menu Anchor”), the link counts as broken – it only opens the top of the page. A jump mark without a page address (just “#contact”) in the header or footer is on every page – which one is meant is unknown, so such links are not checked. The line under the heading is green (all fine), orange (unsure or not all checked yet) or red (broken links).
+                        <li><strong>Broken links</strong> – links in your posts, pages and menus – with a block theme also in the site editor’s templates (the front page, for example), header and footer, patterns and navigation menus – that lead nowhere, with where they are, “Edit” and “Show on page” (opens the page exactly at this link, highlighted – handy when a page has several similar buttons; very old browsers just open the page). Buttons of blocks that build their content only when the page is shown (hero, tile, banner or the header button of a block plugin, for example) are found too. <strong>Elementor:</strong> pages and Elementor templates are read the way Elementor shows them to visitors – buttons, headings, icon lists, text fields, image links, embedded templates and shortcodes. “Edit” then opens the Elementor editor. With <strong>Elementor Pro</strong> also headers and footers from the Theme Builder, popups, global widgets, the “Template” widget, Pro widgets like Call to Action or Price Table, and dynamic links (“Post URL”, for example). Headers, footers and other Theme Builder templates without display conditions are seen by no visitor – their links are not checked; as soon as you set a condition, they are included. <strong>WooCommerce:</strong> products are checked with their description and short description, external (affiliate) products also with the address of their buy button – it often breaks when the other shop removes the product. Plus the descriptions of product categories and product tags. “Edit” opens the product or category. Note: with a block theme, WooCommerce’s default product template shows the short description as plain text – a link in it cannot be clicked there, but it is reported anyway (it is in the short description and shows as soon as the theme or template displays it). Customer reviews and comments are not checked. A jump mark without a page address (just “#contact”) in an Elementor template is not checked, as the template can be on different pages. Checked in the background, one portion an hour; every link again after a week, broken ones after a day. When many links are due (the first time, for example), the next portion follows every minute until all are checked. “Check now” collects all links of the website afresh (including one changed a minute ago) and checks every one right away while the page stays open, with a progress display. Links to a jump mark (for example …/#contact) are checked on the target page: if there is no element with that name (in Elementor: “CSS ID” or the widget “Menu Anchor”), the link counts as broken – it only opens the top of the page. A jump mark without a page address (just “#contact”) in the header or footer is on every page – which one is meant is unknown, so such links are not checked. The line under the heading is green (all fine), orange (unsure or not all checked yet) or red (broken links). <strong>AI briefing:</strong> under the list, “AI briefing: repair the links together with an AI” → “Create briefing” makes a text for ChatGPT, Claude, Gemini or another AI chat – the task, how to guide you step by step, what each problem means, your website (WordPress, theme, page builder), every broken link with where it is and its “Edit” link, the jump marks that really exist on the target pages and your published pages as possible targets. “Copy text” or “Save as file”, paste it into the AI chat, and the AI walks you through the repairs one link at a time. Nothing is sent anywhere until you paste it yourself; the text contains addresses of your website, no visitor data.
                                 <ul>
                                         <li>Links to your own pages are checked in the database where possible (page published? file there?). A page that is a draft, private or in the trash makes the link broken.</li>
@@ -104 +104 @@
                                 </ul>
                                 Google judges each value by the <strong>75th percentile</strong>: at least 3 of 4 page views must be in the green range. The number shown is exactly that value – three quarters of the visits were this fast or faster. The bar below shows the shares good / needs improvement / poor. “Passed” means LCP, INP and CLS are all good. A verdict needs at least 20 measurements; before that the value is already shown in its colour, but marked “provisional” – it can still change a lot with the next visits.
+                                <strong>After optimising the website:</strong> under the values, “Website optimised?” sets a starting point (today – then only page views from this moment – or the day after your work). From then on only new measurements count: in this card, in “Loading time per page” (Pro), in the weekly and monthly report and in the alerts. Nothing is deleted – under each value “before” shows the 28 days before the starting point, so you see what the work brought. Empty the page cache first, so visitors get the optimised pages. “Remove starting point” makes all measurements count again.
                                 <br>Google’s own numbers (Search Console, PageSpeed Insights) come from Chrome users only, over 28 days, and can therefore differ. Measured at the visitor, with the reports the tracker sends anyway – no extra request, nothing stored in the browser. A page view counts once the visitor stays 10 seconds or leaves the page. Switch off: <a href="{settings}">Settings → Counting → Measure loading time</a>. With <strong>smartEngin Analytics Pro</strong> a list per page follows below the card.</li>
                         <li><strong>Pages not found (404)</strong> – addresses visitors opened that do not exist: old links, typos in a newsletter, renamed pages. Below them the websites linking to such addresses. Fix the link or set up a redirect (for example with the plugin Redirection). Probes for vulnerable files (/.env and the like) are not here but in the Security tab.</li>

smartengin-analytics/trunk/includes/admin/class-sean-tech-tab.php

@@ -25 +25 @@
                 add_action( 'admin_post_sean_link_check', array( __CLASS__, 'check_now' ) );
                 add_action( 'wp_ajax_sean_link_check_step', array( __CLASS__, 'ajax_step' ) );
+                add_action( 'admin_post_sean_vitals_start', array( __CLASS__, 'vitals_start' ) );
+        }
+
+        /**
+         * Set or remove the starting point of the loading time (admin-post, card "Loading time").
+         *
+         * @return void
+         */
+        public static function vitals_start() {
+                if ( ! current_user_can( SEAN_Admin::capability() ) ) {
+                        wp_die( esc_html__( 'You do not have permission to see this page.', 'smartengin-analytics' ) );
+                }
+                check_admin_referer( 'sean_vitals_start' );
+                if ( ! empty( $_POST['sean_remove'] ) ) {
+                        SEAN_Vitals::clear_start();
+                        $msg = 'vitals_start_removed';
+                } else {
+                        $today = wp_date( 'Y-m-d' );
+                        $day   = isset( $_POST['sean_start_day'] ) ? sanitize_text_field( wp_unslash( $_POST['sean_start_day'] ) ) : '';
+                        if ( ! preg_match( '/^(\d{4})-(\d{2})-(\d{2})$/', $day, $m ) || ! checkdate( (int) $m[2], (int) $m[3], (int) $m[1] ) || $day > $today || $day < '2020-01-01' ) {
+                                $day = $today;
+                        }
+                        // Today: from this moment (the measurements of the morning still show the old website);
+                        // an earlier day: from its start.
+                        $ts = $day === $today ? time() : ( new DateTimeImmutable( $day . ' 00:00:00', wp_timezone() ) )->getTimestamp();
+                        SEAN_Vitals::set_start( $ts );
+                        $msg = 'vitals_start';
+                }
+                // Back to the same period.
+                $args = array( 'sean_msg' => $msg );
+                foreach ( array( 'range', 'from', 'to', 'back' ) as $k ) {
+                        if ( isset( $_POST[ 'sean_r_' . $k ] ) ) {
+                                $args[ $k ] = sanitize_text_field( wp_unslash( $_POST[ 'sean_r_' . $k ] ) );
+                        }
+                }
+                wp_safe_redirect( SEAN_Admin::url( 'technical', $args ) . '#sean-vitals' );
+                exit;
         }
 
@@ -190 +227 @@
                 } else {
                         self::problem_table( $p );
+                        self::brief_box();
                 }
                 // Links that could not be checked (Pierre 10.10.2026: fold-out with a very discreet orange note).
@@ -201 +239 @@
                 }
                 echo '</div>';
+        }
+
+        /**
+         * "AI briefing": a text to copy into an AI chat that then guides through the repairs (1.0.12).
+         *
+         * @return void
+         */
+        private static function brief_box() {
+                $cfg = array(
+                        'url'    => admin_url( 'admin-ajax.php' ),
+                        'nonce'  => wp_create_nonce( 'sean_link_brief' ),
+                        'busy'   => __( 'Creating the briefing … (the pages with broken jump marks are read, this takes a few seconds)', 'smartengin-analytics' ),
+                        'ready'  => __( 'Ready. Copy the text and paste it into ChatGPT, Claude, Gemini or another AI chat.', 'smartengin-analytics' ),
+                        'failed' => __( 'The briefing could not be created. Try again in a moment.', 'smartengin-analytics' ),
+                        'copied' => __( 'Copied – now paste it into the AI chat.', 'smartengin-analytics' ),
+                        'file'   => 'ki-briefing-kaputte-links-' . wp_date( 'Y-m-d' ) . '.md',
+                );
+                echo '<details class="sean-brief" id="sean-brief"><summary>' . esc_html__( 'AI briefing: repair the links together with an AI', 'smartengin-analytics' ) . '</summary>';
+                echo '<p class="sean-hint">' . esc_html__( 'Creates a text for an AI chat (ChatGPT, Claude, Gemini …): the task, how to guide you step by step, what each problem means, your website (WordPress, theme, page builder), every broken link with where it is and the “Edit” link, the jump marks that exist on the target pages and your published pages as possible targets. The AI then walks you through the repairs one link at a time. The text contains addresses of your website, no visitor data – nothing is sent anywhere until you paste it yourself.', 'smartengin-analytics' ) . '</p>';
+                echo '<p class="sean-brief__buttons"><button type="button" class="button button-primary" data-sean-brief="' . esc_attr( wp_json_encode( $cfg ) ) . '">' . esc_html__( 'Create briefing', 'smartengin-analytics' ) . '</button> ';
+                echo '<button type="button" class="button" id="sean-brief-copy" hidden>' . esc_html__( 'Copy text', 'smartengin-analytics' ) . '</button> ';
+                echo '<button type="button" class="button" id="sean-brief-save" hidden>' . esc_html__( 'Save as file', 'smartengin-analytics' ) . '</button> ';
+                echo '<span class="sean-hint" id="sean-brief-status" aria-live="polite"></span></p>';
+                echo '<textarea id="sean-brief-text" class="large-text code sean-brief__text" rows="18" readonly hidden aria-label="' . esc_attr__( 'AI briefing', 'smartengin-analytics' ) . '"></textarea>';
+                echo '</details>';
         }
 

smartengin-analytics/trunk/includes/class-sean-extras.php

@@ -103 +103 @@
                         return;
                 }
-                $sum   = SEAN_Vitals::summary( $r['from'], $r['to'] );
+                $sum   = SEAN_Vitals::summary( $r['from'], $r['to'] ); // From the starting point on, when there is one.
+                $sday  = SEAN_Vitals::start_day();
+                $reach = '' !== $sday && $r['to'] >= $sday;
+                // "Before": the 28 days before the starting point, as they were (1.0.12).
+                $before = null;
+                if ( $reach ) {
+                        $before = SEAN_Vitals::summary( gmdate( 'Y-m-d', (int) strtotime( $sday . ' -28 days' ) ), gmdate( 'Y-m-d', (int) strtotime( $sday . ' -1 day' ) ), false );
+                        if ( SEAN_Vitals::count_all( $before ) < 1 ) {
+                                $before = null;
+                        }
+                }
                 $devs  = array(
                         'm' => __( 'Phone & tablet', 'smartengin-analytics' ),
@@ -125 +135 @@
                         echo '<p class="sean-hint">' . esc_html__( 'Measuring the loading time is switched off in the settings.', 'smartengin-analytics' ) . '</p>';
                 }
-                $total = 0;
-                foreach ( $sum as $per ) {
-                        foreach ( $per as $x ) {
-                                $total += $x['all'];
-                        }
+                self::start_note( $r, $sday, $reach );
+                $total = SEAN_Vitals::count_all( $sum );
+                $none  = $reach
+                        ? __( 'No measurements since the starting point yet. They appear as soon as visitors open pages – a page view counts once the visitor stays 10 seconds or leaves the page.', 'smartengin-analytics' )
+                        : __( 'No measurements in this period yet. They appear as soon as visitors open pages – a page view counts once the visitor stays 10 seconds or leaves the page.', 'smartengin-analytics' );
+                if ( 0 === $total && ! $before ) {
+                        echo '<p class="sean-empty">' . esc_html( $none ) . '</p>';
+                        if ( '' === $sday ) {
+                                self::start_form( $r );
+                        }
+                        echo '</div>';
+                        return;
                 }
                 if ( 0 === $total ) {
-                        echo '<p class="sean-empty">' . esc_html__( 'No measurements in this period yet. They appear as soon as visitors open pages – a page view counts once the visitor stays 10 seconds or leaves the page.', 'smartengin-analytics' ) . '</p></div>';
-                        return;
+                        echo '<p class="sean-empty">' . esc_html( $none ) . '</p>';
                 }
                 $pass = array();
@@ -150 +166 @@
                                 echo '<td data-dev="' . esc_attr( $devs[ $d ] ) . '">';
                                 if ( $x['all'] < 1 ) {
-                                        echo '<span class="sean-muted">' . esc_html__( 'not measured', 'smartengin-analytics' ) . '</span></td>';
+                                        echo '<span class="sean-muted">' . esc_html__( 'not measured', 'smartengin-analytics' ) . '</span>';
+                                        self::before_value( $before, $m, $d );
+                                        echo '</td>';
                                         continue;
                                 }
@@ -172 +190 @@
                                 /* translators: %s: number of measurements */
                                 echo esc_html( sprintf( _n( '%s measurement', '%s measurements', $x['all'], 'smartengin-analytics' ), number_format_i18n( $x['all'] ) ) ) . ' · ' . esc_html( $tip );
-                                echo '</span></td>';
+                                echo '</span>';
+                                self::before_value( $before, $m, $d );
+                                echo '</td>';
                         }
                         echo '</tr>';
@@ -183 +203 @@
                 );
                 foreach ( array_keys( $devs ) as $d ) {
-                        echo '<td data-dev="' . esc_attr( $devs[ $d ] ) . '"><span class="sean-cwv sean-cwv--' . esc_attr( $pass[ $d ] ) . '">' . esc_html( $pw[ $pass[ $d ] ] ) . '</span></td>';
+                        echo '<td data-dev="' . esc_attr( $devs[ $d ] ) . '"><span class="sean-cwv sean-cwv--' . esc_attr( $pass[ $d ] ) . '">' . esc_html( $pw[ $pass[ $d ] ] ) . '</span>';
+                        if ( $before ) {
+                                /* translators: %s: value before the starting point, e.g. "1.0 s" or "Not passed" */
+                                echo '<span class="sean-muted sean-cwv-before">' . esc_html( sprintf( __( 'before: %s', 'smartengin-analytics' ), $pw[ SEAN_Vitals::passed( $before, $d ) ] ) ) . '</span>';
+                        }
+                        echo '</td>';
                 }
                 echo '</tr></tbody></table></div>';
@@ -193 +218 @@
                  */
                 do_action( 'sean_tech_after_vitals', $r );
+                if ( '' === $sday ) {
+                        self::start_form( $r );
+                }
                 echo '</div>';
+        }
+
+        /**
+         * Under a value: the 75th percentile of the 28 days before the starting point.
+         *
+         * @param array|null $before Summary before the starting point, or null.
+         * @param string     $m      Metric.
+         * @param string     $d      Device.
+         * @return void
+         */
+        private static function before_value( $before, $m, $d ) {
+                if ( ! $before || $before[ $m ][ $d ]['all'] < 1 || null === $before[ $m ][ $d ]['p75'] ) {
+                        return;
+                }
+                /* translators: %s: value before the starting point, e.g. "1.0 s" or "Not passed" */
+                echo '<span class="sean-muted sean-cwv-before">' . esc_html( sprintf( __( 'before: %s', 'smartengin-analytics' ), SEAN_Vitals::format( $m, $before[ $m ][ $d ]['p75'] ) ) ) . '</span>';
+        }
+
+        /**
+         * Hidden fields that bring the chosen period back after a form.
+         *
+         * @param array $r Range.
+         * @return void
+         */
+        private static function range_fields( array $r ) {
+                $r = wp_parse_args(
+                        $r,
+                        array(
+                                'key'  => 'custom',
+                                'from' => wp_date( 'Y-m-d' ),
+                                'to'   => wp_date( 'Y-m-d' ),
+                                'back' => 0,
+                        )
+                );
+                foreach ( SEAN_Dashboard::range_args( $r ) as $k => $v ) {
+                        echo '<input type="hidden" name="sean_r_' . esc_attr( $k ) . '" value="' . esc_attr( (string) $v ) . '">';
+                }
+        }
+
+        /**
+         * Note above the values while a starting point is set, with the button to remove it.
+         *
+         * @param array  $r     Range.
+         * @param string $sday  Day of the starting point or ''.
+         * @param bool   $reach The period reaches the starting point.
+         * @return void
+         */
+        private static function start_note( array $r, $sday, $reach ) {
+                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display only.
+                $msg = isset( $_GET['sean_msg'] ) ? sanitize_key( wp_unslash( $_GET['sean_msg'] ) ) : '';
+                if ( 'vitals_start_removed' === $msg ) {
+                        echo '<p class="sean-vitals-start__done">' . esc_html__( 'Starting point removed – all measurements count again.', 'smartengin-analytics' ) . '</p>';
+                }
+                if ( '' === $sday ) {
+                        return;
+                }
+                $when = wp_date( get_option( 'date_format' ) . ', ' . get_option( 'time_format' ), SEAN_Vitals::start_ts() );
+                echo '<div class="sean-vitals-start sean-vitals-start--set">';
+                if ( 'vitals_start' === $msg ) {
+                        echo '<p class="sean-vitals-start__done">' . esc_html__( 'Starting point set.', 'smartengin-analytics' ) . '</p>';
+                }
+                if ( $reach ) {
+                        /* translators: %s: date and time of the starting point */
+                        echo '<p><strong>' . esc_html( sprintf( __( 'Measured afresh since %s (your starting point after the optimisation).', 'smartengin-analytics' ), $when ) ) . '</strong> ' . esc_html__( 'Measurements before it no longer count here, in the reports and in the alerts. Nothing was deleted: under each value, “before” shows the 28 days before the starting point for comparison.', 'smartengin-analytics' ) . '</p>';
+                } else {
+                        /* translators: %s: date and time of the starting point */
+                        echo '<p>' . esc_html( sprintf( __( 'This period lies before your starting point (%s) – these are the values from back then.', 'smartengin-analytics' ), $when ) ) . '</p>';
+                }
+                echo '<form method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" class="sean-inline-form">';
+                wp_nonce_field( 'sean_vitals_start' );
+                self::range_fields( $r );
+                echo '<input type="hidden" name="action" value="sean_vitals_start"><input type="hidden" name="sean_remove" value="1"><button class="button button-small">' . esc_html__( 'Remove starting point', 'smartengin-analytics' ) . '</button></form>';
+                echo '</div>';
+        }
+
+        /**
+         * Form "Website optimised? Measure afresh from …" (no starting point yet).
+         *
+         * @param array $r Range.
+         * @return void
+         */
+        private static function start_form( array $r ) {
+                $today = wp_date( 'Y-m-d' );
+                echo '<form method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" class="sean-vitals-start" id="sean-vitals-start">';
+                wp_nonce_field( 'sean_vitals_start' );
+                self::range_fields( $r );
+                echo '<input type="hidden" name="action" value="sean_vitals_start">';
+                echo '<p><strong>' . esc_html__( 'Website optimised?', 'smartengin-analytics' ) . '</strong> ' . esc_html__( 'Set a starting point: from then on only new measurements count – here, in the reports and in the alerts. Nothing is deleted; the values before it are shown next to the new ones for comparison. Choose today (then only page views from this moment count) or the day after your work was finished. Empty the page cache first, so visitors get the optimised pages.', 'smartengin-analytics' ) . '</p>';
+                echo '<p><label>' . esc_html__( 'Measure afresh from', 'smartengin-analytics' ) . ' <input type="date" name="sean_start_day" value="' . esc_attr( $today ) . '" max="' . esc_attr( $today ) . '"></label> <button class="button">' . esc_html__( 'Set starting point', 'smartengin-analytics' ) . '</button></p>';
+                echo '</form>';
         }
 

smartengin-analytics/trunk/includes/class-sean-link-check.php

@@ -559 +559 @@
                                                 'edit'  => (string) get_edit_term_link( $term ),
                                                 'view'  => is_wp_error( $term_link ) ? '' : self::view_url( (string) $term_link, (string) $r['text'], (string) $src_row['ctx'] ),
+                                                'ctx'   => (string) $src_row['ctx'],
                                         );
                                         continue;
@@ -574 +575 @@
                                                 'edit'  => admin_url( 'nav-menus.php' . ( ( ! is_wp_error( $menus ) && $menus ) ? '?action=edit&menu=' . (int) $menus[0]->term_id : '' ) ),
                                                 'view'  => self::view_url( home_url( '/' ), (string) $r['text'] ),
+                                                'ctx'   => '',
                                         );
                                 } else {
@@ -610 +612 @@
                                                 'edit'  => self::edit_url( $p ),
                                                 'view'  => self::view_url( self::place_page( $p ), (string) $r['text'], (string) $src_row['ctx'] ),
+                                                'ctx'   => (string) $src_row['ctx'],
                                         );
                                 }

smartengin-analytics/trunk/includes/class-sean-vitals.php

@@ -78 +78 @@
 
         /**
+         * Option: starting point "measure afresh from here" (Unix time), set after optimising the website
+         * (Pierre 09.11.2026). Nothing is deleted: the values before it stay and are shown for comparison.
+         */
+        const START_OPTION = 'sean_vitals_start';
+
+        /**
+         * Starting point (Unix time) or 0.
+         *
+         * @return int
+         */
+        public static function start_ts() {
+                return max( 0, (int) get_option( self::START_OPTION, 0 ) );
+        }
+
+        /**
+         * Day of the starting point (site time) or ''.
+         *
+         * @return string
+         */
+        public static function start_day() {
+                $t = self::start_ts();
+                return $t > 0 ? wp_date( 'Y-m-d', $t ) : '';
+        }
+
+        /**
+         * From which time page views of a day count: on the day of the starting point from the starting
+         * point on, every other day from 0 (all).
+         *
+         * @param string $day Day.
+         * @return int
+         */
+        public static function day_floor( $day ) {
+                $t = self::start_ts();
+                return ( $t > 0 && wp_date( 'Y-m-d', $t ) === $day ) ? $t : 0;
+        }
+
+        /**
+         * First day of a period that counts: never before the starting point (when the period reaches it).
+         *
+         * @param string $from Day.
+         * @param string $to   Day.
+         * @return string
+         */
+        public static function clamp( $from, $to ) {
+                $s = self::start_day();
+                if ( '' === $s || $to < $s || $from >= $s ) {
+                        return $from;
+                }
+                return $s;
+        }
+
+        /**
+         * Set the starting point. A day whose page views are still kept (today, yesterday) is folded again
+         * at once, so the measurements before the starting point leave that day.
+         *
+         * @param int $ts Unix time.
+         * @return void
+         */
+        public static function set_start( $ts ) {
+                $old = self::start_day();
+                update_option( self::START_OPTION, max( 1, (int) $ts ), false );
+                self::refold( self::start_day() );
+                if ( '' !== $old && $old !== self::start_day() ) {
+                        self::refold( $old );
+                }
+        }
+
+        /**
+         * Remove the starting point (all measurements count again).
+         *
+         * @return void
+         */
+        public static function clear_start() {
+                $old = self::start_day();
+                delete_option( self::START_OPTION );
+                if ( '' !== $old ) {
+                        self::refold( $old );
+                }
+        }
+
+        /**
+         * Fold a day again, but only while its page views are still kept (today and yesterday) –
+         * an older day would lose its figures.
+         *
+         * @param string $day Day.
+         * @return void
+         */
+        private static function refold( $day ) {
+                if ( '' === $day || $day < wp_date( 'Y-m-d', time() - DAY_IN_SECONDS ) || $day > wp_date( 'Y-m-d' ) ) {
+                        return;
+                }
+                SEAN_Aggregator::recompute_day( $day );
+        }
+
+        /**
          * Fold the measured page views of one day (called from SEAN_Aggregator::recompute_day()).
          *
@@ -88 +183 @@
                 $views    = SEAN_DB::views();
                 $sessions = SEAN_DB::sessions();
+                $floor    = self::day_floor( $day ); // On the day of the starting point only page views after it (1.0.12).
                 $wpdb->query( $wpdb->prepare( "DELETE FROM %i WHERE day = %s AND dim IN ('cwv','cwv_h')", $dim, $day ) ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.DirectDatabaseQuery
                 foreach ( array_keys( self::METRICS ) as $m ) {
@@ -97 +193 @@
                         $key  = $m . '|';
                         // phpcs:disable WordPress.DB.PreparedSQL.NotPrepared,WordPress.DB.DirectDatabaseQuery -- metric names and limits from the fixed list above, all as placeholders.
-                        $wpdb->query( $wpdb->prepare( "INSERT INTO %i (day, dim, k, visitors, pageviews, dur_sum, dur_n) SELECT %s, 'cwv', CONCAT(%s, " . self::DEVICE_SQL . ", '|', CASE WHEN v.%i <= %d THEN 'good' WHEN v.%i <= %d THEN 'ni' ELSE 'poor' END) AS kk, COUNT(*), COUNT(*), 0, 0" . ' FROM %i v JOIN %i s ON s.id = v.session_id WHERE v.day = %s AND v.%i IS NOT NULL GROUP BY kk', $dim, $day, $key, $m, $good, $m, $poor, $views, $sessions, $day, $m ) );
-                        $wpdb->query( $wpdb->prepare( "INSERT INTO %i (day, dim, k, visitors, pageviews, dur_sum, dur_n) SELECT %s, 'cwv_h', CONCAT(%s, " . self::DEVICE_SQL . ", '|', LEAST(%d, FLOOR(v.%i / %d))) AS kk, COUNT(*), COUNT(*), 0, 0" . ' FROM %i v JOIN %i s ON s.id = v.session_id WHERE v.day = %s AND v.%i IS NOT NULL GROUP BY kk', $dim, $day, $key, $bins, $m, $step, $views, $sessions, $day, $m ) );
+                        $wpdb->query( $wpdb->prepare( "INSERT INTO %i (day, dim, k, visitors, pageviews, dur_sum, dur_n) SELECT %s, 'cwv', CONCAT(%s, " . self::DEVICE_SQL . ", '|', CASE WHEN v.%i <= %d THEN 'good' WHEN v.%i <= %d THEN 'ni' ELSE 'poor' END) AS kk, COUNT(*), COUNT(*), 0, 0" . ' FROM %i v JOIN %i s ON s.id = v.session_id WHERE v.day = %s AND v.ts >= %d AND v.%i IS NOT NULL GROUP BY kk', $dim, $day, $key, $m, $good, $m, $poor, $views, $sessions, $day, $floor, $m ) );
+                        $wpdb->query( $wpdb->prepare( "INSERT INTO %i (day, dim, k, visitors, pageviews, dur_sum, dur_n) SELECT %s, 'cwv_h', CONCAT(%s, " . self::DEVICE_SQL . ", '|', LEAST(%d, FLOOR(v.%i / %d))) AS kk, COUNT(*), COUNT(*), 0, 0" . ' FROM %i v JOIN %i s ON s.id = v.session_id WHERE v.day = %s AND v.ts >= %d AND v.%i IS NOT NULL GROUP BY kk', $dim, $day, $key, $bins, $m, $step, $views, $sessions, $day, $floor, $m ) );
                         // phpcs:enable
                 }
@@ -141 +237 @@
          * Summary for a period: per metric and device the counts, shares, 75th percentile, verdict.
          *
-         * @param string $from Day.
-         * @param string $to   Day.
+         * @param string $from  Day.
+         * @param string $to    Day.
+         * @param bool   $clamp Only from the starting point on (default); false for "before" comparisons.
          * @return array<string,array<string,array>> metric => device (m|d) => data.
          */
-        public static function summary( $from, $to ) {
+        public static function summary( $from, $to, $clamp = true ) {
                 global $wpdb;
+                if ( $clamp ) {
+                        $from = self::clamp( $from, $to );
+                }
                 $dim = SEAN_DB::dim();
                 $out = array();
@@ -348 +448 @@
                         return '';
                 }
-                $prev  = self::summary( $pfrom, $pto );
+                $prev  = self::summary( $pfrom, $pto, false ); // The period before stays as it was – also before an optimisation.
                 $color = array(
                         'good' => '#1e8a4f',

smartengin-analytics/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.0.11
+Stable tag: 1.0.12
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -142 +142 @@
 == Changelog ==
 
+= 1.0.12 =
+* Loading time: after optimising the website, set a starting point – from then on only new measurements count, the values before stay for comparison.
+* Broken links: "AI briefing" – a text for an AI chat that guides you through repairing the links.
+
 = 1.0.11 =
 * Security log: requests from Stripe, Bingbot and Googlebot are recognised by the official address lists of their makers (shipped with the plugin, nothing is downloaded) and shown by name instead of "human or bot".

smartengin-analytics/trunk/smartengin-analytics.php

@@ -4 +4 @@
  * Plugin URI:        https://smartengin.de/smartengin-analytics/
  * Description:       Privacy-friendly visitor statistics that show where visitors come from – classic search, AI assistants, social media, other websites or direct – plus pages, clicks on buy buttons and links, countries, devices, live visitors and a security log (login attempts, probes, spam) that only records. No cookies, no stored IP addresses in the statistics.
- * Version:           1.0.11
+ * Version:           1.0.12
  * Requires at least: 6.8
  * Requires PHP:      7.4
@@ -19 +19 @@
 }
 
-define( 'SEAN_VERSION', '1.0.11' );
+define( 'SEAN_VERSION', '1.0.12' );
 define( 'SEAN_FILE', __FILE__ );
 define( 'SEAN_DIR', plugin_dir_path( __FILE__ ) );
@@ -87 +87 @@
                 require_once SEAN_DIR . 'includes/admin/class-sean-security-tab.php';
                 require_once SEAN_DIR . 'includes/admin/class-sean-tech-tab.php';
+                require_once SEAN_DIR . 'includes/admin/class-sean-link-brief.php';
                 require_once SEAN_DIR . 'includes/admin/class-sean-settings-page.php';
                 require_once SEAN_DIR . 'includes/admin/class-sean-export.php';
@@ -93 +94 @@
                 SEAN_Admin::init();
                 SEAN_Tech_Tab::init();
+                SEAN_Link_Brief::init();
         }
 

smartengin-analytics/trunk/uninstall.php

@@ -24 +24 @@
                 $wpdb->query( $wpdb->prepare( "DROP TABLE IF EXISTS %i", $sean_table ) ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.DirectDatabaseQuery
         }
-        foreach ( array( 'sean_settings', 'sean_db_version', 'sean_version', 'sean_activated_at', 'sean_buffer_key', 'sean_config_hash', 'sean_endpoint_ok', 'sean_endpoint_check', 'sean_geo', 'sean_last_aggregate', 'sean_links_cursor', 'sean_last_lines', 'sean_last_ms', 'sean_hourly_ms', 'sean_hourly_last', 'sean_link_check_force', 'sean_link_check_last', 'sean_report_last' ) as $sean_o ) {
+        foreach ( array( 'sean_settings', 'sean_db_version', 'sean_version', 'sean_activated_at', 'sean_buffer_key', 'sean_config_hash', 'sean_endpoint_ok', 'sean_endpoint_check', 'sean_geo', 'sean_last_aggregate', 'sean_links_cursor', 'sean_last_lines', 'sean_last_ms', 'sean_hourly_ms', 'sean_hourly_last', 'sean_link_check_force', 'sean_link_check_last', 'sean_report_last', 'sean_vitals_start' ) as $sean_o ) {
                 delete_option( $sean_o );
         }