Changeset 3739629

Timestamp:

10/11/2026 02:52:48 PM (5 weeks ago)

Author:

enetrato

Message:

Release VeloIMG 0.9.7

Location:

veloimg

Files:

• assets/screenshot-1-ru.png (added)
• assets/screenshot-1.png (modified) ( previous)
• assets/screenshot-2-ru.png (added)
• assets/screenshot-2.png (modified) ( previous)
• assets/screenshot-3-ru.png (added)
• assets/screenshot-3.png (modified) ( previous)
• assets/screenshot-4-ru.png (added)
• assets/screenshot-4.png (modified) ( previous)
• assets/screenshot-5-ru.png (added)
• assets/screenshot-5.png (modified) ( previous)
• trunk/assets/css/admin-base.css (modified) (61 diffs)
• trunk/assets/js/admin-avif.js (modified) (29 diffs)
• trunk/assets/js/admin-navigation.js (added)
• trunk/assets/js/admin.js (modified) (41 diffs)
• trunk/assets/js/folder-statistics-runtime.js (modified) (2 diffs)
• trunk/languages/veloimg-ru_RU.mo (modified) ( previous)
• trunk/languages/veloimg-ru_RU.po (modified) (2 diffs)
• trunk/readme.txt (modified) (6 diffs)
• trunk/src/Admin/OptimizationSummary.php (modified) (4 diffs)
• trunk/src/Admin/SettingsPage.php (modified) (35 diffs)
• trunk/src/Conversion/UploadsPhysicalScopeSummary.php (modified) (7 diffs)
• trunk/src/Conversion/WebpManifestMassOrchestrator.php (modified) (2 diffs)
• trunk/src/Conversion/WebpRetry.php (added)
• trunk/src/Database/WebpRunStatistics.php (modified) (2 diffs)
• trunk/src/Delivery/FormatStrategy.php (modified) (1 diff)
• trunk/src/Delivery/Resolver.php (modified) (6 diffs)
• trunk/src/Lifecycle/Activate.php (modified) (1 diff)
• trunk/src/Queue/Worker.php (modified) (3 diffs)
• trunk/templates/admin-avif.php (modified) (12 diffs)
• trunk/templates/admin-dashboard.php (modified) (13 diffs)
• trunk/templates/admin-diagnostics.php (added)
• trunk/templates/admin-home.php (modified) (4 diffs)
• trunk/templates/generation-concurrency.php (added)
• trunk/templates/optimization-home-result.php (modified) (1 diff)
• trunk/templates/webp-retry.php (added)
• trunk/veloimg.php (modified) (2 diffs)

veloimg/trunk/assets/css/admin-base.css

@@ -1 +1 @@
 /*
- * VeloIMG Admin UI - WordPress style base skin.
+ * VeloIMG Admin UI - approved warm WordPress-native skin.
  * This is the single admin UI stylesheet used by the plugin.
  */
 
 .wrap.velowp{
-        --vw-border: #c3c4c7;
-        --vw-border-soft: #dcdcde;
-        --vw-surface: #fff;
-        --vw-surface-muted: #f6f7f7;
-        --vw-text: #1d2327;
-        --vw-muted: #646970;
+        --vw-page: #f3f0eb;
+        --vw-border: #ded8d0;
+        --vw-border-soft: #e6e0d8;
+        --vw-control-border: #aaa39a;
+        --vw-surface: #fffdfa;
+        --vw-surface-muted: #f7f4ef;
+        --vw-accent: #a65338;
+        --vw-accent-bg: #f5efe8;
+        --vw-accent-bg-open: #eee5dc;
+        --vw-text: #302d29;
+        --vw-muted: #615950;
         --vw-primary: #2271b1;
         --vw-primary-dark: #135e96;
-        --vw-success: #00a32a;
-        --vw-success-bg: #edfaef;
-        --vw-warning: #dba617;
-        --vw-warning-bg: #fcf9e8;
-        --vw-danger: #d63638;
-        --vw-danger-bg: #fcf0f1;
-        --vw-info-bg: #edf6fc;
+        --vw-success: #309454;
+        --vw-success-text: #206344;
+        --vw-success-border: #c3dacb;
+        --vw-success-bg: #edf5ef;
+        --vw-warning: #b77a1c;
+        --vw-warning-text: #755016;
+        --vw-warning-border: #e6d4af;
+        --vw-warning-bg: #fcf3de;
+        --vw-danger: #b53f42;
+        --vw-danger-text: #853638;
+        --vw-danger-border: #e9c7c8;
+        --vw-danger-bg: #fbefef;
+        --vw-info-border: #cadce7;
+        --vw-info-bg: #edf4f9;
+        --vw-radius: 4px;
+        --vw-panel-radius: 6px;
         color: var(--vw-text);
+        font-size: 14px;
+        line-height: 1.6;
         max-width: 1280px;
+}
+
+.wrap.velowp p,
+.wrap.velowp .description{
+        font-size: 14px;
+        line-height: 1.6;
 }
 
@@ -34 +56 @@
 }
 
+.velowp-concurrency-warning{
+        position: relative;
+        margin: 12px 0;
+        padding: 12px 44px 12px 16px;
+        border-radius: var(--vw-radius);
+        background: var(--vw-warning-bg);
+}
+.velowp-concurrency-dismiss{
+        position: absolute;
+        top: 6px;
+        right: 6px;
+        width: 32px;
+        height: 32px;
+        padding: 6px;
+        border: 0;
+        border-radius: var(--vw-radius);
+        background: transparent;
+        color: var(--vw-warning-text);
+        cursor: pointer;
+}
+.velowp-concurrency-dismiss:hover{
+        background: var(--vw-warning-border);
+}
+.velowp-concurrency-dismiss:focus-visible{
+        outline: 2px solid var(--vw-primary);
+        outline-offset: 1px;
+}
+.velowp-concurrency-warning[hidden]{
+        display: none;
+}
+
+/* WordPress marks JS-enabled pages before footer scripts load. Keep the
+   server-selected panel stable on the first paint; no-JS retains all sections. */
+body.js .velowp-shell:not(.velowp-shell--js) .velowp-panel,
 .velowp-shell--js .velowp-panel{
         display: none;
 }
 
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="mass"] .velowp-panel[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="setup"] .velowp-panel[data-panel="setup"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="mass"] .velowp-panel[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="setup"] .velowp-panel[data-panel="setup"],
 .velowp-shell--js .velowp-panel.is-active{
         display: block;
@@ -47 +107 @@
         justify-content: space-between;
         gap: 16px;
-        margin: 16px 0 0;
-        padding: 0 0 14px;
-        border-bottom: 1px solid var(--vw-border);
+        margin: 24px 0 0;
 }
 
@@ -72 +130 @@
 .wrap.velowp img.velowp-topbar__logo--wide,
 .velowp-topbar__logo--wide{
-        width: min(110px, 45vw);
+        width: min(148px, 45vw);
         height: auto;
-        max-width: min(110px, 45vw);
-        max-height: 30px;
+        max-width: min(148px, 45vw);
+        max-height: 40px;
 }
 
@@ -83 +141 @@
         justify-content: space-between;
         gap: 24px;
-        max-width: 1120px;
         margin: 24px 0;
 }
@@ -99 +156 @@
 
 .velowp-home-logo__image--wide{
-        max-width: 160px;
+        max-width: 220px;
 }
 
@@ -124 +181 @@
         padding: 3px 8px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface-muted);
         color: var(--vw-text);
         font-size: 12px;
         font-weight: 600;
-        line-height: 1.7;
+        line-height: 1.6;
 }
 
 .velowp-pill--ok{
-        border-color: #b8e6c1;
+        border-color: var(--vw-success-border);
         background: var(--vw-success-bg);
-        color: #0a4b1f;
+        color: var(--vw-success-text);
 }
 
 .velowp-pill--bad{
-        border-color: #f0c5c7;
+        border-color: var(--vw-danger-border);
         background: var(--vw-danger-bg);
-        color: #8a2424;
+        color: var(--vw-danger-text);
 }
 
@@ -147 +205 @@
         flex-wrap: wrap;
         gap: 0;
-        margin: 18px 0 0;
-        padding-top: 9px;
+        margin: 24px 0 0;
         border-bottom: 1px solid var(--vw-border);
 }
@@ -156 +213 @@
         appearance: none;
         border: 1px solid var(--vw-border);
-        background: #f0f0f1;
-        color: #2c3338;
+        background: var(--vw-accent-bg);
+        color: var(--vw-text);
         cursor: pointer;
         font-size: 14px;
+        font-family: inherit;
         line-height: 1.71428571;
         text-decoration: none;
@@ -166 +224 @@
 .velowp-nav__btn{
         margin: 0 4px -1px 0;
-        padding: 5px 10px;
+        padding: 8px 14px;
+        min-height: 40px;
+        border-radius: var(--vw-radius) var(--vw-radius) 0 0;
         border-bottom: 1px solid var(--vw-border);
 }
 
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="mass"] .velowp-nav__btn[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="setup"] .velowp-nav__btn[data-panel="setup"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="mass"] .velowp-nav__btn[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="setup"] .velowp-nav__btn[data-panel="setup"],
 .velowp-nav__btn.is-active{
         border-bottom-color: var(--vw-surface);
         background: var(--vw-surface);
-        color: #000;
+        color: var(--vw-primary);
+        font-weight: 600;
+        box-shadow: inset 0 2px 0 var(--vw-primary);
+}
+
+.velowp-nav__btn:hover,
+.velowp-topbtn:hover{
+        color: var(--vw-primary-dark);
+}
+
+.velowp-nav__btn:focus-visible,
+.velowp-topbtn:focus-visible{
+        outline: 2px solid var(--vw-primary);
+        outline-offset: 2px;
 }
 
 .velowp-topbtn{
-        padding: 4px 10px;
+        padding: 6px 12px;
+        border-radius: var(--vw-radius);
 }
 
@@ -183 +261 @@
 .velowp-quick-card,
 .velowp-mass-card{
+        min-width: 0;
         margin: 16px 0 0;
-        padding: 16px;
+        padding: 24px;
         border: 1px solid var(--vw-border);
+        border-radius: var(--vw-panel-radius);
         background: var(--vw-surface);
-        box-shadow: 0 1px 1px rgba(0,0,0,.04);
+        box-shadow: none;
 }
 
 .velowp-card--glass{
         background: var(--vw-surface);
+}
+
+.velowp-home-accordion{
+        padding: 0;
+}
+
+.velowp-home-accordion > summary{
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 12px;
+        padding: 16px 20px;
+        cursor: pointer;
+        list-style: none;
+}
+
+.velowp-home-accordion > summary:hover{
+        background: var(--vw-surface-muted);
+}
+
+.velowp-home-accordion[open] > summary{
+        border-bottom: 1px solid var(--vw-border-soft);
+}
+
+.velowp-home-accordion > summary::-webkit-details-marker{
+        display: none;
+}
+
+.velowp-home-accordion > summary .velowp-quick-card__title{
+        margin: 0;
+}
+
+.velowp-home-accordion > summary::after{
+        content: '';
+        flex: 0 0 8px;
+        height: 8px;
+        border-right: 2px solid currentColor;
+        border-bottom: 2px solid currentColor;
+        transform: rotate(45deg);
+}
+
+.velowp-home-accordion[open] > summary::after{
+        transform: rotate(225deg);
+}
+
+.velowp-home-accordion > summary:focus-visible{
+        outline: 2px solid var(--vw-primary);
+        outline-offset: -2px;
+}
+
+.velowp-home-accordion__body{
+        padding: 20px;
 }
 
@@ -204 +336 @@
 
 .velowp-mass-grid--top{
-        grid-template-columns: minmax(0, 1.35fr) minmax(280px, .65fr);
+        grid-template-columns: minmax(0, 1.8fr) minmax(280px, 1fr);
+}
+
+.velowp-panel[data-panel="setup"] > .velowp-grid{
+        grid-template-columns: minmax(0, 1.5fr) minmax(280px, 1fr);
 }
 
 .velowp-mass-grid--bottom{
         grid-template-columns: 1fr;
+}
+
+.velowp-mass-main-column{
+        min-width: 0;
+}
+
+.velowp-webp-retry-controls{
+        display: flex;
+        align-items: flex-end;
+        gap: 16px;
+        flex-wrap: wrap;
+}
+
+.velowp-webp-retry-controls label{
+        display: block;
+        margin-bottom: 8px;
+        font-weight: 600;
+}
+
+.velowp-webp-retry-quality{
+        flex: 1 1 200px;
+}
+
+.velowp-webp-retry-quality input{
+        width: 100%;
+        margin: 0;
+}
+
+.velowp-webp-retry-engine select{
+        min-width: 140px;
+        max-width: 100%;
 }
 
@@ -220 +387 @@
 
 .velowp-h2{
-        font-size: 20px;
+        font-size: 22px;
         font-weight: 600;
 }
@@ -227 +394 @@
 .velowp-h3,
 .velowp-quick-card__title{
-        font-size: 16px;
+        font-size: 18px;
         font-weight: 600;
 }
@@ -256 +423 @@
 .wrap.velowp input[type="url"]{
         max-width: 100%;
+        min-height: 38px;
+        padding: 6px 10px;
+        border-color: var(--vw-control-border);
+        border-radius: var(--vw-radius);
+        font-size: 14px;
+        line-height: 1.6;
+}
+
+.wrap.velowp select{
+        padding-right: 30px;
+}
+
+.wrap.velowp input[type="range"],
+.wrap.velowp input[type="checkbox"],
+.wrap.velowp input[type="radio"]{
+        accent-color: var(--vw-primary);
+}
+
+.wrap.velowp input[type="checkbox"],
+.wrap.velowp input[type="radio"]{
+        flex-shrink: 0;
 }
 
@@ -263 +451 @@
 
 .wrap.velowp .velowp-home-card{
-        max-width: 1120px;
+        max-width: none;
+        padding: 24px;
+        border-color: var(--vw-border);
+        border-radius: var(--vw-panel-radius);
+        background: var(--vw-surface);
+        box-shadow: none;
+}
+
+.velowp-home-card > h2{
+        margin: 0 0 12px;
+        font-size: 22px;
+        line-height: 1.3;
 }
 
 .velowp-home-status-grid{
         display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-        gap: 12px;
-        margin: 18px 0;
+        grid-template-columns: repeat(4, minmax(0, 1fr));
+        gap: 16px;
+        margin: 24px 0 20px;
 }
 
@@ -276 +475 @@
         min-width: 0;
         min-height: 150px;
-        padding: 14px;
+        padding: 16px;
         border: 1px solid var(--vw-border);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
-        box-shadow: 0 1px 1px rgba(0,0,0,.04);
-}
-
-.velowp-home-status-card.is-success{
-        border-color: #b8e6c1;
-        background: linear-gradient(0deg, var(--vw-success-bg), var(--vw-surface) 58%);
-}
-
-.velowp-home-status-card.is-warning{
-        border-color: #ead483;
-        background: linear-gradient(0deg, var(--vw-warning-bg), var(--vw-surface) 58%);
-}
-
-.velowp-home-status-card.is-error{
-        border-color: #f0c5c7;
-        background: linear-gradient(0deg, var(--vw-danger-bg), var(--vw-surface) 58%);
+        box-shadow: none;
 }
 
@@ -307 +492 @@
 
 .velowp-home-status-card__head strong{
-        flex: 1 1 120px;
+        flex: 1 1 100px;
         min-width: 0;
-        font-size: 14px;
+        font-size: 16px;
         line-height: 1.35;
 }
@@ -334 +519 @@
 
 .velowp-home-strategy-value.is-success{
-        border-color: #b8e6c1;
+        border-color: var(--vw-success-border);
         background: var(--vw-success-bg);
-        color: #0a4b1f;
+        color: var(--vw-success-text);
 }
 
 .velowp-home-strategy-value.is-warning{
-        border-color: #ead483;
+        border-color: var(--vw-warning-border);
         background: var(--vw-warning-bg);
-        color: #5c4300;
+        color: var(--vw-warning-text);
 }
 
 .velowp-home-strategy-value.is-error{
-        border-color: #f0c5c7;
+        border-color: var(--vw-danger-border);
         background: var(--vw-danger-bg);
-        color: #8a2424;
+        color: var(--vw-danger-text);
+}
+
+.wrap.velowp select.velowp-home-badge-select{
+        appearance: auto;
+        background-image: none;
+        min-height: 38px;
+        max-width: 100%;
+        width: 100%;
+        padding: 6px 24px 6px 10px;
+        border-color: var(--vw-border);
+        border-radius: var(--vw-radius);
+        background-color: var(--vw-surface-muted);
+        color: var(--vw-text);
+        font-size: 14px;
+        font-weight: 400;
+        line-height: 1.6;
+        cursor: pointer;
+        text-align: left;
+}
+
+.velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head{
+        flex-direction: column;
+        align-items: stretch;
+}
+
+.velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head strong{
+        flex: none;
+}
+
+.velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head,
+.velowp-home-status-card--strategy .velowp-home-status-card__head{
+        min-height: 0;
+        margin-bottom: 10px;
+}
+
+.velowp-home-generation-result{
+        margin-top: 16px;
+        padding-top: 12px;
+        border-top: 1px solid var(--vw-border-soft);
+}
+
+.velowp-home-generation-result [data-velowp-home-summary="saved"] strong{
+        display: block;
+        margin-top: 4px;
+        color: var(--vw-text);
+        font-size: 34px;
+        font-weight: 600;
+        line-height: 1.2;
+}
+
+.wrap.velowp select.velowp-home-strategy-value{
+        width: 100%;
 }
 
@@ -355 +592 @@
 }
 
+.velowp-diagnostics-tests{
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 16px;
+}
+
+.velowp-diagnostics-tests > form{
+        min-width: 0;
+        margin-top: 0;
+        padding: 16px;
+}
+
+.velowp-bypass-copy{
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        gap: 8px;
+}
+
+.velowp-bypass-copy input.regular-text{
+        max-width: 100%;
+        cursor: pointer;
+}
+
+@media (max-width: 782px){
+        .velowp-diagnostics-tests{ grid-template-columns: minmax(0, 1fr); }
+}
+
 .velowp-help-page{
-        max-width: 1120px;
+        max-width: 1280px;
 }
 
@@ -368 +633 @@
 .velowp-help-grid{
         display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+        grid-template-columns: repeat(5, minmax(0, 1fr));
         gap: 12px;
-        margin: 18px 0;
+        margin: 24px 0;
 }
 
 .velowp-help-card{
-        padding: 14px;
+        min-width: 0;
+        padding: 16px;
         border: 1px solid var(--vw-border);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
-        box-shadow: 0 1px 1px rgba(0,0,0,.04);
+        box-shadow: none;
 }
 
 .velowp-help-card h2{
         margin: 0 0 8px;
-        font-size: 14px;
+        font-size: 16px;
         line-height: 1.35;
 }
@@ -392 +659 @@
 
 .velowp-help-section{
-        max-width: 1120px;
+        max-width: none;
 }
 
@@ -403 +670 @@
 .velowp-help-faq details{
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
 }
 
 .velowp-help-faq summary{
-        padding: 12px 14px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 16px;
+        padding: 12px 16px;
         color: var(--vw-text);
         font-weight: 600;
         cursor: pointer;
+        list-style: none;
+}
+
+.velowp-help-faq summary::-webkit-details-marker{
+        display: none;
+}
+
+.velowp-help-faq summary::after{
+        content: '';
+        flex: 0 0 8px;
+        height: 8px;
+        border-right: 2px solid currentColor;
+        border-bottom: 2px solid currentColor;
+        transform: rotate(45deg);
+}
+
+.velowp-help-faq details[open] summary::after{
+        color: var(--vw-primary);
+        transform: rotate(225deg);
+}
+
+.velowp-help-faq summary:focus-visible{
+        outline: 2px solid var(--vw-primary);
+        outline-offset: -2px;
 }
 
 .velowp-help-faq details[open] summary{
         border-bottom: 1px solid var(--vw-border-soft);
-        background: var(--vw-surface-muted);
+        background: var(--vw-surface);
 }
 
 .velowp-help-faq p{
         margin: 0;
-        padding: 12px 14px 14px;
+        padding: 12px 16px 16px;
         color: var(--vw-muted);
 }
@@ -428 +724 @@
         align-items: center;
         gap: 10px;
-        max-width: 420px;
+        width: 100%;
 }
 
 .velowp-range input[type="range"]{
-        flex: 1;
+        flex: 1 1 auto;
+        min-width: 0;
+        margin: 0;
+        height: 28px;
 }
 
@@ -439 +738 @@
         text-align: right;
         font-weight: 600;
+}
+
+.velowp-range-scale{
+        display: flex;
+        justify-content: space-between;
+        margin-right: 46px;
+        color: var(--vw-muted);
+        font-size: 12px;
 }
 
@@ -447 +754 @@
         align-items: center;
         gap: 8px;
+}
+
+.velowp-toggle{
+        align-items: flex-start;
+}
+
+.velowp-toggle input{
+        margin-top: 3px;
 }
 
@@ -459 +774 @@
         border-radius: 50%;
         background: var(--vw-surface-muted);
-        color: #2c3338;
+        color: var(--vw-text);
         font-size: 12px;
         font-weight: 600;
@@ -525 +840 @@
 }
 
+.velowp-panel[data-panel="setup"] .form-table tr{
+        display: block;
+        padding: 20px 0;
+        border-top: 1px solid var(--vw-border-soft);
+}
+
+.velowp-panel[data-panel="setup"] .form-table th,
+.velowp-panel[data-panel="setup"] .form-table td{
+        display: block;
+        width: 100%;
+        padding: 0;
+}
+
+.velowp-panel[data-panel="setup"] .form-table th{
+        margin-bottom: 12px;
+        font-size: 18px;
+}
+
+.velowp-verdict strong{
+        display: inline-block;
+        margin: 0 0 12px;
+        padding: 3px 10px;
+        border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
+}
+
+.velowp-verdict-ok strong{
+        border-color: var(--vw-success-border);
+        background: var(--vw-success-bg);
+        color: var(--vw-success-text);
+}
+
+.velowp-verdict-bad strong{
+        border-color: var(--vw-danger-border);
+        background: var(--vw-danger-bg);
+        color: var(--vw-danger-text);
+}
+
+.velowp-verdict .description{
+        display: block;
+        margin-bottom: 16px;
+}
+
 .velowp-strategy-options{
         display: grid;
@@ -559 +917 @@
 }
 
+.velowp-diagnostics-tests .velowp-quick-inline--top{
+        flex-direction: column;
+        align-items: stretch;
+}
+
+.velowp-diagnostics-tests .velowp-quick-pick{
+        flex: 0 1 auto;
+}
+
 .velowp-quick-pick{
         flex: 1 1 320px;
@@ -573 +940 @@
 .wrap.velowp .velowp-btn-glass--primary{
         min-width: 0;
+        min-height: 38px;
+        padding: 6px 14px;
+}
+
+.wrap.velowp .button{
+        min-height: 38px;
+        padding: 6px 14px;
+        border-color: var(--vw-primary);
+        border-radius: var(--vw-radius);
+        background: var(--vw-surface);
+        color: var(--vw-primary);
+        font-family: inherit;
+        font-size: 14px;
+        line-height: 1.6;
+}
+
+.wrap.velowp .button-primary{
+        border-color: var(--vw-primary);
+        background: var(--vw-primary);
+        color: #fff;
+}
+
+.wrap.velowp .button-primary:hover,
+.wrap.velowp .button-primary:focus{
+        border-color: var(--vw-primary-dark);
+        background: var(--vw-primary-dark);
+}
+
+.wrap.velowp .button-small{
         min-height: 30px;
-        padding: 0 12px;
+        padding: 3px 10px;
+        font-size: 12px;
 }
 
@@ -584 +981 @@
 .wrap.velowp .velowp-btn-warn{
         border-color: var(--vw-warning);
-        color: #7a5b00;
+        color: var(--vw-warning-text);
 }
 
 .wrap.velowp .velowp-btn-danger{
-        border-color: var(--vw-danger);
-        background: var(--vw-danger);
-        color: #fff;
+        border-color: var(--vw-danger-border);
+        background: var(--vw-danger-bg);
+        color: var(--vw-danger-text);
 }
 
 .wrap.velowp .velowp-btn-danger-outline{
         border-color: var(--vw-danger);
-        color: #8a2424;
+        color: var(--vw-danger-text);
 }
 
 .wrap.velowp .button[disabled],
 .wrap.velowp .button:disabled{
-        opacity: .65;
+        border-color: var(--vw-border) !important;
+        background: var(--vw-surface-muted) !important;
+        color: #756f65 !important;
+        opacity: 1;
         cursor: not-allowed;
 }
@@ -650 +1050 @@
 .velowp-quick-result-row{
         display: grid;
-        grid-template-columns: 220px minmax(0, 1fr);
+        grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
         gap: 12px;
         padding-top: 10px;
@@ -670 +1070 @@
         align-items: center;
         gap: 8px;
+}
+
+.velowp-quick-result-value{
+        min-width: 0;
+        overflow-wrap: anywhere;
 }
 
@@ -699 +1104 @@
         padding: 12px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface-muted);
 }
@@ -707 +1113 @@
 
 .velowp-self-test-summary.is-success{
-        border-left: 4px solid var(--vw-success);
         background: var(--vw-success-bg);
 }
 
 .velowp-self-test-summary.is-warning{
-        border-left: 4px solid var(--vw-warning);
         background: var(--vw-warning-bg);
 }
 
 .velowp-self-test-summary.is-error{
-        border-left: 4px solid var(--vw-danger);
         background: var(--vw-danger-bg);
 }
@@ -733 +1136 @@
         padding: 10px 12px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
 }
@@ -749 +1153 @@
 }
 
-.velowp-home-generation-result{ border-top: 1px solid var(--vw-border, #dcdcde); margin-top: 10px; padding-top: 8px; }
 .velowp-home-last-scope{ display: block; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
 
@@ -758 +1161 @@
         padding: 2px 8px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
         font-size: 12px;
@@ -766 +1170 @@
 .velowp-self-test-badge.is-success,
 .velowp-badge--success{
-        border-color: #b8e6c1;
+        border-color: var(--vw-success-border);
         background: var(--vw-success-bg);
-        color: #0a4b1f;
+        color: var(--vw-success-text);
 }
 
 .velowp-self-test-badge.is-warning,
 .velowp-badge--warning{
-        border-color: #ead9a1;
+        border-color: var(--vw-warning-border);
         background: var(--vw-warning-bg);
-        color: #7a5b00;
+        color: var(--vw-warning-text);
 }
 
 .velowp-self-test-badge.is-error,
 .velowp-badge--danger{
-        border-color: #f0c5c7;
+        border-color: var(--vw-danger-border);
         background: var(--vw-danger-bg);
-        color: #8a2424;
+        color: var(--vw-danger-text);
 }
 
 .velowp-self-test-badge.is-info,
 .velowp-badge--info{
-        border-color: #c5d9ed;
+        border-color: var(--vw-info-border);
         background: var(--vw-info-bg);
-        color: #0a4b78;
+        color: var(--vw-primary-dark);
 }
 
@@ -811 +1215 @@
 .velowp-audit-metrics{
         display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(210px, 1fr));
-        gap: 10px;
+        grid-template-columns: repeat(4, minmax(0, 1fr));
+        gap: 16px;
         margin-top: 12px;
 }
@@ -818 +1222 @@
 .velowp-audit-metric{
         display: grid;
-        grid-template-columns: minmax(0, 1fr) auto;
+        grid-template-columns: minmax(0, 1fr);
         grid-template-areas:
-                "head value"
-                "description description";
+                "head"
+                "value"
+                "description";
         align-items: flex-start;
         gap: 8px 14px;
         min-height: 86px;
-        padding: 12px;
+        min-width: 0;
+        padding: 16px;
         border: 1px solid var(--vw-border-soft);
-        border-left: 4px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
-        box-shadow: 0 1px 1px rgba(0,0,0,.03);
-}
-
-.velowp-audit-metric.is-success{
-        border-left-color: var(--vw-success);
-        background: linear-gradient(90deg, var(--vw-success-bg), var(--vw-surface) 42%);
-}
-
-.velowp-audit-metric.is-warning{
-        border-left-color: var(--vw-warning);
-        background: linear-gradient(90deg, var(--vw-warning-bg), var(--vw-surface) 42%);
-}
-
-.velowp-audit-metric.is-error{
-        border-left-color: var(--vw-danger);
-        background: linear-gradient(90deg, var(--vw-danger-bg), var(--vw-surface) 42%);
-}
-
-.velowp-audit-metric.is-info{
-        border-left-color: #72aee6;
-        background: linear-gradient(90deg, var(--vw-info-bg), var(--vw-surface) 42%);
+        box-shadow: none;
+}
+
+.velowp-audit-metrics:not(.velowp-audit-metrics--no-generated) > .velowp-audit-metric:nth-child(n+5){
+        grid-column: span 2;
 }
 
 .velowp-audit-metric__head{
         display: flex;
-        flex-wrap: wrap;
-        align-items: center;
+        justify-content: space-between;
+        align-items: flex-start;
         gap: 6px;
         grid-area: head;
@@ -862 +1252 @@
 
 .velowp-audit-metric span{
-        color: var(--vw-muted);
-        font-size: 12px;
-        font-weight: 600;
-        text-transform: uppercase;
+        color: var(--vw-text);
+        font-size: 16px;
+        font-weight: 600;
+        line-height: 1.35;
 }
 
@@ -883 +1273 @@
 
 .velowp-audit-metric.is-success em{
-        border-color: #b8e6c1;
+        border-color: var(--vw-success-border);
         background: var(--vw-success-bg);
-        color: #0a4b1f;
+        color: var(--vw-success-text);
 }
 
 .velowp-audit-metric.is-warning em{
-        border-color: #ead9a1;
+        border-color: var(--vw-warning-border);
         background: var(--vw-warning-bg);
-        color: #7a5b00;
+        color: var(--vw-warning-text);
 }
 
 .velowp-audit-metric.is-error em{
-        border-color: #f0c5c7;
+        border-color: var(--vw-danger-border);
         background: var(--vw-danger-bg);
-        color: #8a2424;
+        color: var(--vw-danger-text);
 }
 
 .velowp-audit-metric.is-info em{
-        border-color: #c5d9ed;
+        border-color: var(--vw-info-border);
         background: var(--vw-info-bg);
-        color: #0a4b78;
+        color: var(--vw-primary-dark);
 }
 
 .velowp-audit-metric__value{
         grid-area: value;
-        justify-self: end;
-        color: var(--vw-text);
-        font-size: 24px;
+        justify-self: start;
+        color: var(--vw-primary);
+        font-size: 34px;
         line-height: 1.1;
         white-space: nowrap;
@@ -916 +1306 @@
 
 .velowp-audit-metric.is-success .velowp-audit-metric__value{
-        color: #0a4b1f;
+        color: var(--vw-primary);
 }
 
 .velowp-audit-metric.is-warning .velowp-audit-metric__value{
-        color: #7a5b00;
+        color: var(--vw-warning-text);
 }
 
 .velowp-audit-metric.is-error .velowp-audit-metric__value{
-        color: #8a2424;
+        color: var(--vw-danger-text);
 }
 
 .velowp-audit-metric.is-info .velowp-audit-metric__value{
-        color: #0a4b78;
+        color: var(--vw-primary);
 }
 
@@ -935 +1325 @@
         grid-area: description;
         color: var(--vw-muted);
-        font-size: 12px;
-        line-height: 1.35;
+        padding-top: 10px;
+        border-top: 1px solid var(--vw-border-soft);
+        font-size: 14px;
+        line-height: 1.5;
 }
 
 .velowp-audit-metrics--no-generated{
-        grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+        grid-template-columns: repeat(2, minmax(0, 1fr));
 }
 
@@ -960 +1352 @@
         padding: 12px 14px;
         border: 1px solid var(--vw-border-soft);
-        border-left: 4px solid var(--vw-warning);
         background: var(--vw-warning-bg);
 }
@@ -1014 +1405 @@
         align-items: center;
         gap: 6px;
-        padding: 5px 9px;
+        padding: 7px 10px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface-muted);
         cursor: pointer;
+}
+
+.velowp-seg:has(input:checked){
+        border-color: #72aee6;
+        background: var(--vw-info-bg);
+}
+
+.velowp-seg:has(input:focus-visible){
+        outline: 2px solid var(--vw-primary);
+        outline-offset: 2px;
+}
+
+.velowp-seg input{
+        margin: 0;
 }
 
