Aller au contenu principal

Automatisation et tâches cron

WHMCS s'appuie sur une tâche cron principale pour exécuter l'ensemble de ses processus automatiques : facturation, renouvellements, synchronisation des domaines, envoi d'emails, etc. Une configuration correcte du cron est indispensable au bon fonctionnement du module registrar HostMyServers.

Configurer la tâche cron principale

La tâche cron WHMCS doit être exécutée toutes les 5 minutes sur votre serveur. Depuis votre panneau de configuration serveur (cPanel, Plesk, ou directement via crontab), ajoutez l'entrée suivante :

*/5 * * * * /usr/bin/php -q /chemin/vers/whmcs/crons/cron.php

Remplacez /chemin/vers/whmcs/ par le chemin absolu vers votre installation WHMCS.

Trouver le chemin absolu

Si vous n'êtes pas sûr du chemin, connectez-vous en SSH et exécutez pwd depuis le répertoire racine de WHMCS. Sur un cPanel classique, ce sera souvent /home/votreuser/public_html/ ou similaire.

Via cPanel

  1. Connectez-vous à cPanel
  2. Rendez-vous dans Tâches planifiées (Cron Jobs)
  3. Dans le champ Commande, saisissez :
    /usr/bin/php -q /home/VOTRE_USER/public_html/crons/cron.php
  4. Sélectionnez la fréquence : Toutes les 5 minutes
  5. Cliquez sur Ajouter la tâche cron

Via SSH / crontab

crontab -e

Ajoutez la ligne :

*/5 * * * * /usr/bin/php -q /var/www/whmcs/crons/cron.php > /dev/null 2>&1

Tâche de synchronisation des domaines

En plus du cron principal, WHMCS dispose d'une tâche dédiée à la synchronisation des domaines. Elle est exécutée automatiquement via le cron principal, mais vous pouvez aussi l'exécuter manuellement.

Synchronisation manuelle

Depuis l'administration WHMCS :

UtilitairesSynchronisation des domaines

Cette page permet de :

  • Lancer une synchronisation complète immédiatement
  • Voir les derniers résultats de synchronisation
  • Identifier les domaines dont le statut ou la date d'expiration diffère entre WHMCS et HostMyServers

Fréquence recommandée

La synchronisation automatique se déclenche une fois par jour via le cron principal. C'est suffisant dans la majorité des cas. Si vous gérez un volume important de domaines ou si vous effectuez fréquemment des opérations depuis l'espace client HostMyServers directement, vous pouvez augmenter la fréquence :

0 */6 * * * /usr/bin/php -q /var/www/whmcs/crons/cron.php --do DomainStatusSync > /dev/null 2>&1

Ceci lancera une synchronisation toutes les 6 heures.

Renouvellements automatiques

WHMCS gère les renouvellements automatiques selon la configuration de chaque domaine. Voici le flux standard :

Délai avant expirationAction WHMCS
J-30Génération de la facture de renouvellement
J-141ère relance email client
J-72ème relance email client
J-0Expiration (si facture non payée)
J+xSuspension du service (selon configuration)

Renouvellement automatique côté HostMyServers

Par défaut, le module n'active pas le renouvellement automatique côté HostMyServers (c'est WHMCS qui déclenche le renouvellement via l'API). Si vous souhaitez que les domaines soient renouvelés automatiquement par HostMyServers indépendamment de WHMCS, activez l'option Auto-renouvellement dans votre espace client HostMyServers.

Double renouvellement

Évitez d'activer le renouvellement automatique à la fois dans WHMCS et dans votre espace client HostMyServers, au risque de facturer et renouveler deux fois un même domaine.

Emails automatiques de renouvellement

WHMCS envoie automatiquement des emails de relance à vos clients avant l'expiration de leurs domaines. Ces emails utilisent les templates configurés dans :

ConfigurationSystèmeTemplates d'emails → catégorie Domaines

Les templates concernés par les domaines HostMyServers :

TemplateDéclencheur
Domain Expiry NoticeRelances avant expiration (J-30, J-14, J-7)
Domain Renewal SuccessfulConfirmation de renouvellement
Domain Transfer InitiatedDémarrage d'un transfert entrant
Domain Transfer CompletedFinalisation d'un transfert

Personnalisez ces templates selon votre charte graphique et votre discours commercial. Les variables disponibles (nom de domaine, date d'expiration, lien de paiement, etc.) sont listées dans l'éditeur WHMCS au survol du champ.

Vérification du bon fonctionnement du cron

Pour vérifier que le cron s'exécute correctement :

  1. Dans l'administration WHMCS, allez dans UtilitairesActivitéLogs d'activité
  2. Filtrez par type Cron
  3. Vérifiez que des entrées récentes sont présentes (toutes les 5 minutes)

Si aucune entrée n'apparaît depuis plus de 15 minutes, le cron n'est pas configuré ou ne s'exécute pas. Vérifiez la configuration côté serveur et les éventuels messages d'erreur dans les logs PHP.