Journaux et débogage

Cette page décrit la manière dont l'extension gère les journaux et le débogage à un niveau général. La classe de journalisation interne, l'emplacement des fichiers de journalisation, les seuils de rotation et les règles de masquage sont des détails d'implémentation et ne sont pas publiés ici.

Comportement général

• L'extension écrit les diagnostics d'exécution dans sa propre destination de journalisation gérée par WordPress, séparée du journal de débogage principal de WordPress.
• Le volume des journaux est limité : les anciennes entrées subissent une rotation et sont purgées automatiquement.
• Les valeurs sensibles (identifiants, jetons, en-têtes d'autorisation, en-têtes de requêtes signées) sont masquées avant l'écriture de chaque ligne.
• En cas de problème lors d'une importation ou d'une tâche en arrière-plan, l'extension affiche une indication côté administration et écrit une entrée de diagnostic qui peut être partagée avec le support.

Pour les administrateurs

Si vous devez partager des diagnostics avec le support, utilisez la fonction d'exportation de diagnostics disponible depuis l'interface d'administration de l'extension plutôt que de copier des fichiers de journaux bruts. Le pack exporté contient les informations nécessaires au support tout en préservant le masquage des données confidentielles.

Pour les développeurs

Ne dépendez pas de chemins de fichiers de journaux, de formats ou de comportements de rotation spécifiques à partir d'un code externe ; ce sont des détails d'implémentation. Lors du développement avec l'extension, privilégiez le flux de travail standard WP_DEBUG de WordPress ainsi que l'exportation de diagnostics de l'extension.

Surfaces d'intégration publiques prises en charge

Lors de l'intégration avec l'extension, privilégiez ces surfaces stables :

• L'interface utilisateur des réglages d'administration de l'extension.
• Les shortcodes documentés.
• Les surcharges de modèles au niveau du thème, comme décrit dans Système de modèles et surcharges.
• L' Aperçu pour les développeurs général pour vous orienter.

Les noms de classes internes, les clés d'options, les tables de la base de données, les points de terminaison REST et AJAX, les noms de hooks cron, les identifiants de capacités et de nonces, ainsi que l'infrastructure de publication / mise à jour sont traités comme des détails d'implémentation. Ils peuvent changer d'une version à l'autre sans préavis et ne font pas partie du contrat d'intégration public.

Politique de stabilité et de modification

Tout ce qui n'est pas répertorié comme une surface publique prise en charge ci-dessus est considéré comme un détail d'implémentation interne. Les API internes, la structure de stockage et l'implémentation de la sécurité peuvent changer d'une version à l'autre. Ne dépendez pas d'eux à partir de codes tiers, de thèmes ou de systèmes externes. Les écritures directes dans la base de données ne sont pas prises en charge.

Avis de documentation publique. Cette page fournit uniquement un aperçu de l'intégration à un niveau général. Les détails d'implémentation interne, les API privées, les structures internes de stockage et l'infrastructure de publication sensible à la sécurité sont gérés séparément et ne font pas partie de la documentation publique. Les surfaces d'intégration prises en charge sont les shortcodes documentés, les surcharges de modèles, l'interface utilisateur des réglages et tous les points d'extension explicitement publiés dans cette section.