Changeset 3494018

Timestamp:

03/29/2026 09:03:11 PM (8 weeks ago)

Author:

xavivars

Message:

Bypass cache

Location:

xv-random-quotes/trunk

Files:

• changelog.txt (modified) (1 diff)
• js/quote-refresh.js (modified) (3 diffs)
• readme.txt (modified) (1 diff)
• src/Admin/OverviewPage.php (modified) (1 diff)
• src/Admin/Settings.php (modified) (4 diffs)
• src/Blocks/RandomQuote/block.json (modified) (1 diff)
• src/Blocks/RandomQuote/index.tsx (modified) (3 diffs)
• src/Blocks/RandomQuote/render.php (modified) (2 diffs)
• src/Output/QuoteOutput.php (modified) (5 diffs)
• src/Shortcodes/ShortcodeHandlers.php (modified) (3 diffs)
• src/generated/random-quote-block.asset.php (modified) (1 diff)
• src/generated/random-quote-block.js (modified) (1 diff)
• xv-random-quotes.php (modified) (1 diff)

xv-random-quotes/trunk/changelog.txt

@@ -1 +1 @@
 == XV Random Quotes ==
+
+= 2.9.0 =
+New feature: Cache bypass mode — AJAX-enabled quotes can now fetch a fresh quote on every page load, bypassing full-page caches like WP Rocket
+New feature: Global "Bypass Page Cache" setting in AJAX Settings
+New feature: Per-block "Bypass page cache" toggle in the Random Quote block editor
+New feature: cache_bypass shortcode attribute for [stray-random]
+Fix: AJAX refresh no longer sends a WP nonce header, preventing failures on pages cached longer than 12-24 hours
+Fix: Admin card padding overridden to restore proper spacing when other plugins (e.g. Subscribe to Comments Reloaded) zero out .card padding
 
 = 2.8.0 =

xv-random-quotes/trunk/js/quote-refresh.js

@@ -32 +32 @@
         // Set up auto-refresh timers
         const containers = document.querySelectorAll('.xv-quote-container[data-timer]');
-        
+
         containers.forEach(function(container) {
             const timer = parseInt(container.getAttribute('data-timer'), 10);
-            
+
             if (timer > 0) {
                 setInterval(function() {
@@ -41 +41 @@
                 }, timer * 1000); // Convert seconds to milliseconds
             }
+        });
+
+        // Load-on-init: fetch a fresh quote immediately for cache-bypass containers
+        const initContainers = document.querySelectorAll('.xv-quote-container[data-load-on-init="1"]');
+
+        initContainers.forEach(function(container) {
+            refreshQuote(container);
         });
     }
@@ -95 +102 @@
             method: 'GET',
             headers: {
-                'Content-Type': 'application/json',
-                'X-WP-Nonce': xvQuoteRefresh.restNonce
-            },
-            credentials: 'same-origin'
+                'Content-Type': 'application/json'
+            }
         })
         .then(function(response) {

xv-random-quotes/trunk/readme.txt

@@ -6 +6 @@
 Tested up to: 6.9
 Requires PHP: 7.4
-Stable tag: 2.8.0
+Stable tag: 2.9.0
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html

xv-random-quotes/trunk/src/Admin/OverviewPage.php

@@ -231 +231 @@
                     max-width: 100%;
                     margin-bottom: 20px;
+                    padding: 16px 20px 20px !important;
                 }
                 .wrap .card h3 {

xv-random-quotes/trunk/src/Admin/Settings.php

@@ -52 +52 @@
     // AJAX Settings
     const OPTION_AJAX           = 'xv_quotes_ajax';
+    const OPTION_CACHE_BYPASS   = 'xv_quotes_cache_bypass';
     const OPTION_LOADER         = 'xv_quotes_loader';
     const OPTION_BEFORE_LOADER  = 'xv_quotes_before_loader';
@@ -196 +197 @@
         register_setting(
             self::SETTINGS_GROUP,
+            self::OPTION_CACHE_BYPASS,
+            array(
+                'type'              => 'string',
+                'default'           => '0',
+                'sanitize_callback' => array( $this, 'sanitize_checkbox' ),
+            )
+        );
+
+        register_setting(
+            self::SETTINGS_GROUP,
             self::OPTION_LOADER,
             array(
@@ -523 +534 @@
                 'option_name' => self::OPTION_AJAX,
                 'description' => __( 'Check to disable AJAX dynamic loading entirely. When unchecked, AJAX can still be disabled from widgets, shortcodes, or template tags.', 'xv-random-quotes' ),
+            )
+        );
+
+        add_settings_field(
+            self::OPTION_CACHE_BYPASS,
+            __( 'Bypass Page Cache Globally', 'xv-random-quotes' ),
+            array( $this, 'render_checkbox_field' ),
+            self::PAGE_SLUG,
+            'xv_quotes_ajax',
+            array(
+                'label_for'   => self::OPTION_CACHE_BYPASS,
+                'option_name' => self::OPTION_CACHE_BYPASS,
+                'description' => __( 'When enabled, all AJAX-enabled quotes will fetch a fresh quote on every page load, bypassing full-page caches like WP Rocket. Requires AJAX to be enabled on each quote block or shortcode.', 'xv-random-quotes' ),
             )
         );
@@ -798 +822 @@
                 max-width: 100%;
                 margin-bottom: 20px;
+                padding: 16px 20px 20px !important;
             }
             .xv-quotes-settings .card h2 {

xv-random-quotes/trunk/src/Blocks/RandomQuote/block.json

@@ -37 +37 @@
             "type": "number",
             "default": 0
+        },
+        "cacheBypass": {
+            "type": "boolean",
+            "default": false
         }
     },

