Documentación · Empezando

Primera configuración

Esta guía explica qué debe configurar un administrador de WordPress después de activar el plugin ADP Car Market Hub y en qué orden. Seguir la secuencia recomendada evita los errores de reprocesamiento más comunes; por ejemplo, ejecutar una importación antes de que se valide la conexión de la API o pasar a producción antes de haber verificado el frontend en una página de vehículo real.

Este documento cubre el flujo de configuración. El material de referencia detallado para cada pestaña de administración está disponible en la sección Referencia de administración. En Referencia del asistente de configuración se proporciona una referencia específica para el Asistente de primera configuración integrado en el plugin.

Asistente de primera configuración

ADP Car Market Hub incluye un Asistente de primera configuración que guía a un administrador a través de las opciones de configuración más comunes en siete sencillos pasos. El primer paso es la activación de la licencia, que es obligatoria: hasta que no se active una licencia válida, todos los pasos operativos del asistente (y todas las pestañas de administración del plugin que no sean Ajustes) permanecerán bloqueados. Una vez que la licencia está activa, los pasos restantes son el punto de entrada recomendado tanto para evaluaciones de demostración como para despliegues reales de AutoScout24, pero no son obligatorios: cada opción que ofrecen también se puede configurar manualmente utilizando las pestañas de administración habituales documentadas en la Referencia de administración.

Qué hace el asistente

Activa su licencia como primer paso. La licencia desbloquea las áreas premium del plugin; sin ella, el asistente no puede avanzar más allá de la pantalla de licencia y las demás pestañas de administración muestran una pantalla de "Licencia requerida".
Permite al administrador elegir entre Configuración de demostración (instala vehículos de demostración, aplica valores predeterminados de demostración y activa las analíticas para que las páginas de Escritorio y Analíticas tengan datos que mostrar) y Configuración real de AutoScout24 (guarda credenciales reales y páginas seleccionadas sin instalar datos de demostración).
Captura el perfil del concesionario (nombre, dirección, datos de contacto, logotipo).
Captura la conexión de AutoScout24 (Client ID, Client Secret, Seller ID, URL base de la API).
Opcionalmente, crea las páginas públicas Coches, Comparar coches y Favoritos con los shortcodes canónicos.
Activa o desactiva las funciones predeterminadas más comunes (compartir en redes sociales, PDF datasheet, código QR del PDF, costes de funcionamiento por 100 km, Comparar, Favoritos, Alertas de búsqueda, seguimiento de Analíticas).
Marca la configuración como completada y devuelve al administrador al Escritorio.

Cuándo aparece el asistente

Después de la primera activación del plugin, aparece un aviso de administración titulado Bienvenido a ADP Car Market Hub en la parte superior de cada página de administración de WordPress.
El aviso no es un redireccionamiento forzado: el administrador puede seguir navegando por WordPress e iniciar el asistente más tarde.
El aviso se muestra solo cuando se cumplen todas las siguientes condiciones:
El usuario actual tiene la capacidad de gestión del plugin.
Se ha registrado una marca de tiempo de primera activación.
El asistente no se ha marcado como completado.
El asistente no se ha marcado como omitido.
Las actualizaciones del plugin que no desencadenan una nueva activación no muestran el aviso en las instalaciones existentes.

Cómo iniciar el asistente

Haga clic en Iniciar asistente de configuración en el aviso de bienvenida, o
Abra Car Market Hub → Escritorio y use el enlace Ejecutar asistente de configuración cerca de la parte superior, o
Abra Car Market Hub → Herramientas y use la tarjeta Asistente de configuración.

El asistente está registrado como una página de administración oculta accesible en wp-admin/admin.php?page=as24ci-setup-wizard. Se aplican comprobaciones de capacidad y de nonce en cada paso.

Cómo omitir el asistente

Haga clic en Omitir por ahora en el aviso de bienvenida. El aviso no volverá a aparecer en las siguientes cargas de páginas de administración.
El asistente sigue estando accesible desde el Escritorio y la pestaña Herramientas para que pueda reanudarse en cualquier momento.

Pasos del asistente

