Documentación · Referencia del administrador

Referencia de sistema y ayuda

Este documento es una referencia para la pantalla Sistema y ayuda del plugin ADP Car Market Hub (Car Market Hub → System & Help). Explica los paneles de conectividad, tareas en segundo plano, servidor, archivos de registro y cola de imágenes que muestra esta vista de estado.

Cuándo usar este documento

Lea esto si necesita:

Confirmar que la API de AutoScout24, el endpoint REST del plugin y la API de Market Hub están accesibles.
Ver si las tareas programadas (cron jobs) están en buen estado y cuándo se ejecutarán la próxima vez.
Activar una importación, una ejecución de la cola de imágenes o una purga de la cola desde un único lugar.
Comprobar que el servidor cumple con los requisitos del plugin (versión de PHP, memoria, tiempo de ejecución).
Inspeccionar el tamaño del archivo de registro y el estado de rotación, así como el estado de la cola de importación de imágenes.

Descripción general

La pantalla es un panel de estado principalmente de lectura. Una barra de acciones superior encima de las tarjetas incluye un botón Descargar diagnóstico (etiquetado como Descargar diagnóstico ZIP, o Descargar diagnóstico JSON cuando el soporte ZIP no está disponible en el servidor) que descarga un paquete de diagnóstico que puede adjuntar a una solicitud de soporte.

La pantalla se divide en las siguientes tarjetas:

Conectividad y API: estado de la API de AutoScout24, estado del token OAuth2, comprobación del endpoint REST del plugin y estado de la API de Market Hub.
Diagnóstico de actualizaciones privadas: diagnóstico de actualizaciones y versiones con un informe JSON copiable.
Tareas en segundo plano: lista de eventos cron programados con su planificación y próxima hora de ejecución, además de botones de acción.
Requisitos del plugin: versiones mínimas y flags de características.
Servidor y almacenamiento: configuración de PHP, entorno del servidor y estado del directorio de subidas.
Estado del archivo de registro: tamaño actual del archivo de registro, estado de rotación y ruta.
Estado de la cola de imágenes: imágenes pendientes, estadísticas de la última ejecución del worker.

Cada fila utiliza distintivos de semáforo (ok, warn, bad) con información sobre herramientas que explica el umbral o el paso de solución.

Requisitos o prerrequisitos

Un usuario con la capacidad de gestión del plugin.
Para las comprobaciones de conectividad: acceso HTTPS saliente desde el servidor web a los endpoints de la API configurados.
Para la comprobación de la API REST: enlaces permanentes amigables de WordPress habilitados.
Para la sección cron: el cron integrado de WordPress debe estar activo, o un programador del lado del servidor debe llamar a wp-cron.php.

Instrucciones paso a paso

Verificar la conectividad

Abra Car Market Hub → System & Help.
En Conectividad y API, compruebe: - Estado del endpoint de la API de AS24 y Accesibilidad de la API de AS24 para la URL base de AutoScout24. - Estado del token (Válido / Expira pronto / Expirado / Sin token). - Estado de la API REST para el endpoint as24ci/v1/cron-import del plugin. - Accesibilidad de Market Hub para la API de Market Hub.
Pase el cursor sobre cualquier distintivo para ver la información sobre herramientas con el detalle subyacente (estado HTTP, latencia o mensaje de error).

Revisar el diagnóstico de actualizaciones

Abra la tarjeta Diagnóstico de actualizaciones privadas en la columna de la derecha.
Lea las filas para confirmar que el canal de actualización del plugin está en buen estado: la versión instalada, si los hooks de actualización están registrados, la nueva versión remota ofrecida, la consistencia del transient (datos de actualización almacenados en caché), el estado de la licencia y el dominio normalizado.
Si se pone en contacto con el soporte técnico por un problema de actualización o de licencia, utilice el informe JSON copiable de la parte inferior de la tarjeta y péguelo en su ticket.

Esta tarjeta es una forma rápida de confirmar que el plugin puede ver y aplicar actualizaciones privadas sin exponer ninguna credencial confidencial.