xv-random-quotes/trunk/src/Blocks/RandomQuote/index.tsx

@@ -16 +16 @@
     enableAjax: boolean;
     timer: number;
+    cacheBypass: boolean;
 }
 
@@ -60 +61 @@
                 />
                 {attributes.enableAjax && (
+                    <>
                     <RangeControl
                         label={__('Auto-refresh timer (seconds)', 'xv-random-quotes')}
@@ -68 +70 @@
                         help={__('0 = no auto-refresh', 'xv-random-quotes')}
                     />
+                    <ToggleControl
+                        label={__('Bypass page cache', 'xv-random-quotes')}
+                        checked={attributes.cacheBypass}
+                        onChange={(value) => setAttributes({ cacheBypass: value })}
+                        help={__('Fetch a fresh quote on every page load, even when the page is cached', 'xv-random-quotes')}
+                    />
+                    </>
                 )}
             </BlockEditor>

xv-random-quotes/trunk/src/Blocks/RandomQuote/render.php

@@ -22 +22 @@
     $enableAjax    = $attributes['enableAjax'] ?? false;
     $timer         = $attributes['timer'] ?? 0;
+    $cacheBypass   = $attributes['cacheBypass'] ?? false;
 
     // Use QuoteOutput class for complete rendering (including AJAX if enabled)
@@ -33 +34 @@
             'disableaspect' => $disableaspect,
             'enable_ajax'   => $enableAjax,
+            'cache_bypass'  => $cacheBypass,
             'timer'         => $timer,
         )

xv-random-quotes/trunk/src/Output/QuoteOutput.php

@@ -82 +82 @@
                 'contributor'   => '',
                 'enable_ajax'   => false,
+                'cache_bypass'  => false,
                 'link_phrase'   => '',
                 'timer'         => 0,
@@ -118 +119 @@
         // Wrap with AJAX functionality if enabled
         if ( $args['enable_ajax'] ) {
-            return $this->wrap_with_ajax( $quote_html, $args, $quotes );
+            // Apply global cache bypass setting if not already enabled per-instance
+            $cache_bypass = $args['cache_bypass'];
+            if ( ! $cache_bypass && get_option( Settings::OPTION_CACHE_BYPASS, false ) === '1' ) {
+                $cache_bypass = true;
+            }
+            return $this->wrap_with_ajax( $quote_html, $args, $quotes, $cache_bypass );
         }
 
@@ -127 +133 @@
      * Wrap quote HTML with AJAX container and refresh link
      *
-     * @param string $quote_html The rendered quote HTML.
-     * @param array  $args       Arguments array with AJAX configuration.
-     * @param array  $quotes     Array of WP_Post quote objects being displayed.
+     * @param string $quote_html  The rendered quote HTML.
+     * @param array  $args        Arguments array with AJAX configuration.
+     * @param array  $quotes      Array of WP_Post quote objects being displayed.
+     * @param bool   $cache_bypass When true, renders an empty container so JS fetches a fresh quote on every page load.
      * @return string HTML wrapped with AJAX functionality.
      */
