Documentación · Referencia del administrador
Referencia de configuración
Este documento es una referencia para la pantalla de Configuración (Settings) del plugin ADP Car Market Hub (CMH Center → Settings). Explica cada tarjeta de la página, qué controla cada campo y cómo se validan y almacenan los valores.
Cuándo usar este documento
Utilice esta referencia cuando configure el plugin por primera vez, cuando necesite buscar qué hace una opción específica o cuando esté solucionando un comportamiento que dependa de una configuración.
Descripción general
La pantalla de Configuración está organizada como una pila vertical de tarjetas. Cada tarjeta tiene su propio botón Guardar configuración, pero enviar cualquiera de ellos guarda toda la página. La página se divide en las siguientes secciones:
- Licencia y activación (se muestra en la parte superior de la página)
- Fuentes de datos y conexiones API (un enlace a la página de Conexiones)
- Configuración general (moneda predeterminada)
- Páginas predeterminadas y shortcodes
- SEO e integraciones
- Características del frontend
- Características del administrador
- Zona de peligro
Las credenciales de la API se han trasladado. Las versiones anteriores configuraban la conexión de la API de AutoScout24 aquí. Todas las credenciales de las fuentes de datos (AutoScout24, mobile.de, carcuro, feed, correo electrónico) se introducen ahora en la página de Conexiones, donde cada fuente muestra también su estado de conexión. Consulte la Referencia de conexiones. La pantalla de Configuración conserva únicamente las opciones generales.
Requisitos o prerrequisitos
- Acceso a CMH Center → Settings (requiere la capacidad de gestión del plugin).
- Para las credenciales de las fuentes de datos: utilice la página de Conexiones, no esta pantalla.
- Para las páginas predeterminadas: permiso para crear páginas de WordPress.
Instrucciones paso a paso
- Abra CMH Center → Settings.
- Elija la Moneda predeterminada en la tarjeta de Configuración general. Para conectar una fuente de datos o introducir credenciales de API, utilice el botón Gestionar fuentes de datos (abre la página de Conexiones).
- Guarde y confirme que no haya errores de validación en la parte superior de la pantalla.
- Opcionalmente, active Crear páginas predeterminadas al guardar para que el plugin cree automáticamente las páginas de Vehículos, Comparador y Favoritos. De lo contrario, inserte los shortcodes correspondientes manualmente en las páginas de su elección.
- Revise las tarjetas de SEO e integraciones, Características del frontend y Características del administrador y active las funciones que necesite.
- Active únicamente los elementos de la Zona de peligro tras leer atentamente las advertencias y crear una copia de seguridad si procede.
Configuration reference
License and Activation
La tarjeta License es la primera tarjeta en la página de Settings. ADP Car Market Hub es un producto con licencia: la licencia desbloquea las áreas premium (como AI Assistant, Content Studio y Market Insights) y permite las actualizaciones y el soporte. La clave de licencia es proporcionada por AD Promotion.
Cómo funciona la licencia, paso a paso:
- Activar la licencia. Pegue la clave proporcionada por AD Promotion en el campo License key y haga clic en Activate. El plugin se conecta con el servicio de licencias, valida la clave para el dominio de este sitio y la almacena enmascarada. Si alguna vez vuelve a introducir una clave, el botón mostrará Re-activate.
- Comprobar el estado en cualquier momento. Haga clic en Check license now para solicitar el estado más reciente al servicio de licencias. A continuación, la tarjeta actualiza el Status (por ejemplo, Active, Inactive, Suspended o Expired), el plan, las fechas de vencimiento/soporte y las características incluidas. El mismo estado de la licencia también se muestra como una tarjeta de KPI en el Dashboard y en la pantalla de Support, para que pueda verlo sin tener que abrir Settings.
- Ver qué funciones están desbloqueadas. Cuando la licencia está activa, la tarjeta muestra una fila de Included features que enumera las áreas premium que cubre su licencia (por ejemplo, AI Assistant, Content Studio, Market Insights). Cada pantalla premium también refleja esto directamente: si un área está incluida, muestra sus controles normales, y si no está incluida, muestra en su lugar una tarjeta de "not included in this license".
- Reactivar o eliminar. Utilice Re-activate después de un cambio de plan para obtener los nuevos derechos, o Remove license para borrar la clave almacenada de este sitio (las áreas premium se volverán a bloquear).
La mayor parte de esto se ejecuta de forma automática en segundo plano: el plugin vuelve a comprobar la licencia periódicamente y mantiene el estado actualizado, por lo que el botón manual Check license now sirve principalmente para confirmar un cambio de inmediato.
| Element | Notes |
|---|---|
| License key | Introduzca la clave proporcionada por AD Promotion y haga clic en Activate (o Re-activate). La clave se almacena enmascarada y vinculada al dominio de este sitio; la clave completa no se volverá a mostrar. |
| Status | El estado actual de la licencia, por ejemplo, Active, Inactive, Suspended o Expired. |
| Check license now | Vuelve a comprobar la licencia con el servicio de licencias y actualiza el estado, el plan y las características incluidas. Disponible una vez que se almacena una clave. |
| Remove license | Elimina la clave almacenada de este sitio. Las funciones premium que dependen de la licencia se volverán a bloquear. |
Cuando una clave está activa, la tarjeta también muestra detalles de solo lectura: Plan, Expires, Support until, Domain, Last checked, Reported version, el límite de importación y la lista de Included features. El mismo estado de la licencia también se muestra como un KPI en el Dashboard y en la pantalla de Support.
Las áreas premium que no forman parte de su licencia muestran una tarjeta de "not included in this license" en su propia página en lugar de los controles normales (consulte la Referencia de AI Assistant, la Referencia de Content Studio y la Referencia de Market Insights). Nada está roto en ese estado; póngase en contacto con el soporte de ADP Car Market Hub para habilitar el área.
Data sources & API connections
Esta tarjeta no contiene ningún campo. Es un indicador sencillo que explica que las fuentes de datos se configuran de forma centralizada y proporciona un botón Manage data sources que enlaza a la página de Connections. Allí puede conectar AutoScout24, mobile.de, carcuro, un feed automático o una bandeja de entrada de correo electrónico, introducir las credenciales de la API y ver el estado de conexión de cada fuente. Los secretos como el Client Secret de AutoScout24, la contraseña de la API de mobile.de y el token de carcuro se almacenan cifrados en reposo.
General Settings
| Field | Type | Notes |
|---|---|---|
| Default currency | Select | Elija uno de los códigos ISO 4217 admitidos: BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. Los valores desconocidos volverán por defecto a EUR. |
Default Pages & Shortcodes
| Field | Type | Notes |
|---|---|---|
| Create default pages on save | Toggle | Cuando se marca y se guarda, se crean las páginas que falten de Cars, Compare Cars y Favorites. Las páginas existentes no se sobrescriben. |
La tarjeta también enumera shortcodes listos para copiar:
[as24ci_archive]— listado de vehículos.[as24ci_compare]— página de comparación.[as24ci_favorites]— página de favoritos / lista de deseos.[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]— ejemplo de listado prefiltrado.
Parámetros admitidos de [as24ci_archive] tal como se documentan en la administración: make, model, price_min, price_max, fuel, body, order_by (price / mileage / date), order (asc / desc), per_page (12 / 24 / 48 / 72 / all).
SEO & Integrations
| Field | Default | Notes |
|---|---|---|
| Schema.org & Open Graph | On | Genera datos estructurados JSON-LD y etiquetas meta Open Graph / Twitter Card en las páginas de vehículos individuales. |
| XML Sitemap integration | On | Añade las publicaciones de vehículos a los mapas del sitio principales de WordPress con las fechas lastmod correctas. La etiqueta de administración indica la compatibilidad con Yoast SEO y Rank Math. |
| Redirect removed vehicles | On | Cuando la URL de un vehículo vendido/eliminado devolvería un error 404, emite una redirección 301 a una búsqueda prefiltrada para la misma marca y modelo (bajando a solo marca, luego al archivo, para que nunca termine en un resultado vacío). Evita errores 404 sin salida para enlaces indexados/compartidos sin crear cadenas de redirección. |
| REST API | Off | Cuando está habilitado, registra GET /wp-json/as24ci/v1/vehicles y GET /wp-json/as24ci/v1/vehicles/{id} para acceso externo. |
Frontend Features
| Field | Default | Notes |
|---|---|---|
| Favorites / Wishlist | On | Añade iconos de favoritos en el archivo y la barra lateral flotante en las páginas individuales. La página de favoritos se puede incrustar con [as24ci_favorites]. La implementación se basa en localStorage. |
| Vehicle Compare | On | Añade botones de alternancia de comparación en el archivo y en las páginas individuales. Los vehículos seleccionados se pueden mostrar a través de [as24ci_compare]. |
| Financing Calculator | Off | Cuando está habilitada, la calculadora se puede colocar a través del Layout Manager en Single Vehicle – Sidebar, Single Vehicle Main Content o Single Vehicle – Bottom Section. |
| Annual interest rate (%) | 3.9 | Rango permitido 0–50, paso 0.1. |
| Loan term (months) | 48 | Valores permitidos: 12, 24, 36, 48, 60, 72, 84. |
| Down payment (%) | 20 | Rango permitido 0–100. |
Los valores de financiación son valores predeterminados precargados en la calculadora en el frontend; los visitantes pueden ajustarlos si la plantilla de la calculadora lo permite.
Admin Features
| Field | Default | Notes |
|---|---|---|
| Dashboard widget | On | Muestra el widget de resumen de estadísticas de vehículos en el escritorio de WordPress. |
| Bulk actions | On | Añade las acciones por lote Cambiar a borrador, Cambiar a publicado y Eliminar con imágenes a la tabla de lista de vehículos. |
| Vehicle export | On | Permite la exportación CSV / JSON de los datos de los vehículos en la pestaña Herramientas. |
Danger Zone
| Field | Default | Notes |
|---|---|---|
| Delete imported cars and imported images when the plugin is deleted | Off | Cuando está habilitado, al desinstalar el plugin se eliminan las entradas del tipo de contenido personalizado Cars y sus archivos adjuntos importados. Las páginas creadas por el plugin no se eliminan automáticamente. |
Notas operativas
- Cada tarjeta tiene su propio botón de envío, pero cada envío publica el formulario completo. Al guardar cualquier tarjeta se conservan todos los campos de la página.
- Las credenciales de la API de origen de datos no se introducen aquí; se encuentran en la página Connections. Las claves secretas que se encuentran allí (AutoScout24 Client Secret, contraseña de la API de mobile.de, token de carcuro, contraseñas de feed/buzón de correo) se almacenan cifradas en reposo.
- Activar el calculador de financiación no lo coloca en la página por sí solo; la ubicación se controla en el Layout Manager.
- El interruptor de la REST API controla únicamente los endpoints públicos de vehículos. Los endpoints AJAX internos de administración utilizados por el plugin no se ven afectados por este interruptor.
- La acción "Crear páginas predeterminadas al guardar" solo se ejecuta cuando la casilla está marcada en el momento de guardar. Desmarcarla más tarde no elimina las páginas creadas previamente.
Resolución de problemas
- ¿Dónde introduzco las credenciales de la API? Aquí no. Abra la página Connections (o use el botón Gestionar fuentes de datos) para conectar AutoScout24, mobile.de, carcuro, un feed o una bandeja de entrada de correo electrónico. La validación de credenciales y los errores 401/403 se tratan allí y en API Connection Errors.
- No se crearon las páginas predeterminadas. El interruptor solo actúa al momento de guardar. Asegúrese de que la casilla esté marcada cuando haga clic en Guardar y de que el usuario de WordPress tenga permisos para crear páginas.
- La moneda no cambia en el frontend. El campo almacena un valor predeterminado. Las monedas por vehículo que provienen del proveedor de datos pueden anular la visualización según las plantillas activas. Verifique este comportamiento en la versión actual del plugin antes de publicar.
- El calculador de financiación está habilitado pero no es visible. Añada el bloque del Calculador de financiación a una de las zonas de Vehículo único en el Layout Manager. La pantalla de Configuración no advierte sobre la ubicación; solo muestra una descripción estática que apunta al Layout Manager. Para evitar que el calculador aparezca dos veces, asegúrese de añadirlo a una sola zona de Vehículo único.