Licencia: introduzca y active su clave de licencia. Este paso se exige en primer lugar; el asistente no puede continuar con ningún paso operativo hasta que la licencia esté operativa. La clave de licencia es de solo escritura: nunca se rellena previamente en la pantalla.
Modo: elija Configuración de demostración o Configuración real de AutoScout24; elija el país del concesionario, la moneda y el idioma de administración.
Perfil del concesionario: nombre, calle, código postal, ciudad, país, teléfono, correo electrónico, sitio web, logotipo.
AutoScout24: Client ID, Client Secret, Seller ID y URL base de la API. El campo Client Secret se muestra vacío intencionadamente (consulte Configuración de Credenciales de la API).
Páginas: para cada página pública (Coches, Comparar coches, Favoritos) elija Crear automáticamente, Usar página existente o Omitir.
Características: active o desactive las funciones predeterminadas enumeradas anteriormente.
Finalizar: revise el resumen y confirme. En el modo de demostración, el paso final también activa el instalador de datos de demostración existente; en el modo real, solo guarda los ajustes del asistente.

Seguridad para instalaciones existentes

La activación del plugin solo establece valores predeterminados no destructivos; nunca sobrescribe los valores de las opciones existentes.
Desactivar y reactivar el plugin no vuelve a abrir el asistente automáticamente y no sobrescribe los ajustes.
El asistente solo cambia los ajustes cuyos campos de formulario envíe realmente el administrador.
La configuración de demostración es la única vía que instala datos de demostración y restablece las opciones controladas por la demostración; es una operación explícita de restablecimiento e inicialización. La configuración real no es destructiva con respecto a los vehículos y los ajustes del cliente.

Para obtener todos los detalles sobre las marcas, capacidades, URL de la página de administración oculta y el comportamiento de almacenamiento de los pasos, consulte la Referencia del asistente de configuración.

Cuándo usar este documento

Use este documento si está:

Configurando ADP Car Market Hub en una instalación recién activada.
Volviendo a configurar el plugin después de una migración de servidor, reconstrucción de entorno o promoción de un entorno de pruebas (staging) a producción.
Documentando un proceso de incorporación repetible para el sitio de un nuevo cliente.

El público destinatario es un administrador de WordPress que ya ha completado la Guía de instalación y tiene acceso a las credenciales de la API de AutoScout24 proporcionadas por la cuenta del concesionario o su socio de integración.

Antes de empezar

Confirme lo siguiente antes de comenzar la configuración:

El plugin está instalado y activado y el menú Car Market Hub aparece en la administración de WordPress.
El sitio cumple con todos los puntos de la Lista de verificación previa a la instalación.
Tiene su clave de licencia de ADP Car Market Hub. La licencia es necesaria para desbloquear las áreas premium del plugin: hasta que se active, todas las pestañas de administración excepto Ajustes muestran una pantalla de "Licencia requerida" y las importaciones, el cron y las demás funciones permanecen bloqueados.
Tiene las credenciales de la API de AutoScout24 requeridas por su cuenta: URL base de la API, Seller ID(s), Client ID y Client Secret. Estos datos provienen de la cuenta de AutoScout24 del concesionario o del socio de integración que gestiona el acceso a la API. El plugin no los proporciona.
Ha decidido los valores comerciales predeterminados que influirán en la configuración: moneda predeterminada, qué texto legal/de consentimiento desea el concesionario en los formularios de contacto y qué funciones (reserva de prueba de conducción, Alertas de búsqueda, AI Assistant, Analíticas) deben estar activadas en el lanzamiento.
Se ha realizado una copia de seguridad del sitio de WordPress y, de manera ideal, la configuración se está realizando en un entorno de pruebas (staging) que refleja el de producción.

Orden de configuración recomendado

La siguiente secuencia de diez pasos es la recomendada. Cada paso se basa en el anterior. No se salte ningún paso; por ejemplo, no active las importaciones automáticas antes de que la prueba de conexión haya tenido éxito.

