WordPress

Plugin para WordPress y WooCommerce

Gratis en todos los planes, incluido el gratuito

Empezar gratis Documentación

Dónde conseguirlo

Ver en el directorio de plugins

Directorio de plugins de WordPress.org

Requisitos WordPress 5.6+, PHP 7.2+

Nombre del paquete dockray

Precios Gratis

Para qué sirve

El plugin oficial de DockRay conecta WordPress con la plataforma de monitorización y reporta automáticamente errores de PHP y excepciones no controladas. Los problemas de WordPress, el tema, los plugins o WooCommerce se envían directamente al panel de DockRay.

Información sobre los errores

Los eventos reportados pueden incluir, entre otros datos:

el tipo y el contenido del error,
el lugar donde se produjo y el stack trace,
información sobre el entorno y la versión de la aplicación,
el contexto de la solicitud procesada.

El alcance de los errores de PHP reportados puede configurarse para limitar la recopilación de eventos menos relevantes.

Configuración sencilla

Puedes configurar la integración en Ajustes → DockRay introduciendo el token del proyecto y la clave privada. Las credenciales también pueden definirse en el archivo wp-config.php.

Privacidad y opciones para desarrolladores

De forma predeterminada, DockRay no envía datos de los usuarios. Opcionalmente, puedes activar contexto adicional, como el identificador del usuario, la dirección de correo electrónico, la dirección IP o el user agent.

El plugin también permite añadir etiquetas y contexto personalizados, modificar la configuración del cliente y reportar manualmente excepciones desde el código.

Instalación

Instalación desde el directorio de plugins de WordPress

En el panel de WordPress, ve a Plugins → Añadir nuevo.
Busca DockRay y haz clic en Instalar ahora.
Una vez finalizada la instalación, haz clic en Activar.
Ve a Ajustes → DockRay.
Introduce el token del proyecto y la clave privada disponibles en el panel de DockRay y guarda los ajustes.
Utiliza el botón Enviar evento de prueba para comprobar que la conexión funciona correctamente.

Una vez configurado correctamente, el plugin comenzará a reportar automáticamente los errores y excepciones compatibles a tu proyecto en DockRay.

Configuración mediante wp-config.php

Si no quieres almacenar las credenciales en la base de datos de WordPress, puedes definir el token del proyecto y la clave privada directamente en el archivo wp-config.php:

define( 'DOCK_RAY_TOKEN', 'TU_TOKEN_DE_PROYECTO' );
define( 'DOCK_RAY_PRIVATE_KEY', 'TU_CLAVE_PRIVADA' );

Añade las constantes antes del comentario que indica el final de la edición del archivo wp-config.php. Después de guardar los cambios, el plugin detectará automáticamente la configuración y su origen aparecerá en Ajustes → DockRay.

Instalación desde un archivo ZIP

Descarga la versión más reciente del plugin DockRay desde WordPress.org.
En el panel de WordPress, ve a Plugins → Añadir nuevo → Subir plugin.
Selecciona el archivo ZIP descargado e inicia la instalación.
Activa el plugin.
Ve a Ajustes → DockRay y configura la conexión con tu proyecto.

Cómo usarlo

La integración informa de las excepciones por sí sola. Esto es para los informes que envías a propósito.

php

<?php

if ( function_exists( 'dock_ray_safe' ) ) {
    dock_ray_safe( fn( $hub ) => $hub->captureMessage( 'Error message...' ) );
}

try {
    $order->finalize();
} catch ( Throwable $e ) {
    if ( function_exists( 'dock_ray_safe' ) ) {
        dock_ray_safe( fn( $hub ) => $hub->captureException( $e ) );
    }
}