feat(plugin): v1.1.0 - add revalidation log, retry logic, debug

  mode

Author: brijr

wordpress/next-revalidate/next-revalidate.php

@@ -3,7 +3,7 @@
  * Plugin Name: Next.js Revalidation
  * Plugin URI: https://github.com/9d8dev/next-wp
  * Description: Automatically revalidate Next.js cache when WordPress content changes
- * Version: 1.0.0
+ * Version: 1.1.0
  * Author: 9d8
  * Author URI: https://9d8.dev
  * License: MIT
@@ -15,7 +15,8 @@
 
 class NextRevalidate {
     private $option_name = 'next_revalidate_settings';
-    private $last_revalidation = 'next_revalidate_last';
+    private $log_option = 'next_revalidate_log';
+    private $last_option = 'next_revalidate_last';
 
     public function __construct() {
         add_action('admin_menu', [$this, 'add_admin_menu']);
@@ -54,36 +55,20 @@ public function register_settings() {
             'next-revalidate'
         );
 
-        add_settings_field(
-            'nextjs_url',
-            'Next.js Site URL',
-            [$this, 'field_nextjs_url'],
-            'next-revalidate',
-            'next_revalidate_main'
-        );
-
-        add_settings_field(
-            'webhook_secret',
-            'Webhook Secret',
-            [$this, 'field_webhook_secret'],
-            'next-revalidate',
-            'next_revalidate_main'
-        );
-
-        add_settings_field(
-            'cooldown',
-            'Cooldown (seconds)',
-            [$this, 'field_cooldown'],
-            'next-revalidate',
-            'next_revalidate_main'
-        );
+        add_settings_field('nextjs_url', 'Next.js Site URL', [$this, 'field_nextjs_url'], 'next-revalidate', 'next_revalidate_main');
+        add_settings_field('webhook_secret', 'Webhook Secret', [$this, 'field_webhook_secret'], 'next-revalidate', 'next_revalidate_main');
+        add_settings_field('cooldown', 'Cooldown (seconds)', [$this, 'field_cooldown'], 'next-revalidate', 'next_revalidate_main');
+        add_settings_field('max_retries', 'Max Retries', [$this, 'field_max_retries'], 'next-revalidate', 'next_revalidate_main');
+        add_settings_field('debug_mode', 'Debug Mode', [$this, 'field_debug_mode'], 'next-revalidate', 'next_revalidate_main');
     }
 
     public function sanitize_settings($input) {
         $sanitized = [];
         $sanitized['nextjs_url'] = esc_url_raw(rtrim($input['nextjs_url'] ?? '', '/'));
         $sanitized['webhook_secret'] = sanitize_text_field($input['webhook_secret'] ?? '');
         $sanitized['cooldown'] = absint($input['cooldown'] ?? 2);
+        $sanitized['max_retries'] = min(10, max(0, absint($input['max_retries'] ?? 3)));
+        $sanitized['debug_mode'] = !empty($input['debug_mode']);
         return $sanitized;
     }
 
@@ -104,25 +89,49 @@ public function field_webhook_secret() {
     public function field_cooldown() {
         $options = get_option($this->option_name);
         $value = $options['cooldown'] ?? 2;
-        echo '<input type="number" name="' . $this->option_name . '[cooldown]" value="' . esc_attr($value) . '" min="0" max="60" class="small-text" />';
-        echo '<p class="description">Minimum seconds between revalidation requests (prevents spam)</p>';
+        echo '<input type="number" name="' . $this->option_name . '[cooldown]" value="' . esc_attr($value) . '" min="0" max="60" class="small-text" /> seconds';
+        echo '<p class="description">Minimum time between revalidation requests (prevents spam)</p>';
+    }
+
+    public function field_max_retries() {
+        $options = get_option($this->option_name);
+        $value = $options['max_retries'] ?? 3;
+        echo '<input type="number" name="' . $this->option_name . '[max_retries]" value="' . esc_attr($value) . '" min="0" max="10" class="small-text" />';
+        echo '<p class="description">Number of retry attempts for failed requests (with exponential backoff)</p>';
+    }
+
+    public function field_debug_mode() {
+        $options = get_option($this->option_name);
+        $checked = !empty($options['debug_mode']) ? 'checked' : '';
+        echo '<label><input type="checkbox" name="' . $this->option_name . '[debug_mode]" value="1" ' . $checked . ' /> Enable debug logging</label>';
+        echo '<p class="description">Logs detailed request/response info to PHP error log</p>';
     }
 
     public function settings_page() {
         if (!current_user_can('manage_options')) {
             return;
         }
 
-        $last = get_option($this->last_revalidation);
+        $last = get_option($this->last_option);
+        $log = get_option($this->log_option, []);
         ?>
         <div class="wrap">
             <h1>Next.js Revalidation Settings</h1>
 
             <?php if ($last): ?>
-            <div class="notice notice-info">
-                <p>Last revalidation: <?php echo esc_html(date('Y-m-d H:i:s', $last['time'])); ?>
-                - Type: <?php echo esc_html($last['type']); ?>
-                - Status: <?php echo $last['success'] ? 'Success' : 'Failed'; ?></p>
+            <div class="notice notice-<?php echo $last['success'] ? 'success' : 'error'; ?>">
+                <p>
+                    <strong>Last revalidation:</strong>
+                    <?php echo esc_html(date('Y-m-d H:i:s', $last['time'])); ?> —
+                    Type: <?php echo esc_html($last['type']); ?> —
+                    Status: <?php echo $last['success'] ? '✓ Success' : '✗ Failed'; ?>
+                    <?php if (!empty($last['error'])): ?>
+                        — Error: <?php echo esc_html($last['error']); ?>
+                    <?php endif; ?>
+                    <?php if (!empty($last['http_code'])): ?>
+                        — HTTP <?php echo esc_html($last['http_code']); ?>
+                    <?php endif; ?>
+                </p>
             </div>
             <?php endif; ?>
 
@@ -135,16 +144,62 @@ public function settings_page() {
             </form>
 
             <hr>
-            <h2>Test Revalidation</h2>
+            <h2>Test Connection</h2>
+            <p>
+                <button type="button" class="button button-secondary" onclick="testRevalidation()">Send Test Request</button>
+                <span id="test-result" style="margin-left: 10px;"></span>
+            </p>
+
+            <hr>
+            <h2>Recent Activity</h2>
+            <?php if (!empty($log)): ?>
             <p>
-                <button type="button" class="button" onclick="testRevalidation()">Send Test Request</button>
-                <span id="test-result"></span>
+                <button type="button" class="button button-secondary" onclick="clearLog()">Clear Log</button>
+                <span id="clear-result" style="margin-left: 10px;"></span>
             </p>
+            <table class="widefat striped" style="margin-top: 10px;">
+                <thead>
+                    <tr>
+                        <th>Time</th>
+                        <th>Type</th>
+                        <th>Action</th>
+                        <th>Status</th>
+                        <th>HTTP</th>
+                        <th>Retries</th>
+                        <th>Details</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <?php foreach (array_slice($log, 0, 50) as $entry): ?>
+                    <tr>
+                        <td><?php echo esc_html(date('Y-m-d H:i:s', $entry['time'])); ?></td>
+                        <td><?php echo esc_html($entry['type']); ?></td>
+                        <td><?php echo esc_html($entry['data']['action'] ?? '-'); ?></td>
+                        <td><?php echo $entry['success'] ? '<span style="color:green;">✓</span>' : '<span style="color:red;">✗</span>'; ?></td>
+                        <td><?php echo esc_html($entry['http_code'] ?? '-'); ?></td>
+                        <td><?php echo esc_html($entry['retries'] ?? 0); ?></td>
+                        <td>
+                            <?php if (!empty($entry['error'])): ?>
+                                <span style="color:red;"><?php echo esc_html($entry['error']); ?></span>
+                            <?php elseif (!empty($entry['data']['slug'])): ?>
+                                <?php echo esc_html($entry['data']['slug']); ?>
+                            <?php else: ?>
+                                -
+                            <?php endif; ?>
+                        </td>
+                    </tr>
+                    <?php endforeach; ?>
+                </tbody>
+            </table>
+            <?php else: ?>
+            <p>No revalidation requests yet.</p>
+            <?php endif; ?>
 
             <script>
             function testRevalidation() {
                 const result = document.getElementById('test-result');
                 result.textContent = 'Sending...';
+                result.style.color = '';
 
                 fetch(ajaxurl, {
                     method: 'POST',
@@ -153,10 +208,38 @@ function testRevalidation() {
                 })
                 .then(r => r.json())
                 .then(data => {
-                    result.textContent = data.success ? 'Success!' : 'Failed: ' + data.data;
+                    result.textContent = data.success ? '✓ ' + data.data : '✗ ' + data.data;
+                    result.style.color = data.success ? 'green' : 'red';
+                })
+                .catch(e => {
+                    result.textContent = '✗ Error: ' + e.message;
+                    result.style.color = 'red';
+                });
+            }
+
+            function clearLog() {
+                if (!confirm('Clear all log entries?')) return;
+
+                const result = document.getElementById('clear-result');
+                result.textContent = 'Clearing...';
+
+                fetch(ajaxurl, {
+                    method: 'POST',
+                    headers: {'Content-Type': 'application/x-www-form-urlencoded'},
+                    body: 'action=next_revalidate_clear_log'
+                })
+                .then(r => r.json())
+                .then(data => {
+                    if (data.success) {
+                        location.reload();
+                    } else {
+                        result.textContent = '✗ ' + data.data;
+                        result.style.color = 'red';
+                    }
                 })
                 .catch(e => {
-                    result.textContent = 'Error: ' + e.message;
+                    result.textContent = '✗ Error: ' + e.message;
+                    result.style.color = 'red';
                 });
             }
             </script>
@@ -213,8 +296,10 @@ public function on_status_change($new_status, $old_status, $post) {
     }
 
     public function on_term_change($term_id, $tt_id, $taxonomy) {
+        $term = get_term($term_id, $taxonomy);
         $this->trigger_revalidation('term', [
             'id' => $term_id,
+            'slug' => $term ? $term->slug : '',
             'taxonomy' => $taxonomy,
             'action' => current_action()
         ]);
@@ -229,11 +314,52 @@ private function trigger_revalidation($type, $data) {
 
         // Check cooldown
         $cooldown = $options['cooldown'] ?? 2;
-        $last = get_option($this->last_revalidation);
+        $last = get_option($this->last_option);
         if ($last && (time() - $last['time']) < $cooldown) {
+            $this->debug_log('Skipped: cooldown active');
             return;
         }
 
+        $max_retries = $options['max_retries'] ?? 3;
+        $result = $this->send_with_retry($type, $data, $max_retries);
+
+        // Update last status
+        update_option($this->last_option, [
+            'time' => time(),
+            'type' => $type,
+            'success' => $result['success'],
+            'http_code' => $result['http_code'],
+            'error' => $result['error']
+        ]);
+
+        // Add to log
+        $this->add_log_entry([
+            'time' => time(),
+            'type' => $type,
+            'data' => $data,
+            'success' => $result['success'],
+            'http_code' => $result['http_code'],
+            'error' => $result['error'],
+            'retries' => $result['retries']
+        ]);
+    }
+
+    private function send_with_retry($type, $data, $max_retries, $attempt = 0) {
+        $result = $this->send_request($type, $data);
+
+        if (!$result['success'] && $attempt < $max_retries) {
+            $delay = pow(2, $attempt); // Exponential backoff: 1, 2, 4, 8...
+            $this->debug_log("Retry {$attempt}/{$max_retries} after {$delay}s delay");
+            sleep($delay);
+            return $this->send_with_retry($type, $data, $max_retries, $attempt + 1);
+        }
+
+        $result['retries'] = $attempt;
+        return $result;
+    }
+
+    private function send_request($type, $data) {
+        $options = get_option($this->option_name);
         $url = $options['nextjs_url'] . '/api/revalidate';
         $secret = $options['webhook_secret'] ?? '';
 
@@ -243,22 +369,58 @@ private function trigger_revalidation($type, $data) {
             'timestamp' => time()
         ];
 
+        $this->debug_log("Sending request to {$url}", $payload);
+
         $response = wp_remote_post($url, [
-            'timeout' => 10,
+            'timeout' => 15,
             'headers' => [
                 'Content-Type' => 'application/json',
                 'x-webhook-secret' => $secret
             ],
             'body' => json_encode($payload)
         ]);
 
-        $success = !is_wp_error($response) && wp_remote_retrieve_response_code($response) === 200;
+        if (is_wp_error($response)) {
+            $error = $response->get_error_message();
+            $this->debug_log("Request failed: {$error}");
+            return [
+                'success' => false,
+                'http_code' => null,
+                'error' => $error
+            ];
+        }
 
-        update_option($this->last_revalidation, [
-            'time' => time(),
-            'type' => $type,
-            'success' => $success
-        ]);
+        $http_code = wp_remote_retrieve_response_code($response);
+        $body = wp_remote_retrieve_body($response);
+        $success = $http_code === 200;
+
+        $this->debug_log("Response: HTTP {$http_code}", $body);
+
+        return [
+            'success' => $success,
+            'http_code' => $http_code,
+            'error' => $success ? null : "HTTP {$http_code}"
+        ];
+    }
+
+    private function add_log_entry($entry) {
+        $log = get_option($this->log_option, []);
+        array_unshift($log, $entry);
+        $log = array_slice($log, 0, 50); // Keep last 50
+        update_option($this->log_option, $log);
+    }
+
+    private function debug_log($message, $data = null) {
+        $options = get_option($this->option_name);
+        if (empty($options['debug_mode'])) {
+            return;
+        }
+
+        $log_message = '[Next.js Revalidation] ' . $message;
+        if ($data !== null) {
+            $log_message .= ' - ' . (is_string($data) ? $data : json_encode($data));
+        }
+        error_log($log_message);
     }
 }
 
@@ -283,7 +445,7 @@ private function trigger_revalidation($type, $data) {
     $secret = $options['webhook_secret'] ?? '';
 
     $response = wp_remote_post($url, [
-        'timeout' => 10,
+        'timeout' => 15,
         'headers' => [
             'Content-Type' => 'application/json',
             'x-webhook-secret' => $secret
@@ -301,8 +463,18 @@ private function trigger_revalidation($type, $data) {
 
     $code = wp_remote_retrieve_response_code($response);
     if ($code !== 200) {
-        wp_send_json_error('HTTP ' . $code);
+        wp_send_json_error('HTTP ' . $code . ' - ' . wp_remote_retrieve_body($response));
+    }
+
+    wp_send_json_success('Connection successful!');
+});
+
+// AJAX handler for clearing log
+add_action('wp_ajax_next_revalidate_clear_log', function() {
+    if (!current_user_can('manage_options')) {
+        wp_send_json_error('Unauthorized');
     }
 
-    wp_send_json_success('Revalidation triggered successfully');
+    delete_option('next_revalidate_log');
+    wp_send_json_success('Log cleared');
 });