Changeset 3383047

Timestamp:

10/23/2025 04:46:42 AM (4 months ago)

Author:

stooit

Message:

Release 1.6.0

Location:

quant/trunk

Files:

• quant.php (modified) (2 diffs)
• readme.txt (modified) (2 diffs)
• src/Client.php (modified) (1 diff)
• src/Settings.php (modified) (2 diffs)
• src/SettingsScreen.php (modified) (2 diffs)
• src/functions.php (modified) (4 diffs)

quant/trunk/quant.php

@@ -6 +6 @@
  * Author: www.quantcdn.io
  * Plugin URI: https://www.quantcdn.io
- * Version: 1.5.2
+ * Version: 1.6.0
  * License: GPL-2.0+
  * License URI: http://www.gnu.org/licenses/gpl-2.0.txt
@@ -39 +39 @@
     add_option(QUANT_SETTINGS_KEY, [
         'enabled' => 0,
+        'purge_on_save' => 1,
         'api_endpoint' => 'https://api.quantcdn.io',
         'webserver_url' => '',

quant/trunk/readme.txt

@@ -5 +5 @@
 Requires at least: 4.6
 Tested up to: 6.8.2
-Requires PHP: 8.1
-Stable tag: 1.5.2
+Requires PHP: 7.4
+Stable tag: 1.6.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -66 +66 @@
 == Changelog ==
 
+= 1.6.0 =
+* Feature: Added new Cache tab for manual CDN cache purging (purge all or selective paths).
+* Feature: Added "Cache purge on save" option to automatically purge CDN cache when content changes.
+* Feature: Renamed "Quant Enabled" to "Automatic static push" for clarity.
+* Feature: Automatic trailing slash handling - purges both /path and /path/ variants.
+* Improvement: Enhanced error handling and validation for cache purge operations.
+* Improvement: Cache purge now works independently of automatic static push.
+* Tested with WordPress 6.8.2.
+* Updated minimum PHP requirement to 7.4 (previously stated 8.1).
+
 = 1.5.2 =
 * Tested with WordPress 6.8.2.
+* Updated minimum PHP requirement to 7.4 (previously stated 8.1).
 
 = 1.5.1 =

quant/trunk/src/Client.php

@@ -172 +172 @@
     /**
      * Purge the cache for a route in Quant.
+     * Automatically purges both with and without trailing slash (except homepage).
      *
      * @param string $route
+     * @return array Array with 'success' (bool), 'message' (string), and optional 'body' (string)
      */
     public function purge($route) {
 
-        $args = [
-            'headers' => $this->headers,
-            'timeout' => $this->httpRequestTimeout,
-        ];
-
-        $args['headers']['Quant-Url'] = $route;
-
-        if ($this->disableTlsVerify) {
-          $args['sslverify'] = FALSE;
-        }
-
-        $response = wp_remote_post($this->endpoint . '/purge', $args);
-        $body = wp_remote_retrieve_body($response);
-
-        return $body;
+        $routes_to_purge = [$route];
+        
+        // For non-homepage routes, also purge the alternate trailing slash variant
+        if (strlen($route) > 1) {
+            if (substr($route, -1) === '/') {
+                // Has trailing slash, also purge without
+                $routes_to_purge[] = rtrim($route, '/');
+            } else {
+                // No trailing slash, also purge with
+                $routes_to_purge[] = $route . '/';
+            }
+        }
+
+        $last_result = null;
+        
+        foreach ($routes_to_purge as $purge_route) {
+            $args = [
+                'headers' => $this->headers,
+                'timeout' => $this->httpRequestTimeout,
+            ];
+
+            $args['headers']['Quant-Url'] = $purge_route;
+
+            if ($this->disableTlsVerify) {
+              $args['sslverify'] = FALSE;
+            }
+
+            $response = wp_remote_post($this->endpoint . '/purge', $args);
+            
+            // Check for WordPress HTTP errors
+            if (is_wp_error($response)) {
+                $error_message = $response->get_error_message();
+                return [
+                    'success' => false,
+                    'message' => "HTTP Error: {$error_message}",
+                ];
+            }
+
+            $status_code = wp_remote_retrieve_response_code($response);
+            $body = wp_remote_retrieve_body($response);
+
+            // Check for non-200 status codes
+            if ($status_code < 200 || $status_code >= 300) {
+                $error_msg = "API returned status {$status_code}";
+                if (!empty($body)) {
+                    $decoded = json_decode($body, true);
+                    if (isset($decoded['error'])) {
+                        $error_msg .= ": " . $decoded['error'];
+                    } else if (isset($decoded['message'])) {
+                        $error_msg .= ": " . $decoded['message'];
+                    }
+                }
+                return [
+                    'success' => false,
+                    'message' => $error_msg,
+                ];
+            }
+
+            $last_result = [
+                'success' => true,
+                'message' => 'Cache purged successfully',
+                'body' => $body,
+            ];
+        }
+
+        return $last_result;
     }
 

quant/trunk/src/Settings.php

@@ -39 +39 @@
          * General settings form fields.
          */
-        add_settings_field('quant_enabled', 'Quant Enabled', ['Quant\Field', 'checkbox'], $key, 'general', [
+        add_settings_field('quant_enabled', 'Automatic static push', ['Quant\Field', 'checkbox'], $key, 'general', [
             'name' => "{$key}[enabled]",
-            'description' => 'Enable QuantCDN integration',
+            'description' => 'Automatically push static content to Quant when content changes',
             'value' => $options['enabled'] ?? 0,
+        ]);
+
+        add_settings_field('quant_purge_on_save', 'Cache purge on save', ['Quant\Field', 'checkbox'], $key, 'general', [
+            'name' => "{$key}[purge_on_save]",
+            'description' => 'Automatically purge CDN cache when content changes<br><small><em>Note: This is automatically enabled when "Automatic static push" is checked.</em></small>',
+            'value' => $options['purge_on_save'] ?? 1,
         ]);
 
@@ -195 +201 @@
     public static function sanitize($input)
     {
-        // @todo: Sanitization
+        // If automatic static push is enabled, ensure cache purge is also enabled
+        // since pushing content inherently purges the cache
+        if (!empty($input['enabled'])) {
+            $input['purge_on_save'] = 1;
+        }
+        
         return $input;
     }

quant/trunk/src/SettingsScreen.php

@@ -95 +95 @@
                 <a href="?page=quant&tab=settings" class="nav-tab <?php echo $active_tab == 'settings' ? 'nav-tab-active' : ''; ?>">Settings</a>
                 <a href="?page=quant&tab=cron" class="nav-tab <?php echo $active_tab == 'cron' ? 'nav-tab-active' : ''; ?>">Cron</a>
+                <a href="?page=quant&tab=cache" class="nav-tab <?php echo $active_tab == 'cache' ? 'nav-tab-active' : ''; ?>">Cache</a>
             </h2>
 
+            <?php if( $active_tab == 'cache' ) { ?>
+                <!-- Cache tab doesn't use a form, it has custom actions -->
+                <?php self::renderCacheTab(); ?>
+            <?php } else { ?>
             <form method="post" action="<?php echo esc_url( add_query_arg('tab', $active_tab, admin_url( 'options.php' )) ); ?>">
 
@@ -119 +124 @@
                 ?>
             </form>
+            <?php } ?>
 
         </div><?php
     }
+
+    /**
+     * Render the Cache management tab
+     *
+     * @return void
+     */
+    public static function renderCacheTab()
+    {
+        ?>
+        <div class="quant-cache-management">
+            <style>
+                .quant-cache-card {
+                    background: #fff;
+                    border: 1px solid #ccd0d4;
+                    box-shadow: 0 1px 1px rgba(0,0,0,.04);
+                    margin: 20px 0;
+                    padding: 20px;
+                    max-width: 800px;
+                }
+                .quant-cache-card h3 {
+                    margin-top: 0;
+                }
+                .quant-cache-card p {
+                    color: #646970;
+                }
+                .quant-purge-paths {
+                    width: 100%;
+                    min-height: 150px;
+                    font-family: monospace;
+                }
+                .quant-cache-response {
+                    margin-top: 15px;
+                    padding: 10px;
+                    display: none;
+                }
+                .quant-cache-response.success {
+                    display: block;
+                    background: #d7f0d7;
+                    border-left: 4px solid #46b450;
+                    color: #000;
+                }
+                .quant-cache-response.error {
+                    display: block;
+                    background: #f8d7da;
+                    border-left: 4px solid #dc3545;
+                    color: #721c24;
+                }
+                .quant-button-large {
+                    height: 40px;
+                    font-size: 14px;
+                }
+            </style>
+
+            <div class="quant-cache-card">
+                <h3>Purge All Cache</h3>
+                <p>This will purge the entire CDN cache for your site by purging "/*".</p>
+                <button type="button" id="quant-purge-all" class="button button-primary button-hero quant-button-large">
+                    Purge All Cache
+                </button>
+                <div id="quant-purge-all-response" class="quant-cache-response"></div>
+            </div>
+
+            <div class="quant-cache-card">
+                <h3>Purge Selective Paths</h3>
+                <p>Enter specific paths to purge from the CDN cache (one per line):</p>
+                <textarea id="quant-purge-paths" class="quant-purge-paths" placeholder="/path/to/page&#10;/another/path&#10;/blog/*"></textarea>
+                <p><em>Examples: /about, /blog/*, /wp-content/themes/mytheme/style.css</em></p>
+                <button type="button" id="quant-purge-selective" class="button button-primary button-large quant-button-large">
+                    Purge Selected Paths
+                </button>
+                <div id="quant-purge-selective-response" class="quant-cache-response"></div>
+            </div>
+
+            <script>
+            jQuery(document).ready(function($) {
+                // Purge all cache
+                $('#quant-purge-all').on('click', function() {
+                    var button = $(this);
+                    var responseDiv = $('#quant-purge-all-response');
+                    
+                    button.prop('disabled', true).text('Purging...');
+                    responseDiv.removeClass('success error').hide();
+                    
+                    $.ajax({
+                        url: ajaxurl,
+                        type: 'POST',
+                        data: {
+                            action: 'quant_purge_cache',
+                            nonce: '<?php echo wp_create_nonce('quant_purge_cache'); ?>',
+                            paths: ['/*']
+                        },
+                        success: function(response) {
+                            if (response.success) {
+                                responseDiv.addClass('success').text('✓ Successfully purged all cache').show();
+                            } else {
+                                responseDiv.addClass('error').text('✗ Error: ' + (response.data || 'Unknown error')).show();
+                            }
+                            button.prop('disabled', false).text('Purge All Cache');
+                        },
+                        error: function(xhr, status, error) {
+                            responseDiv.addClass('error').text('✗ Request failed: ' + error).show();
+                            button.prop('disabled', false).text('Purge All Cache');
+                        }
+                    });
+                });
+
+                // Purge selective paths
+                $('#quant-purge-selective').on('click', function() {
+                    var button = $(this);
+                    var responseDiv = $('#quant-purge-selective-response');
+                    var pathsTextarea = $('#quant-purge-paths');
+                    var paths = pathsTextarea.val().split('\n').map(function(p) { 
+                        return p.trim(); 
+                    }).filter(function(p) { 
+                        return p.length > 0; 
+                    });
+                    
+                    if (paths.length === 0) {
+                        responseDiv.addClass('error').text('✗ Please enter at least one path').show();
+                        return;
+                    }
+                    
+                    button.prop('disabled', true).text('Purging...');
+                    responseDiv.removeClass('success error').hide();
+                    
+                    $.ajax({
+                        url: ajaxurl,
+                        type: 'POST',
+                        data: {
+                            action: 'quant_purge_cache',
+                            nonce: '<?php echo wp_create_nonce('quant_purge_cache'); ?>',
+                            paths: paths
+                        },
+                        success: function(response) {
+                            if (response.success) {
+                                responseDiv.addClass('success').text('✓ Successfully purged ' + paths.length + ' path(s)').show();
+                            } else {
+                                responseDiv.addClass('error').text('✗ Error: ' + (response.data || 'Unknown error')).show();
+                            }
+                            button.prop('disabled', false).text('Purge Selected Paths');
+                        },
+                        error: function(xhr, status, error) {
+                            responseDiv.addClass('error').text('✗ Request failed: ' + error).show();
+                            button.prop('disabled', false).text('Purge Selected Paths');
+                        }
+                    });
+                });
+            });
+            </script>
+        </div>
+        <?php
+    }
 }

quant/trunk/src/functions.php

@@ -85 +85 @@
     function quant_save_post($id)
     {
-        if (!quant_is_enabled()) {
-            return;
-        }
-
-        // @todo: Support draft/scheduled posts
-        if (get_post_status($id) !== 'publish') {
-            quant_unpublish_post($id);
-            return;
-        }
-
-        $client = new Client();
-        $client->sendPost($id);
+        $options = quant_get_options();
+        
+        // If automatic push is enabled, send the full content
+        if (quant_is_enabled()) {
+            // @todo: Support draft/scheduled posts
+            if (get_post_status($id) !== 'publish') {
+                quant_unpublish_post($id);
+                return;
+            }
+
+            $client = new Client();
+            $client->sendPost($id);
+            return;
+        }
+
+        // If automatic push is disabled but cache purge is enabled, just purge
+        if (!empty($options['purge_on_save'])) {
+            $client = new Client();
+            $permalink = wp_make_link_relative(get_permalink($id));
+            // Client::purge() automatically handles both with/without trailing slash
+            $client->purge($permalink);
+        }
     }
 }
@@ -135 +145 @@
     function quant_save_category($id)
     {
+        $options = quant_get_options();
         $client = new Client();
-        $client->sendCategory($id);
+        
+        // If automatic push is enabled, send the full content
+        if (quant_is_enabled()) {
+            $client->sendCategory($id);
+            return;
+        }
+
+        // If automatic push is disabled but cache purge is enabled, just purge
+        if (!empty($options['purge_on_save'])) {
+            $permalink = wp_make_link_relative(get_term_link($id));
+            // Client::purge() automatically handles both with/without trailing slash
+            $client->purge($permalink);
+        }
     }
 }
@@ -284 +307 @@
     function quant_init_hooks()
     {
-        if (!quant_is_enabled()) {
+        $options = quant_get_options();
+        
+        // Only register hooks if either automatic push or cache purge is enabled
+        if (!quant_is_enabled() && empty($options['purge_on_save'])) {
             return;
         }
@@ -321 +347 @@
 
 }
+
+if (!function_exists('quant_purge_cache_ajax')) {
+    /**
+     * AJAX handler for cache purging
+     *
+     * @return void
+     */
+    function quant_purge_cache_ajax()
+    {
+        // Verify nonce
+        if (!isset($_POST['nonce']) || !wp_verify_nonce($_POST['nonce'], 'quant_purge_cache')) {
+            wp_send_json_error('Invalid security token');
+            return;
+        }
+
+        // Check user permissions
+        if (!current_user_can('manage_options')) {
+            wp_send_json_error('Insufficient permissions');
+            return;
+        }
+
+        // Get paths to purge
+        $paths = isset($_POST['paths']) ? $_POST['paths'] : [];
+        
+        if (empty($paths) || !is_array($paths)) {
+            wp_send_json_error('No paths provided');
+            return;
+        }
+
+        $client = new Client();
+        $results = [];
+        $errors = [];
+
+        foreach ($paths as $path) {
+            $path = trim($path);
+            if (empty($path)) {
+                continue;
+            }
+
+            // Ensure path starts with /
+            if (substr($path, 0, 1) !== '/') {
+                $path = '/' . $path;
+            }
+
+            $purge_result = $client->purge($path);
+            
+            if (!empty($purge_result['success'])) {
+                $results[] = $path;
+            } else {
+                $error_message = isset($purge_result['message']) ? $purge_result['message'] : 'Unknown error';
+                $errors[] = "{$path}: {$error_message}";
+            }
+        }
+
+        if (!empty($errors)) {
+            $error_msg = 'Failed to purge some paths: ' . implode('; ', $errors);
+            wp_send_json_error($error_msg);
+        } else if (empty($results)) {
+            wp_send_json_error('No valid paths were processed');
+        } else {
+            wp_send_json_success([
+                'message' => 'Successfully purged ' . count($results) . ' path(s)',
+                'paths' => $results
+            ]);
+        }
+    }
+
+    // Register AJAX handlers
+    add_action('wp_ajax_quant_purge_cache', 'quant_purge_cache_ajax');
+}