-    private function wrap_with_ajax( $quote_html, $args, $quotes = array() ) {
+    private function wrap_with_ajax( $quote_html, $args, $quotes = array(), $cache_bypass = false ) {
         // Generate or use provided container ID
         $container_id = ! empty( $args['container_id'] ) ? $args['container_id'] : 'xv-quote-container-' . uniqid();
@@ -164 +171 @@
         $output .= ' data-timer="' . esc_attr( absint( $args['timer'] ) ) . '"';
 
+        if ( $cache_bypass ) {
+            $output .= ' data-load-on-init="1"';
+        }
+
         $output .= '>';
-        $output .= $quote_html;
+
+        if ( ! $cache_bypass ) {
+            $output .= $quote_html;
+        }
 
         // Add refresh link (only if not auto-refresh only)
@@ -211 +225 @@
                 'xvQuoteRefresh',
                 array(
-                    'restUrl'   => esc_url_raw( rest_url( 'xv-random-quotes/v1/quote/random' ) ),
-                    'restNonce' => wp_create_nonce( 'wp_rest' ),
+                    'restUrl' => esc_url_raw( rest_url( 'xv-random-quotes/v1/quote/random' ) ),
                 )
             );

xv-random-quotes/trunk/src/Shortcodes/ShortcodeHandlers.php

@@ -111 +111 @@
         'noajax' => '',
         'enable_ajax' => '',
+        'cache_bypass' => '',
         'multi' => 1,
         'timer' => '',
@@ -138 +139 @@
     }
 
+    $cache_bypass = ! empty( $atts['cache_bypass'] ) ? filter_var( $atts['cache_bypass'], FILTER_VALIDATE_BOOLEAN ) : false;
+
     // Use QuoteOutput class for complete rendering (including AJAX if enabled)
     $quote_output = new QuoteOutput();
@@ -149 +152 @@
             'contributor'   => $atts['user'],
             'enable_ajax'   => $enable_ajax,
+            'cache_bypass'  => $cache_bypass,
             'link_phrase'   => $atts['linkphrase'],
             'timer'         => ! empty( $atts['timer'] ) ? absint( $atts['timer'] ) : 0,

xv-random-quotes/trunk/src/generated/random-quote-block.asset.php