@@ -1040 +1446 @@
         padding: 7px 10px;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface);
 }
@@ -1053 +1460 @@
 
 .velowp-chip--ok{
-        border-color: #b8e6c1;
+        border-color: var(--vw-success-border);
         background: var(--vw-success-bg);
-        color: #0a4b1f;
+        color: var(--vw-success-text);
 }
 
 .velowp-chip--queue{
-        border-color: #c5d9ed;
+        border-color: var(--vw-info-border);
         background: var(--vw-info-bg);
-        color: #0a4b78;
+        color: var(--vw-primary-dark);
 }
 
 .velowp-chip--bad{
-        border-color: #f0c5c7;
-        background: var(--vw-danger-bg);
-        color: #8a2424;
+        border-color: var(--vw-warning-border);
+        background: var(--vw-warning-bg);
+        color: var(--vw-warning-text);
 }
 
@@ -1079 +1486 @@
 .velowp-progress{
         flex: 1 1 auto;
-        height: 12px;
+        height: 14px;
         overflow: hidden;
         border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
         background: var(--vw-surface-muted);
 }
@@ -1113 +1521 @@
 .velowp-donut{
         --pct: 0;
-        width: 148px;
-        height: 148px;
-        margin: 0 auto 14px;
+        width: 168px;
+        height: 168px;
+        margin: 16px auto 24px;
         border-radius: 50%;
-        background: conic-gradient(var(--vw-primary) calc(var(--pct) * 1%), #dcdcde 0);
+        background: conic-gradient(var(--vw-primary) calc(var(--pct) * 1%), var(--vw-border) 0);
         display: flex;
         align-items: center;
@@ -1124 +1532 @@
 
 .velowp-donut__center{
-        width: 104px;
-        height: 104px;
-        border: 1px solid var(--vw-border-soft);
+        width: 120px;
+        height: 120px;
         border-radius: 50%;
         background: var(--vw-surface);
@@ -1137 +1544 @@
 
 .velowp-donut__pct{
-        font-size: 24px;
+        font-size: 26px;
         font-weight: 600;
 }
@@ -1153 +1560 @@
 .velowp-bars__row{
         display: grid;
-        grid-template-columns: 78px minmax(0, 1fr) 90px;
+        grid-template-columns: 78px minmax(0, 1fr) 64px;
         gap: 10px;
         align-items: center;
@@ -1193 +1600 @@
         display: grid;
         grid-template-columns: repeat(2, minmax(0, 1fr));
-        gap: 10px;
+        gap: 16px;
 }
 
@@ -1204 +1611 @@
 }
 
-.velowp-folder-row--active td{ background: #f0f6ff; }
-.velowp-folder-row--stopped td{ background: #fff8e6; }
-.velowp-folder-status{ margin-left: 6px; color: #50575e; font-size: 11px; font-weight: 600; }
+.velowp-folder-row--active td{ background: var(--vw-info-bg); }
+.velowp-folder-row--stopped td{ background: var(--vw-surface-muted); }
+.velowp-folder-status{ margin-left: 6px; color: var(--vw-muted); font-size: 11px; font-weight: 600; }
 .velowp-folder-more-wrap{ margin: 10px 0 0; }
 
@@ -1263 +1670 @@
 }
 
-#velowp-mass.is-running .velowp-mass-mode,
-#velowp-mass.is-running #velowp-mass-folder-field,
-#velowp-mass.is-running #velowp-mass-theme-field{
+.velowp-mass.is-running .velowp-mass-mode,
+.velowp-mass.is-running .velowp-mass-folder{
         opacity: .7;
 }
@@ -1272 +1678 @@
 .velowp-table-tight td{
         vertical-align: middle;
+        padding: 12px;
+        font-size: 14px;
+}
+
+.wrap.velowp .widefat{
+        border-color: var(--vw-border-soft);
+        border-radius: var(--vw-radius);
+        box-shadow: none;
+}
+
+.wrap.velowp .widefat th{
+        font-weight: 600;
+}
+
+.wrap.velowp .widefat td,
+.wrap.velowp .widefat th{
+        color: var(--vw-text);
+        border-bottom: 1px solid var(--vw-border-soft);
+}
+
+.wrap.velowp .widefat tr:last-child td,
+.wrap.velowp .widefat tr:last-child th{
+        border-bottom: 0;
+}
+
+.velowp-table-scroll{
+        max-width: 100%;
+        overflow-x: auto;
+}
+
+.velowp-table-scroll:focus-visible{
+        outline: 2px solid var(--vw-primary);
+        outline-offset: 2px;
+}
+
+.velowp-table-scroll > table{
+        min-width: 760px;
+}
+
+.velowp-panel[data-panel="setup"] .widefat{
+        margin-top: 16px;
+}
+
+.velowp-panel[data-panel="setup"] .widefat.striped > tbody > :nth-child(odd){
+        background: var(--vw-surface);
 }
 
@@ -1293 +1744 @@
         .velowp-mass-grid,
         .velowp-mass-layout,
-        .velowp-mass-grid--top{
+        .velowp-mass-grid--top,
+        .velowp-panel[data-panel="setup"] > .velowp-grid{
                 grid-template-columns: 1fr;
+        }
+        .velowp-home-status-grid,
+        .velowp-help-grid,
+        .velowp-audit-metrics{
+                grid-template-columns: repeat(2, minmax(0, 1fr));
+        }
+        .velowp-audit-metrics:not(.velowp-audit-metrics--no-generated) > .velowp-audit-metric:nth-child(n+5){
+                grid-column: auto;
         }
 }
@@ -1317 +1777 @@
         }
 
-        .velowp-quick-result-row,
-        .velowp-bars__row,
-        .velowp-summarybox__grid{
+        .velowp-quick-result-row{
                 grid-template-columns: 1fr;
         }
 
-        .wrap.velowp .velowp-btn-wide{
-                width: auto;
+        .velowp-card,
+        .velowp-quick-card,
+        .velowp-mass-card,
+        .wrap.velowp .velowp-home-card{
+                padding: 16px;
         }
-}
-.wrap.velowp .velowp-mass-card--summary.velowp-statistics-frozen > :not(h3):not([role="status"]){
-        opacity: .6;
-}
-.velowp-home-generation-result[data-velowp-home-frozen="1"] [data-velowp-home-summary-group]{
+        .velowp-home-accordion{
+                padding: 0;
+        }
+        .velowp-home-accordion > summary,
+        .velowp-home-accordion__body{
+                padding: 16px;
+        }
+        .velowp-home-logo__image--wide{ max-width: 180px; }
+        .velowp-chip{ padding: 6px 8px; }
+        .velowp-chip__icon{ width: 16px; }
+        .velowp-home-status-card__head strong{ flex-basis: 120px; }
+}
+
+@media (max-width: 600px){
+        .velowp-home-status-grid,
+        .velowp-help-grid,
+        .velowp-audit-metrics,
+        .velowp-audit-metrics--no-generated{
+                grid-template-columns: minmax(0, 1fr);
+        }
+        .velowp-home-status-card{ min-height: 0; }
+        .velowp-self-test-item{ flex-wrap: wrap; }
+        .velowp-bars__row{ grid-template-columns: 76px minmax(0, 1fr) 60px; gap: 8px; }
+}
+.wrap.velowp .velowp-mass-card--summary.velowp-statistics-frozen .velowp-optimization-totals > :not(.description),
+.wrap.velowp .velowp-home-generation-result[data-velowp-home-frozen="1"] [data-velowp-home-summary-group]{
+        /* Dim saved figures only; the freshness notice and file actions remain clear. */
         opacity: .6;
 }
@@ -1358 +1841 @@
         filter: none;
 }
+/* Internal navigation preserves the WordPress shell and the current confirmed view. */
+.velowp.velowp-navigation-loading { cursor: progress; }
+.velowp.velowp-navigation-loading > :not(#velowp-navigation-status) { pointer-events: none; opacity: .65; }
+.velowp #velowp-navigation-status { margin: 0 0 16px; }
+.velowp #velowp-navigation-status[role="status"] {
+        position: fixed;
+        right: 20px;
+        bottom: 20px;
+        z-index: 100000;
+        max-width: calc(100vw - 40px);
+        box-sizing: border-box;
+        margin: 0;
+        pointer-events: none;
+}
+
+/* One visual language for Home, WebP, AVIF and Help; no controller-specific skin. */
+body.wp-admin:has(.wrap.velowp){
+        background: #f3f0eb;
+}
+.wrap.velowp{
+        font-variant-numeric: tabular-nums;
+}
+.wrap.velowp a{
+        color: var(--vw-primary);
+}
+.wrap.velowp a:hover{
+        color: var(--vw-primary-dark);
+}
+.wrap.velowp .button-primary,
+.wrap.velowp .button-primary:hover{
+        color: #fff;
+}
+.wrap.velowp input[type="text"],
+.wrap.velowp input[type="url"],
+.wrap.velowp input[type="number"],
+.wrap.velowp input[type="search"],
+.wrap.velowp textarea,
+.wrap.velowp select{
+        background-color: var(--vw-surface);
+        color: var(--vw-text);
+}
+.wrap.velowp input:focus,
+.wrap.velowp select:focus,
+.wrap.velowp textarea:focus{
+        border-color: var(--vw-primary);
+        box-shadow: 0 0 0 1px var(--vw-primary);
+}
+.wrap.velowp input[readonly]{
+        background: var(--vw-surface-muted);
+        font-family: Consolas, Monaco, monospace;
+}
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="mass"] .velowp-nav__btn[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-panel="setup"] .velowp-nav__btn[data-panel="setup"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="mass"] .velowp-nav__btn[data-panel="mass"],
+body.js .velowp-shell:not(.velowp-shell--js)[data-velowp-avif-panel="setup"] .velowp-nav__btn[data-panel="setup"],
+.velowp-nav__btn.is-active{
+        color: var(--vw-text);
+        box-shadow: inset 0 2px 0 var(--vw-accent);
+}
+.velowp-home-accordion > summary,
+.velowp-help-faq summary{
+        border-radius: var(--vw-panel-radius);
+        background: var(--vw-accent-bg);
+}
+.velowp-home-accordion[open] > summary,
+.velowp-help-faq details[open] summary{
+        border-radius: var(--vw-panel-radius) var(--vw-panel-radius) 0 0;
+        background: var(--vw-accent-bg-open);
+}
+.velowp-home-accordion > summary::after,
+.velowp-help-faq summary::after{
+        color: var(--vw-accent);
+}
+.velowp-home-accordion > summary:hover,
+.velowp-help-faq summary:hover{
+        background: #ede4da;
+}
+.velowp-home-status-card[data-velowp-delivery-card]{
+        background: var(--vw-surface-muted);
+}
+.velowp-home-status-card[data-velowp-delivery-card].is-warning{
+        background: var(--vw-warning-bg);
+}
+.velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head{
+        margin-bottom: 0;
+}
+.velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head strong{
+        min-height: 44px;
+}
+.velowp-home-status-card--strategy[data-velowp-delivery-card] .velowp-home-status-card__head{
+        margin-bottom: 10px;
+}
+.wrap.velowp select.velowp-home-badge-select{
+        background-color: var(--vw-surface);
+        border-color: var(--vw-control-border);
+}
+.wrap.velowp select.velowp-home-badge-select.is-success{
+        background-color: var(--vw-success-bg);
+        border-color: var(--vw-success);
+        color: var(--vw-success-text);
+}
+.wrap.velowp .velowp-savings-value.is-success,
+.velowp-quick-result-row--savings .velowp-quick-result-value{
+        color: var(--vw-success-text);
+        font-weight: 600;
+}
+.wrap.velowp .velowp-savings-value.is-warning{
+        color: var(--vw-warning-text);
+}
+.velowp-home-generation-result [data-velowp-home-phase]:not([hidden]){
+        display: inline-flex;
+        align-items: center;
+        padding: 3px 8px;
+        border-radius: var(--vw-radius);
+        background: var(--vw-surface-muted);
+        color: var(--vw-muted);
+}
+.velowp-home-generation-result [data-velowp-home-phase="running"]:not([hidden]),
+.velowp-home-generation-result [data-velowp-home-phase="preparing"]:not([hidden]),
+.velowp-home-generation-result [data-velowp-home-phase="stopping"]:not([hidden]){
+        background: var(--vw-info-bg);
+        color: var(--vw-primary-dark);
+}
+.velowp-home-generation-result [data-velowp-home-phase="completed"]:not([hidden]){
+        background: var(--vw-success-bg);
+        color: var(--vw-success-text);
+}
+.velowp-home-generation-result [data-velowp-home-phase="failed"]:not([hidden]){
+        background: var(--vw-danger-bg);
+        color: var(--vw-danger-text);
+}
+.velowp-home-generation-result [data-velowp-home-notice],
+.velowp-statistics-frozen > [role="status"],
+.velowp-self-test-result > p.description:only-child,
+.velowp-url-audit-result > p.description:only-child{
+        padding: 10px 12px;
+        border-radius: var(--vw-radius);
+        background: var(--vw-info-bg);
+        color: var(--vw-primary-dark);
+}
+.velowp-self-test-result > p.description:only-child::before,
+.velowp-url-audit-result > p.description:only-child::before{
+        content: "\f348";
+        display: inline-block;
+        margin-right: 8px;
+        font: normal 16px/1 dashicons;
+        vertical-align: -2px;
+        color: var(--vw-primary);
+}
+.velowp-home-status-card[data-velowp-delivery-card].is-warning #velowp-delivery-description,
+.velowp-home-status-card[data-velowp-delivery-card].is-warning > p.description{
+        color: var(--vw-warning-text);
+}
+.wrap.velowp .velowp-home-accordion__body > .form-table{
+        margin-top: 16px;
+        border-spacing: 0;
+        border-radius: var(--vw-panel-radius);
+        background: var(--vw-surface-muted);
+}
+.wrap.velowp .velowp-home-accordion__body > .form-table th,
+.wrap.velowp .velowp-home-accordion__body > .form-table td{
+        padding: 16px;
+}
+.velowp-url-audit-form + p.description + p.description{
+        padding: 10px 12px;
+        border-radius: var(--vw-radius);
+        background: var(--vw-warning-bg);
+        color: var(--vw-warning-text);
+}
+.wrap.velowp .notice{
+        border: 1px solid var(--vw-border-soft);
+        border-radius: var(--vw-radius);
+        background: var(--vw-surface-muted);
+        box-shadow: none;
+}
+.wrap.velowp .notice-success{
+        background: var(--vw-success-bg);
+        color: var(--vw-success-text);
+}
+.wrap.velowp .notice-warning{
+        background: var(--vw-warning-bg);
+        color: var(--vw-warning-text);
+}
+.wrap.velowp .notice-error{
+        background: var(--vw-danger-bg);
+        color: var(--vw-danger-text);
+}
+.wrap.velowp .notice-info{
+        background: var(--vw-info-bg);
+        color: var(--vw-primary-dark);
+}
+.wrap.velowp .widefat{
+        background: var(--vw-surface);
+}
+.wrap.velowp .widefat thead th{
+        background: var(--vw-accent-bg);
+}
+.wrap.velowp .widefat.striped > tbody > :nth-child(odd){
+        background: var(--vw-surface-muted);
+}
+.velowp-folders-table tbody tr:not(.velowp-folder-details):hover td{
+        background: var(--vw-accent-bg);
+}
+.velowp-bars__value,
+.velowp-summarybox__v,
+.velowp-progressline__pct,
+.velowp-home-generation-result strong{
+        font-variant-numeric: tabular-nums;
+}
+@media (max-width: 1100px){
+        .velowp-home-status-card[data-velowp-delivery-card] .velowp-home-status-card__head strong{
+                min-height: 0;
+        }
+}
+@media (max-width: 782px){
+        .wrap.velowp .velowp-home-accordion__body > .form-table th,
+        .wrap.velowp .velowp-home-accordion__body > .form-table td{
+                padding: 12px;
+        }
+        .wrap.velowp .velowp-home-accordion__body > .form-table th{
+                padding-bottom: 0;
+        }
+        .wrap.velowp .velowp-home-accordion__body > .form-table td{
+                padding-top: 8px;
+        }
+}

veloimg/trunk/assets/js/admin-avif.js

@@ -1 +1 @@
 (function () {
         'use strict';
+        var nativeSetTimeout = window.setTimeout || globalThis.setTimeout;
+        var nativeClearTimeout = window.clearTimeout || globalThis.clearTimeout;
+        function mount(pageScope) {
+        var setTimeout = pageScope ? pageScope.setTimeout : nativeSetTimeout;
+        var clearTimeout = pageScope ? pageScope.clearTimeout : nativeClearTimeout;
+        function listen(target, name, fn, options) {
+                if (pageScope) pageScope.listen(target, name, fn, options);
+                else target.addEventListener(name, fn, options);
+        }
+        if (pageScope) pageScope.onDispose(function () {
+                qsa('.velowp-popover').forEach(function (node) { node.remove(); });
+        });
 
         var running = false;
@@ -46 +58 @@
         function clearReconciliation() {
                 if (reconciliationTimer) {
-                        window.clearTimeout(reconciliationTimer);
+                        clearTimeout(reconciliationTimer);
                         reconciliationTimer = null;
                 }
@@ -55 +67 @@
         function clearRuntimeClock() {
                 if (runtimeClockTimer) {
-                        window.clearTimeout(runtimeClockTimer);
+                        clearTimeout(runtimeClockTimer);
                         runtimeClockTimer = null;
                 }
@@ -69 +81 @@
                         return;
                 }
-                runtimeClockTimer = window.setTimeout(function () {
+                runtimeClockTimer = setTimeout(function () {
                         runtimeClockTimer = null;
                         if (!running || String((currentState || {}).current_rel || '') === '') {
@@ -88 +100 @@
 
         function statisticsFrozen() {
-                return !!running || !!stopRequested || !!currentState.active;
+                return !!(pageScope && !pageScope.active) || !!running || !!stopRequested || !!currentState.active;
         }
 
@@ -106 +118 @@
                         clearFoldersOverviewRefresh();
                         if (folderDetailsTimer) {
-                                window.clearTimeout(folderDetailsTimer);
+                                clearTimeout(folderDetailsTimer);
                                 folderDetailsTimer = null;
                         }
@@ -151 +163 @@
                 var row = document.querySelector('#velowp-avif-folders-overview tr[data-folder="' + openFolder.folder + '"]');
                 if (!row || !row.classList.contains('velowp-folder-row--active')) { return; }
-                folderDetailsTimer = window.setTimeout(function () {
+                folderDetailsTimer = setTimeout(function () {
                         folderDetailsTimer = null;
                         var currentRow = openFolder ? document.querySelector('#velowp-avif-folders-overview tr[data-folder="' + openFolder.folder + '"]') : null;
@@ -187 +199 @@
         function clearFoldersOverviewRefresh() {
                 if (foldersOverviewTimer) {
-                        window.clearTimeout(foldersOverviewTimer);
+                        clearTimeout(foldersOverviewTimer);
                         foldersOverviewTimer = null;
                 }
@@ -202 +214 @@
                 delayMs = parseInt(delayMs || 0, 10);
                 delayMs = Math.max(5000, delayMs || foldersOverviewRefreshMs);
-                foldersOverviewTimer = window.setTimeout(function () {
+                foldersOverviewTimer = setTimeout(function () {
                         foldersOverviewTimer = null;
                         if (!folderStatsRuntime.shouldRequestOverview(typeof document !== 'undefined' && document.hidden)) {
@@ -333 +345 @@
 
         function refreshNonce(done) {
+                if (pageScope && !pageScope.active) return;
                 if (typeof done === 'function') {
                         nonceWaiters.push(done);
@@ -378 +391 @@
                         flushNonceWaiters(false, explainAjaxFailure(xhr, 'timeout'));
                 };
+                if (pageScope) pageScope.trackXhr(xhr);
                 xhr.send('action=' + encodeURIComponent(settings.nonceAction || 'velowp_avif_mass_nonce'));
         }
@@ -395 +409 @@
 
         function post(action, data, done, meta) {
+                if (pageScope && !pageScope.active) return;
                 if (avifTestHooks && typeof avifTestHooks.post === 'function') {
                         avifTestHooks.post(action, Object.assign({}, data || {}), done, Object.assign({}, meta || {}));
@@ -439 +454 @@
                                 nextMeta._retriedNetwork = true;
                                 finished = true;
-                                window.setTimeout(function () {
+                                setTimeout(function () {
                                         post(action, data, done, nextMeta);
                                 }, 1600);
@@ -491 +506 @@
                         failOnce('timeout');
                 };
+                if (pageScope) pageScope.trackXhr(xhr, action);
                 xhr.send(encoded.join('&'));
         }
@@ -1037 +1053 @@
                 showMessage((reason ? reason + ' ' : '') + avifText('startWaiting', 'Checking whether generation started. If it did not, the selected scope will start automatically when the server is free.'), 'info');
                 renderStatisticsFreeze();
-                reconciliationTimer = window.setTimeout(function () {
+                reconciliationTimer = setTimeout(function () {
                         reconciliationTimer = null;
                         if (token !== runToken || stopRequested || !running) { return; }
@@ -1069 +1085 @@
         function scheduleReconciliation(token, controlId, delay) {
                 if (reconciliationTimer) {
-                        window.clearTimeout(reconciliationTimer);
-                }
-                reconciliationTimer = window.setTimeout(function () {
+                        clearTimeout(reconciliationTimer);
+                }
+                reconciliationTimer = setTimeout(function () {
                         reconciliationTimer = null;
                         if (!running || stopRequested || token !== runToken || reconciliationInFlight) {
@@ -1155 +1171 @@
                         if (data.active) {
                                 var delay = data.note ? 2500 : 250;
-                                window.setTimeout(function () {
+                                setTimeout(function () {
                                         driveRun(token);
                                 }, delay);
@@ -1175 +1191 @@
                 stopRequested = true;
                 clearReconciliation();
-                if (folderDetailsTimer) { window.clearTimeout(folderDetailsTimer); folderDetailsTimer = null; }
+                if (folderDetailsTimer) { clearTimeout(folderDetailsTimer); folderDetailsTimer = null; }
                 clearFoldersOverviewRefresh();
                 var token = ++runToken;
@@ -1379 +1395 @@
                 var total = parseInt(summary.total || 0, 10);
                 node.classList.toggle('velowp-hidden', total === 0);
-                node.textContent = total ? avifText('outsideMonthsSummary', 'Outside monthly folders (included in Entire Media Library): %1$d images; processed: %2$d; AVIF: %3$d; unsuccessful: %4$d; left: %5$d.')
+                node.textContent = total ? avifText('outsideMonthsSummary', 'Outside monthly folders (included in All uploads): %1$d images; processed: %2$d; AVIF: %3$d; unsuccessful: %4$d; left: %5$d.')
                         .replace('%1$d', total).replace('%2$d', parseInt(summary.processed || 0, 10)).replace('%3$d', parseInt(summary.ready || 0, 10)).replace('%4$d', parseInt(summary.failed || 0, 10)).replace('%5$d', parseInt(summary.remaining || 0, 10)) : '';
         }
@@ -1689 +1705 @@
 
         function closeAvifFolderDetails() {
-                if (folderDetailsTimer) { window.clearTimeout(folderDetailsTimer); folderDetailsTimer = null; }
+                if (folderDetailsTimer) { clearTimeout(folderDetailsTimer); folderDetailsTimer = null; }
                 var table = byId('velowp-avif-folders-overview');
                 if (!table) {
@@ -1996 +2012 @@
                 }
                 shell.classList.add('velowp-shell--js');
-                function setPanel(panel) {
+                var defaultPanel = shell.getAttribute('data-velowp-avif-panel') || 'mass';
+                function setPanel(panel, pushHash) {
                         panel = panel || shell.getAttribute('data-velowp-avif-panel') || 'mass';
                         shell.setAttribute('data-velowp-avif-panel', panel);
@@ -2008 +2025 @@
                                 el.classList.toggle('is-active', String(el.getAttribute('data-panel')) === panel);
                         });
+                        if (pushHash) window.location.hash = panel;
                 }
                 shell.addEventListener('click', function (event) {
@@ -2015 +2033 @@
                         }
                         event.preventDefault();
-                        setPanel(String(btn.getAttribute('data-panel') || 'mass'));
-                });
-                setPanel(shell.getAttribute('data-velowp-avif-panel') || 'mass');
+                        setPanel(String(btn.getAttribute('data-panel') || 'mass'), true);
+                });
+                listen(window, 'hashchange', function () {
+                        var panel = String(window.location.hash || '').slice(1);
+                        if (!panel || panel === 'mass' || panel === 'setup') setPanel(panel || defaultPanel, false);
+                });
+                var hash = String(window.location.hash || '').slice(1);
+                setPanel(hash === 'mass' || hash === 'setup' ? hash : shell.getAttribute('data-velowp-avif-panel') || 'mass', false);
         }
 
@@ -2030 +2053 @@
                         });
                 });
-                var select = byId('velowp-avif-candidate-select');
-                var input = byId('velowp-avif-quick-input');
-                var submit = byId('velowp-avif-quick-generate');
-                if (select && input) {
-                        select.addEventListener('change', function () {
-                                input.value = select.value || '';
-                                if (submit && submit.getAttribute('data-velowp-avif-ready') === '1') {
-                                        submit.disabled = !input.value;
-                                }
-                        });
-                }
         }
 
@@ -2117 +2129 @@
 
         function init() {
+                if (folderStatsRuntime) folderStatsRuntime.initGenerationConcurrency(cfg(), pageScope);
                 var more = byId('velowp-avif-folders-more');
                 setFoldersMoreVisible(false);
@@ -2137 +2150 @@
                 initMass();
                 initPopover();
-                if (!document.documentElement.dataset.velowpAvifFoldersVisibilityBound) {
-                        document.documentElement.dataset.velowpAvifFoldersVisibilityBound = '1';
-                        document.addEventListener('visibilitychange', function () {
+                        listen(document, 'visibilitychange', function () {
                                 if (!document.hidden) { requestFoldersOverview(false); }
                         });
-                }
                 ensureFoldersOverviewRefresh(foldersOverviewRefreshMs);
         }
@@ -2193 +2203 @@
                         activePopover = popover;
                 }
-                document.addEventListener('click', function (event) {
+                listen(document, 'click', function (event) {
                         var button = event.target && event.target.closest ? event.target.closest('.velowp-file-q') : null;
                         if (button) {
@@ -2211 +2221 @@
                         closePopover();
                 });
-                document.addEventListener('keydown', function (event) {
+                listen(document, 'keydown', function (event) {
                         if (event.key === 'Escape') {
                                 closePopover();
                         }
                 });
-                window.addEventListener('scroll', closePopover, true);
-                window.addEventListener('resize', closePopover);
+                listen(window, 'scroll', closePopover, true);
+                listen(window, 'resize', closePopover);
         }
 
@@ -2236 +2246 @@
                         setRuntimeState: function (next) { next = next || {}; running = !!next.running; stopRequested = !!next.stopRequested; runToken = Number(next.runToken || 0); currentSummary = next.currentSummary || null; currentState = next.currentState || {}; allReady = Number(next.allReady || 0); },
                         getRuntimeState: function () { return { running: running, stopRequested: stopRequested, runToken: runToken, currentSummary: currentSummary, currentState: currentState, allReady: allReady }; },
-                        resetRuntimeState: function () { window.clearTimeout(foldersOverviewTimer); window.clearTimeout(folderDetailsTimer); clearReconciliation(); foldersOverviewTimer = null; folderDetailsTimer = null; running = false; stopRequested = false; runToken = 0; lifecycleRequestSequence = 0; lifecycleAppliedRevisions = {}; currentSummary = null; currentState = {}; allReady = 0; avifTestHooks.post = null; }
+                        resetRuntimeState: function () { clearTimeout(foldersOverviewTimer); clearTimeout(folderDetailsTimer); clearReconciliation(); foldersOverviewTimer = null; folderDetailsTimer = null; running = false; stopRequested = false; runToken = 0; lifecycleRequestSequence = 0; lifecycleAppliedRevisions = {}; currentSummary = null; currentState = {}; allReady = 0; avifTestHooks.post = null; }
                 };
                 if (window.__VELOIMG_AVIF_SKIP_AUTO_INIT__ === true) { return; }
         }
         if (document.readyState === 'loading') {
-                document.addEventListener('DOMContentLoaded', init);
+                listen(document, 'DOMContentLoaded', init);
         } else {
                 init();
         }
+        }
+        if (window.VeloimgAdminNavigation) window.VeloimgAdminNavigation.register(['velowp-avif'], mount);
+        else mount(null);
 })();

veloimg/trunk/assets/js/admin.js

@@ -1 +1 @@
 (function ($) {
         'use strict';
+        var nativeSetTimeout = window.setTimeout || globalThis.setTimeout;
+        var nativeClearTimeout = window.clearTimeout || globalThis.clearTimeout;
+        function mount(pageScope) {
+        var setTimeout = pageScope ? pageScope.setTimeout : nativeSetTimeout;
+        var clearTimeout = pageScope ? pageScope.clearTimeout : nativeClearTimeout;
+        function pageAjax(options) { return pageScope ? pageScope.ajax(options) : $.ajax(options); }
+        function listen(target, name, fn, options) {
+                if (pageScope) pageScope.listen(target, name, fn, options);
+                else target.addEventListener(name, fn, options);
+        }
+        if (pageScope) pageScope.onDispose(function () {
+                $(document).off('.velowpPage'); $(window).off('.velowpPage');
+                $('.velowp-popover').remove();
+        });
         var folderStatsRuntime = window.VeloimgFolderStatisticsRuntime;
 
@@ -49 +63 @@
                         }
 
-                        window.setTimeout(function () {
+                        setTimeout(function () {
                                 var target = document.getElementById('velowp-diagnostics');
                                 if (!target) {
@@ -87 +101 @@
                 }
 
+                var defaultPanel = String($shell.attr('data-velowp-panel') || 'mass');
                 var initial = '';
                 if (window.location.hash) {
@@ -96 +111 @@
                 setPanel(initial, false);
 
-                $(document).on('click', '.velowp-nav__btn', function (e) {
+                $(document).on('click.velowpPage', '.velowp-nav__btn', function (e) {
                         e.preventDefault();
                         setPanel($(this).data('panel'), true);
                 });
 
-                $(document).on('click', '[data-velowp-switch]', function (e) {
+                $(document).on('click.velowpPage', '[data-velowp-switch]', function (e) {
                 e.preventDefault();
                 setPanel($(this).data('velowp-switch'), true);
         });
 
-                $(window).on('hashchange', function () {
+                $(window).on('hashchange.velowpPage', function () {
                         var h = String(window.location.hash || '').replace('#', '');
-                        if (h) {
-                                setPanel(h, false);
-                        }
+                        setPanel(h || defaultPanel, false);
                 });
         }
 
         $(function () {
+                if (pageScope && !pageScope.active) return;
                 initPanels();
+                if (folderStatsRuntime) folderStatsRuntime.initGenerationConcurrency(window.velowpAdmin || {}, pageScope);
+
+                (function initHomeAccordions(){
+                        if (!$('.velowp-home-accordion').length) return;
+                        function revealHashTarget(){
+                                var target = document.getElementById(String(window.location.hash || '').slice(1));
+                                if (!target) return;
+                                var $block = $(target).closest('.velowp-home-accordion');
+                                if (!$block.length) return;
+                                $block.prop('open', true);
+                                target.scrollIntoView({ block: 'start' });
+                        }
+                        $(window).on('hashchange.velowpHomeAccordion.velowpPage', revealHashTarget);
+                        revealHashTarget();
+                })();
 
                 (function initHomeGenerationStatus(){
@@ -125 +154 @@
                         var stopped = false;
                         var visibilityEpoch = 0;
+                        var acknowledged = {};
 
                         function schedule(delay){
@@ -130 +160 @@
                                 timer = null;
                                 if (!stopped && !document.hidden) timer = setTimeout(refresh, delay);
+                        }
+                        function refreshSummaries(formats, epoch, refreshed){
+                                if (stopped || document.hidden || epoch !== visibilityEpoch) { schedule(6000); return; }
+                                var format = formats.shift();
+                                if (!format) { schedule(refreshed ? 0 : 6000); return; }
+                                pending = true;
+                                var accepted = false;
+                                pageAjax({
+                                        url: config.ajaxUrl, type: 'POST', dataType: 'json', timeout: 45000,
+                                        data: { action: config.optimizationSummaryAction, format: format.name, nonce: config.homeSummaryNonces[format.name] }
+                                }).done(function(response){
+                                        if (stopped || document.hidden || epoch !== visibilityEpoch || !response || !response.success || !response.data) return;
+                                        var summary = response.data.global_summary;
+                                        if (response.data.ok && summary && summary.home_run_key === format.key) {
+                                                acknowledged[format.name] = format.key;
+                                                accepted = true;
+                                        }
+                                }).fail(function(xhr){
+                                        if (xhr && (xhr.status === 400 || xhr.status === 403)) stopped = true;
+                                }).always(function(){
+                                        pending = false;
+                                        // Reconcile a raced/failed refresh through status before trying again.
+                                        if (accepted) refreshSummaries(formats, epoch, true);
+                                        else schedule(6000);
+                                });
                         }
                         function refresh(){
@@ -136 +191 @@
                                 pending = true;
                                 var epoch = visibilityEpoch;
-                                $.ajax({
+                                var formats = [];
+                                pageAjax({
                                         url: config.ajaxUrl, type: 'POST', dataType: 'json', timeout: 15000,
                                         data: { action: 'velowp_home_status', nonce: config.homeStatusNonce }
@@ -160 +216 @@
                                                 }
                                         });
+                                        var phases = response.data.generation_phases || {};
+                                        var keys = response.data.pending_refresh || {};
+                                        if (config.optimizationSummaryAction && config.homeSummaryNonces) {
+                                                ['webp', 'avif'].forEach(function(format){
+                                                        var key = keys[format];
+                                                        if ((phases[format] === 'paused' || phases[format] === 'completed') && typeof key === 'string' && key && acknowledged[format] !== key && config.homeSummaryNonces[format]) {
+                                                                formats.push({ name: format, key: key });
+                                                        }
+                                                });
+                                        }
                                 }).fail(function(xhr){
                                         if (xhr && (xhr.status === 400 || xhr.status === 403)) stopped = true;
                                 }).always(function(){
                                         pending = false;
-                                        schedule(6000);
+                                        refreshSummaries(formats, epoch, false);
                                 });
                         }
-                        $(document).on('visibilitychange', function(){
+                        $(document).on('visibilitychange.velowpPage', function(){
                                 visibilityEpoch++;
                                 schedule(0);
                         });
-                        $(window).on('pagehide', function(){ stopped = true; visibilityEpoch++; schedule(0); });
+                        $(window).on('pagehide.velowpPage', function(){ stopped = true; visibilityEpoch++; schedule(0); });
                         schedule(6000);
                 })();
@@ -183 +249 @@
                 }, 5000);
 
-                $(document).on('input change', 'input[type="range"][data-velowp-range-output]', function () {
+                $(document).on('input.velowpPage change.velowpPage', 'input[type="range"][data-velowp-range-output]', function () {
                         var outputId = String($(this).data('velowp-range-output') || '');
                         var val = String($(this).val() || '');
@@ -191 +257 @@
                 });
 
-                $(document).on('input change', 'input[type="range"][data-velowp-range]', function () {
+                $(document).on('input.velowpPage change.velowpPage', 'input[type="range"][data-velowp-range]', function () {
                         var key = String($(this).data('velowp-range') || '');
                         if (!key) return;
@@ -211 +277 @@
                                         $note.prop('hidden', String($note.data('velowp-delivery-note') || '') !== method);
                                 });
+                                var status = method === 'off' ? 'is-warning' : 'is-success';
+                                $('[data-velowp-delivery-card], #velowp-delivery-method, #velowp-image-strategy')
+                                        .removeClass('is-success is-warning is-error').addClass(status);
                         }
 
@@ -217 +286 @@
                 })();
 
-                $(document).on('click', '.velowp-details > summary', function (e) {
+                (function initHomeStrategyNote(){
+                        var $select = $('#velowp-image-strategy');
+                        var $note = $('#velowp-strategy-description');
+                        if (!$select.length || !$note.length) return;
+                        function syncStrategyNote(){
+                                $note.text(String($select.find('option:selected').attr('data-description') || ''));
+                        }
+                        $select.on('change', syncStrategyNote);
+                        syncStrategyNote();
+                })();
+
+                $(document).on('click.velowpPage', '.velowp-details > summary', function (e) {
                         e.preventDefault();
                         var $d = $(this).closest('details');
@@ -223 +303 @@
                 });
 
-                var $input = $('#velowp-quick-input');
+                ['', 'avif-'].forEach(function (prefix) {
+                var $input = $('#velowp-' + prefix + 'quick-input');
                 if ($input.length) {
-                        var $quickSubmit = $('#velowp-quick-generate');
-                        var $fallbackInput = $('#velowp-quick-input-fallback');
+                        var $quickSubmit = $('#velowp-' + prefix + 'quick-generate');
+                        var $fallbackInput = $('#velowp-' + prefix + 'quick-input-fallback');
 
                         function syncQuickSubmitState() {
@@ -233 +314 @@
                                 var ready = hiddenVal.length > 0 || fallbackVal.length > 0;
                                 if ($quickSubmit.length) {
-                                        $quickSubmit.prop('disabled', !ready);
+                                        $quickSubmit.prop('disabled', !ready || $quickSubmit.attr('data-velowp-avif-ready') === '0');
                                 }
                         }
 
                         syncQuickSubmitState();
-                        if ($('#velowp-candidate-select').length) {
-                                $('#velowp-candidate-select').find('option').first().text(velowpText('selectImage', 'Select an image'));
-                        }
-
-                        $('#velowp-candidate-select').on('change', function () {
+                        if ($('#velowp-' + prefix + 'candidate-select').length) {
+                                $('#velowp-' + prefix + 'candidate-select').find('option').first().text(velowpText('selectImage', 'Select an image'));
+                        }
+
+                        $('#velowp-' + prefix + 'candidate-select').on('change', function () {
                                 var v = String($(this).val() || '');
                                 $input.val(v);
@@ -248 +329 @@
                         });
 
-                        $('#velowp-pick-media').on('click', function (e) {
+                        $('#velowp-' + prefix + 'pick-media').on('click', function (e) {
                                 e.preventDefault();
                                 if (typeof wp === 'undefined' || !wp.media) {
@@ -286 +367 @@
                         }
                 }
+                });
+
+                (function initBypassCopy(){
+                        var $field = $('#velowp-bypass-query');
+                        var $status = $('#velowp-bypass-copy-status');
+                        if (!$field.length) return;
+                        function report(copied){
+                                $status.text(String($status.attr(copied ? 'data-success' : 'data-fallback') || ''));
+                        }
+                        function fallback(){
+                                $field[0].focus();
+                                $field[0].select();
+                                var copied = false;
+                                try { copied = !!document.execCommand && document.execCommand('copy'); } catch (e) {}
+                                report(copied);
+                        }
+                        function copy(){
+                                $field[0].select();
+                                if (window.navigator.clipboard && typeof window.navigator.clipboard.writeText === 'function') {
+                                        window.navigator.clipboard.writeText(String($field.val() || '')).then(function(){ report(true); }, fallback);
+                                } else {
+                                        fallback();
+                                }
+                        }
+                        $field.on('click', copy);
+                        $('#velowp-bypass-copy').on('click', copy);
+                })();
 
                 (function initSelfTest(){
@@ -356 +464 @@
                                 $result.html('<p class="description velowp-muted">' + velowpEscapeHtml(velowpText('selfTestLoading', 'Running self-test...')) + '</p>');
 
-                                $.ajax({
+                                pageAjax({
                                         method: 'POST',
                                         url: ajaxUrl,
@@ -522 +630 @@
                                 $result.html('<p class="description velowp-muted">' + velowpEscapeHtml(velowpText('frontendAuditLoading', 'Checking the page...')) + '</p>');
 
-                                $.ajax({
+                                pageAjax({
                                         method: 'POST',
                                         url: ajaxUrl,
@@ -550 +658 @@
                 })();
 
-                $(document).on('change', '.velowp-scan-candidate', function () {
+                $(document).on('change.velowpPage', '.velowp-scan-candidate', function () {
                         var v = String($(this).val() || '');
                         if (v) {
@@ -608 +716 @@
                         var $badges = $('#velowp-mass-badges');
                         var $help = $('#velowp-mass-help');
+                        var $retryCard = $('#velowp-webp-retry');
+                        var $retryStart = $('#velowp-webp-retry-start');
+                        var $retryQuality = $('#velowp-webp-retry-quality');
+                        var $retryEngine = $('#velowp-webp-retry-engine');
+                        var webpRetrySnapshot = { scope: '', count: 0 };
                         var $outsideMonthsSummary = $('#velowp-outside-months-summary');
 
@@ -723 +836 @@
 
                         function statisticsFrozen() {
-                                return !webpControlState || !!webpCommandPending || webpControlUncertain || webpStopUnconfirmed
+                                return !!(pageScope && !pageScope.active) || !webpControlState || !!webpCommandPending || webpControlUncertain || webpStopUnconfirmed
                                         || ['preparing', 'running', 'stopping'].indexOf(webpPhase(webpControlState)) !== -1;
                         }
@@ -818 +931 @@
                                 renderStatisticsFreeze();
                                 applyModeUI();
+                                renderWebpRetry();
                                 $stop.prop('disabled', !!webpCommandPending || webpControlUncertain || !state.control_id || (phase !== 'running' && phase !== 'preparing'));
                                 var label = '', buttonLabel = '';
@@ -857 +971 @@
                                         if (statusText.indexOf(webpControlError + ' ') !== 0) $status.text(webpControlError + ' ' + statusText);
                                 }
+                        }
+
+                        function renderWebpRetry() {
+                                var state = webpControlState || {};
+                                var ownRetry = !!state.retry && !!state.retry.quality && isSameRunScope(state, sourceValue(), folderValue());
+                                var activeRetry = ownRetry && ['preparing', 'running', 'stopping'].indexOf(webpPhase(state)) !== -1;
+                                var count = webpRetrySnapshot.scope === currentWebpScopeKey() ? webpRetrySnapshot.count : 0;
+                                if (activeRetry) count = progressInt(state.manifest_count || state.display_total || state.total);
+                                $retryCard.toggleClass('velowp-hidden', count <= 0);
+                                $('#velowp-webp-retry-count').text(massText('retryCount', 'Files eligible for retry in this selection: %d').replace('%d', count));
+                                var disabled = statisticsFrozen() || running || !massStateReady || webpStatsFlight === webpUiEpoch;
+                                $retryCard.find('input, select').prop('disabled', disabled);
+                                $retryStart.prop('disabled', disabled || count <= 0 || $retryCard.attr('data-encoder-ready') !== '1')
+                                        .text(massText('retryStart', 'Retry processing %d files').replace('%d', count));
+                                if (activeRetry) {
+                                        $retryQuality.val(state.retry.quality);
+                                        $retryEngine.val(state.retry.engine);
+                                }
+                                $('#velowp-webp-retry-quality-value').text(String($retryQuality.val() || 75) + '%');
+                                var hint = disabled ? massText(activeRetry ? 'retryRunning' : 'retryUnavailable', activeRetry
+                                        ? 'Retry processing is running. Progress and Stop are in the generation block above.'
+                                        : 'Retry processing will be available after statistics are updated and generation is stopped or completed.') : '';
+                                $('#velowp-webp-retry-status').toggleClass('velowp-hidden', !hint).text(hint);
                         }
 
@@ -1181 +1318 @@
                                         return;
                                 }
-                                var text = massText('outsideMonthsSummary', 'Outside monthly folders (included in Entire Media Library): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.')
+                                var text = massText('outsideMonthsSummary', 'Outside monthly folders (included in All uploads): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.')
                                         .replace('%1$d', total).replace('%2$d', parseInt(outside.processed || 0, 10))
                                         .replace('%3$d', parseInt(outside.ready || 0, 10)).replace('%4$d', parseInt(outside.failed || 0, 10)).replace('%5$d', parseInt(outside.remaining || 0, 10));
@@ -1377 +1514 @@
                                         return;
                                 }
-                                nonceRefreshXhr = $.ajax({
+                                nonceRefreshXhr = pageAjax({
                                         url: ajaxUrl,
                                         type: 'POST',
@@ -1410 +1547 @@
                                 data.action = action;
                                 data.nonce = nonce;
-                                $.ajax({
+                                pageAjax({
                                         url: ajaxUrl,
                                         type: 'POST',
@@ -1824 +1961 @@
 
                         setFoldersMoreVisible(false);
-                        $(document).off('click.velowpFoldersMore').on('click.velowpFoldersMore', '#velowp-folders-more', function () {
+                        $(document).off('click.velowpFoldersMore.velowpPage').on('click.velowpFoldersMore.velowpPage', '#velowp-folders-more', function () {
                                 if (statisticsFrozen() || folderMorePending) { return; }
                                 folderHistoryAutoContinued = false;
@@ -2170 +2307 @@
 }
 
-$(document).off('click.velowpSort').on('click.velowpSort', '#velowp-folders-overview .velowp-folder-details th.velowp-sort', function(e){
+$(document).off('click.velowpSort.velowpPage').on('click.velowpSort.velowpPage', '#velowp-folders-overview .velowp-folder-details th.velowp-sort', function(e){
         e.preventDefault();
         if (!openFolder) return;
@@ -2361 +2498 @@
                                 return isThemeMode()
                                         ? massText('emptyThemeFolder', 'No JPG/PNG images were found in the selected theme folder.')
-                                        : massText('emptyFolder', 'No images were found in the Media Library for this folder.');
+                                        : massText('emptyFolder', 'No images were found in uploads for this folder.');
                         }
 
@@ -2369 +2506 @@
                                 }
                                 return isAllMode()
-                                        ? massText('startAll', 'Start for the entire Media Library')
+                                        ? massText('startAll', 'Start for all uploads')
                                         : massText('startFolder', 'Start generation');
                         }
@@ -2495 +2632 @@
                                 } else {
 
-                                $start.text(all ? massText('startAll', 'Start for the entire Media Library') : massText('startFolder', 'Start generation'));
+                                $start.text(all ? massText('startAll', 'Start for all uploads') : massText('startFolder', 'Start generation'));
                                 }
                                 if (theme && (controlsLocked || massStateReady)) {
@@ -2669 +2806 @@
 
                         function requestStats() {
+                                renderWebpRetry();
                                 if (webpCommandPending) return;
                                 if (webpStatsFlight === webpUiEpoch) return;
@@ -2707 +2845 @@
                                 updateSecondaryActions(folderVal, {});
                                 webpStatsFlight = requestedEpoch;
+                                renderWebpRetry();
                                 if (!statisticsFrozen()) $('#velowp-statistics-status').removeClass('velowp-hidden').text(massText('statsUpdating', 'Updating statistics...'));
                                 ajax('velowp_mass_stats', { folder: folderVal, source: sourceValue(), include_overview: '1', history_limit: folderHistoryLimit }, function (d) {
@@ -2864 +3003 @@
                                         renderOutsideMonthsSummary(summary);
                                         renderHelpBlock(summary);
+                                        webpRetrySnapshot = { scope: currentWebpScopeKey(), count: progressInt(summary.retryable) };
+                                        renderWebpRetry();
 
                                         
@@ -2918 +3059 @@
                                                         $status.text(massText('emptyThemeFolder', 'No JPG/PNG images were found in the selected theme folder.'));
                                                 } else {
-                                                        $status.text(massText('emptyFolder', 'No images were found in the Media Library for this folder.'));
+                                                        $status.text(massText('emptyFolder', 'No images were found in uploads for this folder.'));
                                                 }
                                         } else {
@@ -3038 +3179 @@
                                         payload.source = sourceValue();
                                         payload.mode = mode === 'repair' ? 'repair' : 'generate';
+                                        if (action === 'start' && mode === 'retry') {
+                                                payload.retry_quality = String($retryQuality.val() || 75);
+                                                payload.retry_engine = String($retryEngine.val() || 'auto');
+                                                payload.display_total = webpRetrySnapshot.count;
+                                                payload.display_ready = payload.display_failed = payload.display_processed = 0;
+                                        }
                                 }
                                 var epoch = bumpWebpUiEpoch();
@@ -3127 +3274 @@
                                 }
                                 startRun('generate');
+                        });
+                        $retryQuality.on('input change', function () { $('#velowp-webp-retry-quality-value').text(String(this.value) + '%'); });
+                        $retryStart.on('click', function (e) {
+                                e.preventDefault();
+                                if ($retryStart.prop('disabled') || webpRetrySnapshot.scope !== currentWebpScopeKey() || webpRetrySnapshot.count <= 0) return;
+                                runWebpCommand('start', 'retry');
                         });
                         if ($repair.length) {
@@ -3200 +3353 @@
                         }
 
-                        $(window).on('focus', function () {
+                        $(window).on('focus.velowpPage', function () {
                                 refreshMassStateFromServer();
                         });
                         if (document && document.addEventListener) {
-                                        document.addEventListener('visibilitychange', function () {
+                                        listen(document, 'visibilitychange', function () {
                                         if (!document.hidden) {
                                                 refreshMassStateFromServer();
@@ -3221 +3374 @@
                         renderGlobalSummary();
                         applyModeUI();
-                        setTimeout(requestStats, 80);
+                        setTimeout(requestStats, 0);
                         // The first status response establishes whether reads are safe and carries the overview.
                 })();   });
@@ -3256 +3409 @@
                                 activePopover = $p;
                         }
-                        $(document).on('click', '.velowp-file-q, .velowp-help-q', function(e){
+                        $(document).on('click.velowpPage', '.velowp-file-q, .velowp-help-q', function(e){
                                 e.preventDefault();
                                 e.stopPropagation();
@@ -3267 +3420 @@
                                 openPopover($btn, text);
                         });
-                        $(document).on('click', function(e){
+                        $(document).on('click.velowpPage', function(e){
                                 if (e && $(e.target).closest('.velowp-popover, .velowp-file-q, .velowp-help-q').length) return;
                                 closePopover();
                         });
-                        $(document).on('keydown', function(e){ if (e && e.key === 'Escape') closePopover(); });
-                        $(window).on('scroll resize', function(){ if (activePopover) closePopover(); });
-
+                        $(document).on('keydown.velowpPage', function(e){ if (e && e.key === 'Escape') closePopover(); });
+                        $(window).on('scroll.velowpPage resize.velowpPage', function(){ if (activePopover) closePopover(); });
+
+        }
+        if (window.VeloimgAdminNavigation) window.VeloimgAdminNavigation.register(['velowp', 'velowp-webp', 'velowp-help'], mount);
+        else mount(null);
 })(jQuery);

veloimg/trunk/assets/js/folder-statistics-runtime.js

@@ -74 +74 @@
         function overviewVisible(hasRows, renderedSource, renderedFolder, source, folder) {
                 return !!hasRows && (renderedSource || 'uploads') === source && (source !== 'theme' || renderedFolder === folder);
+        }
+
+        var dismissedGenerations = {};
+        /** One display-only warning for both generation pages; never changes controls. */
+        function initGenerationConcurrency(config, pageScope) {
+                if (typeof document === 'undefined') return;
+                var node = document.querySelector('[data-velowp-concurrency-warning]');
+                if (!node || !config.ajaxUrl || !config.homeStatusNonce || node.velowpConcurrencyInitialized) return;
+                var other = node.getAttribute('data-velowp-other-format');
+                if (other !== 'webp' && other !== 'avif') return;
+                node.velowpConcurrencyInitialized = true;
+                var generationId = node.getAttribute('data-velowp-generation-id') || '';
+                var storageKey = 'veloimg:concurrency-dismissed:' + config.ajaxUrl + ':' + other;
+                var dismissed = dismissedGenerations[storageKey] || '';
+                try { dismissed = window.sessionStorage.getItem(storageKey) || dismissed; } catch (error) { /* Storage may be disabled; AJAX navigation still keeps the dismissal. */ }
+                var unknownDismissed = false;
+                if (generationId && dismissed === generationId) node.hidden = true;
+                function dismiss() {
+                        node.hidden = true;
+                        if (!generationId) { unknownDismissed = true; return; }
+                        dismissed = generationId;
+                        dismissedGenerations[storageKey] = generationId;
+                        try { window.sessionStorage.setItem(storageKey, generationId); } catch (error) { /* Keep the in-memory dismissal. */ }
+                }
+                var close = node.querySelector('[data-velowp-concurrency-dismiss]');
+                if (close) {
+                        if (pageScope) pageScope.listen(close, 'click', dismiss);
+                        else close.addEventListener('click', dismiss);
+                }
+                var timer = null, pending = false, stopped = false, epoch = 0;
+                if (pageScope) pageScope.onDispose(function () { stopped = true; epoch++; if (timer !== null) clearTimeout(timer); });
+                function schedule(delay) {
+                        if (timer !== null) clearTimeout(timer);
+                        timer = null;
+                        if (!stopped && !document.hidden) timer = setTimeout(refresh, delay);
+                }
+                function refresh() {
+                        timer = null;
+                        if (stopped || document.hidden || pending) return;
+                        pending = true;
+                        var requestEpoch = epoch, xhr = new XMLHttpRequest();
+                        xhr.open('POST', config.ajaxUrl, true);
+                        xhr.timeout = 15000;
+                        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded; charset=UTF-8');
+                        function finish() {
+                                pending = false;
+                                if (xhr.status === 400 || xhr.status === 403) stopped = true;
+                                if (!stopped && !document.hidden && requestEpoch === epoch && xhr.status >= 200 && xhr.status < 300) {
+                                        try {
+                                                var response = JSON.parse(xhr.responseText || '{}');
+                                                var phase = response.success && response.data && response.data.generation_phases && response.data.generation_phases[other];
+                                                // Missing/failed reads retain the last warning instead of claiming idle.
+                                                if (['idle', 'preparing', 'running', 'stopping', 'paused', 'failed', 'completed'].indexOf(phase) !== -1) {
+                                                        var ids = response.data.generation_ids;
+                                                        if (ids && typeof ids[other] === 'string') {
+                                                                if (ids[other] !== generationId) unknownDismissed = false;
+                                                                generationId = ids[other];
+                                                        }
+                                                        if (phase === 'idle' || phase === 'completed' || phase === 'failed') unknownDismissed = false;
+                                                        var active = ['preparing', 'running', 'stopping'].indexOf(phase) !== -1;
+                                                        node.hidden = !active || unknownDismissed || !!(generationId && dismissed === generationId);
+                                                }
+                                        } catch (error) { /* Keep the last confirmed display state. */ }
+                                }
+                                schedule(6000);
+                        }
+                        xhr.onload = xhr.onerror = xhr.ontimeout = finish;
+                        xhr.send('action=velowp_home_status&nonce=' + encodeURIComponent(config.homeStatusNonce));
+                }
+                var visible = function () { epoch++; schedule(0); };
+                var leave = function () { stopped = true; epoch++; schedule(0); };
+                if (pageScope) {
+                        pageScope.listen(document, 'visibilitychange', visible);
+                        pageScope.listen(window, 'pagehide', leave);
+                } else {
+                        document.addEventListener('visibilitychange', visible);
+                        window.addEventListener('pagehide', leave);
+                }
+                schedule(0);
         }
 
@@ -119 +198 @@
                 overviewRefreshDelay: 6000,
                 overviewVisible: overviewVisible,
+                initGenerationConcurrency: initGenerationConcurrency,
                 renderOptimizationSummary: renderOptimizationSummary,
                 refreshOptimizationSummary: refreshOptimizationSummary,

veloimg/trunk/languages/veloimg-ru_RU.po

@@ -2 +2 @@
 msgid ""
 msgstr ""
-"Project-Id-Version: VeloIMG – WebP & AVIF Image Optimizer 0.9.6\n"
+"Project-Id-Version: VeloIMG – WebP & AVIF Image Optimizer 0.9.7\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/veloimg\n"
 "POT-Creation-Date: 2026-09-27T08:44:59+00:00\n"
@@ -3328 +3328 @@
 msgid "%1$d processed · %2$d optimized · %3$d unsuccessful"
 msgstr "%1$d обработано · %2$d оптимизировано · %3$d неудачно"
+
+#: templates/admin-home.php
+msgid "Diagnostics"
+msgstr "Диагностика"
+
+#: templates/admin-diagnostics.php
+msgid "Trial WebP"
+msgstr "Пробный WebP"
+
+#: templates/admin-diagnostics.php
+msgid "Trial AVIF"
+msgstr "Пробный AVIF"
+
+#: templates/admin-home.php
+msgid "View original images"
+msgstr "Просмотр оригиналов"
+
+#: templates/admin-home.php
+msgid "Copy parameter"
+msgstr "Скопировать параметр"
+
+#: templates/admin-home.php
+msgid "Copied."
+msgstr "Скопировано."
+
+#: templates/admin-home.php
+msgid "Parameter selected. Copy it with Ctrl+C or Command+C."
+msgstr "Параметр выделен. Скопируйте его сочетанием Ctrl+C или Command+C."
+
+#: templates/admin-home.php
+msgid "Copy the parameter and append it to the page address to view the original images. Saved settings are not changed."
+msgstr "Скопируйте параметр и добавьте его в конец адреса страницы, чтобы увидеть оригинальные изображения. Сохранённые настройки не меняются."
+
+#: templates/admin-home.php
+msgid "Copy the parameter and append it to the JPG/PNG image address to view the original. Saved settings are not changed."
+msgstr "Скопируйте параметр и добавьте его в конец адреса JPG/PNG-изображения, чтобы увидеть оригинал. Сохранённые настройки не меняются."
+
+#: templates/admin-home.php
+msgid "Controls how much diagnostic detail is written to the server error log. Leave Error for normal use; Warning and Info help investigate problems, for example at support request. If WordPress debug logging is enabled, messages appear in wp-content/debug.log."
+msgstr "Определяет подробность записей в журнале ошибок сервера. Для обычной работы оставьте «Ошибки». «Предупреждения» и «Информация» помогают разобраться в проблемах, например по просьбе поддержки. Если в WordPress включён журнал отладки, записи доступны в wp-content/debug.log."
+
+#: templates/admin-dashboard.php
+msgid "Configure generation here. Single-file tests are in Diagnostics on the VeloIMG home page."
+msgstr "Здесь настраивается генерация. Пробная обработка одного файла доступна в блоке «Диагностика» на главной странице VeloIMG."
+
+#: templates/webp-retry.php
+msgid "Retry unsuccessful WebP files"
+msgstr "Повторная обработка WebP"
+
+#: templates/webp-retry.php
+msgid "Retry quality"
+msgstr "Качество повторного сжатия"
+
+#: templates/webp-retry.php
+msgid "Encoder"
+msgstr "Движок"
+
+#: templates/webp-retry.php
+msgid "Automatic"
+msgstr "Авто"
+
+#: templates/webp-retry.php
+msgid "Lossy compression is used for this retry, including PNG. Original files, successful WebP files and your main settings are not changed."
+msgstr "Повторное сжатие с потерями, в том числе для PNG. Оригиналы, успешно созданные WebP и основные настройки не изменяются."
+
+#: templates/webp-retry.php
+msgid "Retry processing"
+msgstr "Повторить обработку"
+
+#: src/Admin/SettingsPage.php
+#, php-format
+msgid "Files eligible for retry in this selection: %d"
+msgstr "Можно обработать повторно в выбранной области: %d файлов"
+
+#: src/Admin/SettingsPage.php
+#, php-format
+msgid "Retry processing %d files"
+msgstr "Повторить обработку %d файлов"
+
+#: src/Admin/SettingsPage.php
+msgid "Retry processing is running. Progress and Stop are in the generation block above."
+msgstr "Идёт повторная обработка. Прогресс и кнопка остановки — в блоке генерации выше."
+
+#: src/Admin/SettingsPage.php
+msgid "Retry processing will be available after statistics are updated and generation is stopped or completed."
+msgstr "Повторная обработка станет доступна после обновления статистики и остановки или завершения генерации."
+
+#: src/Admin/SettingsPage.php
+msgid "No unsuccessful WebP files eligible for retry remain in this selection. Refresh the statistics."
+msgstr "В выбранной области больше нет неудачных WebP, подходящих для повторной обработки. Обновите статистику."
+
+#: src/Admin/SettingsPage.php
+msgid "Choose a retry quality between 50 and 100."
+msgstr "Выберите качество повторного сжатия от 50 до 100."
+
+#: src/Admin/SettingsPage.php
+msgid "The selected WebP encoder is unavailable. Refresh the page and select an available encoder."
+msgstr "Выбранный движок WebP недоступен. Обновите страницу и выберите доступный движок."
+
+#: templates/admin-dashboard.php templates/admin-avif.php src/Admin/SettingsPage.php
+msgid "All uploads"
+msgstr "Все загрузки"
+
+#: src/Admin/SettingsPage.php
+msgid "Start for all uploads"
+msgstr "Запустить для всех загрузок"
+
+#: src/Admin/SettingsPage.php
+msgid "Loading uploads information..."
+msgstr "Загружаем данные изображений из uploads..."
+
+#: src/Admin/SettingsPage.php
+msgid "No images were found in uploads for this folder."
+msgstr "В этой папке uploads изображения не найдены."
+
+#: templates/admin-dashboard.php
+msgid "Choose all uploads, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only WebP derivatives are created."
+msgstr "Выберите все изображения из uploads, папку месяца (YYYY/MM) или папку активной темы. Оригиналы не изменяются — создаются только WebP-деривативы."
+
+#: templates/admin-avif.php
+msgid "Choose all uploads, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only AVIF derivatives are created."
+msgstr "Выберите все изображения из uploads, папку месяца (YYYY/MM) или папку активной темы. Оригиналы не изменяются — создаются только AVIF-деривативы."
+
+#: src/Admin/SettingsPage.php
+#, php-format
+msgid "Outside monthly folders (included in All uploads): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d."
+msgstr "Вне папок по месяцам (входит в «Все загрузки»): %1$d изображений; обработано: %2$d; WebP: %3$d; неудачно: %4$d; осталось: %5$d."
+
+#: templates/generation-concurrency.php
+#, php-format
+msgid "Generation of %s is already running. Generating WebP and AVIF at the same time may significantly slow down image processing. You can start both formats or wait until the current run finishes."
+msgstr "Сейчас запущена генерация %s. Одновременная генерация WebP и AVIF может существенно замедлить обработку изображений. Можно запустить оба формата или дождаться завершения."
+
+#: src/Admin/SettingsPage.php
+msgid "Loading section..."
+msgstr "Загружаем раздел…"
+
+#: src/Admin/SettingsPage.php
+msgid "Sending request..."
+msgstr "Отправляем запрос…"
+
+#: src/Admin/SettingsPage.php
+msgid "Could not load the section. The current page is still available."
+msgstr "Не удалось загрузить раздел. Текущая страница остаётся доступной."
+
+#: src/Admin/SettingsPage.php
+msgid "The server response could not be confirmed. Open the page to check the result before trying again."
+msgstr "Не удалось подтвердить ответ сервера. Откройте страницу и проверьте результат перед повторной попыткой."
+
+#: src/Admin/SettingsPage.php
+msgid "Open page"
+msgstr "Открыть страницу"
+
+#: src/Admin/SettingsPage.php
+msgid "There are unsaved settings. Leave this section without saving?"
+msgstr "Есть несохранённые настройки. Перейти в другой раздел без сохранения?"
+
+#: templates/generation-concurrency.php
+msgid "Dismiss this notice."
+msgstr "Закрыть уведомление."

veloimg/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 0.9.6
+Stable tag: 0.9.7
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -25 +25 @@
 * Original JPG and PNG files remain untouched.
 * Safe delivery chains with AVIF, WebP, and original-image fallback.
-* Bulk generation for the full Media Library, monthly uploads folders, and selected theme folders.
+* Bulk generation for all uploads, monthly uploads folders, and selected theme folders.
 * Pause and continue long generation runs.
 * Separate WebP and AVIF processing with clear statistics and failed-file reasons.
@@ -46 +46 @@
 * Folder-level statistics, file lists, ZIP download for selected uploads folders, and safe deletion of generated derivatives.
 * Per-format optimization summaries for uploads and active/parent theme images; files without a usable derivative retain their original weight in the totals.
+* Compact main dashboard with frontend delivery and format priority controls, collapsible setup checks, diagnostics, and a page delivery check.
+* Navigation and settings/test submissions without a full-page reload, with native WordPress fallbacks.
+* Contextual retry of eligible unsuccessful WebP files with run-local quality and an available encoder; original images, successful files, and saved main settings are preserved.
 
 VeloIMG is designed for sites with many images. It avoids modifying originals and does not serve generated files when the derivative is invalid, outdated, or larger than the original where that rule applies.
@@ -107 +110 @@
 = Can WebP and AVIF generation run at the same time? =
 
-Yes. WebP and AVIF use separate generation flows. On limited shared hosting, running them one after another is recommended to reduce server load.
+Yes. WebP and AVIF use separate generation flows, but running both at once can slow image processing. The generation screen explains this before starting the second format; the notice can be dismissed for the current generation.
+
+= Can I retry unsuccessful WebP files with different settings? =
+
+Yes. When eligible unsuccessful files exist in the selected uploads or theme scope, a retry block appears below generation. Choose retry quality and, when both are available, Imagick or GD. This retry uses lossy compression, including PNG. Original images, successful WebP files, and the main generation settings are not changed. Missing or unreadable source images cannot be repaired by changing quality.
 
 = Does VeloIMG delete generated files? =
@@ -116 +123 @@
 
 1. Main VeloIMG dashboard with server readiness, frontend delivery, format priority, and setup checks.
-2. WebP section with generation settings, folder selection, progress, statistics, and file management.
-3. AVIF section with generation settings, folder selection, progress, statistics, and file management.
+2. WebP generation with uploads/theme selection, progress, optimization summary, and file management.
+3. AVIF generation with uploads/theme selection, progress, optimization summary, and file management.
 4. Frontend delivery check showing page response, format coverage, derivative URLs, and unavailable files.
-5. Folder statistics with processed, successful, skipped, and unsuccessful images.
+5. Folder statistics with an expanded file list, status, original and WebP sizes, and savings.
 
 == Changelog ==
+
+= 0.9.7 =
+
+* Updated the admin interface with a warm, readable visual system and consistent WebP/AVIF controls, status badges, and notices.
+* Moved frontend delivery and format priority controls into the main dashboard, with Save settings directly below them and AVIF-first defaults for new or missing choices; explicit saved choices are preserved.
+* Added collapsible setup, diagnostics, and frontend URL-check blocks on the main page. WebP/AVIF trial reports remain independently available after navigation, with a copyable delivery-bypass parameter and an explained log setting.
+* Added contextual retry of eligible unsuccessful WebP files with separate quality and available Imagick/GD selection, without changing originals, successful files, or main settings.
+* Added navigation and settings/test submissions without a full-page reload, retaining native WordPress forms, URL history, and safe recovery when requests fail.
+* Improved completion-state refresh on the main dashboard and dimmed saved optimization figures while generation or statistics refresh is in progress.
+* Renamed the whole-upload scope to All uploads and added a dismissible warning that concurrent WebP/AVIF generation can slow image processing.
+* Prevented setup/generation panels flashing together on first render, stabilized navigation loading notices, and corrected the reported localization, nonce, input sanitation, and output-escaping warnings.
+* Updated the bundled Russian translation and the English/Russian screenshots. Existing generation settings and original files remain unchanged.
 
 = 0.9.6 =
@@ -188 +207 @@
 == Upgrade Notice ==
 
+= 0.9.7 =
+
+Updates the dashboard, diagnostics, WebP retry controls, and navigation. Stop both bulk generators before updating. Existing settings and original images are preserved; clear cached admin assets if the old interface remains visible.
+
 = 0.9.6 =
 

veloimg/trunk/src/Admin/OptimizationSummary.php

@@ -10 +10 @@
                 if ( ! wp_verify_nonce( $nonce, 'velowp_home_status' ) ) { wp_send_json_error( array( 'message' => __( 'Security check failed.', 'veloimg' ) ), 400 ); }
                 $cards = array();
+                $phases = array();
+                $generation_ids = array();
+                $pending_refresh = array();
                 foreach ( array( 'webp', 'avif' ) as $format ) {
                         $context = self::home_context( $format );
                         // A read failure is not an empty run: the browser retains its previous card.
-                        if ( $context['available'] ) { $cards[ $format ] = self::home_html( $format, $context ); }
+                        if ( $context['available'] ) {
+                                $cards[ $format ] = self::home_html( $format, $context );
+                                $phases[ $format ] = $context['phase'];
+                                $generation_ids[ $format ] = $context['generation_id'];
+                                if ( $context['statistics_pending'] ) { $pending_refresh[ $format ] = $context['run_key']; }
+                        }
                 }
-                wp_send_json_success( array( 'cards' => $cards ) );
+                wp_send_json_success( array( 'cards' => $cards, 'generation_phases' => $phases, 'generation_ids' => $generation_ids, 'pending_refresh' => $pending_refresh ) );
         }
 
@@ -28 +36 @@
         /** The same saved format summary as generation pages; only status is live. */
         public static function home_context( string $format ) : array {
-                $context = array( 'global' => self::read( $format ), 'phase' => 'idle', 'available' => true, 'statistics_pending' => false );
+                $context = array( 'global' => self::read( $format ), 'phase' => 'idle', 'available' => true, 'statistics_pending' => false, 'run_key' => '', 'generation_id' => '' );
                 try {
                         $run = self::home_run( $format );
                         $context['phase'] = $run['phase'];
+                        $context['run_key'] = $run['key'];
+                        $context['generation_id'] = $run['id'];
                         // A terminal status is not proof that its ordinary statistics refresh finished.
                         $context['statistics_pending'] = in_array( $run['phase'], array( 'paused', 'completed' ), true )
@@ -48 +58 @@
                 } else {
                         $state = self::fresh_home_option( 'velowp_avif_mass_state_v2' );
-                        if ( null === $state || array() === $state ) { return array( 'phase' => 'idle', 'key' => self::home_run_key( $format, array() ) ); }
+                        if ( null === $state || array() === $state ) { return array( 'phase' => 'idle', 'key' => self::home_run_key( $format, array() ), 'id' => '' ); }
                         if ( ! is_array( $state ) ) { throw new \UnexpectedValueException( 'home_state_invalid' ); }
                         $phase = ! empty( $state['runtime_failure'] ) ? 'failed' : ( ! empty( $state['stopped'] ) ? 'paused' : ( ! empty( $state['done'] ) ? 'completed' : ( ! empty( $state['active'] ) ? 'running' : 'paused' ) ) );
@@ -55 +65 @@
                 }
                 if ( ! in_array( $phase, array( 'idle', 'preparing', 'running', 'stopping', 'paused', 'failed', 'completed' ), true ) ) { throw new \UnexpectedValueException( 'home_phase_invalid' ); }
-                return array( 'phase' => $phase, 'key' => self::home_run_key( $format, $state ) );
+                return array( 'phase' => $phase, 'key' => self::home_run_key( $format, $state ), 'id' => self::generation_id( $format, $state ) );
+        }
+
+        /** Display-only dismissal identity: progress and Stop/Continue never change it. */
+        private static function generation_id( string $format, array $state ) : string {
+                $id = (string) ( $state[ 'webp' === $format ? 'run_id' : 'manifest_id' ] ?? '' );
+                if ( '' === $id && ! empty( $state['started_at'] ) ) {
+                        $id = implode( '|', array( (string) ( $state['source'] ?? '' ), (string) ( $state['folder'] ?? '' ), (string) $state['started_at'] ) );
+                }
+                return '' === $id ? '' : hash( 'sha256', $format . "\0" . $id );
         }
 

veloimg/trunk/src/Admin/SettingsPage.php

@@ -17 +17 @@
 use VeloWP\Conversion\WebpUploadsFolderSnapshot;
 use VeloWP\Conversion\WebpManifestMassOrchestrator;
+use VeloWP\Conversion\WebpRetry;
+use VeloWP\Database\AvifResultsRepository;
 use VeloWP\Database\FilesRepository;
 use VeloWP\Database\Installer;
@@ -44 +46 @@
         private static $uploads_folder_candidates_request_cache = array();
         private static $theme_preview_request_cache = array();
+        private static $admin_page_configs = array();
 
         public static function svg_icon( string $name ) : string {
@@ -100 +103 @@
         private static function default_settings() : array {
                 return array(
-                        'image_strategy'          => 'webp_only',
+                        'image_strategy'          => 'avif_webp',
                         'delivery_method'         => 'off',
                         'bypass_param'            => 'no_veloimg',
@@ -154 +157 @@
                         $strategy = $legacy[ $strategy ];
                 }
-                return array_key_exists( $strategy, self::image_strategies() ) ? $strategy : 'webp_only';
+                return array_key_exists( $strategy, self::image_strategies() ) ? $strategy : 'avif_webp';
         }
 
@@ -171 +174 @@
         private static function delivery_settings_signature( array $settings ) : string {
                 $payload = array(
-                        'image_strategy'  => self::sanitize_image_strategy( (string) ( $settings['image_strategy'] ?? 'webp_only' ) ),
+                        'image_strategy'  => self::sanitize_image_strategy( (string) ( $settings['image_strategy'] ?? 'avif_webp' ) ),
                         'delivery_method' => self::sanitize_delivery_method( (string) ( $settings['delivery_method'] ?? 'off' ) ),
                         'bypass_param'    => self::sanitize_bypass_param( (string) ( $settings['bypass_param'] ?? 'no_veloimg' ) ),
@@ -438 +441 @@
         public static function register() : void {
                 self::maybe_sync_settings();
+                add_action( 'wp_ajax_velowp_admin_page', array( __CLASS__, 'ajax_admin_page' ) );
 
                 register_setting(
@@ -514 +518 @@
                 if ( 'home' === sanitize_key( (string) ( $in['_form'] ?? '' ) ) ) {
                         $out = $current;
-                        $out['image_strategy']  = self::sanitize_image_strategy( (string) ( $in['image_strategy'] ?? ( $current['image_strategy'] ?? 'webp_only' ) ) );
+                        $out['image_strategy']  = self::sanitize_image_strategy( (string) ( $in['image_strategy'] ?? ( $current['image_strategy'] ?? 'avif_webp' ) ) );
                         $out['delivery_method'] = self::sanitize_delivery_method( (string) ( $in['delivery_method'] ?? ( $current['delivery_method'] ?? 'off' ) ) );
                         $bp = isset( $in['bypass_param'] ) ? (string) $in['bypass_param'] : (string) ( $current['bypass_param'] ?? 'no_veloimg' );
@@ -557 +561 @@
                 $out = array();
 
-                $out['image_strategy']  = self::sanitize_image_strategy( (string) ( $in['image_strategy'] ?? ( $current['image_strategy'] ?? 'webp_only' ) ) );
+                $out['image_strategy']  = self::sanitize_image_strategy( (string) ( $in['image_strategy'] ?? ( $current['image_strategy'] ?? 'avif_webp' ) ) );
                 $out['delivery_method'] = self::sanitize_delivery_method( (string) ( $in['delivery_method'] ?? ( $current['delivery_method'] ?? 'off' ) ) );
 
@@ -609 +613 @@
         }
 
-        public static function render_home() : void {
-                if ( ! current_user_can( self::CAPABILITY ) ) {
-                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
-                }
-
-                $logo_h_abs = VELOWP_DIR . 'assets/images/velowp-logo-horizontal.png';
-                $has_logo_h = is_file( $logo_h_abs );
-                $stored_settings = (array) get_option( 'velowp_settings', array() );
-                if ( array_key_exists( 'avif_quality', $stored_settings ) ) {
-                        $legacy_avif_quality = self::sanitize_avif_quality( $stored_settings['avif_quality'] ?? 85 );
-                        if ( ! array_key_exists( 'avif_jpeg_quality', $stored_settings ) ) {
-                                $stored_settings['avif_jpeg_quality'] = $legacy_avif_quality;
-                        }
-                        if ( ! array_key_exists( 'avif_png_quality', $stored_settings ) ) {
-                                $stored_settings['avif_png_quality'] = $legacy_avif_quality;
-                        }
-                }
-                $settings = wp_parse_args( $stored_settings, self::default_settings() );
-                $report     = Checker::check();
-                $avif_caps  = self::detect_avif_caps();
-                $self_test_report = self::load_self_test_report();
-                $auto_self_test = self::auto_self_test_pending( $settings );
-
-                $image_strategies = self::image_strategies();
-                $image_strategy   = self::sanitize_image_strategy( (string) ( $settings['image_strategy'] ?? 'webp_only' ) );
-                $delivery_method  = self::sanitize_delivery_method( (string) ( $settings['delivery_method'] ?? 'off' ) );
-                $webp_ready       = ! empty( $report['caps']['store_writable'] ) && ( ! empty( $report['caps']['imagick_webp'] ) || ! empty( $report['caps']['gd_webp'] ) );
-                $avif_ready       = ! empty( $report['caps']['store_writable'] ) && ( ! empty( $avif_caps['imagick_avif'] ) || ! empty( $avif_caps['gd_avif'] ) );
-                $store_writable   = ! empty( $report['caps']['store_writable'] );
-                $webp_encoders    = array();
-                $avif_encoders    = array();
-                if ( ! empty( $report['caps']['imagick_webp'] ) ) {
-                        $webp_encoders[] = 'Imagick';
-                }
-                if ( ! empty( $report['caps']['gd_webp'] ) ) {
-                        $webp_encoders[] = 'GD';
-                }
-                if ( ! empty( $avif_caps['imagick_avif'] ) ) {
-                        $avif_encoders[] = 'Imagick';
-                }
-                if ( ! empty( $avif_caps['gd_avif'] ) ) {
-                        $avif_encoders[] = 'GD';
-                }
-
-                $webp_page_url        = admin_url( 'admin.php?page=' . self::WEBP_SLUG );
-                $avif_page_url        = admin_url( 'admin.php?page=' . self::AVIF_SLUG );
-                $help_page_url        = admin_url( 'admin.php?page=' . self::HELP_SLUG );
-                $delivery_labels      = array(
-                        'off'      => __( 'Off (no frontend changes)', 'veloimg' ),
-                        'php_safe' => __( 'PHP Safe', 'veloimg' ),
-                        'apache'   => __( 'Apache /.htaccess', 'veloimg' ),
-                );
-                $delivery_status = $delivery_labels[ $delivery_method ] ?? __( 'Off (no frontend changes)', 'veloimg' );
-
-                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
-                $admin_js_ver       = is_file( VELOWP_DIR . 'assets/js/admin.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/admin.js' ) : VELOWP_VERSION;
-                $folder_runtime_ver = is_file( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) : VELOWP_VERSION;
-                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
-                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array(), $folder_runtime_ver, true );
-                wp_enqueue_script( 'velowp-admin', VELOWP_URL . 'assets/js/admin.js', array( 'jquery', 'velowp-folder-statistics-runtime' ), $admin_js_ver, true );
-                wp_localize_script(
-                        'velowp-admin',
-                        'velowpAdmin',
-                        array(
-                                'ajaxUrl'       => admin_url( 'admin-ajax.php' ),
-                                'selfTestNonce' => wp_create_nonce( self::SELF_TEST_NONCE_ACTION ),
-                                'autoSelfTest'  => $auto_self_test,
-                                'homeStatusNonce' => wp_create_nonce( 'velowp_home_status' ),
-                                'frontendAuditNonce' => wp_create_nonce( self::FRONTEND_AUDIT_NONCE_ACTION ),
-                                'i18n'          => array(
-                                        'ajaxMissing'        => __( 'AJAX URL is missing', 'veloimg' ),
-                                        'selfTestLoading'    => __( 'Running self-test...', 'veloimg' ),
-                                        'selfTestFailed'     => __( 'Could not run the self-test.', 'veloimg' ),
-                                        'selfTestLastCheck'  => __( 'Last check:', 'veloimg' ),
-                                        'frontendAuditLoading' => __( 'Checking the page...', 'veloimg' ),
-                                        'frontendAuditFailed'  => __( 'Could not check the page.', 'veloimg' ),
-                                        'frontendAuditEnterUrl' => __( 'Enter a page URL to check.', 'veloimg' ),
-                                        'frontendAuditRunAgain' => __( 'Check again', 'veloimg' ),
-                                        'frontendAuditIssues' => __( 'Details', 'veloimg' ),
-                                        'frontendAuditNoIssues' => __( 'No delivery issues found.', 'veloimg' ),
-                                        'frontendAuditBrokenUrls' => __( 'Broken checked URLs', 'veloimg' ),
-                                        'runAgain'           => __( 'Run again', 'veloimg' ),
-                                        'checkStatusSuccess' => __( 'Passed', 'veloimg' ),
-                                        'checkStatusWarning' => __( 'Warning', 'veloimg' ),
-                                        'checkStatusError'   => __( 'Failed', 'veloimg' ),
-                                        'checkStatusInfo'    => __( 'Info', 'veloimg' ),
-                                ),
-                        )
-                );
-
-                include VELOWP_DIR . 'templates/admin-home.php';
-        }
-
-        public static function render_help() : void {
-                if ( ! current_user_can( self::CAPABILITY ) ) {
-                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
-                }
-
-                $home_page_url = admin_url( 'admin.php?page=' . self::SLUG );
-                $webp_page_url = admin_url( 'admin.php?page=' . self::WEBP_SLUG );
-                $avif_page_url = admin_url( 'admin.php?page=' . self::AVIF_SLUG );
-
-                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
-                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
-
-                include VELOWP_DIR . 'templates/admin-help.php';
-        }
-
-        public static function render_avif() : void {
-                if ( ! current_user_can( self::CAPABILITY ) ) {
-                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
-                }
-
-                $stored_settings = (array) get_option( 'velowp_settings', array() );
-                if ( array_key_exists( 'avif_quality', $stored_settings ) ) {
-                        $legacy_avif_quality = self::sanitize_avif_quality( $stored_settings['avif_quality'] ?? 85 );
-                        if ( ! array_key_exists( 'avif_jpeg_quality', $stored_settings ) ) {
-                                $stored_settings['avif_jpeg_quality'] = $legacy_avif_quality;
-                        }
-                        if ( ! array_key_exists( 'avif_png_quality', $stored_settings ) ) {
-                                $stored_settings['avif_png_quality'] = $legacy_avif_quality;
-                        }
-                }
-                $settings = wp_parse_args( $stored_settings, self::default_settings() );
-                $report       = Checker::check();
-                $avif_caps    = self::detect_avif_caps();
-                $store        = DerivativesStore::default_store();
-                $mapper       = new PathMapper( $store );
-                $avif_jpeg_quality = self::sanitize_avif_quality( $settings['avif_jpeg_quality'] ?? ( $settings['avif_quality'] ?? 85 ) );
-                $avif_png_quality  = self::sanitize_avif_quality( $settings['avif_png_quality'] ?? ( $settings['avif_quality'] ?? 85 ) );
-                $store_ready  = ! empty( $report['caps']['store_writable'] );
-                $encoder_ready = ! empty( $avif_caps['imagick_avif'] ) || ! empty( $avif_caps['gd_avif'] );
-                $avif_ready   = $store_ready && $encoder_ready;
-                $avif_hosting_ready = AvifMass::hosting_readiness();
-                $encoder_labels = array();
-                $avif_candidates = self::get_large_recent_images( $mapper );
-                $avif_quick = array(
-                        'submitted'    => false,
-                        'input'        => '',
-                        'ok'           => false,
-                        'message'      => '',
-                        'error'        => '',
-                        'original_rel' => '',
-                        'd_expected'   => array(),
-                        'result'       => array(),
-                        'verdict'      => array(),
-                );
-
-                if ( ! empty( $avif_caps['imagick_avif'] ) ) {
-                        $encoder_labels[] = 'Imagick';
-                }
-                if ( ! empty( $avif_caps['gd_avif'] ) ) {
-                        $encoder_labels[] = 'GD';
-                }
-
-                $store_base_rel = trim( (string) $store->base_rel(), '/' );
-                $uploads_example_rel = ( '' !== $store_base_rel ? $store_base_rel . '/' : '' ) . 'YYYY/MM/example.jpg.avif';
-                $theme_example_rel   = ( '' !== $store_base_rel ? $store_base_rel . '/' : '' ) . 'theme/theme-slug/assets/example.png.avif';
-                $upload = wp_get_upload_dir();
-                $uploads_basedir = (string) ( $upload['basedir'] ?? '' );
-                $avif_folder_candidates = self::list_uploads_year_month_candidates( $uploads_basedir );
-                $theme_asset_candidates = self::discover_theme_asset_folders();
-                $avif_mass_status = AvifMass::status_payload();
-
-                if ( isset( $_POST['velowp_avif_quick_nonce'] ) && check_admin_referer( 'velowp_avif_quick', 'velowp_avif_quick_nonce' ) ) {
-                        $avif_quick['submitted'] = true;
-                        $raw = trim( self::post_text( 'velowp_avif_quick_input' ) );
-                        $avif_quick['input'] = $raw;
-
-                        $valid = $mapper->validate_original_rel( $raw );
-                        if ( empty( $valid['ok'] ) ) {
-                                $avif_quick['error'] = (string) ( $valid['error'] ?? __( 'Invalid input.', 'veloimg' ) );
-                        } else {
-                                $rel = (string) $valid['rel'];
-                                $processor = new AvifProcessor(
-                                        $store,
-                                        $mapper,
-                                        array_merge( (array) $avif_caps, array( 'exif' => function_exists( 'exif_read_data' ) ) ),
-                                        $settings
-                                );
-                                $derivative_abs = $processor->derivative_abs_from_original_rel( $rel );
-                                $avif_quick['original_rel'] = $rel;
-                                $avif_quick['d_expected'] = array(
-                                        'derivative_rel' => $processor->derivative_rel_from_original_rel( $rel ),
-                                        'derivative_abs' => $derivative_abs,
-                                        'derivative_url' => $processor->derivative_url_from_original_rel( $rel ),
-                                        'exists_before'  => is_file( $derivative_abs ),
-                                        'exists'         => is_file( $derivative_abs ),
-                                        'valid'          => is_file( $derivative_abs ) && self::is_avif_file( $derivative_abs ),
-                                );
-
-                                $res = $processor->generate_from_rel( $rel, false );
-                                $avif_quick['result'] = is_array( $res ) ? $res : array();
-                                $avif_quick['ok'] = ! empty( $res['ok'] );
-                                $avif_quick['message'] = self::avif_quick_result_message( $avif_quick['result'], $store_ready, $encoder_ready );
-                                $avif_quick['d_expected']['exists'] = is_file( $derivative_abs );
-                                $avif_quick['d_expected']['valid']  = is_file( $derivative_abs ) && self::is_avif_file( $derivative_abs );
-                        }
-
-                        $avif_quick['verdict'] = self::build_avif_quick_verdict( $avif_quick, $store_ready, $encoder_ready );
-                }
-
-                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
-                $admin_avif_js_ver  = is_file( VELOWP_DIR . 'assets/js/admin-avif.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/admin-avif.js' ) : VELOWP_VERSION;
-                $folder_runtime_ver = is_file( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) : VELOWP_VERSION;
-                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
-                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array(), $folder_runtime_ver, true );
-                wp_enqueue_script( 'velowp-admin-avif', VELOWP_URL . 'assets/js/admin-avif.js', array( 'velowp-folder-statistics-runtime' ), $admin_avif_js_ver, true );
-                wp_localize_script(
-                        'velowp-admin-avif',
-                        'velowpAvifAdmin',
-                        array(
-                                'ajaxUrl' => admin_url( 'admin-ajax.php' ),
-                                'nonce'   => wp_create_nonce( AvifMass::nonce_action() ),
-                                'nonceAction' => 'velowp_avif_mass_nonce',
-                                'initialMassStatus' => $avif_mass_status,
-                                'initialFoldersOverview' => StatisticsDisplaySnapshot::read( 'avif' ),
-                                'initialGlobalSummary' => OptimizationSummary::read( 'avif' ),
-                                'optimizationSummaryAction' => 'velowp_optimization_summary',
-                                'folderStatisticsTitles' => array( 'uploads' => __( 'Uploads folder statistics', 'veloimg' ), 'theme' => __( 'Theme folder statistics', 'veloimg' ) ),
-                                'i18n'    => array(
-                                        'ajaxMissing'  => __( 'AJAX URL missing', 'veloimg' ),
-                                        'chooseFolder' => __( 'Choose a folder.', 'veloimg' ),
-                                        'chooseThemeFolder' => __( 'Choose a theme folder.', 'veloimg' ),
-                                        'loadingStats' => __( 'Loading folder information...', 'veloimg' ),
-                                        'loadingAll'   => __( 'Loading Media Library information...', 'veloimg' ),
-                                        'loadingTheme' => __( 'Loading theme folder information...', 'veloimg' ),
-                                        'emptyFolder'  => __( 'No images were found in the Media Library for this folder.', 'veloimg' ),
-                                        'emptyThemeFolder' => __( 'No JPG/PNG images were found in the selected theme folder.', 'veloimg' ),
-                                        'ready'        => __( 'Ready.', 'veloimg' ),
-                                        'starting'     => __( 'Starting AVIF generation...', 'veloimg' ),
-                                        'startingTheme' => __( 'Starting theme folder AVIF processing...', 'veloimg' ),
-                                        'running'      => __( 'Generating AVIF...', 'veloimg' ),
-                                        'runningTheme' => __( 'Generating AVIF for the theme folder...', 'veloimg' ),
-                                        'processingFile' => __( 'Processing file:', 'veloimg' ),
-                                        'currentStepTime' => __( 'Current step:', 'veloimg' ),
-                                        'noProgressFor' => __( 'No progress for:', 'veloimg' ),
-                                        'stoppingDrain' => __( 'Stopping. Finishing the current work...', 'veloimg' ),
-                                        'secondsShort' => __( 'sec', 'veloimg' ),
-                                        'minutesShort' => __( 'min', 'veloimg' ),
-                                        'slowCurrentFile' => __( 'This file is taking longer than usual. If the server stops the request, the file will be marked as unsuccessful and generation will continue.', 'veloimg' ),
-                                        'timeoutLimit' => __( 'Timeout limit:', 'veloimg' ),
-                                        'stopping'     => __( 'Stopping...', 'veloimg' ),
-                                        'stopped'      => __( 'Stopped.', 'veloimg' ),
-                                        'done'         => __( 'AVIF generation completed.', 'veloimg' ),
-                                        'doneLabel'    => __( 'Generation completed', 'veloimg' ),
-                                        'failed'       => __( 'AVIF generation failed.', 'veloimg' ),
-                                        'errorTitle'   => __( 'Error', 'veloimg' ),
-                                        'hint'         => __( 'Hint', 'veloimg' ),
-                                        'longRun'      => __( 'There are many files. Generation may take a while depending on the server. You can stop and continue later without losing progress.', 'veloimg' ),
-                                        'unsuccessful' => __( 'Unsuccessful', 'veloimg' ),
-                                        'avifBiggerExplain' => __( 'Some images are marked as "Unsuccessful" because AVIF became larger than the original, so the plugin intentionally does not save it.', 'veloimg' ),
-                                        'avifWhatToDo' => __( 'If you want to try again, reduce the AVIF JPEG/PNG quality and run generation again.', 'veloimg' ),
-                                        'unsuccessfulReasonsInline' => __( 'Unsuccessful items were processed, but the derivative was not saved. Reasons:', 'veloimg' ),
-                                        'skippedReasonsInline' => __( 'There are "Unsuccessful" items. The main reasons are listed here:', 'veloimg' ),
-                                        'skippedDetailsBelow' => __( 'There are "Unsuccessful" items. See the statistics for details.', 'veloimg' ),
-                                        'whyNoAvif'    => __( 'Why items are still without AVIF', 'veloimg' ),
-                                        'ajaxFailed'   => __( 'AJAX request failed', 'veloimg' ),
-                                        'nonceRefreshFailed' => __( 'Could not refresh the security token. Reload the VeloIMG page.', 'veloimg' ),
-                                        'nonceExpired' => __( 'The page session expired. Refreshing the security token...', 'veloimg' ),
-                                        'requestTimeout' => __( 'The server took too long to respond. This usually means the hosting environment limited the request. Try again; progress is not lost.', 'veloimg' ),
-                                        'requestRetrying' => __( 'The server did not answer in time. Retrying; progress is not lost.', 'veloimg' ),
-                                        'startWaiting' => __( 'Checking whether generation started. If it did not, the selected scope will start automatically when the server is free.', 'veloimg' ),
-                                        'staleRun' => __( 'This AVIF run was replaced. Refresh the status before continuing.', 'veloimg' ),
-                                        'networkOffline' => __( 'Network connection appears to be offline.', 'veloimg' ),
-                                        'networkChanged' => __( 'The connection to the server was interrupted or the network changed. Try again in a few seconds.', 'veloimg' ),
-                                        'locked'       => __( 'Another generation process is running. Wait until it finishes.', 'veloimg' ),
-                                        'noDataYet'    => __( 'No data yet.', 'veloimg' ),
-                                        'processed'    => __( 'Processed:', 'veloimg' ),
-                                        'startAvif'    => __( 'Start AVIF generation', 'veloimg' ),
-                                        'startAll'     => __( 'Start for the entire Media Library', 'veloimg' ),
-                                        'startFolder'  => __( 'Start AVIF generation', 'veloimg' ),
-                                        'startTheme'   => __( 'Start for the theme folder', 'veloimg' ),
-                                        'continueRun'  => __( 'Continue', 'veloimg' ),
-                                        'imagesLabel'  => __( 'Images', 'veloimg' ),
-                                        'left'         => __( 'Left', 'veloimg' ),
-                                        'foldersEmpty' => __( 'No data.', 'veloimg' ),
-                                        'foldersFailed' => __( 'Could not load folder overview.', 'veloimg' ),
-                                        'statsFrozen' => __( 'Generation is running. Statistics will be refreshed after completion or a confirmed stop.', 'veloimg' ),
-                                        /* translators: 1: total images outside monthly folders, 2: processed images, 3: ready derivatives, 4: unsuccessful images, 5: remaining images. */
-                                        'outsideMonthsSummary' => str_replace( 'WebP', 'AVIF', __( 'Outside monthly folders (included in Entire Media Library): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.', 'veloimg' ) ),
-                                        'savedLine'    => __( 'Savings', 'veloimg' ),
-                                        'active'       => __( 'In progress', 'veloimg' ),
-                                        'paused'       => __( 'Paused', 'veloimg' ),
-                                        'completed'    => __( 'Completed', 'veloimg' ),
-                                        'deleting'     => __( 'Deleting AVIF...', 'veloimg' ),
-                                        'deletingTheme'=> __( 'Deleting AVIF files for the theme folder...', 'veloimg' ),
-                                        'deleteFailed' => __( 'Could not delete AVIF.', 'veloimg' ),
-                                        'deleted'      => __( 'AVIF files were deleted.', 'veloimg' ),
-                                        'deletedHint'  => __( 'You can run generation again.', 'veloimg' ),
-                                        'deleteConfirm'=> __( 'Delete all AVIF files in the selected folder? Original files will not be touched.', 'veloimg' ),
-                                        'deleteThemeConfirm' => __( 'Delete all AVIF files for the selected theme folder? Original files will not be touched.', 'veloimg' ),
-                                        'deleteAllConfirm' => __( 'Delete ALL generated AVIF files across the Media Library and theme derivatives? Original files will not be touched.', 'veloimg' ),
-                                        'noFolderData' => __( 'No file data available.', 'veloimg' ),
-                                        'open'         => __( 'Open', 'veloimg' ),
-                                        'avif'         => __( 'AVIF', 'veloimg' ),
-                                        'file'         => __( 'File', 'veloimg' ),
-                                        'status'       => __( 'Status', 'veloimg' ),
-                                        'origSize'     => __( 'Original', 'veloimg' ),
-                                        'saving'       => __( 'Savings', 'veloimg' ),
-                                        'loadedCount'  => __( 'loaded', 'veloimg' ),
-                                        'loadingMore'  => __( 'Loading...', 'veloimg' ),
-                                        'scrollToLoadMore' => __( 'Scroll down to load more...', 'veloimg' ),
-                                        'allLoaded'    => __( 'All rows are loaded.', 'veloimg' ),
-                                ),
-                        )
-                );
-
-                include VELOWP_DIR . 'templates/admin-avif.php';
-        }
-
-        public static function render() : void {
-                if ( ! current_user_can( self::CAPABILITY ) ) {
-                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
-                }
-
-                $active_panel = 'mass';
-                if ( isset( $_GET['settings-updated'] ) ) {
-                        $active_panel = 'setup';
-                }
-
-                $report   = Checker::check();
-                $settings = wp_parse_args( (array) get_option( 'velowp_settings', array() ), self::default_settings() );
-                $theme_asset_candidates = self::discover_theme_asset_folders();
-                $theme_asset_selected   = isset( $settings['theme_asset_folders'] ) && is_array( $settings['theme_asset_folders'] ) ? array_values( array_unique( array_map( 'strval', (array) $settings['theme_asset_folders'] ) ) ) : array();
-
-                $store  = DerivativesStore::default_store();
-                $mapper = new PathMapper( $store );
-                $repo   = new QueueRepository();
-
+        private static function home_webp_check( DerivativesStore $store, PathMapper $mapper, array $report, array $settings ) : array {
+                $repo = new QueueRepository();
                 $quick = array(
                         'submitted'  => false,
@@ -953 +629 @@
                 );
 
-                $candidates = self::get_large_recent_images( $mapper );
-
                 if ( isset( $_POST['velowp_quick_nonce'] ) && check_admin_referer( 'velowp_quick', 'velowp_quick_nonce' ) ) {
                         $quick['submitted'] = true;
-                        $active_panel = 'quick';
                         $quick['action']    = self::post_key( 'velowp_quick_action' );
                         $raw               = trim( self::post_text( 'velowp_quick_input' ) );
@@ -1037 +710 @@
                         }
                 }
+                return self::remember_home_trial( 'webp', $quick );
+        }
+
+        private static function home_avif_check( DerivativesStore $store, PathMapper $mapper, array $avif_caps, array $settings, bool $store_ready, bool $encoder_ready ) : array {
+                $avif_quick = array(
+                        'submitted'    => false,
+                        'input'        => '',
+                        'ok'           => false,
+                        'message'      => '',
+                        'error'        => '',
+                        'original_rel' => '',
+                        'd_expected'   => array(),
+                        'result'       => array(),
+                        'verdict'      => array(),
+                );
+
+                if ( isset( $_POST['velowp_avif_quick_nonce'] ) && check_admin_referer( 'velowp_avif_quick', 'velowp_avif_quick_nonce' ) ) {
+                        $avif_quick['submitted'] = true;
+                        $raw = trim( self::post_text( 'velowp_avif_quick_input' ) );
+                        $avif_quick['input'] = $raw;
+
+                        $valid = $mapper->validate_original_rel( $raw );
+                        if ( empty( $valid['ok'] ) ) {
+                                $avif_quick['error'] = (string) ( $valid['error'] ?? __( 'Invalid input.', 'veloimg' ) );
+                        } else {
+                                $rel = (string) $valid['rel'];
+                                $processor = new AvifProcessor(
+                                        $store,
+                                        $mapper,
+                                        array_merge( (array) $avif_caps, array( 'exif' => function_exists( 'exif_read_data' ) ) ),
+                                        $settings
+                                );
+                                $derivative_abs = $processor->derivative_abs_from_original_rel( $rel );
+                                $avif_quick['original_rel'] = $rel;
+                                $avif_quick['d_expected'] = array(
+                                        'derivative_rel' => $processor->derivative_rel_from_original_rel( $rel ),
+                                        'derivative_abs' => $derivative_abs,
+                                        'derivative_url' => $processor->derivative_url_from_original_rel( $rel ),
+                                        'exists_before'  => is_file( $derivative_abs ),
+                                        'exists'         => is_file( $derivative_abs ),
+                                        'valid'          => is_file( $derivative_abs ) && self::is_avif_file( $derivative_abs ),
+                                );
+
+                                $res = $processor->generate_from_rel( $rel, false );
+                                $avif_quick['result'] = is_array( $res ) ? $res : array();
+                                $avif_quick['ok'] = ! empty( $res['ok'] );
+                                $avif_quick['message'] = self::avif_quick_result_message( $avif_quick['result'], $store_ready, $encoder_ready );
+                                $avif_quick['d_expected']['exists'] = is_file( $derivative_abs );
+                                $avif_quick['d_expected']['valid']  = is_file( $derivative_abs ) && self::is_avif_file( $derivative_abs );
+                        }
+
+                        $avif_quick['verdict'] = self::build_avif_quick_verdict( $avif_quick, $store_ready, $encoder_ready );
+                }
+                return self::remember_home_trial( 'avif', $avif_quick );
+        }
+
+        /** Keep one last authenticated trial per format, scoped to this WordPress site. */
+        private static function remember_home_trial( string $format, array $quick ) : array {
+                if ( ! in_array( $format, array( 'webp', 'avif' ), true ) ) {
+                        return $quick;
+                }
+                $key = 'velowp_last_trial_' . $format;
+                if ( ! empty( $quick['submitted'] ) ) {
+                        $snapshot = $quick;
+                        // The selected result is sufficient; do not persist unrelated queue items.
+                        unset( $snapshot['tick'] );
+                        update_option( $key, $snapshot, false );
+                        return $quick;
+                }
+                $stored = get_option( $key, array() );
+                return is_array( $stored ) && ! empty( $stored['submitted'] )
+                        ? array_replace( $quick, array_intersect_key( $stored, $quick ) )
+                        : $quick;
+        }
+
+        public static function render_home() : void {
+                if ( ! current_user_can( self::CAPABILITY ) ) {
+                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
+                }
+
+                $logo_h_abs = VELOWP_DIR . 'assets/images/velowp-logo-horizontal.png';
+                $has_logo_h = is_file( $logo_h_abs );
+                $stored_settings = (array) get_option( 'velowp_settings', array() );
+                if ( array_key_exists( 'avif_quality', $stored_settings ) ) {
+                        $legacy_avif_quality = self::sanitize_avif_quality( $stored_settings['avif_quality'] ?? 85 );
+                        if ( ! array_key_exists( 'avif_jpeg_quality', $stored_settings ) ) {
+                                $stored_settings['avif_jpeg_quality'] = $legacy_avif_quality;
+                        }
+                        if ( ! array_key_exists( 'avif_png_quality', $stored_settings ) ) {
+                                $stored_settings['avif_png_quality'] = $legacy_avif_quality;
+                        }
+                }
+                $settings = wp_parse_args( $stored_settings, self::default_settings() );
+                $report     = Checker::check();
+                $avif_caps  = self::detect_avif_caps();
+                $self_test_report = self::load_self_test_report();
+                $auto_self_test = self::auto_self_test_pending( $settings );
+
+                $image_strategies = self::image_strategies();
+                $image_strategy   = self::sanitize_image_strategy( (string) ( $settings['image_strategy'] ?? 'avif_webp' ) );
+                $delivery_method  = self::sanitize_delivery_method( (string) ( $settings['delivery_method'] ?? 'off' ) );
+                $webp_ready       = ! empty( $report['caps']['store_writable'] ) && ( ! empty( $report['caps']['imagick_webp'] ) || ! empty( $report['caps']['gd_webp'] ) );
+                $avif_ready       = ! empty( $report['caps']['store_writable'] ) && ( ! empty( $avif_caps['imagick_avif'] ) || ! empty( $avif_caps['gd_avif'] ) );
+                $store_writable   = ! empty( $report['caps']['store_writable'] );
+                $store            = DerivativesStore::default_store();
+                $mapper           = new PathMapper( $store );
+                $recent_images    = self::get_large_recent_images( $mapper );
+                $quick            = self::home_webp_check( $store, $mapper, $report, $settings );
+                $avif_quick       = self::home_avif_check( $store, $mapper, $avif_caps, $settings, $store_writable, ! empty( $avif_caps['imagick_avif'] ) || ! empty( $avif_caps['gd_avif'] ) );
+                $candidates       = self::home_trial_candidates( $recent_images, $mapper, 'webp', $quick, $settings );
+                $avif_candidates  = self::home_trial_candidates( $recent_images, $mapper, 'avif', $avif_quick, $settings );
+                $diagnostics_open = wp_verify_nonce( self::post_text( 'velowp_quick_nonce' ), 'velowp_quick' )
+                        || wp_verify_nonce( self::post_text( 'velowp_avif_quick_nonce' ), 'velowp_avif_quick' );
+                $bypass_query     = '?' . self::sanitize_bypass_param( (string) ( $settings['bypass_param'] ?? 'no_veloimg' ) ) . '=1';
+                $webp_encoders    = array();
+                $avif_encoders    = array();
+                if ( ! empty( $report['caps']['imagick_webp'] ) ) {
+                        $webp_encoders[] = 'Imagick';
+                }
+                if ( ! empty( $report['caps']['gd_webp'] ) ) {
+                        $webp_encoders[] = 'GD';
+                }
+                if ( ! empty( $avif_caps['imagick_avif'] ) ) {
+                        $avif_encoders[] = 'Imagick';
+                }
+                if ( ! empty( $avif_caps['gd_avif'] ) ) {
+                        $avif_encoders[] = 'GD';
+                }
+
+                $webp_page_url        = admin_url( 'admin.php?page=' . self::WEBP_SLUG );
+                $avif_page_url        = admin_url( 'admin.php?page=' . self::AVIF_SLUG );
+                $help_page_url        = admin_url( 'admin.php?page=' . self::HELP_SLUG );
+                $delivery_labels      = array(
+                        'off'      => __( 'Off (no frontend changes)', 'veloimg' ),
+                        'php_safe' => __( 'PHP Safe', 'veloimg' ),
+                        'apache'   => __( 'Apache /.htaccess', 'veloimg' ),
+                );
+                $delivery_status = $delivery_labels[ $delivery_method ] ?? __( 'Off (no frontend changes)', 'veloimg' );
+
+                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
+                $admin_js_ver       = is_file( VELOWP_DIR . 'assets/js/admin.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/admin.js' ) : VELOWP_VERSION;
+                $folder_runtime_ver = is_file( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) : VELOWP_VERSION;
+                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
+                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array( 'velowp-admin-navigation' ), $folder_runtime_ver, true );
+                wp_enqueue_script( 'velowp-admin', VELOWP_URL . 'assets/js/admin.js', array( 'jquery', 'velowp-folder-statistics-runtime' ), $admin_js_ver, true );
+                self::localize_admin_script(
+                        'velowp-admin',
+                        'velowpAdmin',
+                        array(
+                                'ajaxUrl'       => admin_url( 'admin-ajax.php' ),
+                                'selfTestNonce' => wp_create_nonce( self::SELF_TEST_NONCE_ACTION ),
+                                'autoSelfTest'  => $auto_self_test,
+                                'homeStatusNonce' => wp_create_nonce( 'velowp_home_status' ),
+                                'optimizationSummaryAction' => 'velowp_optimization_summary',
+                                'homeSummaryNonces' => array( 'webp' => wp_create_nonce( self::MASS_NONCE_ACTION ), 'avif' => wp_create_nonce( AvifMass::nonce_action() ) ),
+                                'frontendAuditNonce' => wp_create_nonce( self::FRONTEND_AUDIT_NONCE_ACTION ),
+                                'i18n'          => array(
+                                        'selectImage'        => __( 'Select an image', 'veloimg' ),
+                                        'ajaxMissing'        => __( 'AJAX URL is missing', 'veloimg' ),
+                                        'selfTestLoading'    => __( 'Running self-test...', 'veloimg' ),
+                                        'selfTestFailed'     => __( 'Could not run the self-test.', 'veloimg' ),
+                                        'selfTestLastCheck'  => __( 'Last check:', 'veloimg' ),
+                                        'frontendAuditLoading' => __( 'Checking the page...', 'veloimg' ),
+                                        'frontendAuditFailed'  => __( 'Could not check the page.', 'veloimg' ),
+                                        'frontendAuditEnterUrl' => __( 'Enter a page URL to check.', 'veloimg' ),
+                                        'frontendAuditRunAgain' => __( 'Check again', 'veloimg' ),
+                                        'frontendAuditIssues' => __( 'Details', 'veloimg' ),
+                                        'frontendAuditNoIssues' => __( 'No delivery issues found.', 'veloimg' ),
+                                        'frontendAuditBrokenUrls' => __( 'Broken checked URLs', 'veloimg' ),
+                                        'runAgain'           => __( 'Run again', 'veloimg' ),
+                                        'checkStatusSuccess' => __( 'Passed', 'veloimg' ),
+                                        'checkStatusWarning' => __( 'Warning', 'veloimg' ),
+                                        'checkStatusError'   => __( 'Failed', 'veloimg' ),
+                                        'checkStatusInfo'    => __( 'Info', 'veloimg' ),
+                                ),
+                        )
+                );
+
+                include VELOWP_DIR . 'templates/admin-home.php';
+                self::render_navigation_config( self::SLUG );
+        }
+
+        public static function render_help() : void {
+                if ( ! current_user_can( self::CAPABILITY ) ) {
+                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
+                }
+
+                $home_page_url = admin_url( 'admin.php?page=' . self::SLUG );
+                $webp_page_url = admin_url( 'admin.php?page=' . self::WEBP_SLUG );
+                $avif_page_url = admin_url( 'admin.php?page=' . self::AVIF_SLUG );
+
+                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
+                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
+
+                include VELOWP_DIR . 'templates/admin-help.php';
+                self::render_navigation_config( self::HELP_SLUG );
+        }
+
+        public static function render_avif() : void {
+                if ( ! current_user_can( self::CAPABILITY ) ) {
+                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
+                }
+
+                $stored_settings = (array) get_option( 'velowp_settings', array() );
+                if ( array_key_exists( 'avif_quality', $stored_settings ) ) {
+                        $legacy_avif_quality = self::sanitize_avif_quality( $stored_settings['avif_quality'] ?? 85 );
+                        if ( ! array_key_exists( 'avif_jpeg_quality', $stored_settings ) ) {
+                                $stored_settings['avif_jpeg_quality'] = $legacy_avif_quality;
+                        }
+                        if ( ! array_key_exists( 'avif_png_quality', $stored_settings ) ) {
+                                $stored_settings['avif_png_quality'] = $legacy_avif_quality;
+                        }
+                }
+                $settings = wp_parse_args( $stored_settings, self::default_settings() );
+                $report       = Checker::check();
+                $avif_caps    = self::detect_avif_caps();
+                $store        = DerivativesStore::default_store();
+                $mapper       = new PathMapper( $store );
+                $avif_jpeg_quality = self::sanitize_avif_quality( $settings['avif_jpeg_quality'] ?? ( $settings['avif_quality'] ?? 85 ) );
+                $avif_png_quality  = self::sanitize_avif_quality( $settings['avif_png_quality'] ?? ( $settings['avif_quality'] ?? 85 ) );
+                $store_ready  = ! empty( $report['caps']['store_writable'] );
+                $encoder_ready = ! empty( $avif_caps['imagick_avif'] ) || ! empty( $avif_caps['gd_avif'] );
+                $avif_ready   = $store_ready && $encoder_ready;
+                $avif_hosting_ready = AvifMass::hosting_readiness();
+                $encoder_labels = array();
+
+                if ( ! empty( $avif_caps['imagick_avif'] ) ) {
+                        $encoder_labels[] = 'Imagick';
+                }
+                if ( ! empty( $avif_caps['gd_avif'] ) ) {
+                        $encoder_labels[] = 'GD';
+                }
+
+                $store_base_rel = trim( (string) $store->base_rel(), '/' );
+                $uploads_example_rel = ( '' !== $store_base_rel ? $store_base_rel . '/' : '' ) . 'YYYY/MM/example.jpg.avif';
+                $theme_example_rel   = ( '' !== $store_base_rel ? $store_base_rel . '/' : '' ) . 'theme/theme-slug/assets/example.png.avif';
+                $upload = wp_get_upload_dir();
+                $uploads_basedir = (string) ( $upload['basedir'] ?? '' );
+                $avif_folder_candidates = self::list_uploads_year_month_candidates( $uploads_basedir );
+                $theme_asset_candidates = self::discover_theme_asset_folders();
+                $avif_mass_status = AvifMass::status_payload();
+
+
+                $admin_base_css_ver = is_file( VELOWP_DIR . 'assets/css/admin-base.css' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/css/admin-base.css' ) : VELOWP_VERSION;
+                $admin_avif_js_ver  = is_file( VELOWP_DIR . 'assets/js/admin-avif.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/admin-avif.js' ) : VELOWP_VERSION;
+                $folder_runtime_ver = is_file( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) : VELOWP_VERSION;
+                wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
+                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array( 'velowp-admin-navigation' ), $folder_runtime_ver, true );
+                wp_enqueue_script( 'velowp-admin-avif', VELOWP_URL . 'assets/js/admin-avif.js', array( 'velowp-folder-statistics-runtime' ), $admin_avif_js_ver, true );
+                self::localize_admin_script(
+                        'velowp-admin-avif',
+                        'velowpAvifAdmin',
+                        array(
+                                'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+                                'nonce'   => wp_create_nonce( AvifMass::nonce_action() ),
+                                'nonceAction' => 'velowp_avif_mass_nonce',
+                                'homeStatusNonce' => wp_create_nonce( 'velowp_home_status' ),
+                                'initialMassStatus' => $avif_mass_status,
+                                'initialFoldersOverview' => StatisticsDisplaySnapshot::read( 'avif' ),
+                                'initialGlobalSummary' => OptimizationSummary::read( 'avif' ),
+                                'optimizationSummaryAction' => 'velowp_optimization_summary',
+                                'folderStatisticsTitles' => array( 'uploads' => __( 'Uploads folder statistics', 'veloimg' ), 'theme' => __( 'Theme folder statistics', 'veloimg' ) ),
+                                'i18n'    => array(
+                                        'ajaxMissing'  => __( 'AJAX URL missing', 'veloimg' ),
+                                        'chooseFolder' => __( 'Choose a folder.', 'veloimg' ),
+                                        'chooseThemeFolder' => __( 'Choose a theme folder.', 'veloimg' ),
+                                        'loadingStats' => __( 'Loading folder information...', 'veloimg' ),
+                                        'loadingAll'   => __( 'Loading uploads information...', 'veloimg' ),
+                                        'loadingTheme' => __( 'Loading theme folder information...', 'veloimg' ),
+                                        'emptyFolder'  => __( 'No images were found in uploads for this folder.', 'veloimg' ),
+                                        'emptyThemeFolder' => __( 'No JPG/PNG images were found in the selected theme folder.', 'veloimg' ),
+                                        'ready'        => __( 'Ready.', 'veloimg' ),
+                                        'starting'     => __( 'Starting AVIF generation...', 'veloimg' ),
+                                        'startingTheme' => __( 'Starting theme folder AVIF processing...', 'veloimg' ),
+                                        'running'      => __( 'Generating AVIF...', 'veloimg' ),
+                                        'runningTheme' => __( 'Generating AVIF for the theme folder...', 'veloimg' ),
+                                        'processingFile' => __( 'Processing file:', 'veloimg' ),
+                                        'currentStepTime' => __( 'Current step:', 'veloimg' ),
+                                        'noProgressFor' => __( 'No progress for:', 'veloimg' ),
+                                        'stoppingDrain' => __( 'Stopping. Finishing the current work...', 'veloimg' ),
+                                        'secondsShort' => __( 'sec', 'veloimg' ),
+                                        'minutesShort' => __( 'min', 'veloimg' ),
+                                        'slowCurrentFile' => __( 'This file is taking longer than usual. If the server stops the request, the file will be marked as unsuccessful and generation will continue.', 'veloimg' ),
+                                        'timeoutLimit' => __( 'Timeout limit:', 'veloimg' ),
+                                        'stopping'     => __( 'Stopping...', 'veloimg' ),
+                                        'stopped'      => __( 'Stopped.', 'veloimg' ),
+                                        'done'         => __( 'AVIF generation completed.', 'veloimg' ),
+                                        'doneLabel'    => __( 'Generation completed', 'veloimg' ),
+                                        'failed'       => __( 'AVIF generation failed.', 'veloimg' ),
+                                        'errorTitle'   => __( 'Error', 'veloimg' ),
+                                        'hint'         => __( 'Hint', 'veloimg' ),
+                                        'longRun'      => __( 'There are many files. Generation may take a while depending on the server. You can stop and continue later without losing progress.', 'veloimg' ),
+                                        'unsuccessful' => __( 'Unsuccessful', 'veloimg' ),
+                                        'avifBiggerExplain' => __( 'Some images are marked as "Unsuccessful" because AVIF became larger than the original, so the plugin intentionally does not save it.', 'veloimg' ),
+                                        'avifWhatToDo' => __( 'If you want to try again, reduce the AVIF JPEG/PNG quality and run generation again.', 'veloimg' ),
+                                        'unsuccessfulReasonsInline' => __( 'Unsuccessful items were processed, but the derivative was not saved. Reasons:', 'veloimg' ),
+                                        'skippedReasonsInline' => __( 'There are "Unsuccessful" items. The main reasons are listed here:', 'veloimg' ),
+                                        'skippedDetailsBelow' => __( 'There are "Unsuccessful" items. See the statistics for details.', 'veloimg' ),
+                                        'whyNoAvif'    => __( 'Why items are still without AVIF', 'veloimg' ),
+                                        'ajaxFailed'   => __( 'AJAX request failed', 'veloimg' ),
+                                        'nonceRefreshFailed' => __( 'Could not refresh the security token. Reload the VeloIMG page.', 'veloimg' ),
+                                        'nonceExpired' => __( 'The page session expired. Refreshing the security token...', 'veloimg' ),
+                                        'requestTimeout' => __( 'The server took too long to respond. This usually means the hosting environment limited the request. Try again; progress is not lost.', 'veloimg' ),
+                                        'requestRetrying' => __( 'The server did not answer in time. Retrying; progress is not lost.', 'veloimg' ),
+                                        'startWaiting' => __( 'Checking whether generation started. If it did not, the selected scope will start automatically when the server is free.', 'veloimg' ),
+                                        'staleRun' => __( 'This AVIF run was replaced. Refresh the status before continuing.', 'veloimg' ),
+                                        'networkOffline' => __( 'Network connection appears to be offline.', 'veloimg' ),
+                                        'networkChanged' => __( 'The connection to the server was interrupted or the network changed. Try again in a few seconds.', 'veloimg' ),
+                                        'locked'       => __( 'Another generation process is running. Wait until it finishes.', 'veloimg' ),
+                                        'noDataYet'    => __( 'No data yet.', 'veloimg' ),
+                                        'processed'    => __( 'Processed:', 'veloimg' ),
+                                        'startAvif'    => __( 'Start AVIF generation', 'veloimg' ),
+                                        'startAll'     => __( 'Start for all uploads', 'veloimg' ),
+                                        'startFolder'  => __( 'Start AVIF generation', 'veloimg' ),
+                                        'startTheme'   => __( 'Start for the theme folder', 'veloimg' ),
+                                        'continueRun'  => __( 'Continue', 'veloimg' ),
+                                        'imagesLabel'  => __( 'Images', 'veloimg' ),
+                                        'left'         => __( 'Left', 'veloimg' ),
+                                        'foldersEmpty' => __( 'No data.', 'veloimg' ),
+                                        'foldersFailed' => __( 'Could not load folder overview.', 'veloimg' ),
+                                        'statsFrozen' => __( 'Generation is running. Statistics will be refreshed after completion or a confirmed stop.', 'veloimg' ),
+                                        /* translators: 1: total images outside monthly folders, 2: processed images, 3: ready derivatives, 4: unsuccessful images, 5: remaining images. */
+                                        'outsideMonthsSummary' => str_replace( 'WebP', 'AVIF', __( 'Outside monthly folders (included in All uploads): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.', 'veloimg' ) ),
+                                        'savedLine'    => __( 'Savings', 'veloimg' ),
+                                        'active'       => __( 'In progress', 'veloimg' ),
+                                        'paused'       => __( 'Paused', 'veloimg' ),
+                                        'completed'    => __( 'Completed', 'veloimg' ),
+                                        'deleting'     => __( 'Deleting AVIF...', 'veloimg' ),
+                                        'deletingTheme'=> __( 'Deleting AVIF files for the theme folder...', 'veloimg' ),
+                                        'deleteFailed' => __( 'Could not delete AVIF.', 'veloimg' ),
+                                        'deleted'      => __( 'AVIF files were deleted.', 'veloimg' ),
+                                        'deletedHint'  => __( 'You can run generation again.', 'veloimg' ),
+                                        'deleteConfirm'=> __( 'Delete all AVIF files in the selected folder? Original files will not be touched.', 'veloimg' ),
+                                        'deleteThemeConfirm' => __( 'Delete all AVIF files for the selected theme folder? Original files will not be touched.', 'veloimg' ),
+                                        'deleteAllConfirm' => __( 'Delete ALL generated AVIF files across the Media Library and theme derivatives? Original files will not be touched.', 'veloimg' ),
+                                        'noFolderData' => __( 'No file data available.', 'veloimg' ),
+                                        'open'         => __( 'Open', 'veloimg' ),
+                                        'avif'         => __( 'AVIF', 'veloimg' ),
+                                        'file'         => __( 'File', 'veloimg' ),
+                                        'status'       => __( 'Status', 'veloimg' ),
+                                        'origSize'     => __( 'Original', 'veloimg' ),
+                                        'saving'       => __( 'Savings', 'veloimg' ),
+                                        'loadedCount'  => __( 'loaded', 'veloimg' ),
+                                        'loadingMore'  => __( 'Loading...', 'veloimg' ),
+                                        'scrollToLoadMore' => __( 'Scroll down to load more...', 'veloimg' ),
+                                        'allLoaded'    => __( 'All rows are loaded.', 'veloimg' ),
+                                ),
+                        )
+                );
+
+                include VELOWP_DIR . 'templates/admin-avif.php';
+                self::render_navigation_config( self::AVIF_SLUG );
+        }
+
+        public static function render() : void {
+                if ( ! current_user_can( self::CAPABILITY ) ) {
+                        wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'veloimg' ) );
+                }
+
+                $active_panel = 'mass';
+                if ( isset( $_GET['settings-updated'] ) ) {
+                        $active_panel = 'setup';
+                }
+
+                $report   = Checker::check();
+                $settings = wp_parse_args( (array) get_option( 'velowp_settings', array() ), self::default_settings() );
+                $theme_asset_candidates = self::discover_theme_asset_folders();
+                $theme_asset_selected   = isset( $settings['theme_asset_folders'] ) && is_array( $settings['theme_asset_folders'] ) ? array_values( array_unique( array_map( 'strval', (array) $settings['theme_asset_folders'] ) ) ) : array();
+
+                $store  = DerivativesStore::default_store();
+                $mapper = new PathMapper( $store );
+                $repo   = new QueueRepository();
+
 
                 $scan = array(
@@ -1174 +1220 @@
                 $folder_runtime_ver = is_file( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) ? (string) (int) filemtime( VELOWP_DIR . 'assets/js/folder-statistics-runtime.js' ) : VELOWP_VERSION;
                 wp_enqueue_style( 'velowp-admin-base', VELOWP_URL . 'assets/css/admin-base.css', array(), $admin_base_css_ver );
-                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array(), $folder_runtime_ver, true );
+                wp_enqueue_script( 'velowp-folder-statistics-runtime', VELOWP_URL . 'assets/js/folder-statistics-runtime.js', array( 'velowp-admin-navigation' ), $folder_runtime_ver, true );
                 wp_enqueue_script( 'velowp-admin', VELOWP_URL . 'assets/js/admin.js', array( 'jquery', 'velowp-folder-statistics-runtime' ), $admin_js_ver, true );
-                wp_localize_script(
+                self::localize_admin_script(
                         'velowp-admin',
                         'velowpAdmin',
@@ -1182 +1228 @@
                                 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
                                 'nonce' => wp_create_nonce( self::MASS_NONCE_ACTION ),
+                                'homeStatusNonce' => wp_create_nonce( 'velowp_home_status' ),
                                 'initialFoldersOverview' => StatisticsDisplaySnapshot::read( 'webp' ),
                                 'initialGlobalSummary' => OptimizationSummary::read( 'webp' ),
@@ -1193 +1240 @@
                                         'unableStats'  => __( 'Could not load folder information', 'veloimg' ),
                                         'chooseFolder' => __( 'Choose a folder.', 'veloimg' ),
-                                        'emptyFolder'  => __( 'No images were found in the Media Library for this folder.', 'veloimg' ),
+                                        'emptyFolder'  => __( 'No images were found in uploads for this folder.', 'veloimg' ),
                                         'nothingToDo'  => __( 'Everything in this folder is already optimized.', 'veloimg' ),
                                         'ready'        => __( 'Ready.', 'veloimg' ),
@@ -1235 +1282 @@
                                         'chooseFolder'   => __( 'Choose a folder.', 'veloimg' ),
                                         'chooseThemeFolder' => __( 'Choose a theme folder.', 'veloimg' ),
-                                        'emptyFolder'    => __( 'No images were found in the Media Library for this folder.', 'veloimg' ),
+                                        'emptyFolder'    => __( 'No images were found in uploads for this folder.', 'veloimg' ),
                                         'emptyThemeFolder' => __( 'No JPG/PNG images were found in the selected theme folder.', 'veloimg' ),
                                         'nothingToDo'    => __( 'Everything in this folder is already optimized.', 'veloimg' ),
@@ -1249 +1296 @@
                                         'doneLabel'      => __( 'Generation completed', 'veloimg' ),
                                         'continueRun'    => __( 'Continue', 'veloimg' ),
-                                        'startAll'       => __( 'Start for the entire Media Library', 'veloimg' ),
+                                        'startAll'       => __( 'Start for all uploads', 'veloimg' ),
                                         'startFolder'    => __( 'Start generation', 'veloimg' ),
                                         'startFailed'    => __( 'Could not start', 'veloimg' ),
                                         'startTheme'     => __( 'Start for the theme folder', 'veloimg' ),
                                         'stepFailed'     => __( 'Step failed', 'veloimg' ),
-                                        'loadingAll'     => __( 'Loading Media Library information...', 'veloimg' ),
+                                        'loadingAll'     => __( 'Loading uploads information...', 'veloimg' ),
                                         'noDataYet'      => __( 'No data yet.', 'veloimg' ),
                                         'noFolderData'   => __( 'No file data available.', 'veloimg' ),
@@ -1294 +1341 @@
                                 'networkChanged'     => __( 'The connection to the server was interrupted or the network changed. Try again in a few seconds.', 'veloimg' ),
                                 'loadingStats'       => __( 'Loading folder information...', 'veloimg' ),
+                                /* translators: %d: number of unsuccessful files eligible for retry. */
+                                'retryCount'         => __( 'Files eligible for retry in this selection: %d', 'veloimg' ),
+                                /* translators: %d: number of unsuccessful files selected for retry. */
+                                'retryStart'         => __( 'Retry processing %d files', 'veloimg' ),
+                                'retryRunning'       => __( 'Retry processing is running. Progress and Stop are in the generation block above.', 'veloimg' ),
+                                'retryUnavailable'   => __( 'Retry processing will be available after statistics are updated and generation is stopped or completed.', 'veloimg' ),
                                 'loadingTheme'       => __( 'Loading theme folder information...', 'veloimg' ),
                                 'unableStats'        => __( 'Could not load folder information', 'veloimg' ),
                                 'chooseFolder'       => __( 'Choose a folder.', 'veloimg' ),
                                 'chooseThemeFolder'  => __( 'Choose a theme folder.', 'veloimg' ),
-                                'emptyFolder'        => __( 'No images were found in the Media Library for this folder.', 'veloimg' ),
+                                'emptyFolder'        => __( 'No images were found in uploads for this folder.', 'veloimg' ),
                                 'emptyThemeFolder'   => __( 'No JPG/PNG images were found in the selected theme folder.', 'veloimg' ),
                                 'nothingToDo'        => __( 'Everything in this folder is already optimized.', 'veloimg' ),
@@ -1317 +1370 @@
                                 'doneLabel'          => __( 'Generation completed', 'veloimg' ),
                                 'continueRun'        => __( 'Continue', 'veloimg' ),
-                                'startAll'           => __( 'Start for the entire Media Library', 'veloimg' ),
+                                'startAll'           => __( 'Start for all uploads', 'veloimg' ),
                                 'startFolder'        => __( 'Start generation', 'veloimg' ),
                                 'startFailed'        => __( 'Could not start', 'veloimg' ),
                                 'startTheme'         => __( 'Start for the theme folder', 'veloimg' ),
                                 'stepFailed'         => __( 'Step failed', 'veloimg' ),
-                                'loadingAll'         => __( 'Loading Media Library information...', 'veloimg' ),
+                                'loadingAll'         => __( 'Loading uploads information...', 'veloimg' ),
                                 'noDataYet'          => __( 'No data yet.', 'veloimg' ),
                                 'noFolderData'       => __( 'No file data available.', 'veloimg' ),
@@ -1363 +1416 @@
                                 'queuePendingOne'    => __( 'In queue', 'veloimg' ),
                                 /* translators: 1: total images outside monthly folders, 2: processed images, 3: ready derivatives, 4: unsuccessful images, 5: remaining images. */
-                                'outsideMonthsSummary' => __( 'Outside monthly folders (included in Entire Media Library): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.', 'veloimg' ),
+                                'outsideMonthsSummary' => __( 'Outside monthly folders (included in All uploads): %1$d images; processed: %2$d; WebP: %3$d; unsuccessful: %4$d; left: %5$d.', 'veloimg' ),
                                 'queueProcessing'    => __( 'Processing', 'veloimg' ),
                                 'queueProcessingOne' => __( 'Processing', 'veloimg' ),
@@ -1441 +1494 @@
                 wp_enqueue_media();
 
+                $admin_i18n_overrides['i18n'] = array_replace( self::$admin_page_configs['velowpAdmin']['i18n'], $admin_i18n_overrides['i18n'] );
+                self::$admin_page_configs['velowpAdmin'] = array_replace( self::$admin_page_configs['velowpAdmin'], $admin_i18n_overrides );
                 include VELOWP_DIR . 'templates/admin-dashboard.php';
+                self::render_navigation_config( self::WEBP_SLUG );
                 return;
         }
 
+        /** Keep the native page and its AJAX fragment on the same configuration path. */
+        private static function localize_admin_script( string $handle, string $object, array $data ) : void {
+                self::$admin_page_configs[ $object ] = $data;
+                wp_localize_script( $handle, $object, $data );
+        }
+
+        private static function render_navigation_config( string $page ) : void {
+                $pages = array( self::SLUG, self::WEBP_SLUG, self::AVIF_SLUG, self::HELP_SLUG );
+                $labels = array(
+                        self::SLUG => __( 'VeloIMG', 'veloimg' ),
+                        self::WEBP_SLUG => __( 'WebP generation', 'veloimg' ),
+                        self::AVIF_SLUG => __( 'AVIF generation', 'veloimg' ),
+                        self::HELP_SLUG => __( 'Help / FAQ', 'veloimg' ),
+                );
+                foreach ( array( 'admin-navigation', 'folder-statistics-runtime', 'admin', 'admin-avif' ) as $asset ) {
+                        $file = 'assets/js/' . $asset . '.js';
+                        $version = is_file( VELOWP_DIR . $file ) ? (string) (int) filemtime( VELOWP_DIR . $file ) : VELOWP_VERSION;
+                        $deps = 'admin-navigation' === $asset ? array( 'jquery' ) : array( 'jquery', 'velowp-admin-navigation' );
+                        if ( in_array( $asset, array( 'admin', 'admin-avif' ), true ) ) { $deps[] = 'velowp-folder-statistics-runtime'; }
+                        wp_enqueue_script( 'velowp-' . $asset, VELOWP_URL . $file, $deps, $version, true );
+                }
+                // The media picker is available after any internal transition, not just a native WebP load.
+                wp_enqueue_media();
+                $packet = array(
+                        'page' => $page,
+                        'title' => $labels[ $page ] . ' ‹ VeloIMG — ' . get_bloginfo( 'name' ),
+                        'admin' => self::$admin_page_configs['velowpAdmin'] ?? array(),
+                        'avif' => self::$admin_page_configs['velowpAvifAdmin'] ?? array(),
+                        'navigation' => array(
+                                'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+                                'pageUrl' => admin_url( 'admin.php' ),
+                                'pages' => $pages,
+                                'nonce' => wp_create_nonce( 'velowp_admin_navigation' ),
+                                'i18n' => array(
+                                        'loading' => __( 'Loading section...', 'veloimg' ),
+                                        'saving' => __( 'Sending request...', 'veloimg' ),
+                                        'failed' => __( 'Could not load the section. The current page is still available.', 'veloimg' ),
+                                        'saveFailed' => __( 'The server response could not be confirmed. Open the page to check the result before trying again.', 'veloimg' ),
+                                        'openPage' => __( 'Open page', 'veloimg' ),
+                                        'unsaved' => __( 'There are unsaved settings. Leave this section without saving?', 'veloimg' ),
+                                ),
+                        ),
+                );
+                // JSON is inert page data, never executable inline code.
+                echo '<script type="application/json" id="velowp-admin-page-config">' . wp_json_encode( $packet, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT ) . '</script>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- JSON_HEX_* encodes HTML metacharacters in this inert JSON data block.
+        }
+
+        public static function ajax_admin_page() : void {
+                if ( ! current_user_can( self::CAPABILITY ) || ! check_ajax_referer( 'velowp_admin_navigation', 'nonce', false ) ) {
+                        wp_send_json_error( array( 'message' => __( 'Security check failed.', 'veloimg' ) ), 403 );
+                }
+                $page = isset( $_POST['page'] ) ? sanitize_key( wp_unslash( $_POST['page'] ) ) : '';
+                $renderers = array( self::SLUG => 'render_home', self::WEBP_SLUG => 'render', self::AVIF_SLUG => 'render_avif', self::HELP_SLUG => 'render_help' );
+                if ( ! isset( $renderers[ $page ] ) ) { wp_send_json_error( array( 'message' => __( 'Invalid request.', 'veloimg' ) ), 400 ); }
+                $request_post = $_POST;
+                $request_get = $_GET;
+                $request_uri = isset( $_SERVER['REQUEST_URI'] ) ? esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : '';
+                // This endpoint only renders. Native trial/save POSTs never enter this path.
+                $_POST = array();
+                $_GET = array( 'page' => $page );
+                if ( ! empty( $request_post['settings_updated'] ) ) { $_GET['settings-updated'] = '1'; }
+                // wp_nonce_field()/Settings API must refer back to the real page, not admin-ajax.php.
+                $_SERVER['REQUEST_URI'] = (string) wp_parse_url( admin_url( 'admin.php' ), PHP_URL_PATH ) . '?' . http_build_query( $_GET );
+                ob_start();
+                try { self::{ $renderers[ $page ] }(); $html = ob_get_contents(); }
+                finally { ob_end_clean(); $_POST = $request_post; $_GET = $request_get; $_SERVER['REQUEST_URI'] = $request_uri; }
+                wp_send_json_success( array( 'html' => $html ) );
+        }
 
         private static function find_quick_tick_item( array $tick, string $original_rel ) : array {
@@ -1832 +1956 @@
                 );
 
-                return array_slice( $items, 0, 10 );
+                return $items;
+        }
+
+        /** Read existing evidence only: never convert images while building the picker. */
+        private static function home_trial_candidates( array $items, PathMapper $mapper, string $format, array $quick, array $settings ) : array {
+                $paths = array_column( $items, 'rel' );
+                $is_avif = 'avif' === $format;
+                $records = $is_avif
+                        ? ( new AvifResultsRepository() )->map_by_source_paths( 'uploads', $paths )
+                        : ( new WebpResultsRepository() )->map_by_source_paths( 'uploads', 'uploads', $paths );
+                $queue = $is_avif ? array() : self::queue_map_for_originals( $paths );
+                $avif_processor = $is_avif ? new AvifProcessor( DerivativesStore::default_store(), $mapper, array(), $settings ) : null;
+                $ready = array();
+                $untested_jpeg = array();
+                $untested_png = array();
+                foreach ( $items as $item ) {
+                        $rel = (string) ( $item['rel'] ?? '' );
+                        $src_abs = $mapper->original_abs_from_original_rel( $rel );
+                        if ( ! is_file( $src_abs ) || is_link( $src_abs ) ) {
+                                continue;
+                        }
+                        $src_mtime = (int) filemtime( $src_abs );
+                        $src_bytes = (int) filesize( $src_abs );
+                        $row = (array) ( $records[ $rel ] ?? array() );
+                        $last_trial = $rel === (string) ( $quick['original_rel'] ?? '' ) && ! empty( $quick['verdict']['done'] );
+                        $last_passed = $last_trial && ! empty( $quick['verdict']['passed'] );
+                        $dst_abs = $is_avif ? $avif_processor->derivative_abs_from_original_rel( $rel ) : $mapper->derivative_abs_from_original_rel( $rel );
+                        $is_png = 'png' === strtolower( (string) pathinfo( $rel, PATHINFO_EXTENSION ) );
+                        $usable = is_file( $dst_abs ) && ! is_link( $dst_abs )
+                                && (int) filesize( $dst_abs ) > 0 && (int) filesize( $dst_abs ) <= $src_bytes
+                                && (int) filemtime( $dst_abs ) >= $src_mtime
+                                && ( $is_avif ? self::is_avif_file( $dst_abs ) : self::is_webp_file( $dst_abs ) );
+                        // PNG/AVIF needs previous successful validation, not just a container header.
+                        if ( $usable && ( ! $is_avif || ! $is_png || $last_passed || 'done' === (string) ( $row['status'] ?? '' ) ) ) {
+                                $ready[] = $item;
+                                if ( count( $ready ) >= 10 ) {
+                                        break;
+                                }
+                                continue;
+                        }
+                        $record_current = $is_avif
+                                ? (int) ( $row['src_bytes'] ?? 0 ) === $src_bytes
+                                : ( (int) ( $row['original_mtime'] ?? -1 ) === $src_mtime && (int) ( $row['src_bytes'] ?? -1 ) === $src_bytes );
+                        $queue_status = (string) ( $queue[ $rel ]['status'] ?? '' );
+                        $queue_failed = 'error' === $queue_status || ( 'skipped' === $queue_status && 'up_to_date' !== (string) ( $queue[ $rel ]['last_error'] ?? '' ) );
+                        if ( ( $record_current && in_array( (string) ( $row['status'] ?? '' ), array( 'error', 'skipped' ), true ) )
+                                || $queue_failed
+                                || ( $last_trial && ! $last_passed ) ) {
+                                continue;
+                        }
+                        if ( $is_png ) {
+                                $untested_png[] = $item;
+                        } else {
+                                $untested_jpeg[] = $item;
+                        }
+                }
+                return array_slice( array_merge( $ready, $untested_jpeg, $untested_png ), 0, 10 );
         }
 
@@ -2307 +2487 @@
                         ? __( 'Another run control request is in progress. Wait briefly and try again.', 'veloimg' )
                         : __( 'The run state could not be confirmed. Synchronize the page before retrying.', 'veloimg' );
+                if ( 'retry_quality_invalid' === $code ) { $message = __( 'Choose a retry quality between 50 and 100.', 'veloimg' ); }
+                if ( 'retry_engine_unavailable' === $code ) { $message = __( 'The selected WebP encoder is unavailable. Refresh the page and select an available encoder.', 'veloimg' ); }
                 $result = array( 'ok' => false, 'code' => $code, 'message' => $message, 'retry_after' => 2 );
                 try { $result['state'] = WebpRunState::state(); } catch ( WebpStateException $read_error ) { $result['state_unavailable'] = true; }
@@ -3924 +4106 @@
                 $all_original_bytes = 0;
                 $last_activity_ts = 0;
+                $retry_paths = array();
                 foreach ( $theme_files as $status ) {
                         $all_original_bytes += max( 0, (int) ( $status['src_bytes'] ?? 0 ) );
@@ -3931 +4114 @@
                         $result_status = (string) ( $result['status'] ?? '' );
                         $is_unsuccessful = ! $is_ready && in_array( $result_status, array( 'skipped', 'error' ), true );
+                        if ( $is_unsuccessful && WebpRetry::candidate( trailingslashit( (string) $status['root_dir'] ) . (string) $status['rel'], (string) ( $result['reason'] ?? '' ) ) ) {
+                                $retry_paths[] = (string) $status['root_slug'] . '/' . (string) $status['rel'];
+                        }
 
                         if ( $is_ready ) {
@@ -3986 +4172 @@
                 }
 
+                $snapshot['retryable'] = count( $retry_paths );
                 return self::$theme_preview_request_cache[ $cache_key ] = array(
+                        'retry_paths'      => $retry_paths,
                         'files'            => $files,
                         'reasons'          => $reasons,
@@ -4181 +4369 @@
                         $summary    = array(
                                 'total'          => $total,
+                                'retryable'      => (int) ( $theme_snapshot['retryable'] ?? 0 ),
                                 'success'        => $done,
                                 'failed'         => $failed,
@@ -4291 +4480 @@
                 $locked_until = ! empty( $lock['locked'] ) ? (int) ( $lock['until'] ?? 0 ) : 0;
                 $now_ts = (int) current_time( 'timestamp' );
-                $folder_label = ( '__all__' === $folder_rel ) ? __( 'Entire Media Library', 'veloimg' ) : $folder_rel;
+                $folder_label = ( '__all__' === $folder_rel ) ? __( 'All uploads', 'veloimg' ) : $folder_rel;
 
                 $mass_state = WebpRunState::state();
@@ -4300 +4489 @@
                 $summary = array(
                         'total'          => $total,
+                        'retryable'      => (int) ( $physical['retryable'] ?? 0 ),
                         'success'        => $done,
                         'failed'         => $failed,
@@ -5516 +5706 @@
                                 'queue' => $queue,
                                 'skipped_reasons' => self::build_failed_reason_rows( (array) $physical['reason_counts'] ),
-                                'summary' => array( 'total' => $total, 'success' => $success, 'failed' => $failed, 'processed' => (int) ( $physical['processed'] ?? 0 ), 'remaining' => (int) ( $physical['remaining'] ?? 0 ), 'pending' => (int) ( $physical['pending'] ?? 0 ), 'processing' => (int) ( $physical['processing'] ?? 0 ), 'failed_reasons' => self::build_failed_reason_rows( (array) $physical['reason_counts'] ), 'outside_months' => (int) ( $all_physical['outside_months'] ?? 0 ), 'outside_summary' => (array) ( $all_physical['outside_summary'] ?? array() ), 'jpg' => (int) ( $physical['jpg'] ?? 0 ), 'png' => (int) ( $physical['png'] ?? 0 ) ),
+                                'summary' => array( 'total' => $total, 'retryable' => (int) ( $physical['retryable'] ?? 0 ), 'success' => $success, 'failed' => $failed, 'processed' => (int) ( $physical['processed'] ?? 0 ), 'remaining' => (int) ( $physical['remaining'] ?? 0 ), 'pending' => (int) ( $physical['pending'] ?? 0 ), 'processing' => (int) ( $physical['processing'] ?? 0 ), 'failed_reasons' => self::build_failed_reason_rows( (array) $physical['reason_counts'] ), 'outside_months' => (int) ( $all_physical['outside_months'] ?? 0 ), 'outside_summary' => (array) ( $all_physical['outside_summary'] ?? array() ), 'jpg' => (int) ( $physical['jpg'] ?? 0 ), 'png' => (int) ( $physical['png'] ?? 0 ) ),
                                 'global_summary' => self::global_optimization_summary( $all_physical ),
                                 'heartbeat' => $heartbeat,
@@ -5545 +5735 @@
                 $folder_rel = (string) $reservation['folder'];
                 if ( 'theme' === $source ) {
-                        $items = (array) ( self::theme_folder_files_slice( $folder_rel, 0, 0 )['items'] ?? array() );
-                        $labels = array();
-                        $preview = array( 'total' => count( $items ), 'done' => 0, 'bytes_src_total' => 0, 'bytes_webp_total' => 0 );
-                        foreach ( $items as $item ) {
-                                $labels[] = (string) $item['root_slug'] . '/' . (string) $item['rel'];
-                                if ( ! empty( $item['ready'] ) ) {
-                                        $preview['done']++;
-                                        $preview['bytes_src_total'] += (int) $item['src_bytes'];
-                                        $preview['bytes_webp_total'] += (int) $item['dst_bytes'];
+                        if ( ! empty( $reservation['retry'] ) ) {
+                                $labels = (array) ( self::build_theme_folder_preview( $folder_rel )['retry_paths'] ?? array() );
+                                if ( empty( $labels ) ) { throw new WebpStateException( 'retry_no_files' ); }
+                                $preview = array( 'total' => count( $labels ), 'done' => 0, 'bytes_src_total' => 0, 'bytes_webp_total' => 0 );
+                        } else {
+                                $items = (array) ( self::theme_folder_files_slice( $folder_rel, 0, 0 )['items'] ?? array() );
+                                $labels = array();
+                                $preview = array( 'total' => count( $items ), 'done' => 0, 'bytes_src_total' => 0, 'bytes_webp_total' => 0 );
+                                foreach ( $items as $item ) {
+                                        $labels[] = (string) $item['root_slug'] . '/' . (string) $item['rel'];
+                                        if ( ! empty( $item['ready'] ) ) {
+                                                $preview['done']++;
+                                                $preview['bytes_src_total'] += (int) $item['src_bytes'];
+                                                $preview['bytes_webp_total'] += (int) $item['dst_bytes'];
+                                        }
                                 }
                         }
@@ -5587 +5783 @@
 
                 $manifest = new WebpManifestMassOrchestrator();
-                $sealed = $manifest->build_sealed( $folder_rel );
+                $retry_paths = null;
+                if ( ! empty( $reservation['retry'] ) ) {
+                        UploadsPhysicalScopeSummary::invalidate_request_cache();
+                        $retry_paths = ( new UploadsPhysicalScopeSummary() )->retry_paths( $folder_rel );
+                        if ( empty( $retry_paths ) ) { throw new WebpStateException( 'retry_no_files' ); }
+                }
+                $sealed = $manifest->build_sealed( $folder_rel, $retry_paths );
                 if ( empty( $sealed['ok'] ) ) {
                         throw new WebpStateException( 'manifest_build_failed' );
@@ -5598 +5800 @@
                         throw new WebpStateException( 'manifest_build_invalid' );
                 }
-                try { $statistics = WebpRunStatistics::initialize( $manifest_id ); }
+                try { $statistics = WebpRunStatistics::initialize( $manifest_id, ! empty( $reservation['retry'] ) ); }
                 catch ( \RuntimeException $error ) { throw new WebpStateException( esc_html( $error->getMessage() ) ); }
 
@@ -5636 +5838 @@
                 catch ( WebpStateException $error ) {
                         $state = WebpRunState::fail( $reservation, $error->reason(), static function () : void { self::assert_mass_owner(); }, true );
-                        return array( 'ok' => false, 'code' => $error->reason(), 'state' => $state, 'message' => __( 'Physical uploads manifest could not be sealed. No generation was started.', 'veloimg' ) );
+                        return array( 'ok' => false, 'code' => $error->reason(), 'state' => $state, 'message' => 'retry_no_files' === $error->reason() ? __( 'No unsuccessful WebP files eligible for retry remain in this selection. Refresh the statistics.', 'veloimg' ) : __( 'Physical uploads manifest could not be sealed. No generation was started.', 'veloimg' ) );
                 }
                 // A Stop during the builder keeps stopping; publication cannot reopen the activation.
@@ -5666 +5868 @@
                 if ( empty( $san['ok'] ) ) { throw new WebpStateException( 'mass_folder_invalid' ); }
                 if ( 'uploads' === $source && ! Installer::exact_identity_cutover_ready() ) { throw new WebpStateException( 'exact_identity_not_ready' ); }
+                $retry = array();
+                if ( '' !== self::request_text( 'retry_quality' ) ) {
+                        $report = Checker::check();
+                        try { $retry = WebpRetry::options( self::request_text( 'retry_quality' ), self::request_key( 'retry_engine', 'auto' ), (array) ( $report['caps'] ?? array() ) ); }
+                        catch ( \InvalidArgumentException $error ) { throw new WebpStateException( esc_html( $error->getMessage() ) ); }
+                }
                 return array(
                         'source' => $source,
                         'folder' => (string) $san['folder'],
                         'mode' => $mode,
+                        'retry' => $retry,
                         // These values only preserve the already rendered snapshot while the
                         // new immutable manifest is sealed. They are not worker counters.
@@ -5800 +6009 @@
 
                                 try {
-                                        $result = $resolver->generate_theme_asset_result( (string) ( $item['original_url'] ?? '' ) );
+                                        $result = $resolver->generate_theme_asset_result( (string) ( $item['original_url'] ?? '' ), (array) ( $state['retry'] ?? array() ) );
                                         $generation = (array) ( $result['generation_result'] ?? array() );
                                         $post_status = self::theme_file_status(

veloimg/trunk/src/Conversion/UploadsPhysicalScopeSummary.php

@@ -39 +39 @@
                 $scope = $this->normalize_scope( $scope );
                 return '__all__' === $scope ? (array) $all['all'] : (array) ( $all['groups'][ $scope ] ?? $this->empty_summary( $scope ) );
+        }
+
+        /** Selected terminal failures from the same read-only classification as the UI. */
+        public function retry_paths( string $scope ) : array {
+                $all = $this->all();
+                return (array) ( $all['retry_paths'][ $this->normalize_scope( $scope ) ] ?? array() );
         }
 
@@ -51 +57 @@
                 $outside = $this->empty_summary( '' );
                 $groups = array();
+                $retry_paths = array( '__all__' => array() );
                 $queue = $this->queue_states();
                 $activity = $this->activity_by_original( $queue['activity'], $this->files_activity() );
@@ -73 +80 @@
                         if ( null === $file ) { continue; }
                         $group = $this->group_for( $original_rel );
+                        if ( ! empty( $file['retryable'] ) ) {
+                                $retry_paths['__all__'][] = $original_rel;
+                                if ( '' !== $group ) { $retry_paths[ $group ][] = $original_rel; }
+                        }
                         if ( '' !== $group && ! isset( $groups[ $group ] ) ) {
                                 $groups[ $group ] = $this->empty_summary( $group );
@@ -92 +103 @@
                 unset( $summary );
                 ksort( $groups, SORT_STRING );
-                self::$request_cache[ $key ] = array( 'all' => $all, 'groups' => $groups, 'queue_rows' => $queue['rows'], 'source_file_count' => $all['total'] );
+                self::$request_cache[ $key ] = array( 'all' => $all, 'groups' => $groups, 'queue_rows' => $queue['rows'], 'source_file_count' => $all['total'], 'retry_paths' => $retry_paths );
                 return self::$request_cache[ $key ];
         }
@@ -113 +124 @@
                 if ( $failed ) { $reason = FailureReasons::normalize( FailureReasons::WEBP, (string) ( $errors[ $original_rel ] ?? 'not_saved' ) ); }
                 return array( 'type' => 'png' === $ext ? 'png' : 'jpg', 'ready' => $ready, 'failed' => $failed,
+                        'retryable' => $failed && WebpRetry::candidate( $original_abs, $reason ),
                         'pending' => ! $ready && 'pending' === $status, 'processing' => ! $ready && 'processing' === $status,
                         'reason' => $reason, 'all_original_bytes' => $src_bytes, 'src_bytes' => $ready ? $src_bytes : 0,
@@ -121 +133 @@
         private function add_file( array &$summary, array $file ) : void {
                 $summary['total']++; $summary[ $file['type'] ]++;
-                foreach ( array( 'ready', 'failed', 'pending', 'processing' ) as $field ) { $summary[ $field ] += (int) $file[ $field ]; }
+                foreach ( array( 'ready', 'failed', 'pending', 'processing', 'retryable' ) as $field ) { $summary[ $field ] = (int) ( $summary[ $field ] ?? 0 ) + (int) $file[ $field ]; }
                 $summary['bytes_src_total'] += $file['src_bytes']; $summary['bytes_webp_total'] += $file['webp_bytes'];
                 $summary['all_original_bytes'] += $file['all_original_bytes'];
@@ -175 +187 @@
         /** @return array<string,mixed> */
         private function empty_summary( string $scope ) : array {
-                return array( 'scope' => $scope, 'total' => 0, 'ready' => 0, 'failed' => 0, 'pending' => 0, 'processing' => 0, 'processed' => 0, 'remaining' => 0, 'outside_months' => 0, 'reason_counts' => array(), 'jpg' => 0, 'png' => 0, 'all_original_bytes' => 0, 'bytes_src_total' => 0, 'bytes_webp_total' => 0, 'last_activity' => '' );
+                return array( 'scope' => $scope, 'total' => 0, 'ready' => 0, 'failed' => 0, 'retryable' => 0, 'pending' => 0, 'processing' => 0, 'processed' => 0, 'remaining' => 0, 'outside_months' => 0, 'reason_counts' => array(), 'jpg' => 0, 'png' => 0, 'all_original_bytes' => 0, 'bytes_src_total' => 0, 'bytes_webp_total' => 0, 'last_activity' => '' );
         }
 

veloimg/trunk/src/Conversion/WebpManifestMassOrchestrator.php

@@ -29 +29 @@
          * @return array<string,mixed>
          */
-        public function build_sealed( string $folder_rel ) : array {
+        public function build_sealed( string $folder_rel, ?array $selected_paths = null ) : array {
                 $scope = $this->scope( $folder_rel );
                 if ( '' === $scope ) {
@@ -35 +35 @@
                 }
 
-                $paths = $this->inventory->files_for_folder( $scope );
+                // A retry supplies server-classified failures, never paths from the browser.
+                $paths = null === $selected_paths ? $this->inventory->files_for_folder( $scope ) : $selected_paths;
                 $begin = $this->manifests->begin_snapshot( 'uploads', $scope );
                 if ( empty( $begin['ok'] ) ) {

veloimg/trunk/src/Database/WebpRunStatistics.php

@@ -61 +61 @@
 
         /** Initial reconciliation is once at Start, never in a polling/result loop. */
-        public static function initialize( string $id ) : array {
+        public static function initialize( string $id, bool $retry = false ) : array {
                 global $wpdb;
                 $manifests = new RunManifestRepository();
@@ -84 +84 @@
                         foreach ( $items as $item ) {
                                 $path = (string) $item['original_path'];
-                                if ( ! self::observe( $path, '', '', (array) ( $records[ $path ] ?? array() ), (array) ( $queues[ DerivativesStore::exact_path_key( $path ) ] ?? array() ) ) ) { throw new \RuntimeException( 'statistics_reconciliation_failed' ); }
+                                // An explicit retry begins a new attempt for this sealed subset, not
+                                // a run already at 100% because its previous failures were terminal.
+                                if ( ! self::observe( $path, $retry ? 'pending' : '', '', (array) ( $records[ $path ] ?? array() ), (array) ( $queues[ DerivativesStore::exact_path_key( $path ) ] ?? array() ) ) ) { throw new \RuntimeException( 'statistics_reconciliation_failed' ); }
                                 $cursor = (int) $item['ordinal'];
                         }

veloimg/trunk/src/Delivery/FormatStrategy.php

@@ -8 +8 @@
         /** @param array<string,mixed> $settings */
         public static function order_for( array $settings ) : array {
-                $strategy = sanitize_key( (string) ( $settings['image_strategy'] ?? 'webp_only' ) );
+                $strategy = sanitize_key( (string) ( $settings['image_strategy'] ?? 'avif_webp' ) );
                 $legacy = array(
                         'max_savings' => 'avif_webp',

veloimg/trunk/src/Delivery/Resolver.php

@@ -9 +9 @@
 use VeloWP\Core\FailureReasons;
 use VeloWP\Core\FileSystem;
+use VeloWP\Conversion\WebpRetry;
 use VeloWP\Concurrency\AtomicLease;
 use VeloWP\Concurrency\LeaseLostException;
@@ -342 +343 @@
          * @return array<string,mixed>
          */
-        public function generate_theme_asset_result( string $url ) : array {
+        public function generate_theme_asset_result( string $url, array $retry = array() ) : array {
                 if ( ! $this->theme_assets_mode_enabled() ) {
                         return array( 'ok' => false );
                 }
-                return $this->resolve_theme_asset( $url, true, true );
+                return $this->resolve_theme_asset( $url, true, true, $retry );
         }
 
@@ -570 +571 @@
          * @return array<string,mixed>
          */
-        private function resolve_theme_asset( string $url, bool $allow_generation = true, bool $include_generation_result = false ) : array {
+        private function resolve_theme_asset( string $url, bool $allow_generation = true, bool $include_generation_result = false, array $retry = array() ) : array {
                 $url      = self::strip_query( $url );
                 $url_path = (string) wp_parse_url( $url, PHP_URL_PATH );
@@ -624 +625 @@
                                                         AtomicLease::assert_owned( (string) $lease['token'] );
                                                         if ( ! $this->is_theme_derivative_usable( $original_abs, $webp_abs ) ) {
-                                                                $generation_result = $this->ensure_theme_derivative_result( $original_abs, $webp_abs, $webp_rel, $webp_url );
+                                                                $generation_result = $this->ensure_theme_derivative_result( $original_abs, $webp_abs, $webp_rel, $webp_url, $retry );
                                                                 AtomicLease::assert_owned( (string) $lease['token'] );
                                                                 $generated = ! empty( $generation_result['ok'] ) && 'done' === (string) ( $generation_result['status'] ?? '' );
@@ -674 +675 @@
          * @return array<string,mixed>
          */
-        private function ensure_theme_derivative_result( string $original_abs, string $webp_abs, string $webp_rel, string $webp_url ) : array {
+        private function ensure_theme_derivative_result( string $original_abs, string $webp_abs, string $webp_rel, string $webp_url, array $retry = array() ) : array {
                 $ext = strtolower( (string) pathinfo( $original_abs, PATHINFO_EXTENSION ) );
                 if ( ! in_array( $ext, array( 'jpg', 'jpeg', 'png' ), true ) ) {
@@ -697 +698 @@
 
                 $max_bytes = $src_bytes > 0 ? $src_bytes : 0;
-                $settings    = (array) get_option( 'velowp_settings', array() );
+                $settings    = WebpRetry::settings( (array) get_option( 'velowp_settings', array() ), $retry );
                 $quality     = $this->quality( $settings );
                 $png_mode    = $this->png_mode( $settings );
                 $webp_mode   = $this->webp_mode( $settings );
                 $png_quality = $this->png_quality( $settings );
-                $caps        = $this->caps();
+                $caps        = WebpRetry::caps( $this->caps(), $retry );
                 if ( ( empty( $caps['imagick_webp'] ) || ! class_exists( '\Imagick' ) ) && ( empty( $caps['gd_webp'] ) || ! function_exists( 'imagewebp' ) ) ) {
                         return $this->theme_generation_error( 'engine_missing', $src_bytes, 0, $webp_rel );

veloimg/trunk/src/Lifecycle/Activate.php

@@ -22 +22 @@
                 // Ensure default settings exist.
                 $defaults = array(
-                        'image_strategy'          => 'webp_only',
+                        'image_strategy'          => 'avif_webp',
                         'delivery_method'         => 'off',
                         'bypass_param'            => 'no_veloimg',

veloimg/trunk/src/Queue/Worker.php

@@ -6 +6 @@
 
 use VeloWP\Converter\Processor;
+use VeloWP\Conversion\WebpRetry;
 use VeloWP\Concurrency\LeaseLostException;
 use VeloWP\Core\Checker;
@@ -181 +182 @@
                         $files_repo = new FilesRepository();
                         $proc     = new Processor( $store, $mapper, $files_repo, (array) ( $report['caps'] ?? array() ), $settings, array( 'assert_ownership' => static function () use ( $token ) : void { Lock::assert_owned( $token ); } ) );
+                        $retry_proc = null;
 
                         foreach ( $pending as $task ) {
@@ -243 +245 @@
                                 }
 
-                                $res = $proc->generate_from_rel( $orig, false );
+                                // Generic ticks may also process automatic uploads. Only rows owned by
+                                // this exact retry run receive its immutable settings, including after Resume.
+                                $task_proc = $proc;
+                                if ( '' !== $task_run_id && $task_run_id === (string) ( $mass_activation['run_id'] ?? '' ) && ! empty( $mass_activation['retry'] ) ) {
+                                        if ( null === $retry_proc ) {
+                                                $retry = (array) $mass_activation['retry'];
+                                                $retry_proc = new Processor( $store, $mapper, $files_repo, WebpRetry::caps( (array) ( $report['caps'] ?? array() ), $retry ), WebpRetry::settings( $settings, $retry ), array( 'assert_ownership' => static function () use ( $token ) : void { Lock::assert_owned( $token ); } ) );
+                                        }
+                                        $task_proc = $retry_proc;
+                                }
+                                $res = $task_proc->generate_from_rel( $orig, false );
                                 Lock::assert_owned( $token );
                                 if ( empty( $res['ok'] ) ) {

veloimg/trunk/templates/admin-avif.php

@@ -12 +12 @@
  * - $avif_jpeg_quality (int)
  * - $avif_png_quality (int)
- * - $avif_candidates (array)
- * - $avif_quick (array)
  * - $avif_folder_candidates (array)
  * - $theme_asset_candidates (array)
@@ -25 +23 @@
 }
 
-$velowp_avif_prefill = '';
-if ( empty( $avif_quick['submitted'] ) && empty( $avif_quick['input'] ) && ! empty( $avif_candidates[0]['url'] ) ) {
-        $velowp_avif_prefill = (string) $avif_candidates[0]['url'];
-}
-$velowp_avif_quick_input_prefill = (string) ( $avif_quick['input'] ?? $velowp_avif_prefill );
-$velowp_avif_generate_attrs = array(
-        'id' => 'velowp-avif-quick-generate',
-        'data-velowp-avif-ready' => $avif_ready ? '1' : '0',
-);
-if ( '' === trim( $velowp_avif_quick_input_prefill ) || ! $avif_ready ) {
-        $velowp_avif_generate_attrs['disabled'] = 'disabled';
-}
-
 $velowp_avif_mass_state  = isset( $avif_mass_status['state'] ) && is_array( $avif_mass_status['state'] ) ? (array) $avif_mass_status['state'] : array();
 $velowp_avif_mass_folder = (string) ( $velowp_avif_mass_state['folder'] ?? '' );
@@ -43 +28 @@
 $velowp_avif_mass_is_theme = 'theme' === $velowp_avif_mass_source;
 $velowp_avif_panel       = 'mass';
-if ( ! empty( $avif_quick['submitted'] ) ) {
-        $velowp_avif_panel = 'quick';
-} elseif ( empty( $avif_mass_status['active'] ) && isset( $_GET['settings-updated'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only Settings API redirect flag; only selects the visible panel.
+if ( empty( $avif_mass_status['active'] ) && isset( $_GET['settings-updated'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only Settings API redirect flag; only selects the visible panel.
         $velowp_avif_panel = 'setup';
 }
@@ -74 +57 @@
                 </div>
 
-                <div class="velowp-topbar__right">
-                        <button type="button" class="velowp-topbtn" data-panel="quick"><?php echo esc_html__( 'Quick check', 'veloimg' ); ?></button>
-                </div>
         </div>
 
@@ -111 +91 @@
                                                                         <output class="velowp-range__out" id="velowp-avif-jpeg-quality-output"><?php echo esc_html( (string) $avif_jpeg_quality ); ?></output>
                                                                 </div>
+                                                                <div class="velowp-range-scale" aria-hidden="true"><span>50</span><span>100</span></div>
                                                                 <p class="description"><?php echo esc_html__( 'Default is 85. Set 100 for lossless or maximum-quality AVIF. Lower values reduce file size.', 'veloimg' ); ?></p>
                                                         </td>
@@ -130 +111 @@
                                                                         <output class="velowp-range__out" id="velowp-avif-png-quality-output"><?php echo esc_html( (string) $avif_png_quality ); ?></output>
                                                                 </div>
+                                                                <div class="velowp-range-scale" aria-hidden="true"><span>50</span><span>100</span></div>
                                                                 <p class="description"><?php echo esc_html__( 'Default is 85. Set 100 for lossless or maximum-quality AVIF. Lower values reduce file size.', 'veloimg' ); ?></p>
                                                                 <p class="description"><?php echo esc_html__( 'These settings will be used by future AVIF generation. They do not start conversion by themselves.', 'veloimg' ); ?></p>
@@ -217 +199 @@
         </section>
 
-        <section class="velowp-panel" data-panel="quick">
-                <form method="post" class="velowp-card velowp-quick-card" action="#quick">
-                        <?php wp_nonce_field( 'velowp_avif_quick', 'velowp_avif_quick_nonce' ); ?>
-
-                        <input type="hidden" name="velowp_avif_quick_input" id="velowp-avif-quick-input" value="<?php echo esc_attr( $velowp_avif_quick_input_prefill ); ?>" />
-
-                        <h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Test AVIF generation on one file', 'veloimg' ); ?></h3>
-                        <p class="description"><?php echo esc_html__( 'Pick one image and run a safe AVIF test conversion. This helps confirm that AVIF generation works before starting bulk processing.', 'veloimg' ); ?></p>
-
-                        <div class="velowp-quick-inline velowp-quick-inline--top">
-                                <?php if ( ! empty( $avif_candidates ) ) : ?>
-                                        <div class="velowp-quick-pick">
-                                                <select id="velowp-avif-candidate-select" class="velowp-select velowp-select--wide">
-                                                        <option value=""><?php echo esc_html__( 'Select', 'veloimg' ); ?></option>
-                                                        <?php foreach ( (array) $avif_candidates as $velowp_candidate ) : ?>
-                                                                <?php
-                                                                        $velowp_candidate_url  = (string) ( $velowp_candidate['url'] ?? '' );
-                                                                        $velowp_candidate_size = (int) ( $velowp_candidate['size'] ?? 0 );
-                                                                        $velowp_width          = (int) ( $velowp_candidate['width'] ?? 0 );
-                                                                        $velowp_height         = (int) ( $velowp_candidate['height'] ?? 0 );
-                                                                        $velowp_candidate_label = '';
-                                                                        if ( ! empty( $velowp_candidate['title'] ) ) {
-                                                                                $velowp_candidate_label .= (string) $velowp_candidate['title'] . ' - ';
-                                                                        }
-                                                                        if ( $velowp_width > 0 && $velowp_height > 0 ) {
-                                                                                $velowp_candidate_label .= $velowp_width . 'x' . $velowp_height;
-                                                                        }
-                                                                        if ( $velowp_candidate_size > 0 ) {
-                                                                                $velowp_candidate_label .= ' - ' . size_format( $velowp_candidate_size, 2 );
-                                                                        }
-                                                                        if ( '' === $velowp_candidate_label ) {
-                                                                                $velowp_candidate_label = $velowp_candidate_url;
-                                                                        }
-                                                                ?>
-                                                                <option value="<?php echo esc_attr( $velowp_candidate_url ); ?>" <?php selected( $velowp_avif_quick_input_prefill, $velowp_candidate_url ); ?>><?php echo esc_html( $velowp_candidate_label ); ?></option>
-                                                        <?php endforeach; ?>
-                                                </select>
-                                        </div>
-                                <?php else : ?>
-                                        <div class="velowp-quick-pick velowp-quick-pick--fallback">
-                                                <input
-                                                        type="text"
-                                                        name="velowp_avif_quick_input"
-                                                        id="velowp-avif-quick-input-fallback"
-                                                        class="regular-text velowp-quick-input"
-                                                        value="<?php echo esc_attr( $velowp_avif_quick_input_prefill ); ?>"
-                                                        placeholder="https://example.com/wp-content/uploads/2025/01/photo.jpg"
-                                                />
-                                        </div>
-                                <?php endif; ?>
-
-                                <div class="velowp-actions velowp-actions--launch velowp-actions--inline">
-                                        <button type="submit" class="button button-primary velowp-btn-glass velowp-btn-glass--primary"
-                                                <?php foreach ( $velowp_avif_generate_attrs as $velowp_attr_name => $velowp_attr_value ) : ?>
-                                                        <?php if ( 'disabled' === (string) $velowp_attr_name ) : ?>
-                                                                disabled
-                                                        <?php else : ?>
-                                                                <?php echo esc_attr( (string) $velowp_attr_name ); ?>="<?php echo esc_attr( (string) $velowp_attr_value ); ?>"
-                                                        <?php endif; ?>
-                                                <?php endforeach; ?>
-                                                name="velowp_avif_quick_action" value="convert_now">
-                                                <?php echo esc_html__( 'Generate AVIF', 'veloimg' ); ?>
-                                        </button>
-                                </div>
-                        </div>
-
-                        <?php if ( ! $avif_ready ) : ?>
-                                <p class="description"><?php echo esc_html__( 'AVIF generation is disabled until the server has an AVIF encoder and a writable derivatives store.', 'veloimg' ); ?></p>
-                        <?php endif; ?>
-
-                        <?php if ( ! empty( $avif_quick['submitted'] ) ) : ?>
-                                <hr class="velowp-hr velowp-hr--quick" />
-                                <h3 class="velowp-h3 velowp-h3--quick-result"><?php echo esc_html__( 'Result', 'veloimg' ); ?></h3>
-
-                                <?php if ( ! empty( $avif_quick['verdict']['done'] ) && empty( $avif_quick['verdict']['passed'] ) ) : ?>
-                                        <div class="notice notice-warning inline velowp-quick-notice">
-                                                <p><strong><?php echo esc_html__( 'AVIF test did not create a usable file.', 'veloimg' ); ?></strong></p>
-                                                <?php if ( ! empty( $avif_quick['verdict']['note'] ) ) : ?>
-                                                        <p class="description velowp-result-note"><?php echo esc_html( (string) $avif_quick['verdict']['note'] ); ?></p>
-                                                <?php endif; ?>
-                                        </div>
-                                <?php elseif ( ! empty( $avif_quick['verdict']['passed'] ) ) : ?>
-                                        <div class="notice notice-success inline velowp-quick-notice">
-                                                <p><?php echo esc_html( (string) ( $avif_quick['verdict']['summary'] ?? __( 'AVIF was created and passed validation.', 'veloimg' ) ) ); ?></p>
-                                        </div>
-                                <?php endif; ?>
-
-                                <?php if ( ! empty( $avif_quick['original_rel'] ) ) : ?>
-                                        <?php
-                                                $velowp_avif_url           = (string) ( $avif_quick['d_expected']['derivative_url'] ?? '' );
-                                                $velowp_avif_exists        = ! empty( $avif_quick['d_expected']['exists'] ) && '' !== $velowp_avif_url;
-                                                $velowp_original_bytes     = (int) ( $avif_quick['result']['original_bytes'] ?? 0 );
-                                                $velowp_avif_bytes         = (int) ( $avif_quick['result']['derivative_bytes'] ?? 0 );
-                                                $velowp_avif_saved_bytes   = 0;
-                                                $velowp_avif_saved_percent = 0;
-                                                $velowp_avif_is_valid      = ! empty( $avif_quick['verdict']['passed'] ) && $velowp_avif_exists && $velowp_avif_bytes > 0;
-                                                if ( $velowp_avif_is_valid && $velowp_original_bytes > 0 && $velowp_avif_bytes < $velowp_original_bytes ) {
-                                                        $velowp_avif_saved_bytes   = (int) ( $velowp_original_bytes - $velowp_avif_bytes );
-                                                        $velowp_avif_saved_percent = (int) round( ( $velowp_avif_saved_bytes / $velowp_original_bytes ) * 100 );
-                                                }
-                                                $velowp_avif_status = $velowp_avif_is_valid ? __( 'Exists and valid', 'veloimg' ) : ( $velowp_avif_exists ? __( 'Exists, but is not usable', 'veloimg' ) : __( 'Not created', 'veloimg' ) );
-                                        ?>
-                                        <div class="velowp-quick-result-grid">
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html__( 'Original (relative path)', 'veloimg' ); ?></div>
-                                                        <div class="velowp-quick-result-value"><code><?php echo esc_html( (string) $avif_quick['original_rel'] ); ?></code></div>
-                                                </div>
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html( $velowp_avif_exists ? __( 'AVIF URL', 'veloimg' ) : __( 'Expected AVIF path', 'veloimg' ) ); ?></div>
-                                                        <div class="velowp-quick-result-value">
-                                                                <?php if ( '' !== $velowp_avif_url ) : ?>
-                                                                        <div class="velowp-quick-result-url">
-                                                                                <code><?php echo esc_html( $velowp_avif_url ); ?></code>
-                                                                                <?php if ( $velowp_avif_exists ) : ?>
-                                                                                        <span class="velowp-link-actions"><a class="button button-small velowp-btn-mini-open" href="<?php echo esc_url( $velowp_avif_url ); ?>" target="_blank" rel="noopener noreferrer"><?php echo esc_html__( 'Open AVIF', 'veloimg' ); ?></a></span>
-                                                                                <?php endif; ?>
-                                                                        </div>
-                                                                        <?php if ( ! $velowp_avif_exists ) : ?>
-                                                                                <p class="description velowp-result-note"><?php echo esc_html__( 'The file does not exist yet, so it cannot be opened.', 'veloimg' ); ?></p>
-                                                                        <?php endif; ?>
-                                                                <?php else : ?>
-                                                                        <code>-</code>
-                                                                <?php endif; ?>
-                                                        </div>
-                                                </div>
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html__( 'File status', 'veloimg' ); ?></div>
-                                                        <div class="velowp-quick-result-value"><?php echo esc_html( $velowp_avif_status ); ?></div>
-                                                </div>
-                                                <?php if ( $velowp_original_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Original size', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_original_bytes, 2 ) ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( $velowp_avif_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'AVIF size', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_avif_bytes, 2 ) ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( $velowp_avif_saved_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Savings', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_avif_saved_bytes, 2 ) . ' (' . $velowp_avif_saved_percent . '%)' ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( ! empty( $avif_quick['verdict']['reasons'] ) && is_array( $avif_quick['verdict']['reasons'] ) ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Reason / details', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value">
-                                                                        <ul class="velowp-list">
-                                                                                <?php foreach ( (array) $avif_quick['verdict']['reasons'] as $velowp_reason ) : ?>
-                                                                                        <li><?php echo esc_html( (string) $velowp_reason ); ?></li>
-                                                                                <?php endforeach; ?>
-                                                                        </ul>
-                                                                </div>
-                                                        </div>
-                                                <?php endif; ?>
-                                        </div>
-                                <?php endif; ?>
-                        <?php endif; ?>
-                </form>
-        </section>
 
         <section class="velowp-panel" data-panel="mass">
@@ -389 +207 @@
                                                 <div>
                                                         <h2 class="velowp-h2 velowp-h2--tight"><?php echo esc_html__( 'AVIF generation', 'veloimg' ); ?></h2>
-                                                        <p class="description"><?php echo esc_html__( 'Choose the entire Media Library, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only AVIF derivatives are created.', 'veloimg' ); ?></p>
+                                                        <p class="description"><?php echo esc_html__( 'Choose all uploads, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only AVIF derivatives are created.', 'veloimg' ); ?></p>
                                                 </div>
                                         </div>
@@ -396 +214 @@
                                                 <label class="velowp-seg">
                                                         <input type="radio" name="velowp_avif_mass_mode" id="velowp-avif-mass-mode-all" value="all" <?php checked( ! $velowp_avif_mass_is_theme && ( '' === $velowp_avif_mass_folder || '__all__' === $velowp_avif_mass_folder ) ); ?> />
-                                                        <span><?php echo esc_html__( 'Entire Media Library', 'veloimg' ); ?></span>
+                                                        <span><?php echo esc_html__( 'All uploads', 'veloimg' ); ?></span>
                                                 </label>
                                                 <label class="velowp-seg">
@@ -484 +302 @@
                                         </div>
                                         <p class="description" id="velowp-avif-mass-progress-text"><?php echo esc_html__( 'No AVIF generation run yet.', 'veloimg' ); ?></p>
+                                        <?php $velowp_generation_format = 'avif'; require VELOWP_DIR . 'templates/generation-concurrency.php'; ?>
 
                                         <div class="velowp-mass-actions velowp-mass-actions--row">
@@ -529 +348 @@
                                         <p id="velowp-avif-outside-months-summary" class="velowp-muted velowp-hidden"></p>
 
+                                        <div class="velowp-table-scroll" tabindex="0" role="region" aria-label="<?php echo esc_attr__( 'Uploads folder statistics', 'veloimg' ); ?>">
                                         <table class="widefat striped velowp-table-tight velowp-folders-table" id="velowp-avif-folders-overview">
                                                 <thead>
@@ -545 +365 @@
                                                 </tbody>
                                         </table>
+                                        </div>
                                         <p class="velowp-folder-more-wrap"><button type="button" class="button" id="velowp-avif-folders-more" hidden><?php echo esc_html__( 'Show more', 'veloimg' ); ?></button></p>
                                 </div>

veloimg/trunk/templates/admin-dashboard.php

@@ -9 +9 @@
  * - $lock_status (array)
  * - $next_tick (int)
- * - $quick (array)
- * - $candidates (array)
  * - $scan (array)
  * - $active_panel (string)
@@ -25 +23 @@
 
 $velowp_panel = is_string( $active_panel ?? null ) && '' !== (string) $active_panel ? (string) $active_panel : 'mass';
-
-// Prefill: pick the largest recent image.
-$velowp_prefill = '';
-if ( empty( $quick['submitted'] ) && empty( $quick['input'] ) && ! empty( $candidates[0]['url'] ) ) {
-        $velowp_prefill = (string) $candidates[0]['url'];
-}
-$velowp_quick_input_prefill = (string) ( $quick['input'] ?? $velowp_prefill );
 
 $velowp_scan_state  = isset( $scan['state'] ) && is_array( $scan['state'] ) ? (array) $scan['state'] : array();
@@ -71 +62 @@
                 </div>
 
-                <div class="velowp-topbar__right">
-                        <button type="button" class="velowp-topbtn" data-velowp-switch="quick"><?php echo esc_html__( 'Quick check', 'veloimg' ); ?></button>
-                </div>
         </div>
 
@@ -87 +75 @@
                         <div class="velowp-card">
                                 <h2 class="velowp-h2"><?php echo esc_html__( 'Generation settings', 'veloimg' ); ?></h2>
-                                <p class="description"><?php echo esc_html__( 'Configure the parameters first, then run a quick generation check. Only generation is checked here; frontend delivery may still be disabled.', 'veloimg' ); ?></p>
+                                <p class="description"><?php echo esc_html__( 'Configure generation here. Single-file tests are in Diagnostics on the VeloIMG home page.', 'veloimg' ); ?></p>
 
                                 <form method="post" action="options.php" class="velowp-settings-form">
@@ -113 +101 @@
                                                                         <output class="velowp-range__out" id="velowp-webp-jpeg-quality-output"><?php echo esc_html( (string) $velowp_webp_jpeg_quality ); ?></output>
                                                                 </div>
+                                                                <div class="velowp-range-scale" aria-hidden="true"><span>50</span><span>100</span></div>
                                                                 <p class="description"><?php echo esc_html__( 'Default is 85. Set 100 for lossless or maximum-quality WebP. Lower values reduce file size.', 'veloimg' ); ?></p>
                                                         </td>
@@ -137 +126 @@
                                                                         <output class="velowp-range__out" id="velowp-webp-png-quality-output"><?php echo esc_html( (string) $velowp_webp_png_quality ); ?></output>
                                                                 </div>
+                                                                <div class="velowp-range-scale" aria-hidden="true"><span>50</span><span>100</span></div>
                                                                 <p class="description"><?php echo esc_html__( 'Default is 85. Set 100 for lossless or maximum-quality WebP. Lower values reduce file size.', 'veloimg' ); ?></p>
                                                                 <p class="description"><?php echo esc_html__( 'These settings will be used by future WebP generation. They do not start conversion by themselves.', 'veloimg' ); ?></p>
@@ -212 +202 @@
         </section>
 
-        <!-- QUICK -->
-        <section class="velowp-panel" data-panel="quick">
-                <form method="post" class="velowp-card velowp-quick-card" action="#quick">
-                        <?php wp_nonce_field( 'velowp_quick', 'velowp_quick_nonce' ); ?>
-
-                        <input type="hidden" name="velowp_quick_input" id="velowp-quick-input" value="<?php echo esc_attr( $velowp_quick_input_prefill ); ?>" />
-
-                        <h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Test generation on one file', 'veloimg' ); ?></h3>
-                        <p class="description"><?php echo esc_html__( 'Pick one image and run a safe test conversion. This helps confirm that WebP generation works before starting bulk processing.', 'veloimg' ); ?></p>
-
-                        <div class="velowp-quick-inline velowp-quick-inline--top">
-                                <?php if ( ! empty( $candidates ) ) : ?>
-                                        <div class="velowp-quick-pick">
-                                                <select id="velowp-candidate-select" class="velowp-select velowp-select--wide">
-                                                        <option value=""><?php echo esc_html__( 'Select', 'veloimg' ); ?></option>
-                                                        <?php foreach ( (array) $candidates as $velowp_candidate ) : ?>
-                                                                <?php
-                                                                        $velowp_candidate_url  = (string) ( $velowp_candidate['url'] ?? '' );
-                                                                        $velowp_candidate_size = (int) ( $velowp_candidate['size'] ?? 0 );
-                                                                        $velowp_width    = (int) ( $velowp_candidate['width'] ?? 0 );
-                                                                        $velowp_height    = (int) ( $velowp_candidate['height'] ?? 0 );
-                                                                        $velowp_candidate_label = '';
-                                                                        if ( ! empty( $velowp_candidate['title'] ) ) {
-                                                                                $velowp_candidate_label .= (string) $velowp_candidate['title'] . ' - ';
-                                                                        }
-                                                                        if ( $velowp_width > 0 && $velowp_height > 0 ) {
-                                                                                $velowp_candidate_label .= $velowp_width . 'x' . $velowp_height;
-                                                                        }
-                                                                        if ( $velowp_candidate_size > 0 ) {
-                                                                                $velowp_candidate_label .= ' - ' . sprintf( '%.2f MB', $velowp_candidate_size / 1024 / 1024 );
-                                                                        }
-                                                                ?>
-                                                                <option value="<?php echo esc_attr( $velowp_candidate_url ); ?>" <?php selected( $velowp_quick_input_prefill, $velowp_candidate_url ); ?>><?php echo esc_html( $velowp_candidate_label ); ?></option>
-                                                        <?php endforeach; ?>
-                                                </select>
-                                        </div>
-                                <?php else : ?>
-                                        <div class="velowp-quick-pick velowp-quick-pick--fallback">
-                                                <input
-                                                        type="text"
-                                                        name="velowp_quick_input"
-                                                        id="velowp-quick-input-fallback"
-                                                        class="regular-text velowp-quick-input"
-                                                        value="<?php echo esc_attr( $velowp_quick_input_prefill ); ?>"
-                                                        placeholder="https://example.com/wp-content/uploads/2025/01/photo.jpg"
-                                                />
-                                        </div>
-                                <?php endif; ?>
-
-                                <div class="velowp-actions velowp-actions--launch velowp-actions--inline">
-                                        <button type="submit" class="button button-primary velowp-btn-glass velowp-btn-glass--primary" id="velowp-quick-generate" name="velowp_quick_action" value="convert_now" <?php disabled( '' === trim( $velowp_quick_input_prefill ) ); ?>><?php echo esc_html__( 'Generate WebP', 'veloimg' ); ?></button>
-                                </div>
-                        </div>
-
-                        <?php if ( ! empty( $quick['submitted'] ) ) : ?>
-                                <hr class="velowp-hr velowp-hr--quick" />
-                                <h3 class="velowp-h3 velowp-h3--quick-result"><?php echo esc_html__( 'Result', 'veloimg' ); ?></h3>
-
-                                <?php
-                                        $velowp_quick_verdict = isset( $quick['verdict'] ) && is_array( $quick['verdict'] ) ? (array) $quick['verdict'] : array();
-                                        $velowp_result_kind   = (string) ( $velowp_quick_verdict['result_kind'] ?? '' );
-                                        $velowp_notice_class  = 'notice-error';
-                                        $velowp_notice_title  = __( 'WebP check failed.', 'veloimg' );
-                                        if ( in_array( $velowp_result_kind, array( 'created', 'already_ready' ), true ) ) {
-                                                $velowp_notice_class = 'notice-success';
-                                                $velowp_notice_title = (string) ( $velowp_quick_verdict['summary'] ?? __( 'WebP was created and passed validation.', 'veloimg' ) );
-                                        } elseif ( 'skipped' === $velowp_result_kind ) {
-                                                $velowp_notice_class = 'notice-warning';
-                                                $velowp_notice_title = __( 'WebP was not saved.', 'veloimg' );
-                                        }
-                                ?>
-                                <?php if ( ! empty( $velowp_quick_verdict['done'] ) ) : ?>
-                                        <div class="notice <?php echo esc_attr( $velowp_notice_class ); ?> inline velowp-quick-notice">
-                                                <p><strong><?php echo esc_html( $velowp_notice_title ); ?></strong></p>
-
-                                                <?php if ( 'skipped' === $velowp_result_kind ) : ?>
-                                                        <p class="description velowp-result-note"><?php echo esc_html__( 'Try another file for testing. Some images are intentionally not saved as WebP when the result would be larger than the original.', 'veloimg' ); ?></p>
-                                                <?php endif; ?>
-                                        </div>
-                                <?php endif; ?>
-
-                                <?php if ( ! empty( $quick['original_rel'] ) ) : ?>
-                                        <?php
-                                                $velowp_derivative_url        = (string) ( $quick['d_expected']['derivative_url'] ?? '' );
-                                                $velowp_valid_webp_exists     = ! empty( $quick['verdict']['derivative_bytes'] ) && in_array( $velowp_result_kind, array( 'created', 'already_ready' ), true );
-                                                $velowp_derivative_url_exists = $velowp_valid_webp_exists && '' !== $velowp_derivative_url;
-                                                $velowp_original_bytes        = (int) ( $quick['verdict']['original_bytes'] ?? 0 );
-                                                $velowp_webp_bytes            = (int) ( $quick['verdict']['derivative_bytes'] ?? 0 );
-                                                $velowp_saved_bytes           = (int) ( $quick['verdict']['saved_bytes'] ?? 0 );
-                                                $velowp_saved_percent         = (int) ( $quick['verdict']['saved_percent'] ?? 0 );
-                                                $velowp_file_status           = $velowp_valid_webp_exists ? __( 'Exists and valid', 'veloimg' ) : ( ! empty( $quick['d_expected']['exists'] ) ? __( 'Exists, but is not usable', 'veloimg' ) : __( 'Not created', 'veloimg' ) );
-                                        ?>
-                                        <div class="velowp-quick-result-grid">
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html__( 'Original (relative path)', 'veloimg' ); ?></div>
-                                                        <div class="velowp-quick-result-value"><code><?php echo esc_html( (string) $quick['original_rel'] ); ?></code></div>
-                                                </div>
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html( $velowp_derivative_url_exists ? __( 'WebP URL', 'veloimg' ) : __( 'Expected WebP path', 'veloimg' ) ); ?></div>
-                                                        <div class="velowp-quick-result-value">
-                                                                <?php if ( '' !== $velowp_derivative_url ) : ?>
-                                                                        <div class="velowp-quick-result-url">
-                                                                                <code><?php echo esc_html( $velowp_derivative_url ); ?></code>
-                                                                                <?php if ( $velowp_derivative_url_exists ) : ?>
-                                                                                        <span class="velowp-link-actions"><a class="button button-small velowp-btn-mini-open" href="<?php echo esc_url( $velowp_derivative_url ); ?>" target="_blank" rel="noopener noreferrer"><?php echo esc_html__( 'Open WebP', 'veloimg' ); ?></a></span>
-                                                                                <?php endif; ?>
-                                                                        </div>
-                                                                        <?php if ( ! $velowp_derivative_url_exists ) : ?>
-                                                                                <p class="description velowp-result-note"><?php echo esc_html__( 'The file does not exist yet, so it cannot be opened.', 'veloimg' ); ?></p>
-                                                                        <?php endif; ?>
-                                                                <?php else : ?>
-                                                                        <code>-</code>
-                                                                <?php endif; ?>
-                                                        </div>
-                                                </div>
-                                                <div class="velowp-quick-result-row">
-                                                        <div class="velowp-quick-result-label"><?php echo esc_html__( 'File status', 'veloimg' ); ?></div>
-                                                        <div class="velowp-quick-result-value"><?php echo esc_html( $velowp_file_status ); ?></div>
-                                                </div>
-                                                <?php if ( $velowp_original_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Original size', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_original_bytes, 2 ) ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( $velowp_webp_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'WebP size', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_webp_bytes, 2 ) ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( $velowp_saved_bytes > 0 ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Savings', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value"><?php echo esc_html( size_format( $velowp_saved_bytes, 2 ) . ' (' . $velowp_saved_percent . '%)' ); ?></div>
-                                                        </div>
-                                                <?php endif; ?>
-                                                <?php if ( ! empty( $quick['verdict']['reasons'] ) && is_array( $quick['verdict']['reasons'] ) ) : ?>
-                                                        <div class="velowp-quick-result-row">
-                                                                <div class="velowp-quick-result-label"><?php echo esc_html__( 'Reason / details', 'veloimg' ); ?></div>
-                                                                <div class="velowp-quick-result-value">
-                                                                        <ul class="velowp-list">
-                                                                                <?php foreach ( (array) $quick['verdict']['reasons'] as $velowp_reason ) : ?>
-                                                                                        <li><?php echo esc_html( (string) $velowp_reason ); ?></li>
-                                                                                <?php endforeach; ?>
-                                                                        </ul>
-                                                                </div>
-                                                        </div>
-                                                <?php endif; ?>
-                                        </div>
-                                <?php endif; ?>
-                        <?php endif; ?>
-                </form>
-
-        </section>
 
         
@@ -374 +209 @@
                         <div class="velowp-mass-grid velowp-mass-grid--top">
                                 <!-- MAIN -->
+                                <div class="velowp-mass-main-column">
                                 <div class="velowp-card velowp-card--glass velowp-mass-card velowp-mass-card--main">
                                         <div class="velowp-mass-card__head">
                                                 <div>
                                                         <h2 class="velowp-h2 velowp-h2--tight"><?php echo esc_html__( 'Bulk WebP generation', 'veloimg' ); ?></h2>
-                                                        <p class="description"><?php echo esc_html__( 'Choose the entire Media Library, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only WebP derivatives are created.', 'veloimg' ); ?></p>
+                                                        <p class="description"><?php echo esc_html__( 'Choose all uploads, a month folder inside uploads (YYYY/MM), or a folder from the active theme. Original files are never modified; only WebP derivatives are created.', 'veloimg' ); ?></p>
                                                 </div>
                                         </div>
@@ -385 +221 @@
                                                 <label class="velowp-seg">
                                                         <input type="radio" name="velowp_mass_mode" id="velowp-mass-mode-all" value="all" checked />
-                                                        <span><?php echo esc_html__( 'Entire Media Library', 'veloimg' ); ?></span>
+                                                        <span><?php echo esc_html__( 'All uploads', 'veloimg' ); ?></span>
                                                 </label>
                                                 <label class="velowp-seg">
@@ -462 +298 @@
                                         </div>
                                         <p class="description" id="velowp-mass-status" aria-live="polite"><?php echo esc_html__( 'Choose a folder to see an estimate and the file list.', 'veloimg' ); ?></p>
+                                        <?php $velowp_generation_format = 'webp'; require VELOWP_DIR . 'templates/generation-concurrency.php'; ?>
 
                                         <div class="velowp-mass-actions velowp-mass-actions--row">
@@ -478 +315 @@
                                 </div>
 
+                                <?php require VELOWP_DIR . 'templates/webp-retry.php'; ?>
+                                </div>
                                 <!-- SUMMARY -->
                                 <div class="velowp-card velowp-card--glass velowp-mass-card velowp-mass-card--summary">
@@ -523 +362 @@
 
                                         <p id="velowp-statistics-status" class="velowp-muted velowp-hidden" role="status" aria-live="polite"></p>
+                                        <div class="velowp-table-scroll" tabindex="0" role="region" aria-label="<?php echo esc_attr__( 'Uploads folder statistics', 'veloimg' ); ?>">
                                         <table class="widefat striped velowp-table-tight velowp-folders-table" id="velowp-folders-overview">
                                                 <thead>
@@ -539 +379 @@
                                                 </tbody>
                                         </table>
+                                        </div>
                                         <p id="velowp-outside-months-summary" class="velowp-muted velowp-hidden" role="status" aria-live="polite"></p>
                                         <p class="velowp-folder-more-wrap"><button type="button" class="button velowp-hidden" id="velowp-folders-more" hidden disabled><?php echo esc_html__( 'Show more', 'veloimg' ); ?></button></p>

veloimg/trunk/templates/admin-home.php

@@ -25 +25 @@
 }
 $velowp_image_strategy_current = isset( $image_strategies[ $image_strategy ] ) && is_array( $image_strategies[ $image_strategy ] ) ? (array) $image_strategies[ $image_strategy ] : array();
-$velowp_image_strategy_label   = (string) ( $velowp_image_strategy_current['label'] ?? __( 'Unknown strategy', 'veloimg' ) );
 $velowp_image_strategy_desc    = (string) ( $velowp_image_strategy_current['description'] ?? '' );
 $velowp_delivery_enabled       = 'off' !== $delivery_method;
@@ -102 +101 @@
                                 <div data-velowp-home-result="avif"><?php echo \VeloWP\Admin\OptimizationSummary::home_html( 'avif' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Shared template escapes each value. ?></div>
                         </div>
-                        <div class="velowp-home-status-card is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>">
-                                <div class="velowp-home-status-card__head">
-                                        <strong><?php echo esc_html__( 'Frontend delivery', 'veloimg' ); ?></strong>
-                                        <span class="velowp-self-test-badge is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>"><?php echo esc_html( $delivery_status ); ?></span>
+                        <div class="velowp-home-status-card is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>" data-velowp-delivery-card>
+                                <div class="velowp-home-status-card__head">
+                                        <strong id="velowp-delivery-label"><?php echo esc_html__( 'Frontend delivery', 'veloimg' ); ?></strong>
+                                        <select class="velowp-self-test-badge velowp-home-badge-select is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>" name="velowp_settings[delivery_method]" id="velowp-delivery-method" form="velowp-home-settings-form" aria-labelledby="velowp-delivery-label" aria-describedby="velowp-delivery-description">
+                                                <?php foreach ( $delivery_labels as $velowp_delivery_key => $velowp_delivery_label ) : ?>
+                                                        <option value="<?php echo esc_attr( $velowp_delivery_key ); ?>" <?php selected( $delivery_method, $velowp_delivery_key ); ?>><?php echo 'off' === $velowp_delivery_key ? esc_html__( 'Off', 'veloimg' ) : esc_html( (string) $velowp_delivery_label ); ?></option>
+                                                <?php endforeach; ?>
+                                        </select>
                                 </div>
                                 <p><?php echo esc_html__( 'Controls whether generated files are served to visitors.', 'veloimg' ); ?></p>
-                                <p class="description">
-                                        <?php
-                                        if ( 'php_safe' === $delivery_method ) {
-                                                echo esc_html__( 'PHP Safe adds picture/source markup in WordPress. If the layout breaks, you may need to add CSS for picture elements.', 'veloimg' );
-                                        } elseif ( 'apache' === $delivery_method ) {
-                                                echo esc_html__( 'Apache / LiteSpeed keeps HTML unchanged and serves generated AVIF/WebP files through uploads/.htaccess when the browser accepts them.', 'veloimg' );
-                                        } else {
-                                                echo esc_html__( 'Visitors receive original images until frontend delivery is enabled.', 'veloimg' );
-                                        }
-                                        ?>
-                                </p>
-                        </div>
-                        <div class="velowp-home-status-card velowp-home-status-card--strategy is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>">
-                                <div class="velowp-home-status-card__head">
-                                        <strong><?php echo esc_html__( 'Frontend format priority', 'veloimg' ); ?></strong>
-                                </div>
-                                <div class="velowp-home-strategy-value is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>"><?php echo esc_html( $velowp_image_strategy_label ); ?></div>
-                                <p><?php echo '' !== $velowp_image_strategy_desc ? esc_html( $velowp_image_strategy_desc ) : esc_html__( 'No frontend strategy selected.', 'veloimg' ); ?></p>
+                                <div id="velowp-delivery-description">
+                                        <p class="description velowp-delivery-method-note" data-velowp-delivery-note="off" <?php echo 'off' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'Visitors receive original images until frontend delivery is enabled.', 'veloimg' ); ?></p>
+                                        <p class="description velowp-delivery-method-note" data-velowp-delivery-note="php_safe" <?php echo 'php_safe' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'PHP Safe adds picture/source markup in WordPress. If the layout breaks, you may need to add CSS for picture elements.', 'veloimg' ); ?></p>
+                                        <p class="description velowp-delivery-method-note" data-velowp-delivery-note="apache" <?php echo 'apache' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'Apache / LiteSpeed keeps HTML unchanged and serves generated AVIF/WebP files through uploads/.htaccess when the browser accepts them.', 'veloimg' ); ?></p>
+                                </div>
+                        </div>
+                        <div class="velowp-home-status-card velowp-home-status-card--strategy is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>" data-velowp-delivery-card>
+                                <div class="velowp-home-status-card__head">
+                                        <strong id="velowp-strategy-label"><?php echo esc_html__( 'Frontend format priority', 'veloimg' ); ?></strong>
+                                </div>
+                                <select class="velowp-home-strategy-value velowp-home-badge-select is-<?php echo esc_attr( $velowp_delivery_card_status ); ?>" name="velowp_settings[image_strategy]" id="velowp-image-strategy" form="velowp-home-settings-form" aria-labelledby="velowp-strategy-label" aria-describedby="velowp-strategy-description">
+                                        <?php foreach ( $image_strategies as $velowp_strategy_key => $velowp_strategy ) : ?>
+                                                <option value="<?php echo esc_attr( $velowp_strategy_key ); ?>" data-description="<?php echo esc_attr( (string) ( $velowp_strategy['description'] ?? '' ) ); ?>" <?php selected( $image_strategy, $velowp_strategy_key ); ?>><?php echo esc_html( (string) ( $velowp_strategy['label'] ?? '' ) ); ?></option>
+                                        <?php endforeach; ?>
+                                </select>
+                                <p id="velowp-strategy-description"><?php echo '' !== $velowp_image_strategy_desc ? esc_html( $velowp_image_strategy_desc ) : esc_html__( 'No frontend strategy selected.', 'veloimg' ); ?></p>
                                 <p class="description"><?php echo esc_html__( 'Format priority is applied only when frontend delivery is enabled.', 'veloimg' ); ?></p>
                         </div>
                 </div>
 
-                <div class="velowp-card velowp-quick-card velowp-self-test-card" id="velowp-self-test">
+                <form method="post" action="options.php" class="velowp-settings-form" id="velowp-home-settings-form">
+                        <?php settings_fields( 'velowp_settings_group' ); ?>
+                        <input type="hidden" name="velowp_settings[_form]" value="home" />
+
+                        <?php submit_button( __( 'Save settings', 'veloimg' ) ); ?>
+                </form>
+
+                <details class="velowp-card velowp-quick-card velowp-home-accordion velowp-self-test-card" id="velowp-self-test" <?php echo $auto_self_test ? 'open' : ''; ?>>
+                        <summary><h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Check setup', 'veloimg' ); ?></h3></summary>
+                        <div class="velowp-home-accordion__body">
                         <div class="velowp-self-test-head">
                                 <div>
-                                        <h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Check setup', 'veloimg' ); ?></h3>
                                         <p class="description"><?php echo esc_html__( 'Run a diagnostic check for generation, storage and the currently selected frontend delivery mode. Original images are not touched and bulk conversion is not started; AVIF checks may create temporary files and delete them immediately.', 'veloimg' ); ?></p>
                                 </div>
@@ -178 +187 @@
                                 <?php endif; ?>
                         </div>
-                </div>
-
-                <div class="velowp-card velowp-quick-card velowp-url-audit-card" id="velowp-url-audit">
-                        <div class="velowp-self-test-head">
-                                <div>
-                                        <h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Check frontend URL', 'veloimg' ); ?></h3>
-                                        <p class="description"><?php echo esc_html__( 'Scan one page from this site and show what visitors actually receive: AVIF, WebP, original fallback, source order or Apache response rewrites.', 'veloimg' ); ?></p>
-                                </div>
-                        </div>
-                        <div class="velowp-url-audit-form">
-                                <input type="url" id="velowp-url-audit-input" class="regular-text" value="<?php echo esc_attr( home_url( '/' ) ); ?>" placeholder="<?php echo esc_attr( home_url( '/' ) ); ?>" />
-                                <button type="button" class="button button-primary velowp-btn-glass velowp-btn-glass--primary" id="velowp-url-audit-run" <?php disabled( 'off' === $delivery_method ); ?>><?php echo esc_html__( 'Check page', 'veloimg' ); ?></button>
-                        </div>
-                        <p class="description"><?php echo esc_html__( 'Only URLs from the current site are allowed. The check does not start generation and does not change files.', 'veloimg' ); ?></p>
-                        <p class="description"><?php echo esc_html__( 'If a page cache is active, clear it after changing frontend delivery; cached HTML can keep old markup until the cache expires.', 'veloimg' ); ?></p>
-                        <div class="velowp-url-audit-result" id="velowp-url-audit-result" aria-live="polite">
-                                <p class="description velowp-muted"><?php echo 'off' === $delivery_method ? esc_html__( 'Frontend delivery is disabled. Enable PHP Safe or Apache /.htaccess before running a page delivery check.', 'veloimg' ) : esc_html__( 'No page check has been run yet.', 'veloimg' ); ?></p>
-                        </div>
-                </div>
-
-                <form method="post" action="options.php" class="velowp-settings-form">
-                        <?php settings_fields( 'velowp_settings_group' ); ?>
-                        <input type="hidden" name="velowp_settings[_form]" value="home" />
-
-                        <h3><?php echo esc_html__( 'Frontend format priority', 'veloimg' ); ?></h3>
-                        <fieldset class="velowp-strategy-options">
-                                <?php foreach ( $image_strategies as $velowp_strategy_key => $velowp_strategy ) : ?>
-                                        <label class="velowp-strategy-option">
-                                                <input type="radio" name="velowp_settings[image_strategy]" value="<?php echo esc_attr( $velowp_strategy_key ); ?>" <?php checked( $image_strategy, $velowp_strategy_key ); ?> />
-                                                <strong><?php echo esc_html( (string) ( $velowp_strategy['label'] ?? '' ) ); ?></strong>
-                                                <br />
-                                                <span class="description"><?php echo esc_html( (string) ( $velowp_strategy['description'] ?? '' ) ); ?></span>
-                                        </label>
-                                <?php endforeach; ?>
-                        </fieldset>
-
+                        </div>
+                </details>
+
+                <details class="velowp-card velowp-quick-card velowp-home-accordion" id="velowp-home-diagnostics" <?php echo $diagnostics_open ? 'open' : ''; ?>>
+                        <summary><h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Diagnostics', 'veloimg' ); ?></h3></summary>
+                        <div class="velowp-home-accordion__body">
+                        <div id="velowp-diagnostics">
+                                <?php require VELOWP_DIR . 'templates/admin-diagnostics.php'; ?>
+                        </div>
                         <table class="form-table" role="presentation">
                                 <tr>
-                                        <th scope="row"><?php echo esc_html__( 'Frontend delivery', 'veloimg' ); ?></th>
+                                        <th scope="row"><label for="velowp-bypass-query"><?php echo esc_html__( 'View original images', 'veloimg' ); ?></label></th>
                                         <td>
-                                                <select name="velowp_settings[delivery_method]" id="velowp-delivery-method">
-                                                        <?php foreach ( $delivery_labels as $velowp_delivery_key => $velowp_delivery_label ) : ?>
-                                                                <option value="<?php echo esc_attr( $velowp_delivery_key ); ?>" <?php selected( $delivery_method, $velowp_delivery_key ); ?>><?php echo esc_html( (string) $velowp_delivery_label ); ?></option>
-                                                        <?php endforeach; ?>
-                                                </select>
-                                                <p class="description velowp-delivery-method-note" data-velowp-delivery-note="off" <?php echo 'off' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'Visitors receive original images until frontend delivery is enabled.', 'veloimg' ); ?></p>
-                                                <p class="description velowp-delivery-method-note" data-velowp-delivery-note="php_safe" <?php echo 'php_safe' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'PHP Safe adds picture/source markup in WordPress. If the layout breaks, you may need to add CSS for picture elements.', 'veloimg' ); ?></p>
-                                                <p class="description velowp-delivery-method-note" data-velowp-delivery-note="apache" <?php echo 'apache' === $delivery_method ? '' : 'hidden'; ?>><?php echo esc_html__( 'Apache / LiteSpeed keeps HTML unchanged and serves generated AVIF/WebP files through uploads/.htaccess when the browser accepts them.', 'veloimg' ); ?></p>
+                                                <div class="velowp-bypass-copy">
+                                                        <input type="text" id="velowp-bypass-query" value="<?php echo esc_attr( $bypass_query ); ?>" class="regular-text" readonly aria-describedby="velowp-bypass-help" />
+                                                        <button type="button" class="button" id="velowp-bypass-copy"><?php echo esc_html__( 'Copy parameter', 'veloimg' ); ?></button>
+                                                        <span id="velowp-bypass-copy-status" role="status" aria-live="polite" data-success="<?php echo esc_attr__( 'Copied.', 'veloimg' ); ?>" data-fallback="<?php echo esc_attr__( 'Parameter selected. Copy it with Ctrl+C or Command+C.', 'veloimg' ); ?>"></span>
+                                                </div>
+                                                <p class="description" id="velowp-bypass-help"><?php echo 'apache' === $delivery_method ? esc_html__( 'Copy the parameter and append it to the JPG/PNG image address to view the original. Saved settings are not changed.', 'veloimg' ) : esc_html__( 'Copy the parameter and append it to the page address to view the original images. Saved settings are not changed.', 'veloimg' ); ?></p>
                                         </td>
                                 </tr>
                                 <tr>
-                                        <th scope="row"><?php echo esc_html__( 'Frontend bypass parameter', 'veloimg' ); ?></th>
+                                        <th scope="row"><label for="velowp-log-level"><?php echo esc_html__( 'Log level', 'veloimg' ); ?></label></th>
                                         <td>
-                                                <input type="text" name="velowp_settings[bypass_param]" value="<?php echo esc_attr( (string) ( $settings['bypass_param'] ?? 'no_veloimg' ) ); ?>" class="regular-text" />
-                                                <p class="description"><?php echo esc_html__( 'Add this query parameter to a page URL to temporarily disable VeloIMG frontend delivery for that page load.', 'veloimg' ); ?></p>
-                                        </td>
-                                </tr>
-                                <tr>
-                                        <th scope="row"><?php echo esc_html__( 'Log level', 'veloimg' ); ?></th>
-                                        <td>
-                                                <select name="velowp_settings[log_level]">
+                                                <select name="velowp_settings[log_level]" id="velowp-log-level" form="velowp-home-settings-form" aria-describedby="velowp-log-help">
                                                         <?php $velowp_log_level = (string) ( $settings['log_level'] ?? 'error' ); ?>
                                                         <option value="error" <?php selected( $velowp_log_level, 'error' ); ?>><?php echo esc_html__( 'Error', 'veloimg' ); ?></option>
@@ -244 +217 @@
                                                         <option value="info" <?php selected( $velowp_log_level, 'info' ); ?>><?php echo esc_html__( 'Info', 'veloimg' ); ?></option>
                                                 </select>
-                                                <p class="description"><?php echo esc_html__( 'Used for diagnostics. Logs are written through error_log() and are visible in wp-content/debug.log when WP_DEBUG_LOG is enabled.', 'veloimg' ); ?></p>
+                                                <p class="description" id="velowp-log-help"><?php echo esc_html__( 'Controls how much diagnostic detail is written to the server error log. Leave Error for normal use; Warning and Info help investigate problems, for example at support request. If WordPress debug logging is enabled, messages appear in wp-content/debug.log.', 'veloimg' ); ?></p>
                                         </td>
                                 </tr>
                         </table>
-
-                        <?php submit_button( __( 'Save settings', 'veloimg' ) ); ?>
-                </form>
+                        </div>
+                </details>
+
+                <details class="velowp-card velowp-quick-card velowp-home-accordion velowp-url-audit-card" id="velowp-url-audit">
+                        <summary><h3 class="velowp-quick-card__title"><?php echo esc_html__( 'Check frontend URL', 'veloimg' ); ?></h3></summary>
+                        <div class="velowp-home-accordion__body">
+                        <div class="velowp-self-test-head">
+                                <div>
+                                        <p class="description"><?php echo esc_html__( 'Scan one page from this site and show what visitors actually receive: AVIF, WebP, original fallback, source order or Apache response rewrites.', 'veloimg' ); ?></p>
+                                </div>
+                        </div>
+                        <div class="velowp-url-audit-form">
+                                <input type="url" id="velowp-url-audit-input" class="regular-text" value="<?php echo esc_attr( home_url( '/' ) ); ?>" placeholder="<?php echo esc_attr( home_url( '/' ) ); ?>" />
+                                <button type="button" class="button button-primary velowp-btn-glass velowp-btn-glass--primary" id="velowp-url-audit-run" <?php disabled( 'off' === $delivery_method ); ?>><?php echo esc_html__( 'Check page', 'veloimg' ); ?></button>
+                        </div>
+                        <p class="description"><?php echo esc_html__( 'Only URLs from the current site are allowed. The check does not start generation and does not change files.', 'veloimg' ); ?></p>
+                        <p class="description"><?php echo esc_html__( 'If a page cache is active, clear it after changing frontend delivery; cached HTML can keep old markup until the cache expires.', 'veloimg' ); ?></p>
+                        <div class="velowp-url-audit-result" id="velowp-url-audit-result" aria-live="polite">
+                                <p class="description velowp-muted"><?php echo 'off' === $delivery_method ? esc_html__( 'Frontend delivery is disabled. Enable PHP Safe or Apache /.htaccess before running a page delivery check.', 'veloimg' ) : esc_html__( 'No page check has been run yet.', 'veloimg' ); ?></p>
+                        </div>
+                        </div>
+                </details>
 
                 <p>

veloimg/trunk/templates/optimization-home-result.php

@@ -21 +21 @@
         <div data-velowp-home-summary-group aria-busy="<?php echo $velowp_frozen ? 'true' : 'false'; ?>">
                 <?php if ( $velowp_global ) : ?>
-                        <p data-velowp-home-summary="saved"><?php echo esc_html__( 'Bytes saved', 'veloimg' ); ?>: <strong><?php echo esc_html( $velowp_saved_label ); ?></strong></p>
+                        <p data-velowp-home-summary="saved"><?php echo esc_html__( 'Bytes saved', 'veloimg' ); ?>: <strong class="velowp-savings-value <?php echo $velowp_saved > 0 ? 'is-success' : ( $velowp_saved < 0 ? 'is-warning' : 'is-neutral' ); ?>"><?php echo esc_html( $velowp_saved_label ); ?></strong></p>
                 <?php endif; ?>
                 <?php if ( isset( $velowp_global['processed'], $velowp_global['ready'], $velowp_global['failed'] ) ) : ?>

veloimg/trunk/veloimg.php

@@ -4 +4 @@
  * Plugin URI: https://veloimg.ru/
  * Description: Generate WebP and AVIF derivatives, manage large media libraries, and deliver optimized images through PHP Safe or Apache/LiteSpeed rules.
- * Version: 0.9.6
+ * Version: 0.9.7
  * Requires at least: 6.9
  * Requires PHP: 7.4
@@ -18 +18 @@
 }
 
-define( 'VELOWP_VERSION', '0.9.6' );
+define( 'VELOWP_VERSION', '0.9.7' );
 define( 'VELOWP_DB_VERSION', '1.5.2' );
 define( 'VELOWP_FILE', __FILE__ );