Activación de la licencia
Preparación del sistema
Credenciales de la API
Prueba de conexión
Ajustes de importación
Ajustes de diseño y frontend
Ajustes legales, de privacidad y consentimiento
Importación de prueba
Validación del frontend
Comprobaciones para la puesta en marcha

Instrucciones paso a paso

Paso 1 — Activación de la licencia

Abra Car Market Hub → Settings y complete la tarjeta License Activation en la parte superior de la página. Introduzca su clave de licencia y haga clic en Activate. Una activación exitosa desbloquea las áreas premium del plugin; las pestañas de administración de Car Market Hub distintas de Settings dejarán de mostrar la pantalla "License required", y las importaciones, el cron y el procesamiento en segundo plano pasarán a estar disponibles.

La clave de licencia es de solo escritura: nunca se vuelve a mostrar después de guardarla. La misma tarjeta también ofrece Check license (vuelve a validar la clave almacenada) y Remove license (borra la clave manteniendo los vehículos importados, las páginas y los archivos multimedia). Si comenzó con el Asistente de primera configuración, la activación de la licencia es su primer paso, por lo que ya estará hecho.

No continúe hasta que la licencia esté activa. Sin ella, el resto de pestañas de configuración permanecerán bloqueadas.

Paso 2 — Preparación del sistema

Abra Car Market Hub → System & Help y revise las comprobaciones del entorno. La página informa del estado de PHP, JSON, OpenSSL, cURL, GD/Imagick, el directorio de subidas, la programación del cron, la caché de tokens, el archivo de registro y la cola de imágenes, con distintivos de estado tipo semáforo.

Resuelva cualquier distintivo rojo antes de continuar. Las acciones típicas incluyen habilitar una extensión de PHP que falte, corregir los permisos en el directorio de subidas o solucionar un WP-Cron que no funcione.

Para una revisión más profunda del entorno, consulte Requisitos técnicos del sistema y Requisitos de API, red y SSL.

Paso 3 — Credenciales de la API

Abra Car Market Hub → Settings y complete la tarjeta API Connection & General Settings:

API Base URL — la URL HTTPS completa para su entorno de AutoScout24 o endpoint de integración, incluyendo https://.
Seller ID — uno o más Seller IDs, separados por comas si gestiona varias cuentas de vendedor.
Client ID y Client Secret — las credenciales emitidas para su acceso a la API.
Default currency — la moneda utilizada cuando un anuncio importado no proporciona ninguna.

Haga clic en Save Settings en la parte inferior de la tarjeta.

En la Configuración de Credenciales de la API se ofrece un recorrido completo por cada campo de credencial, de dónde procede y cómo manejarlo de forma segura. Para obtener información sobre cómo obtener acceso a la API, consulte Configuración de la API de AutoScout24 y Credenciales de API externas.

Paso 4 — Prueba de conexión

Después de guardar las credenciales, valídelas antes de realizar cualquier importación. Abra Car Market Hub → Tools y utilice la tarjeta API Connection Test. Haga clic en Test Connection. Una prueba exitosa confirma que el plugin puede autenticarse contra el endpoint de token configurado y comunicarse con la API de anuncios de AutoScout24 para el primer Seller ID configurado.

No continúe con los ajustes de importación hasta que la prueba de conexión tenga éxito. El procedimiento completo, incluyendo cómo interpretar el resultado y cómo reaccionar ante errores comunes, está documentado en la Prueba de conexión.

Paso 5 — Ajustes de importación

Una vez que la conexión funcione, configure cómo se importan los vehículos. Los ajustes pertinentes se encuentran en dos lugares:

Car Market Hub → Settings — opciones de imagen (si se importan imágenes, número máximo de imágenes por vehículo, conversión opcional a WebP y calidad), estado de entrada predeterminado y autor de la entrada para los vehículos recién creados, y la opción Default pages que puede crear automáticamente las páginas Cars, Compare Cars y Favorites al guardar.
Car Market Hub → Import & Limits — comportamiento de programación y tiempo de ejecución: el intervalo de WP-Cron (cada hora, cada 6 horas, dos veces al día, diariamente o personalizado), la hora de inicio para las programaciones diarias/dos veces al día, el modo opcional Full Sync (que elimina los coches locales que ya no estén presentes en AutoScout24) y los ajustes de robustez del cron (número máximo de vehículos por ejecución de cron, interruptor de la cola de imágenes).

