Merge pull request #246 from JLG-WOCFR-DEV/codex/extend-cron-scheduling-for-custom-intervals

JLG-WOCFR-DEV · web-flow · commit 60c3f724059e · 2025-10-02T17:57:42.000+02:00
Add filters to extend cron schedules and preset options
diff --git a/README.md b/README.md
@@ -24,6 +24,31 @@ Liens Morts Detector est une extension WordPress qui détecte les liens et image
 - L’analyse des images distantes (CDN, sous-domaines médias) peut être activée dans les réglages. Cette vérification reste basée sur les fichiers présents dans `wp-content/uploads` et peut rallonger la durée du scan ou consommer davantage de quotas côté CDN.
 
 ## Hooks disponibles
+### `blc_cron_schedule_definitions`
+Permet d’ajouter, modifier ou supprimer des intervalles WP‑Cron proposés par défaut (heures, jours, semaines…). Chaque entrée doit fournir un identifiant unique ainsi qu’un intervalle en secondes.
+
+```php
+add_filter('blc_cron_schedule_definitions', function (array $definitions): array {
+    $definitions['quarter_hour'] = array(
+        'interval' => 15 * MINUTE_IN_SECONDS,
+        'display'  => __('Toutes les 15 minutes', 'liens-morts-detector-jlg'),
+    );
+
+    return $definitions;
+});
+```
+
+### `blc_frequency_preset_options`
+Personnalise la liste des fréquences affichées dans les réglages (radios + champ personnalisé). Idéal pour mettre en cohérence l’interface avec un nouvel intervalle WP‑Cron ajouté via le filtre précédent.
+
+```php
+add_filter('blc_frequency_preset_options', function (array $options): array {
+    $options = array('quarter_hour' => __('Toutes les 15 minutes', 'liens-morts-detector-jlg')) + $options;
+
+    return $options;
+});
+```
+
 ### `blc_max_load_threshold`
 Permet d’ajuster le seuil de charge CPU au‑delà duquel l’analyse est reportée. La valeur par défaut est `2.0`.
 