Comprobar las tareas programadas

Desplácese hasta Tareas en segundo plano.
El encabezado de la tarjeta muestra un distintivo que indica si la programación se ejecuta a través de WP-Cron o un Cron del servidor, junto con una nota de latido como La última importación se ejecutó hace X o No se detectó ninguna ejecución de importación reciente.
Revise la tabla: cada fila muestra la tarea cron, su programación, la marca de tiempo de la próxima ejecución y un distintivo de estado. Las tareas pueden incluir trabajos de importación, cola de imágenes, análisis y Análisis de precios.
Junto al estado normal de próxima ejecución, una tarea puede informar Bloqueo atascado, Gestionado por cron del servidor o No programado.
Si el cron integrado de WordPress está desactivado (DISABLE_WP_CRON), se muestra una advertencia; en ese caso, configure un programador del lado del servidor que llame a wp-cron.php.
Utilice los botones integrados para Ejecutar importación ahora, Ejecutar cola de imágenes ahora o Borrar cola de imágenes cuando sea necesario.

Verificar la compatibilidad del servidor

Lea Requisitos del plugin para ver las versiones mínimas y los flags de características, incluida la disponibilidad de ZipArchive y el estado de ionCube Loader (con su Versión del cargador).
Lea Servidor y almacenamiento para la configuración de PHP: - memory_limit, WP Memory Limit, max_execution_time, upload_max_filesize, post_max_size, max_input_vars. - PHP SAPI y SO del servidor. - Estado del directorio de subidas y espacio libre en disco.

Inspeccionar el archivo de registro y la cola de imágenes

El Estado del archivo de registro muestra si el archivo de registro existe, su tamaño actual, el margen restante antes de la rotación, la hora de la última rotación y la ruta del archivo.
El Estado de la cola de imágenes muestra las importaciones de imágenes pendientes más las estadísticas de la última ejecución del worker (recuento de procesadas, errores, elementos restantes).

Referencia de configuración

La pantalla Sistema y ayuda no almacena sus propios ajustes. Lee de la configuración actual de WordPress, las opciones del plugin y el estado de tiempo de ejecución.

Distintivos de Conectividad y API

Fila	Estados posibles
Estado del endpoint de la API de AS24	`ok` (configurado y accesible), `bad` (sin URL base o inaccesible).
Accesibilidad de la API de AS24	Resultado de tipo latencia con `ok` / `warn` / `bad`; etiquetas como Conexión activa, Host accesible, endpoint de API no verificado o Error del servidor (HTTP n). Almacenado en caché durante 60 segundos.
Estado del token	`Valid`, `Valid — expires <time>`, `Expires soon` (menos de 5 minutos), `Expired`, `No token`.
Estado de la API REST	Endpoint accesible, por ejemplo, Activo, la protección de token funciona (el endpoint rechaza un token de comprobación de estado no válido con HTTP 403); Endpoint REST no encontrado (HTTP 404); o inaccesible.
Accesibilidad de Market Hub	Patrón similar a la comprobación de la API de AS24.

La redacción exacta de las etiquetas puede diferir ligeramente entre las versiones del plugin; confíe en el color del distintivo y en el detalle de la información sobre herramientas en lugar de en el texto preciso.

La fila de la API REST solo se comprueba por completo cuando se ha generado un token cron en Importación y límites. De lo contrario, muestra Not checked — no cron token configured.

Diagnóstico de actualizaciones privadas

Esta tarjeta muestra el estado de las actualizaciones y licencias del plugin. Sus filas suelen incluir la versión instalada, si los hooks de actualización están registrados, la nueva versión remota ofrecida, la consistencia del transient (datos de actualización almacenados en caché), el estado de la licencia y el dominio normalizado. Un informe JSON copiable en la parte inferior empaqueta estos valores para el soporte técnico.

Umbrales del servidor