Para la configuración inicial, elija valores conservadores:

Deje la programación automática desactivada por ahora. Prográmela después de una importación de prueba exitosa.
Mantenga la cola de imágenes activada para que las ejecuciones de cron no superen los límites de tiempo de PHP.
Deje Full Sync desactivado hasta que haya verificado que todos los vehículos esperados llegan correctamente. Full Sync elimina de forma permanente las entradas locales, incluidas las imágenes, de cualquier anuncio que no sea devuelto por la API.

Para el cron externo (a nivel de servidor), incluido el endpoint REST protegido por token, consulte Configuración del Cron del Servidor.

Paso 6 — Ajustes de diseño y frontend

Configure cómo se presentarán los vehículos en el frontend antes de exponerlos a los visitantes:

Car Market Hub → Design & Styles — colores, fuentes, diseños de archivo y de vehículo individual, diseño de galería, lightbox, distintivos de estado y texto de introducción/pie de página en las páginas de archivo.
Car Market Hub → Layout Manager — active/desactive los filtros individuales que aparecen en el archivo de coches (marca, modelo, año, precio, kilometraje, combustible, caja de cambios, color, tipo de carrocería y otros).
Car Market Hub → Mapping — controle las etiquetas legibles por humanos y la visibilidad de cada campo de datos de AutoScout24 en las páginas de detalles. Los valores predeterminados son lógicos; ajuste solo las etiquetas o la visibilidad que realmente desee cambiar.
Car Market Hub → Shortcodes & Widgets — la referencia de los shortcodes utilizados en los diseños de página personalizados (por ejemplo, las páginas de comparación y favoritos). Si activó la opción Default pages en Settings, las páginas correspondientes ya existirán; de lo contrario, coloque los shortcodes manualmente.

Paso 7 — Ajustes legales, de privacidad y consentimiento

ADP Car Market Hub procesa los datos de los leads y, opcionalmente, las suscripciones a alertas de búsqueda. Configure los ajustes correspondientes antes de lanzar el sitio:

Car Market Hub → Leads — configure la dirección de correo electrónico del destinatario, los campos visibles del formulario, la casilla de verificación de consentimiento (etiqueta y estado obligatorio) y los mensajes de notificación. El texto de consentimiento y los campos visibles deben reflejar la política de privacidad del concesionario.
Car Market Hub → Leads — configure también las opciones de Test Drive booking (días laborables disponibles, franja horaria diaria, duración del turno, fechas bloqueadas) en esta pestaña. Car Market Hub → Search Alerts — si la función de alertas de búsqueda está activada en la pestaña Settings (o en el Asistente de configuración), gestione las suscripciones aquí. Las alertas de búsqueda utilizan una confirmación por correo electrónico de doble opt-in que cumple con el RGPD; las plantillas de correo electrónico para las notificaciones al concesionario y al cliente se configuran en la pestaña Search Alerts y en la pestaña Leads respectivamente.
Política de privacidad del sitio — el sitio de WordPress debe tener publicada una política de privacidad que cubra los datos que recopila el plugin (datos del formulario de contacto, eventos analíticos opcionales, suscripciones opcionales a alertas de búsqueda).

Dispone de información de fondo en Datos de leads y consentimiento, Doble Opt-In para Alertas de Búsqueda, Notas sobre RGPD / DSGVO y en la Descripción general del almacenamiento de datos.

Paso 8 — Importación de prueba

Realice una importación pequeña y controlada antes de activar la programación automática.

Dos opciones seguras:

Simulación (Dry run). Abra Car Market Hub → Tools y utilice la tarjeta Dry Run. Esta obtiene una vista previa de los anuncios para los Seller IDs configurados sin escribir ninguna entrada de vehículo. Esto valida que las credenciales acceden a datos reales sin modificar el sitio.
Importación manual a través de Car Importer. Abra Car Market Hub → Car Importer. Previsualice los anuncios devueltos por la API e inicie una importación para uno o dos vehículos individuales. Esto crea entradas reales de as24ci_car y asocia las imágenes, por lo que es la forma más rápida de validar todo el proceso de importación de extremo a extremo.

