1. Hooks PHP disponibles

Alesta expose 23 hooks do_action() et 18 filtres apply_filters() dans son cycle de vie. Les plus utiles :

  • alesta_ai_before_save_meta — déclenché juste avant l'écriture en BDD d'un title/meta généré
  • alesta_ai_after_save_meta — après écriture, pratique pour invalider votre cache custom
  • alesta_ai_before_api_call — avant chaque appel Claude API, vous pouvez modifier le payload
  • alesta_ai_after_api_response — après réponse Claude, pour logger ou post-traiter
  • alesta_ai_module_activated — quand un module est activé par l'admin
  • alesta_ai_license_validated — au check de licence Freemius

Exemple d'usage dans votre functions.php de thème enfant :

"

add_action('alesta_ai_after_save_meta', function($post_id, $meta_type) {
  // Invalide votre cache CDN custom
  my_cdn_purge($post_id);
}, 10, 2);

2. Filtres custom

Les filtres permettent de modifier les valeurs en vol. Les principaux :

  • alesta_ai_prompt_system — modifier le prompt système envoyé à Claude (pour personnaliser le ton)
  • alesta_ai_model_for_module — choisir un modèle Claude différent par module
  • alesta_ai_max_tokens — limiter la longueur de réponse
  • alesta_ai_temperature — ajuster la créativité (0 = factuel, 1 = créatif)
  • alesta_ai_skip_post — exclure certains posts du traitement IA

3. Override CSS / JS

Pour personnaliser l'apparence du chatbot, du widget Talk to Me ou des boutons Alesta : copiez les styles ciblés dans votre thème enfant. Toutes les classes Alesta sont préfixées .alesta- ou #alesta-.

Pour désactiver complètement le chargement d'un CSS Alesta sur une page :

"

add_filter('alesta_ai_enqueue_assets', function($enqueue, $module) {
  if (is_singular('product') && $module === 'chatbot') return false;
  return $enqueue;
}, 10, 2);

4. Multilingue (sous-dossier vs sous-domaine)

Alesta gère trois architectures :

  • Sous-dossier (recommandé) : site.fr/en/ — autorité du domaine concentrée
  • Sous-domaine : en.site.fr — pour sites moyens/grands
  • ccTLD : site.de — grandes marques par pays

Configuration dans Alesta → Module Traduction → Architecture URL. Hreflang est généré automatiquement à l'enregistrement. Détails complets : Traduire son WordPress en 20 langues sans devenir fou.

5. Mode debug

Activez le debug Alesta dans wp-config.php :

"

define('ALESTA_AI_DEBUG', true);
define('ALESTA_AI_LOG_LEVEL', 'verbose'); // 'error' | 'warn' | 'info' | 'verbose'

Les logs sont écrits dans wp-content/uploads/alesta-ai/debug.log (hors webroot public — accessible uniquement par FTP/SSH).

6. Logs et journal d'activité

Le module Journal d'activité (disponible Pro+) trace chaque appel IA : date, module, taille payload, temps de réponse, modèle utilisé, coût estimé. Exportable en CSV mensuel pour votre compta ou audit RGPD.

7. Cache custom

Si vous utilisez WP Rocket, W3 Total Cache ou LiteSpeed Cache à la place du cache Alesta, ajoutez ces hooks pour invalider le cache après chaque écriture IA :

"

add_action('alesta_ai_after_save_meta', function($post_id) {
  if (function_exists('rocket_clean_post')) rocket_clean_post($post_id);
});

8. Performance tuning

Constantes optionnelles dans wp-config.php :

  • ALESTA_AI_TIMEOUT : timeout Claude API (défaut 30s)
  • ALESTA_AI_BATCH_SIZE : nombre de posts traités en parallèle (défaut 5)
  • ALESTA_AI_CACHE_PROMPTS : cache les prompts intermédiaires (défaut true, économise tokens)
  • ALESTA_AI_USE_WP_CRON : bascule sur Action Scheduler si false (défaut true)

9. Multisite WordPress

Alesta supporte officiellement le multisite WP depuis la v1.4 (juin 2026). Activation : Network Admin → Plugins → Alesta AI → Network Activate. Une seule licence Agency couvre l'ensemble du réseau, peu importe le nombre de sous-sites.

10. Intégration WP-CLI

Plusieurs commandes natives :

  • wp alesta-ai generate-titles --post-type=product — batch sur tous les produits Woo
  • wp alesta-ai webp-convert --all — conversion WebP en masse
  • wp alesta-ai sitemap-rebuild — régénère le sitemap.xml
  • wp alesta-ai license-check — diagnostic de la licence Freemius
  • wp alesta-ai cache-purge — vide le cache Alesta

11. Gestion des erreurs

Toutes les erreurs Alesta passent par WordPress WP_Error. Pour les attraper dans votre code :

"

add_action('alesta_ai_api_error', function($wp_error, $context) {
  error_log('Alesta KO : ' . $wp_error->get_error_message());
  // notifier Slack, Sentry, etc.
}, 10, 2);

Et après ? Voir la référence API REST pour l'intégration server-to-server, ou la documentation développeurs pour créer votre propre module Alesta.

Besoin d'aide ? Notre équipe vous répond.

Une question, un cas d'usage spécifique, un problème technique ? Le support Alesta AI répond sous 24h en jours ouvrés.

Contacter le support FAQ →