Documentación · Referencia del administrador
Referencia de ajustes
Este documento es una referencia para la pantalla de Ajustes del plugin ADP Car Market Hub (Car Market Hub → 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 consultar qué hace una opción específica o cuando esté solucionando un comportamiento que dependa de un ajuste.
Descripción general
La pantalla de Ajustes está organizada como una pila vertical de tarjetas. Cada tarjeta tiene su propio botón Guardar ajustes, 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)
- Conexión de la API y ajustes generales
- Páginas predeterminadas y shortcodes
- SEO e integraciones
- Características del frontend
- Características de administración
- Zona de peligro
Requisitos o prerrequisitos
- Acceso a Car Market Hub → Ajustes (requiere la capacidad de gestión del plugin).
- Para la conexión de la API: credenciales válidas emitidas por su proveedor de datos (AutoScout24 o un endpoint de integración compatible). Estas no las proporciona el plugin y deben obtenerse por separado.
- Para las páginas predeterminadas: permiso para crear páginas de WordPress.
Instrucciones paso a paso
- Abra Car Market Hub → Ajustes.
- Rellene la tarjeta Conexión de la API y ajustes generales con la URL, el Seller ID y las credenciales suministradas por su proveedor, luego elija la moneda predeterminada.
- 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, Comparar y Favoritos. De lo contrario, inserte los shortcodes correspondientes manualmente en las páginas que elija.
- Revise las tarjetas SEO e integraciones, Características del frontend y Características de administración y active las funciones que necesite.
- Active los elementos de la Zona de peligro únicamente después de leer atentamente las advertencias y crear una copia de seguridad si procede.
Referencia de configuración
Licencia y Activación
La tarjeta de Licencia es la primera tarjeta en la página de Ajustes. 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 suministrada por AD Promotion.
Cómo funciona el licenciamiento, paso a paso:
- Activar la licencia. Pegue la clave suministrada por AD Promotion en el campo Clave de licencia y haga clic en Activar. El plugin se conecta con el servicio de licencias, valida la clave contra el dominio de este sitio y la almacena enmascarada. Si alguna vez vuelve a introducir una clave, el botón mostrará Reactivar.
- Comprobar el estado en cualquier momento. Haga clic en Comprobar licencia ahora para solicitar al servicio de licencias el estado más reciente. La tarjeta actualizará entonces el Estado (por ejemplo, Activa, Inactiva, Suspendida o Expirada), el plan, las fechas de expiración/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 Soporte, para que pueda verlo sin abrir Ajustes.
- Ver qué funciones están desbloqueadas. Cuando la licencia está activa, la tarjeta muestra una fila de Características incluidas 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 "no incluido en esta licencia".
- Reactivar o eliminar. Utilice Reactivar después de un cambio de plan para obtener los nuevos derechos, o Eliminar licencia para borrar la clave almacenada de este sitio (las áreas premium se volverán a bloquear).
La mayor parte de esto se ejecuta por sí solo en segundo plano: el plugin vuelve a comprobar la licencia periódicamente y mantiene el estado actualizado, por lo que la opción manual Comprobar licencia ahora sirve principalmente para confirmar un cambio de inmediato.
| Elemento | Notas |
|---|---|
| Clave de licencia | Introduzca la clave suministrada por AD Promotion y haga clic en Activar (o Reactivar). La clave se almacena enmascarada y vinculada al dominio de este sitio; la clave completa nunca se vuelve a mostrar. |
| Estado | El estado actual de la licencia, por ejemplo, Activa, Inactiva, Suspendida o Expirada. |
| Comprobar licencia ahora | 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. |
| Eliminar licencia | Elimina la clave almacenada de este sitio. Las características premium que dependen de la licencia se vuelven a bloquear. |
Cuando una clave está activa, la tarjeta también muestra detalles de solo lectura: Plan, Expira, Soporte hasta, Dominio, Última comprobación, Versión reportada, el límite de importación y la lista de Características incluidas. El mismo estado de la licencia también se muestra como un KPI en el Dashboard y en la pantalla de Soporte.
Las áreas premium que no formen parte de su licencia mostrarán una tarjeta de "no incluido en esta licencia" en su propia página en lugar de los controles normales (consulte la Referencia de la herramienta de IA / AI Assistant Reference, la Referencia de Content Studio y la Referencia de Market Insights). No hay ningún fallo en ese estado; póngase en contacto con el soporte de ADP Car Market Hub para activar el área.
Conexión de la API y ajustes generales
| Campo | Tipo | Notas |
|---|---|---|
| URL base de la API | URL | URL completa incluyendo https://. Validada en el lado del servidor; se eliminan las barras finales. Las URL no válidas se rechazan y se mantiene el valor anterior. |
| Seller ID | Texto | Uno o más Seller IDs separados por comas, espacios o puntos y comas. Solo se conservan letras, dígitos, guiones bajos y guiones tras la desinfección. |
| Client ID | Texto | Identificador de cliente de tipo OAuth suministrado por su proveedor. |
| Client Secret | Campo de contraseña | Se almacena como texto de opción plano en la base de datos; trate el campo en consecuencia. La entrada se renderiza como un campo de contraseña para evitar miradas indiscretas. |
| Moneda predeterminada | Selección | Elija uno de los códigos ISO 4217 compatibles: BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. Los valores desconocidos recurren a EUR. |
Cuando las credenciales cambian, el plugin borra su token de acceso almacenado en caché y el estado de conexión de la API en caché para que la siguiente carga de página refleje la nueva configuración.
Páginas predeterminadas y shortcodes
| Campo | Tipo | Notas |
|---|---|---|
| Crear páginas predeterminadas al guardar | Interruptor | Cuando se marca y se guarda, se crean las páginas que falten de Vehículos, Comparar vehículos y Favoritos. 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 de [as24ci_archive] compatibles según lo documentado 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 e integraciones
| Campo | Por defecto | Notas |
|---|---|---|
| Schema.org y Open Graph | Activado | Genera datos estructurados JSON-LD y etiquetas meta Open Graph / Twitter Card en las páginas de vehículos individuales. |
| Integración con XML Sitemap | Activado | 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. |
| REST API | Desactivado | Cuando está activado, registra GET /wp-json/as24ci/v1/vehicles y GET /wp-json/as24ci/v1/vehicles/{id} para el acceso externo. |
Características del frontend
| Campo | Por defecto | Notas |
|---|---|---|
| Favoritos / Lista de deseos | Activado | Añade iconos de favoritos en el archivo y en la barra lateral flotante de las páginas individuales. La página de favoritos se puede integrar con [as24ci_favorites]. La implementación se basa en localStorage. |
| Comparador de vehículos | Activado | Añade botones de alternancia para comparar en el archivo y en las páginas individuales. Los vehículos seleccionados se pueden mostrar mediante [as24ci_compare]. |
| Calculadora financiera | Desactivado | Cuando está activada, la calculadora se puede colocar a través del Gestor de diseño en Vehículo individual – Barra lateral, Contenido principal de vehículo individual o Vehículo individual – Sección inferior. |
| Tipo de interés anual (%) | 3.9 | Rango permitido 0–50, paso 0.1. |
| Plazo del préstamo (meses) | 48 | Valores permitidos: 12, 24, 36, 48, 60, 72, 84. |
| Pago inicial (%) | 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.
Características de administración
| Campo | Por defecto | Notas |
|---|---|---|
| Widget del Dashboard | Activado | Muestra el widget de resumen de estadísticas de vehículos en el dashboard de WordPress. |
| Acciones en lote | Activado | Añade las acciones en lote Cambiar a borrador, Cambiar a publicado y Eliminar con imágenes a la tabla de lista de vehículos. |
| Exportación de vehículos | Activado | Permite la exportación en CSV / JSON de los datos de los vehículos en la pestaña Herramientas. |
Zona de peligro
| Campo | Por defecto | Notas |
|---|---|---|
| Eliminar vehículos importados e imágenes importadas al eliminar el plugin | Desactivado | Cuando está activado, la desinstalación del plugin elimina 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 de funcionamiento
- Cada tarjeta tiene su propio botón de envío, pero cada envío envía el formulario completo. Guardar cualquier tarjeta conserva todos los campos de la página.
- Las credenciales de la API se almacenan en la tabla de opciones de WordPress. Cualquier persona con acceso a la base de datos o a la exportación de administración puede leerlas; proteja el sitio en consecuencia.
- Activar la calculadora financiera no la coloca en la página por sí sola; la ubicación se controla en el Gestor de diseño.
- 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
- Error "La URL base de la API no es una URL válida". El valor no superó
FILTER_VALIDATE_URL. Introduzca la URL completa incluyendo el esquema (https://) y sin caracteres adicionales. El valor anterior se mantiene hasta que se proporcione una URL válida. - Las importaciones devuelven errores 401 / 403 después de guardar las credenciales. Verifique el Client ID, Client Secret y Seller ID con su proveedor. La caché de tokens se borra al guardar, por lo que la siguiente solicitud utilizará los nuevos valores.
- No se crearon las páginas predeterminadas. El interruptor solo actúa al guardar. Asegúrese de que el interruptor esté marcado al hacer clic en Guardar y que el usuario de WordPress tenga permiso para crear páginas.
- La moneda no cambia en el frontend. El campo almacena un valor predeterminado. Las monedas por vehículo procedentes 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.
- La calculadora financiera está activada pero no es visible. Añada el bloque Calculadora financiera a una de las zonas de Vehículo individual en el Gestor de diseño. La pantalla de Ajustes no advierte sobre la ubicación; solo muestra una descripción estática que apunta al Gestor de diseño. Para evitar que la calculadora aparezca dos veces, asegúrese de añadirla a una sola zona de Vehículo individual.