Una vez que una importación pequeña sea exitosa, ejecute una importación manual completa a través del Batch-Wizard en Car Market Hub → Import & Limits. El Batch-Wizard se ejecuta en lotes adaptativos con una barra de progreso y se puede pausar, reanudar o abortar.

Revise la pestaña Logs después para confirmar que no hubo advertencias ni errores.

Paso 9 — Validación del frontend

Después de la importación de prueba, valide el frontend con datos reales:

Abra la página de archivo Cars (o la página donde esté integrado el archivo de vehículos). Confirme que las tarjetas de los vehículos se renderizan correctamente, que las imágenes se cargan, que los filtros funcionan según lo configurado y que la paginación se comporta como se espera.
Abra al menos una página de vehículo individual. Confirme la galería, la tabla de detalles del vehículo, la lista de equipamiento, el formato del precio, el formulario de contacto (y la casilla de consentimiento) y cualquier función opcional que haya activado (calculadora de financiación, formulario de prueba de conducción, compartir en redes sociales).
Envíe un formulario de contacto de prueba desde la página de vehículo individual. Confirme que el lead aparece en Car Market Hub → Leads y que el correo electrónico del destinatario se entrega correctamente.
Si las alertas de búsqueda están activadas, complete una suscripción de prueba, incluido el correo electrónico de confirmación de doble opt-in.
Si el AI Assistant está activado, verifique en al menos un vehículo que la descripción generada por IA (y otros resultados de IA que haya activado) sea aceptable para su publicación.

Corrija cualquier problema (etiquetas, campos que falten, diseño) ajustando la pestaña correspondiente (Mapping, Design & Styles, Layout Manager, Leads, Settings) y vuelva a validar.

Paso 10 — Comprobaciones para el lanzamiento

Solo después de completar los pasos anteriores, prepare el sitio para su lanzamiento:

Active las importaciones automáticas en Car Market Hub → Import & Limits con un intervalo lógico (para muchos concesionarios, una programación horaria es adecuada; los catálogos más pequeños pueden usar una diaria). En servidores que limiten el WP-Cron, configure una tarea cron real del servidor que apunte al endpoint REST protegido por token del plugin, tal como se describe en la Configuración del Cron del Servidor.
Decida si desea activar Full Sync para que los anuncios eliminados en AutoScout24 también se eliminen del sitio. Active esto únicamente después de haber verificado que todos los vehículos esperados aparecen de forma constante en la importación.
Vuelva a ejecutar la Prueba de conexión como comprobación final de seguridad.
Repase la Lista de comprobación para el lanzamiento para asegurarse de cubrir cualquier otro aspecto transversal restante (DNS, caché, visibilidad en motores de búsqueda, monitorización).

Notas de configuración

La página de Settings solo guarda las tarjetas visibles. La página de Settings agrupa las opciones en tarjetas (API Connection & General Settings, Default Pages & Shortcodes, etc.), cada una con su propio botón Save. Guarde la tarjeta que ha editado antes de salir de la página.
Páginas predeterminadas. Si la opción Default pages está activada y las páginas correspondientes aún no existen, al guardar Settings se crearán automáticamente las páginas Cars, Compare Cars y Favorites. Si gestiona estas páginas manualmente, deje la opción desactivada y coloque los shortcodes desde la pestaña Shortcodes & Widgets.
Moneda predeterminada. La moneda predeterminada solo afecta a las importaciones nuevas o actualizadas para las cuales la API no devuelve ningún valor de moneda. Las entradas existentes conservan su moneda almacenada.
Mapping frente a taxonomías. La pestaña Mapping controla las etiquetas y la visibilidad de los campos únicamente en las tablas de detalles. No cambia las taxonomías subyacentes de WordPress que almacenan los valores de los atributos importados. Cambiar el nombre de una etiqueta en Mapping no mueve los términos de taxonomía existentes.
Cola de imágenes. Cuando la cola de imágenes está activada, las importaciones por cron descargan de forma síncrona únicamente la primera imagen de cada vehículo; las imágenes restantes se procesan de forma asíncrona mediante un proceso en segundo plano. Esta es la opción predeterminada recomendada y evita que se agote el tiempo de espera de PHP en catálogos grandes.
Full Sync es destructivo. Full Sync elimina de forma permanente las entradas de coches locales (incluidas las imágenes) de los anuncios que la API ya no devuelve. Trátelo como una opción de nivel de producción y actívelo únicamente cuando las importaciones sean estables.

