Documentación · Resolución de problemas

Descripción general de la resolución de problemas

Este documento proporciona un punto de entrada estructurado para diagnosticar y resolver problemas con el plugin ADP Car Market Hub WordPress. Describe el orden de diagnóstico recomendado, dónde encontrar los logs y la información de estado, y las prácticas seguras al contactar con el soporte técnico.

Cuándo utilizar este documento

Lea este documento en primer lugar siempre que el plugin no se comporte como se espera. Le guiará hacia la página especializada correcta y le ayudará a recopilar la información necesaria antes de ponerse en contacto con el soporte técnico.

Descripción general

El plugin ADP Car Market Hub se conecta a la API de AutoScout24, importa listados de vehículos en WordPress, gestiona la automatización programada y renderiza los listados en el frontend. Pueden producirse problemas en cualquiera de estas capas. Comenzar con un orden de diagnóstico sistemático evita que pierda tiempo en la capa incorrecta.

Orden de diagnóstico recomendado

Trabaje en cada capa de forma secuencial. Deténgase y consulte el documento especializado correspondiente tan pronto como identifique el área del problema.

  1. Comprobar el log del plugin – El plugin escribe todos los eventos significativos, errores y resultados de importación en un archivo de log dedicado. Este es siempre el primer lugar donde mirar.
  2. Comprobar la conexión de la API – Si el log muestra errores de autenticación o HTTP, o si la página de Estado del sistema informa de un problema de conexión, consulte Errores de conexión de la API.
  3. Comprobar los resultados de la importación – Si faltan vehículos, se importan parcialmente o muestran datos desactualizados, consulte Errores de importación.
  4. Comprobar la automatización programada – Si las importaciones automáticas no se están ejecutando, o la hora de la última ejecución no avanza, consulte Errores de Cron.
  5. Comprobar las importaciones de imágenes – Si faltan imágenes de vehículos o no se han descargado por completo, consulte Errores de importación de imágenes.
  6. Comprobar la visualización en el frontend – Si los listados aparecen en el backend pero no correctamente en el frontend, consulte Problemas de visualización en el frontend.
  7. Comprobar los permisos – Si las pantallas de administración o las acciones de importación devuelven errores de acceso denegado, consulte Errores de permisos.

Dónde encontrar los logs y la información de estado

Archivo de log del plugin

El plugin escribe en un archivo de log en el directorio de subidas de WordPress:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

El directorio de logs está protegido contra el acceso web directo mediante un archivo .htaccess y una barrera index.php. Acceda al archivo a través de SFTP, el administrador de archivos del hosting o una herramienta de visualización de logs con acceso al servidor.

El archivo de log rota automáticamente cuando supera los 10 MB. Los archivos rotados se nombran adp-car-market-hub-YYYYMMDD-HHMMSS.log y se eliminan automáticamente después de 7 días.

El registro detallado (entradas por vehículo y por imagen) está habilitado por defecto. Puede desactivarlo en los ajustes del plugin para reducir el volumen del log en catálogos grandes.

Página de Estado del sistema

La administración del plugin incluye una pestaña de Sistema y Ayuda que muestra:

  • Estado de la conexión API (probado por última vez con el Seller ID configurado)
  • Hora de la última ejecución de importación y recuento de resultados (insertados, actualizados, omitidos, errores)
  • Estado de WP-Cron o del cron del servidor y hora de la última ejecución
  • Estado de la cola de imágenes (elementos pendientes, última ejecución del proceso secundario)

Revise esta página antes de comprobar los logs sin procesar.

Administración de WordPress

Las herramientas estándar de WordPress también proporcionan información útil:

  • Herramientas → Eventos programados (o un plugin visor de WP-Cron): verifique que los eventos as24ci_scheduled_import y as24ci_image_queue_process estén presentes y tengan una hora de próxima ejecución realista.
  • Biblioteca de medios: confirme que las imágenes de los vehículos se están adjuntando a las entradas correctas.
  • Entradas → Cars: compruebe el recuento de entradas de vehículos publicadas y cualquier borrador o entrada pendiente.

Requisitos previos para una resolución de problemas eficaz

Antes de investigar, confirme lo siguiente:

  • Tiene acceso de administrador al escritorio de WordPress.
  • Tiene acceso al servidor (SFTP, SSH o administrador de archivos del hosting) para leer el archivo de log.
  • Conoce la versión del plugin instalada actualmente (visible en Plugins → Plugins instalados).
  • Conoce la versión de PHP y la versión de WordPress del sitio (visible en Herramientas → Salud del sitio).

Prácticas seguras al contactar con el soporte técnico

  • No comparta credenciales de la API (Client ID, Client Secret o tokens de acceso) en tickets de soporte o foros públicos. El log del plugin enmascara automáticamente estos valores.
  • Proporcione la sección relevante del archivo de log (no el archivo completo a menos que se le solicite).
  • Incluya la información de salida de la página de Estado del sistema o una captura de pantalla.
  • Describa los pasos exactos que realizó antes de que apareciera el problema, incluyendo cualquier cambio reciente en los ajustes o actualizaciones del plugin.
  • Si sospecha de un problema con WordPress o el entorno de hosting, incluya la información de salida de Herramientas → Salud del sitio → Información.

Notas operativas

  • La mayoría de los problemas se deben a credenciales incorrectas, un endpoint de la API inaccesible o una programación de cron desactivada o mal configurada.
  • El plugin utiliza bloqueos transitorios de WordPress para evitar ejecuciones de importación superpuestas. Si una importación se interrumpió de forma anormal, el bloqueo puede persistir hasta 40 minutos antes de eliminarse automáticamente.
  • El plugin almacena el resultado de la última importación (recuentos y marca de tiempo) en las opciones de WordPress. Estos son visibles en el panel de administración y también se escriben en el log.

Documentos relacionados