Documentación · Resolución de problemas
Preguntas frecuentes sobre resolución de problemas
Este documento responde a las preguntas más frecuentes sobre la resolución de problemas para el plugin ADP Car Market Hub. Para obtener guías detalladas paso a paso, siga los enlaces a los documentos de resolución de problemas correspondientes.
General
El menú del plugin no aparece en el panel de administración de WordPress después de la activación.
El panel de administración del plugin solo es accesible para los usuarios de WordPress con la capacidad manage_as24_imports, que se asigna al rol administrator durante la activación. Inicie sesión como administrador de WordPress. Si el menú sigue sin aparecer, desactive y vuelva a activar el plugin para volver a ejecutar la asignación de capacidades. Consulte Permission Errors.
Puedo ver el panel de administración del plugin, pero todos los botones devuelven "Permission denied" (Permiso denegado).
Todas las acciones AJAX y envíos de formularios del plugin comprueban la capacidad manage_as24_imports. Si a su cuenta de usuario se le otorgó el estado de administrador después de activar el plugin, es posible que no se haya asignado la capacidad. Desactive y vuelva a activar el plugin, o pida a un superadministrador que verifique su rol. Consulte Permission Errors.
¿Cómo puedo comprobar qué está haciendo el plugin?
Abra la pestaña Logs en el panel de administración del plugin. El registro registra todas las ejecuciones de importación, errores, descargas de imágenes y eventos del sistema. Para obtener una exportación de diagnóstico descargable (JSON o ZIP), utilice la pestaña System & Help. Consulte Cron Errors e Import Errors.
Licencias
Una función muestra "not active for this license" (no activa para esta licencia) o una pestaña completa se sustituye por una pantalla de bloqueo.
Varias capacidades (Market Insights, el AI Assistant y Content Studio, entre otras) se rigen por la licencia de su plugin ADP Car Market Hub. Cuando la licencia no incluye una función, esa función muestra un aviso amigable de "no incluido en esta licencia" y sus acciones no se realizan. Cuando la propia licencia no está operativa (por ejemplo, caducada o no verificada), las acciones operativas como las importaciones se pausan y las áreas de administración afectadas muestran una pantalla de bloqueo de licencia. En ningún caso se eliminan las páginas o los datos de vehículos existentes. Póngase en contacto con el soporte de ADP Car Market Hub para habilitar una función o para restaurar una licencia caducada o suspendida. Consulte Market Insights Issues.
Las importaciones dejaron de ejecutarse y el registro menciona la licencia.
Cuando la licencia está caducada, suspendida o no se puede verificar más allá del período de gracia, las acciones operativas como las importaciones y el análisis diario de precios se pausan (fallan por seguridad bloqueando el proceso). Como resultado, no se elimina ninguna entrada, meta o archivo multimedia. Restaure o renueve la licencia para reanudar el funcionamiento normal.
Asistente de configuración
No aparece el aviso de configuración "Welcome to ADP Car Market Hub".
El aviso solo se muestra cuando se ha registrado una marca de tiempo de primera activación, el asistente no se ha completado ni omitido, y el usuario actual debe tener la capacidad de gestión del plugin. Las actualizaciones del plugin que no activan una nueva activación no muestran el aviso en las instalaciones existentes. Siempre puede abrir el asistente manualmente desde Car Market Hub → Tools → Setup Wizard o desde el enlace Run Setup Wizard en el Dashboard. Consulte Setup Wizard Reference.
Omití el asistente. ¿Cómo puedo volver a abrirlo?
Abra Car Market Hub → Tools y haga clic en la tarjeta Setup Wizard, o utilice el enlace Run Setup Wizard cerca de la parte superior de Car Market Hub → Dashboard. El asistente sigue estando accesible en wp-admin/admin.php?page=as24ci-setup-wizard incluso después de haber sido omitido o completado.
El asistente no creó mis páginas.
O bien se seleccionó la opción Skip para esa página en el Paso 4, se reutilizó una página existente con el mismo título (el asistente elimina duplicados por título para evitar crear páginas duplicadas), o la opción correspondiente (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) ya apuntaba a una página publicada. Abra la lista de WordPress Pages para confirmarlo. El asistente nunca elimina páginas existentes.
El campo Client Secret está vacío cuando vuelvo a abrir el Paso 3.
Esto es por diseño. El Client Secret almacenado nunca se vuelve a renderizar en el HTML de administración, ni en el asistente ni en la pestaña Settings. Enviar el formulario con el campo vacío conserva el secreto almacenado existente. Enviar un valor no vacío lo reemplaza.
Analytics no está habilitado después de una configuración en vivo (Live).
En el modo Live, la casilla de verificación de analíticas está desmarcada por defecto y debe habilitarse explícitamente. Vuelva a abrir el asistente y marque la casilla de analíticas en el Paso 5, o habilite las analíticas en la pestaña Analytics. Confirme primero los requisitos de consentimiento de cookies y privacidad. Consulte Analytics Retention.
No se instalaron los datos de demostración.
Los datos de demostración solo se instalan cuando se selecciona Demo setup en el Paso 1 y el asistente se finaliza con Install Demo Data and Finish en el Paso 6. La configuración en vivo (Live) no instala datos de demostración. Los datos de demostración también se pueden instalar en cualquier momento desde la tarjeta Demo Data en Car Market Hub → Tools.
Las páginas de Comparar o Favoritos están vacías después de una instalación de demostración.
Comparar y Favoritos son funciones del lado del cliente que leen del localStorage del navegador del visitante. El instalador de demostración proporciona una alternativa que alimenta el localStorage en la primera carga de la página. Abra la página de Cars, Compare o Favorites una vez en la misma sesión del navegador para activar la carga de datos.
¿Sobrescribirá el asistente mis ajustes existentes si lo ejecuto de nuevo?
No. El asistente solo escribe las opciones cuyos campos de formulario envía realmente el administrador. Volver a ejecutarlo a medias nunca borra un ajuste que no estuviera en el formulario enviado. El Client Secret se conserva cuando el campo se deja vacío. La activación y reactivación del plugin tampoco son destructivas.
API y conexión
La prueba de conexión falla con "Missing API credentials" (Faltan credenciales de la API).
La URL base de la API, el Client ID o el Client Secret están vacíos o son incorrectos. Abra la pestaña Settings del plugin, confirme que los tres campos estén completos y guarde. Consulte API Connection Errors.
El token de acceso sigue caducando y las importaciones fallan.
El plugin almacena en caché el token de acceso en el transient as24ci_access_token. Si el endpoint del token devuelve un valor expires_in muy corto, el token puede caducar antes de que se complete la importación. Elimine el transient a través de WP-CLI (wp transient delete as24ci_access_token) e inténtelo de nuevo. Si el problema persiste, póngase en contacto con su proveedor de API para confirmar el período de validez del token. Consulte API Connection Errors.
La importación devuelve cero vehículos a pesar de que mi cuenta de AutoScout24 tiene anuncios.
Las causas más comunes son: el Seller ID es incorrecto, los anuncios no están activos o publicados en AutoScout24, o las credenciales de la API no tienen acceso al Seller ID configurado. Verifique los cuatro ajustes (URL base, Client ID, Client Secret, Seller ID) y compruebe el registro del plugin para ver si hay mensajes de error específicos. Consulte API Connection Errors e Import Errors.
Importación
Los vehículos se importan como borradores en lugar de publicarse automáticamente.
El estado por defecto de la entrada es configurable. Abra la pestaña Importer o Settings del plugin y compruebe el ajuste Default Post Status. Cámbielo de draft a publish si desea que los vehículos aparezcan en el sitio inmediatamente después de la importación. Tenga en cuenta que importar como draft es el valor predeterminado conservador en las nuevas instalaciones. Consulte Import Errors.
Algunos campos de vehículos están vacíos después de la importación.
La importación mapea los campos de respuesta de la API a los meta de entrada de WordPress utilizando la configuración de mapeo de campos del plugin. Si un campo está vacío, o bien el anuncio de AutoScout24 no contiene un valor para ese campo, o bien se ha modificado el mapeo de campos. Compruebe la pestaña Field Mapping en la administración del plugin y verifique que los campos correspondientes estén correctamente mapeados. Consulte Import Errors.
La importación automática no se está ejecutando.
Las importaciones automáticas requieren que la opción Auto Import esté habilitada y que WP-Cron funcione. Abra la pestaña Import & Limits → Automation para confirmar que la importación automática está activada y que hay una programación configurada. Luego, compruebe la pestaña System & Help para confirmar que el evento as24ci_scheduled_import está programado. Si DISABLE_WP_CRON está establecido en true en wp-config.php, WP-Cron no se ejecutará y se deberá configurar un disparador de cron externo. Consulte Cron Errors.
Imágenes
Los vehículos se importan pero no tienen imágenes.
La importación de imágenes se controla mediante el interruptor Import Images en los ajustes del Importer. Confirme que está habilitado. Si está habilitado pero siguen faltando imágenes, abra el registro del plugin y busque Image download failed o media_handle_sideload failed para identificar el error específico. Las causas comunes incluyen espacio en disco insuficiente, falta de permisos de escritura en wp-content/uploads y límites de memoria de PHP. Consulte Image Import Errors.
Faltan algunas imágenes y otras se importaron correctamente.
El plugin procesa las imágenes a través de una cola en segundo plano (el ejecutor de la cola de imágenes). Las imágenes que no se pudieron descargar en la ejecución principal de la importación se vuelven a intentar de forma asíncrona. Compruebe la pestaña System & Help para ver el tamaño de la cola de imágenes y la hora de la última ejecución. También puede activar la cola manualmente utilizando el botón Run Image Queue. Consulte Image Import Errors.
No se están generando imágenes WebP convertidas.
La conversión a WebP requiere la extensión GD con soporte para imagewebp o la extensión Imagick. Confirme que una de estas está disponible en su servidor (compruebe Herramientas → Salud del sitio → Información → Servidor en WordPress). La conversión a WebP está desactivada por defecto. Habilítela en los ajustes del Importer cuando su servidor sea compatible. Consulte Image Import Errors.
Visualización en el frontend
La página de archivo de vehículos muestra un error 404.
La causa más común es que es necesario regenerar las reglas de reescritura de enlaces permanentes de WordPress. Vaya a Ajustes → Enlaces permanentes y haga clic en Guardar cambios sin realizar ningún cambio. Esto regenera las reglas de reescritura. Consulte Frontend Display Issues.
La página de listado de vehículos no muestra ningún vehículo a pesar de que los vehículos están importados.
Los vehículos deben tener el estado publish para aparecer en el archivo. Compruebe si los vehículos están en estado de borrador y publíquelos. Confirme también que ningún filtro activo o consulta de búsqueda esté ocultando los resultados, y que ningún plugin de caché esté sirviendo una página obsoleta. Consulte Frontend Display Issues.
El archivo de vehículos o las páginas de detalles se ven rotos o sin estilos.
El plugin carga su CSS y JavaScript solo en las páginas donde hay un shortcode de vehículo presente en post_content, o en las plantillas estándar de archivo y entrada única de CPT. Si su tema utiliza un constructor de páginas o una plantilla personalizada que no renderiza post_content directamente, es posible que los recursos no se carguen. Añada el shortcode [as24ci_archive] directamente al campo de contenido de la página. Consulte Frontend Display Issues y Shortcode Issues.
Shortcodes
Un shortcode se muestra como texto plano en la página.
El procesamiento de shortcodes está desactivado en algunos contextos (por ejemplo, constructores de páginas, áreas de widgets o archivos de plantilla personalizados que no llaman a do_shortcode). Verifique que el shortcode esté colocado en el campo estándar de Contenido de WordPress de una página o entrada, no en un widget, campo personalizado o plantilla PHP. Consulte Shortcode Issues.
El shortcode [as24ci_archive] no muestra nada.
Si el shortcode está en la posición correcta pero no muestra nada, la causa más probable es que no existan vehículos publicados. Compruebe que los vehículos estén importados y publicados. Confirme también que los valores de los atributos del shortcode sean válidos; por ejemplo, per_page debe ser un número entero positivo. Consulte Shortcode Issues.
Correo electrónico y Leads
No llega ningún correo electrónico cuando un visitante envía un formulario de consulta.
El plugin envía correos electrónicos de notificación utilizando wp_mail(). Si no llega ningún correo, compruebe si su sitio de WordPress está configurado correctamente para el envío de correos. Muchos entornos de hosting requieren un plugin de SMTP para enviar correos de forma fiable. Verifique también que la dirección del destinatario configurada en los ajustes del plugin sea correcta y no esté siendo filtrada por una carpeta de spam. Consulte Errores de correo electrónico y leads.
El lead se guarda en la administración de Leads pero no se envía ninguna notificación por correo electrónico.
Los datos de los leads se guardan en el tipo de contenido personalizado as24ci_lead independientemente del envío del correo electrónico. El envío del correo electrónico es un proceso independiente. Compruebe la configuración de la dirección del destinatario (ajuste de anulación global → correo del perfil del vendedor → correo del autor de la entrada → correo de administración de WordPress como alternativa) y realice una prueba con un plugin sencillo de envío SMTP. Consulte Errores de correo electrónico y leads.
El formulario de contacto devuelve un error de validación pero todos los campos parecen estar completados.
El formulario valida el nombre, la dirección de correo electrónico, el mensaje y la casilla de verificación de consentimiento en el lado del servidor. Un campo anti-spam honeypot también debe estar vacío. Si el error persiste, es posible que el autocompletado del navegador haya rellenado el campo honeypot, o que un conflicto de JavaScript esté interfiriendo con el formulario. Intente realizar el envío en una ventana de navegación privada sin extensiones activas. Consulte Errores de correo electrónico y leads.
Market Insights
Todos los vehículos muestran no_data en la columna Market Score.
El estado no_data se devuelve cuando un vehículo no tiene un precio almacenado (_as24ci_price está vacío o es cero). Verifique que los vehículos se hayan importado con un precio. Si es así, vuelva a ejecutar la importación o active manualmente el análisis de precios desactivando y volviendo a activar el plugin. Consulte Problemas de Market Insights.
Los días en el lote (Days on Lot) muestran 0 o un número inesperadamente grande.
Un valor de 0 puede significar que el vehículo se publicó hoy o que tiene una publicación programada con fecha futura. Los valores muy grandes indican una fecha de publicación corrupta (por ejemplo, importada de un registro con fecha cero). Compruebe la fecha de publicación del vehículo en la tabla de la lista de entradas. Consulte Problemas de Market Insights.
PDF Datasheet
La URL de la ficha técnica (?as24ci_pdf=123) devuelve un error 404.
O bien la función PDF Datasheet no está activada, el ID de la entrada es incorrecto o el vehículo no está en estado publish. Active la función en los ajustes del plugin, actualice los enlaces permanentes (flush permalinks) y confirme que el vehículo está publicado. Consulte Problemas de PDF Datasheet.
La ficha técnica no muestra imágenes.
Confirme que se hayan importado imágenes para el vehículo y que la opción Show Gallery esté activada en los ajustes del PDF Manager. La ficha técnica muestra un máximo de 5 imágenes. Consulte Problemas de PDF Datasheet.