diff --git a/liens-morts-detector-jlg/includes/blc-cron.php b/liens-morts-detector-jlg/includes/blc-cron.php
@@ -6,41 +6,78 @@
 }
 
 /**
- * Ajoute des planifications personnalisées (hebdomadaire, mensuelle) à la liste des
+ * Retourne les planifications personnalisées proposées par défaut.
+ *
+ * @since 1.1.0
+ *
+ * @return array<string, array{interval:int, display:string}> Tableau associatif de définitions.
+ */
+function blc_get_default_cron_schedules() {
+    return array(
+        'blc_hourly'       => array(
+            'interval' => HOUR_IN_SECONDS,
+            'display'  => __('Toutes les heures', 'liens-morts-detector-jlg'),
+        ),
+        'blc_six_hours'    => array(
+            'interval' => 6 * HOUR_IN_SECONDS,
+            'display'  => __('Toutes les 6 heures', 'liens-morts-detector-jlg'),
+        ),
+        'blc_twelve_hours' => array(
+            'interval' => 12 * HOUR_IN_SECONDS,
+            'display'  => __('Toutes les 12 heures', 'liens-morts-detector-jlg'),
+        ),
+        'weekly'           => array(
+            'interval' => 7 * DAY_IN_SECONDS,
+            'display'  => __('Une fois par semaine', 'liens-morts-detector-jlg'),
+        ),
+        'monthly'          => array(
+            'interval' => 30 * DAY_IN_SECONDS,
+            'display'  => __('Une fois par mois', 'liens-morts-detector-jlg'),
+        ),
+    );
+}
+
+/**
+ * Ajoute des planifications personnalisées (hebdomadaire, mensuelle, etc.) à la liste des
  * fréquences de WP-Cron.
  *
  * @param array $schedules Le tableau des planifications existantes.
  * @return array Le tableau des planifications mis à jour.
  */
 function blc_add_cron_schedules($schedules) {
+    $default_definitions = blc_get_default_cron_schedules();
 
-    // Ajoute des options courtes supplémentaires.
-    $schedules['blc_hourly'] = array(
-        'interval' => HOUR_IN_SECONDS,
-        'display'  => __('Toutes les heures', 'liens-morts-detector-jlg'),
-    );
+    /**
+     * Permet de modifier la liste des planifications ajoutées par le plugin.
+     *
+     * @since 1.1.0
+     *
+     * @param array $default_definitions Tableau associatif `slug => array( 'interval' => int, 'display' => string )`.
+     */
+    $definitions = apply_filters('blc_cron_schedule_definitions', $default_definitions);
 
-    $schedules['blc_six_hours'] = array(
-        'interval' => 6 * HOUR_IN_SECONDS,
-        'display'  => __('Toutes les 6 heures', 'liens-morts-detector-jlg'),
-    );
+    foreach ($definitions as $slug => $definition) {
+        if (!is_scalar($slug)) {
+            continue;
+        }
 
-    $schedules['blc_twelve_hours'] = array(
-        'interval' => 12 * HOUR_IN_SECONDS,
-        'display'  => __('Toutes les 12 heures', 'liens-morts-detector-jlg'),
-    );
+        $slug = (string) $slug;
+        if ('' === $slug || !is_array($definition)) {
+            continue;
+        }
 
-    // Ajoute l'option "Une fois par semaine"
-    $schedules['weekly'] = array(
-        'interval' => 7 * DAY_IN_SECONDS,
-        'display'  => __('Une fois par semaine', 'liens-morts-detector-jlg'),
-    );
+        $interval = isset($definition['interval']) ? (int) $definition['interval'] : 0;
+        if ($interval <= 0) {
+            continue;
+        }
 
-    // Ajoute l'option "Une fois par mois"
-    $schedules['monthly'] = array(
-        'interval' => 30 * DAY_IN_SECONDS,
-        'display'  => __('Une fois par mois', 'liens-morts-detector-jlg'),
-    );
+        $display = isset($definition['display']) ? (string) $definition['display'] : $slug;
+
+        $schedules[$slug] = array(
+            'interval' => $interval,
+            'display'  => $display,
+        );
+    }
 
     $custom_hours = blc_get_custom_frequency_hours();
     $default_custom_schedule = array(
diff --git a/liens-morts-detector-jlg/includes/blc-settings-fields.php b/liens-morts-detector-jlg/includes/blc-settings-fields.php
@@ -404,6 +404,78 @@ function blc_get_timezone_label() {
     return $timezone_label;
 }
 
+/**
+ * Retourne la liste des fréquences prédéfinies disponibles dans l'interface.
+ *
+ * @since 1.1.0
+ *
+ * @return array<string, string> Tableau associatif `valeur => libellé`.
+ */
+function blc_get_frequency_preset_options() {
+    $default_displays = blc_get_default_cron_schedules();
+
+    $base_options = array(
+        'blc_hourly'       => isset($default_displays['blc_hourly']['display'])
+            ? $default_displays['blc_hourly']['display']
+            : __('Toutes les heures', 'liens-morts-detector-jlg'),
+        'blc_six_hours'    => isset($default_displays['blc_six_hours']['display'])
+            ? $default_displays['blc_six_hours']['display']
+            : __('Toutes les 6 heures', 'liens-morts-detector-jlg'),
+        'blc_twelve_hours' => isset($default_displays['blc_twelve_hours']['display'])
+            ? $default_displays['blc_twelve_hours']['display']
+            : __('Toutes les 12 heures', 'liens-morts-detector-jlg'),
+        'daily'            => __('Quotidienne', 'liens-morts-detector-jlg'),
+        'weekly'           => isset($default_displays['weekly']['display'])
+            ? $default_displays['weekly']['display']
+            : __('Hebdomadaire', 'liens-morts-detector-jlg'),
+        'monthly'          => isset($default_displays['monthly']['display'])
+            ? $default_displays['monthly']['display']
+            : __('Mensuelle', 'liens-morts-detector-jlg'),
+    );
+
+    /**
+     * Permet de personnaliser les options affichées dans le sélecteur de fréquence.
+     *
+     * @since 1.1.0
+     *
+     * @param array $base_options Tableau associatif de valeurs => libellés ou définitions.
+     */
+    $options = apply_filters('blc_frequency_preset_options', $base_options);
+
+    $normalized_options = array();
+
+    foreach ($options as $value => $definition) {
+        if (!is_scalar($value)) {
+            continue;
+        }
+
+        $value = (string) $value;
+        if ('' === $value) {
+            continue;
+        }
+
+        if (is_array($definition)) {
+            if (isset($definition['label']) && is_scalar($definition['label'])) {
+                $label = (string) $definition['label'];
+            } elseif (isset($definition['display']) && is_scalar($definition['display'])) {
+                $label = (string) $definition['display'];
+            } else {
+                continue;
+            }
+        } else {
+            $label = (string) $definition;
+        }
+
+        if ('' === $label) {
+            continue;
+        }
+
+        $normalized_options[$value] = $label;
+    }
+
+    return $normalized_options;
+}
+
 /**
  * Affiche le champ de sélection de la fréquence de vérification.
  *
@@ -423,14 +495,13 @@ function blc_render_frequency_field() {
 
     $is_custom_selected = ('custom' === $frequency);
 
-    $preset_options = array(
-        'blc_hourly'      => __('Toutes les heures', 'liens-morts-detector-jlg'),
-        'blc_six_hours'   => __('Toutes les 6 heures', 'liens-morts-detector-jlg'),
-        'blc_twelve_hours'=> __('Toutes les 12 heures', 'liens-morts-detector-jlg'),
-        'daily'           => __('Quotidienne', 'liens-morts-detector-jlg'),
-        'weekly'          => __('Hebdomadaire', 'liens-morts-detector-jlg'),
-        'monthly'         => __('Mensuelle', 'liens-morts-detector-jlg'),
-    );
+    $preset_options = blc_get_frequency_preset_options();
+
+    if (empty($preset_options)) {
+        $preset_options = array(
+            'daily' => __('Quotidienne', 'liens-morts-detector-jlg'),
+        );
+    }
     ?>
     <fieldset id="blc_frequency_fieldset" class="blc-frequency-field">
         <legend class="screen-reader-text"><?php esc_html_e('Fréquence de vérification des liens', 'liens-morts-detector-jlg'); ?></legend>
@@ -936,15 +1007,9 @@ function blc_sanitize_frequency_custom_time_option($value) {
  * @return string
  */
 function blc_sanitize_frequency_option($value) {
-    $allowed_frequencies = array(
-        'blc_hourly',
-        'blc_six_hours',
-        'blc_twelve_hours',
-        'daily',
-        'weekly',
-        'monthly',
-        'custom',
-    );
+    $preset_options     = blc_get_frequency_preset_options();
+    $allowed_frequencies = array_keys($preset_options);
+    $allowed_frequencies[] = 'custom';
 
     $previous_frequency_option    = get_option('blc_frequency', 'daily');
     $previous_frequency_sanitized = sanitize_text_field($previous_frequency_option);
@@ -959,15 +1024,8 @@ function blc_sanitize_frequency_option($value) {
         $frequency = $submitted_frequency;
     } else {
         $frequency        = $fallback_frequency;
-        $frequency_labels = array(
-            'blc_hourly'       => __('toutes les heures', 'liens-morts-detector-jlg'),
-            'blc_six_hours'    => __('toutes les 6 heures', 'liens-morts-detector-jlg'),
-            'blc_twelve_hours' => __('toutes les 12 heures', 'liens-morts-detector-jlg'),
-            'daily'            => __('quotidienne', 'liens-morts-detector-jlg'),
-            'weekly'           => __('hebdomadaire', 'liens-morts-detector-jlg'),
-            'monthly'          => __('mensuelle', 'liens-morts-detector-jlg'),
-            'custom'           => __('personnalisée', 'liens-morts-detector-jlg'),
-        );
+        $frequency_labels = $preset_options;
+        $frequency_labels['custom'] = __('Intervalle personnalisé', 'liens-morts-detector-jlg');
         $frequency_label = isset($frequency_labels[$frequency]) ? $frequency_labels[$frequency] : $frequency;
         $message         = sprintf(
             /* translators: %s: fallback frequency label. */