@@ -1 @@
-<?php return array('dependencies' => array('react-jsx-runtime', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-i18n', 'wp-server-side-render'), 'version' => '53d7bb16db4cdfcfcaec');
+<?php return array('dependencies' => array('react-jsx-runtime', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-i18n', 'wp-server-side-render'), 'version' => '0486856f86ec2cf71c23');

xv-random-quotes/trunk/src/generated/random-quote-block.js

@@ -1 @@
-(()=>{"use strict";var e={n:o=>{var n=o&&o.__esModule?()=>o.default:()=>o;return e.d(n,{a:n}),n},d:(o,n)=>{for(var t in n)e.o(n,t)&&!e.o(o,t)&&Object.defineProperty(o,t,{enumerable:!0,get:n[t]})},o:(e,o)=>Object.prototype.hasOwnProperty.call(e,o)};const o=window.wp.blocks,n=window.wp.components,t=window.wp.i18n,a=window.wp.blockEditor,r=window.wp.serverSideRender;var s=e.n(r);const l=window.ReactJSXRuntime,d=({blockName:e,attributes:o,children:r,renderCondition:d=!0,placeholderMessage:i=null})=>{const u=(0,a.useBlockProps)();return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(a.InspectorControls,{children:(0,l.jsx)(n.PanelBody,{title:(0,t.__)("Quote Settings","xv-random-quotes"),children:r})}),(0,l.jsx)("div",{...u,children:d?(0,l.jsx)(s(),{block:e,attributes:o}):i&&(0,l.jsx)("p",{children:i})})]})},i=({value:e,onChange:o})=>(0,l.jsx)(n.TextControl,{label:(0,t.__)("Categories (comma-separated slugs)","xv-random-quotes"),value:e,onChange:o,help:(0,t.__)("Leave empty for all categories","xv-random-quotes")}),u=({checked:e,onChange:o})=>(0,l.jsx)(n.ToggleControl,{label:(0,t.__)("Disable styling","xv-random-quotes"),checked:e,onChange:o,help:(0,t.__)("Remove default HTML wrappers","xv-random-quotes")});(0,o.registerBlockType)("xv-random-quotes/random-quote",{edit:e=>{const{attributes:o,setAttributes:a}=e;return(0,l.jsxs)(d,{blockName:"xv-random-quotes/random-quote",attributes:o,children:[(0,l.jsx)(i,{value:o.categories,onChange:e=>a({categories:e})}),(0,l.jsx)(n.RangeControl,{label:(0,t.__)("Number of quotes","xv-random-quotes"),value:o.multi,onChange:e=>a({multi:e||1}),min:1,max:10,help:(0,t.__)("How many quotes to display","xv-random-quotes")}),(0,l.jsx)(n.ToggleControl,{label:(0,t.__)("Sequential order","xv-random-quotes"),checked:o.sequence,onChange:e=>a({sequence:e}),help:(0,t.__)("Show quotes in order instead of random","xv-random-quotes")}),(0,l.jsx)(u,{checked:o.disableaspect,onChange:e=>a({disableaspect:e})}),(0,l.jsx)(n.ToggleControl,{label:(0,t.__)("Enable AJAX refresh","xv-random-quotes"),checked:o.enableAjax,onChange:e=>a({enableAjax:e})}),o.enableAjax&&(0,l.jsx)(n.RangeControl,{label:(0,t.__)("Auto-refresh timer (seconds)","xv-random-quotes"),value:o.timer,onChange:e=>a({timer:e}),min:0,max:300,help:(0,t.__)("0 = no auto-refresh","xv-random-quotes")})]})},save:()=>null})})();
+(()=>{"use strict";var e={n:o=>{var n=o&&o.__esModule?()=>o.default:()=>o;return e.d(n,{a:n}),n},d:(o,n)=>{for(var a in n)e.o(n,a)&&!e.o(o,a)&&Object.defineProperty(o,a,{enumerable:!0,get:n[a]})},o:(e,o)=>Object.prototype.hasOwnProperty.call(e,o)};const o=window.wp.blocks,n=window.wp.components,a=window.wp.i18n,t=window.wp.blockEditor,s=window.wp.serverSideRender;var r=e.n(s);const l=window.ReactJSXRuntime,d=({blockName:e,attributes:o,children:s,renderCondition:d=!0,placeholderMessage:c=null})=>{const u=(0,t.useBlockProps)();return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(t.InspectorControls,{children:(0,l.jsx)(n.PanelBody,{title:(0,a.__)("Quote Settings","xv-random-quotes"),children:s})}),(0,l.jsx)("div",{...u,children:d?(0,l.jsx)(r(),{block:e,attributes:o}):c&&(0,l.jsx)("p",{children:c})})]})},c=({value:e,onChange:o})=>(0,l.jsx)(n.TextControl,{label:(0,a.__)("Categories (comma-separated slugs)","xv-random-quotes"),value:e,onChange:o,help:(0,a.__)("Leave empty for all categories","xv-random-quotes")}),u=({checked:e,onChange:o})=>(0,l.jsx)(n.ToggleControl,{label:(0,a.__)("Disable styling","xv-random-quotes"),checked:e,onChange:o,help:(0,a.__)("Remove default HTML wrappers","xv-random-quotes")});(0,o.registerBlockType)("xv-random-quotes/random-quote",{edit:e=>{const{attributes:o,setAttributes:t}=e;return(0,l.jsxs)(d,{blockName:"xv-random-quotes/random-quote",attributes:o,children:[(0,l.jsx)(c,{value:o.categories,onChange:e=>t({categories:e})}),(0,l.jsx)(n.RangeControl,{label:(0,a.__)("Number of quotes","xv-random-quotes"),value:o.multi,onChange:e=>t({multi:e||1}),min:1,max:10,help:(0,a.__)("How many quotes to display","xv-random-quotes")}),(0,l.jsx)(n.ToggleControl,{label:(0,a.__)("Sequential order","xv-random-quotes"),checked:o.sequence,onChange:e=>t({sequence:e}),help:(0,a.__)("Show quotes in order instead of random","xv-random-quotes")}),(0,l.jsx)(u,{checked:o.disableaspect,onChange:e=>t({disableaspect:e})}),(0,l.jsx)(n.ToggleControl,{label:(0,a.__)("Enable AJAX refresh","xv-random-quotes"),checked:o.enableAjax,onChange:e=>t({enableAjax:e})}),o.enableAjax&&(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(n.RangeControl,{label:(0,a.__)("Auto-refresh timer (seconds)","xv-random-quotes"),value:o.timer,onChange:e=>t({timer:e}),min:0,max:300,help:(0,a.__)("0 = no auto-refresh","xv-random-quotes")}),(0,l.jsx)(n.ToggleControl,{label:(0,a.__)("Bypass page cache","xv-random-quotes"),checked:o.cacheBypass,onChange:e=>t({cacheBypass:e}),help:(0,a.__)("Fetch a fresh quote on every page load, even when the page is cached","xv-random-quotes")})]})]})},save:()=>null})})();

xv-random-quotes/trunk/xv-random-quotes.php

@@ -5 +5 @@
 Author: Xavi Ivars
 Author URI: https://xavi.ivars.me/
-Version: 2.8.0
+Version: 2.9.0
 Requires at least: 6.0
 Requires PHP: 7.4