Registro y depuración

Esta página describe cómo el plugin gestiona el registro de logs y la depuración a alto nivel. La clase de registro interna, la ubicación del archivo de log, los umbrales de rotación y las reglas de enmascaramiento son detalles de implementación y no se publican aquí.

Comportamiento a alto nivel

• El plugin escribe diagnósticos de ejecución en su propio destino de logs gestionado por WordPress, de forma independiente al log de depuración principal de WordPress.
• El volumen de logs está limitado: las entradas antiguas se rotan y se eliminan automáticamente.
• Los valores confidenciales (credenciales, tokens, cabeceras de autorización, cabeceras de solicitudes firmadas) se enmascaran antes de escribir cualquier línea.
• Cuando algo falla durante una importación o una tarea en segundo plano, el plugin muestra una indicación en el lado del administrador y escribe una entrada de diagnóstico que se puede compartir con el equipo de soporte.

Para administradores

Si necesita compartir diagnósticos con el equipo de soporte, utilice la función de exportación de diagnósticos disponible en la interfaz de usuario de administración del plugin en lugar de copiar archivos de log sin procesar. El paquete exportado contiene la información que el soporte necesita manteniendo los secretos enmascarados.

Para desarrolladores

No dependa de rutas de archivos de log, formatos o comportamientos de rotación específicos desde código externo; son detalles de implementación. Al desarrollar para el plugin, prefiera el flujo de trabajo estándar de WP_DEBUG de WordPress junto con la exportación de diagnósticos del plugin.

Vías de integración pública compatibles

Al realizar integraciones con el plugin, prefiera estas vías estables:

• La interfaz de usuario de ajustes de administración del plugin.
• Los shortcodes documentados.
• Las anulaciones de plantillas a nivel de tema tal como se describe en Sistema de plantillas y anulaciones.
• La Descripción general para desarrolladores general para orientarse.

Los nombres de clases internas, las claves de opciones, las tablas de la base de datos, los endpoints REST y AJAX, los nombres de hooks de cron, los identificadores de capacidades y nonces, y la infraestructura de lanzamientos / actualizaciones se tratan como detalles de implementación. Pueden cambiar entre versiones sin previo aviso y no forman parte del contrato de integración pública.

Política de estabilidad y cambios

Cualquier elemento que no figure como una vía pública compatible anteriormente se considera un detalle de implementación interna. Las API internas, el diseño del almacenamiento y la implementación de seguridad pueden cambiar entre versiones. No dependa de ellos desde código de terceros, temas o sistemas externos. No se admiten escrituras directas en la base de datos.

Aviso de documentación pública. Esta página proporciona únicamente una descripción general de la integración a alto nivel. Los detalles de implementación interna, las API privadas, los aspectos internos del almacenamiento y la infraestructura de lanzamientos sensible a la seguridad se mantienen por separado y no forman parte de la documentación pública. Las vías de integración compatibles son los shortcodes documentados, las anulaciones de plantillas, la interfaz de usuario de ajustes y cualquier punto de extensión publicado explícitamente en esta sección.