fix: исправлена регистрация одноразовых задач через at()

- Добавлена обработка одноразовых задач (с префиксом 'once_') в методе scheduleEvent
- Обновлена документация в README.md и README.ru.md с примерами использования at()
- Добавлены комментарии к коду для лучшего понимания работы планировщика

Author: Алексей Тихомиров

README.md

@@ -141,6 +141,9 @@ add_action('wp_queue_schedule', function ($scheduler) {
     // From settings
     $scheduler->job(BackupJob::class)
         ->interval(get_option('backup_interval', 'daily'));
+
+    // One-time execution (at specific timestamp)
+    $scheduler->job(OneTimeJob::class)->at(time() + 3600);
 });
 ```
 

README.ru.md

@@ -141,6 +141,9 @@ add_action('wp_queue_schedule', function ($scheduler) {
     // Из настроек
     $scheduler->job(BackupJob::class)
         ->interval(get_option('backup_interval', 'daily'));
+
+    // Одноразовое выполнение (в указанное время)
+    $scheduler->job(OneTimeJob::class)->at(time() + 3600);
 });
 ```
 

src/Scheduler.php

@@ -149,10 +149,33 @@ protected function registerJob(string $jobClass, ScheduledJob $scheduled): void
         $this->scheduleEvent($hook, $interval);
     }
 
+    /**
+     * Schedule an event in WP-Cron.
+     * Handles both recurring events (hourly, daily, etc.) and one-time events (prefixed with 'once_').
+     */
     protected function scheduleEvent(string $hook, string $interval): void
     {
         $existing = wp_get_scheduled_event($hook);
 
+        // Handle one-time events
+        if (str_starts_with($interval, 'once_')) {
+            $timestamp = (int) substr($interval, 5);
+
+            if ($existing !== false) {
+                // If exists but different timestamp or is recurring
+                if ($existing->timestamp !== $timestamp || $existing->schedule) {
+                    wp_clear_scheduled_hook($hook);
+                    $existing = false;
+                }
+            }
+
+            if ($existing === false) {
+                wp_schedule_single_event($timestamp, $hook);
+            }
+
+            return;
+        }
+
         // If exists but different interval, reschedule
         if ($existing !== false && $existing->schedule !== $interval) {
             wp_clear_scheduled_hook($hook);
@@ -178,7 +201,7 @@ protected function getHook(string $jobClass): string
         // Извлекаем короткое имя класса без ReflectionClass
         $name = substr(strrchr($jobClass, '\\') ?: $jobClass, 1) ?: $jobClass;
 
-        return 'wp_queue_'.strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $name));
+        return 'wp_queue_' . strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $name));
     }
 
     /**