Notas operativas

Primero en staging, luego en producción. Todos los pasos de configuración de este documento deben realizarse primero en una copia de staging. Una vez que el concesionario apruebe el comportamiento en staging, replique la configuración en producción. No exporte e importe la base de datos completa de WordPress entre staging y producción a menos que comprenda el impacto en las URL, opciones e ID.
Operación diaria. Después de la configuración, las responsabilidades diarias (monitorear importaciones, procesar leads, revisar registros) se cubren en Operación diaria y en el Manual del usuario.
Capacidades y delegación. La configuración inicial requiere un administrador completo de WordPress. Para las operaciones continuas, el plugin proporciona una capacidad y un rol delegados para que los usuarios del día a día no necesiten derechos de administración completos de WordPress. Consulte Control de acceso y capacidades.
Registro (Logging). Todas las llamadas a la API, solicitudes de tokens, acciones de importación y errores se registran en los archivos de registro del plugin en wp-content/uploads/as24ci-logs/ con rotación. El registro detallado (verbose) añade detalles por vehículo y por imagen, y debe activarse temporalmente solo para la resolución de problemas.

Resolución de problemas

Síntoma	Causa probable	Qué comprobar
Sistema y Ayuda muestra insignias rojas inmediatamente después de la activación.	El entorno de hosting no cumple con los requisitos del plugin (falta alguna extensión de PHP, directorio de subidas sin permisos de escritura, WP-Cron roto).	Resuelva cada insignia roja con su proveedor de hosting antes de continuar. Consulte Requisitos técnicos del sistema.
La página de ajustes no guarda las credenciales, o los campos aparecen vacíos después de guardar.	Formulario enviado desde la tarjeta incorrecta, página almacenada en la caché del navegador o un plugin de seguridad bloqueando la solicitud.	Guarde la tarjeta correcta. Recargue la página. Desactive temporalmente otros plugins que filtren las solicitudes `POST`.
La prueba de conexión falla.	URL base de la API incorrecta, credenciales incorrectas, HTTPS saliente bloqueado, problemas de SSL/firewall.	Siga la Prueba de conexión y los Errores de conexión de la API.
La importación de prueba importa cero vehículos.	El Seller ID configurado no tiene anuncios, las credenciales se autentican en una cuenta diferente o la API devolvió un resultado vacío.	Vuelva a verificar el Seller ID con la cuenta de AutoScout24 del concesionario; confírmelo a través del Simulacro (Dry Run) en Herramientas.
Las páginas de vehículos se renderizan sin imágenes, o las imágenes aparecen más tarde.	La cola de imágenes está activada (comportamiento esperado) y el proceso en segundo plano aún no ha procesado la cola, o los tiempos de espera (timeouts) de PHP están interrumpiendo las descargas.	Utilice el estado de la cola de imágenes en Sistema y Ayuda; active Ejecutar cola de imágenes ahora. Consulte Errores de importación de imágenes.
Las importaciones por Cron no se ejecutan automáticamente después de activar la programación.	WP-Cron está desactivado o limitado por el host.	Configure un cron de servidor externo que apunte al endpoint REST del plugin. Consulte Configuración del Cron del servidor y Errores de Cron.
No se reciben los correos electrónicos de leads.	El sitio no puede enviar correos o la dirección del destinatario es incorrecta.	Verifique el correo electrónico del destinatario en Leads y la configuración de correo saliente del sitio. Consulte Errores de correo electrónico y leads.