Ajuste	`ok`	`warn`	`bad`
`memory_limit`	≥ 256 MB o ilimitado	128–255 MB	< 128 MB
`max_execution_time`	> 60 s o ilimitado	30–60 s	< 30 s

Los otros valores de PHP (upload_max_filesize, post_max_size, max_input_vars, permisos de escritura del directorio de subidas, espacio libre en disco) se presentan con sus valores actuales y un distintivo contextual.

Acciones de tareas en segundo plano

Botón	Efecto
Ejecutar importación ahora	Activa la importación regular una vez, de forma inmediata.
Ejecutar cola de imágenes ahora	Procesa el siguiente lote de la cola de imágenes.
Borrar cola de imágenes	Vacía la cola de imágenes pendientes. Acción destructiva.

Notas operativas

Las comprobaciones de conectividad utilizan un tiempo de espera corto y un user agent personalizado, y almacenan en caché su resultado durante aproximadamente un minuto para evitar saturar los servicios ascendentes. No todas utilizan el mismo método HTTP: la comprobación de AutoScout24 emite una solicitud HEAD, mientras que la autocomprobación REST del plugin y la sonda de estado de Market Hub utilizan GET (la sonda de Market Hub se dirige a un endpoint /v1/health).
El botón Descargar diagnóstico en la barra de acciones superior genera un paquete de diagnóstico (un archivo ZIP donde sea compatible, de lo contrario un archivo JSON) para adjuntarlo a una solicitud de soporte.
La información sobre herramientas de expiración del token utiliza la zona horaria del sitio de WordPress para su visualización, pero el valor almacenado en caché se guarda como una marca de tiempo UNIX.
La comprobación de la API REST utiliza intencionadamente un token no válido; una instalación en buen estado responde con HTTP 403. HTTP 404 indica que el endpoint no es accesible (normalmente un problema de enlaces permanentes o de reescritura).
Si DISABLE_WP_CRON está activo, las tareas programadas no se ejecutarán a menos que el host esté configurado para llamar a wp-cron.php por su cuenta. Las importaciones y el procesamiento de imágenes parecerán atascados sin esto.
El distintivo de advertencia de la cola de imágenes aparece cuando el tamaño de la cola supera el umbral interno del plugin (actualmente 1.000 elementos pendientes).
El espacio libre en disco se informa como una estimación. Algunos proveedores de hosting ocultan esto; en ese caso, el distintivo muestra No se puede determinar.

Resolución de problemas

La accesibilidad de la API de AS24 es bad. Falta la URL base en Ajustes, está mal formada o el servicio ascendente está caído. Compruebe la información sobre herramientas para ver el error subyacente.
El estado del token es No token. Guarde un Client ID y un Secret válidos en Ajustes, luego ejecute Probar conexión en Herramientas.
El estado de la API REST informa que no se encontró el endpoint (HTTP 404). Los enlaces permanentes amigables están desactivados o bien otro plugin está anulando el enrutamiento REST. Vuelva a guardar los enlaces permanentes en Settings → Permalinks.
La fila de la API REST dice "No comprobado: no se ha configurado ningún token cron". Abra Importación y límites y genere un token cron.
Las tareas en segundo plano tienen una "Próxima ejecución" obsoleta. El cron de WordPress está desactivado o no hay tráfico que llegue al sitio. Utilice el botón Ejecutar importación ahora para confirmar que la tarea en sí se ejecuta, luego programe un activador del lado del servidor.
memory_limit marcó bad. Aumente memory_limit en php.ini o wp-config.php (define('WP_MEMORY_LIMIT', '256M');), necesario para importaciones grandes.
La cola de imágenes sigue creciendo. Haga clic en Ejecutar cola de imágenes ahora para procesar un lote. Si el recuento sigue aumentando, reduzca el número de imágenes importadas por vehículo en Ajustes o aumente la frecuencia de ejecución del worker en Importación y límites.
El archivo de registro marcó bad o Aún no hay archivo de registro. Confirme que el directorio de registro tiene permisos de escritura. Verifique en la versión actual del plugin antes de publicar.