Este apéndice es una lista de referencia de las claves de opción que el plugin ADP Car Market Hub lee y escribe.
Cuándo utilizar este documento
Utilice esta referencia cuando necesite buscar la clave de opción detrás de un campo de administración, cuando desee leer un valor mediante programación con get_option() o cuando esté auditando un despliegue. Para la interfaz de usuario de configuración, consulte la Referencia de ajustes (Administrador). Para el modelo de almacenamiento conceptual, consulte Claves de opción y almacenamiento de ajustes.
Descripción general
Todas las opciones del plugin se almacenan en wp_options con el prefijo as24ci_. Los selectores booleanos se almacenan como las cadenas de texto '1' (habilitado) y '0' (deshabilitado), a menos que se indique lo contrario. Las claves canónicas se definen como constantes en includes/class-as24ci-options.php (AS24CI\Options); priorice siempre el uso de las constantes desde PHP.
El plugin no registra opciones a través de la Settings API de WordPress. Cada pestaña de administración guarda sus propias opciones a través de controladores dedicados protegidos por comprobaciones de capacidades y nonces.
API y autenticación
| Clave de opción | Propósito |
|---|
as24ci_base_url | URL base de la API de datos (normalmente un endpoint de AutoScout24 o un proxy proporcionado por el cliente). |
as24ci_token_url | Endpoint del token OAuth. |
as24ci_token_audience | Valor de audiencia JWT. Se deriva automáticamente de la URL base configurada cuando no se establece explícitamente. |
as24ci_client_id | Client ID de OAuth. |
as24ci_client_secret | Client secret de OAuth. Sensible. Se almacena sin cifrar; trátelo como una credencial. |
as24ci_seller_ids | Uno o más Seller IDs (matriz o cadena separada por comas en la entrada). |
as24ci_default_currency | Código de moneda ISO 4217 predeterminado que se utiliza cuando no se proporciona una moneda por vehículo. |
Comportamiento de importación
| Clave de opción | Propósito |
|---|
as24ci_default_post_status | Estado inicial de la publicación para los vehículos recién importados. |
as24ci_default_post_author | ID de usuario utilizado como autor para los vehículos recién importados. |
as24ci_import_images | Habilitar la importación de imágenes. |
as24ci_max_images | Número máximo de imágenes por vehículo (0 = ilimitado). |
as24ci_convert_to_webp | Convertir las imágenes importadas a WebP (requiere GD o Imagick). |
as24ci_webp_quality | Calidad WebP (1–100, por defecto 80). |
as24ci_full_sync | Eliminar los vehículos locales que falten en el feed remoto al final de cada ejecución. Requiere activación explícita. |
as24ci_verbose_logging | Registrar detalles adicionales por campo y por imagen durante las importaciones. |
Programador y automatización
| Clave de opción | Propósito |
|---|
as24ci_auto_import_enabled | Interruptor maestro para el evento de importación de WP-Cron. |
as24ci_cron_schedule | Clave de programación: hourly, as24ci_every_6_hours, twicedaily, daily, as24ci_custom. |
as24ci_cron_start_time | Hora de inicio en HH:MM (24h, zona horaria del sitio WordPress) para daily y twicedaily. |
as24ci_cron_custom_minutes | Intervalo en minutos para as24ci_custom. Limitado a un mínimo de 15. |
as24ci_cron_mode | wp-cron o server-cron. Controla las sugerencias de la interfaz de administración. |
as24ci_cron_token | Token para el endpoint REST cron-import. Sensible. Un valor vacío deshabilita el endpoint. |
as24ci_cron_max_vehicles | Máximo de vehículos procesados por ejecución de cron / REST (0 = ilimitado). |
as24ci_cron_image_queue | Utilizar la cola de imágenes durante las ejecuciones de cron / REST. |
as24ci_last_run_time | Marca de tiempo Unix de la última ejecución completada. |
as24ci_last_run_status | Matriz de recuentos de la última ejecución. |
as24ci_last_run_manual | 1 si la última ejecución se activó manualmente. |
as24ci_last_external_cron_run | Marca de tiempo Unix del último ping de ?as24ci_cron=1. |
REST API
| Clave de opción | Propósito |
|---|
as24ci_rest_api_enabled | Cuando está en '1', registra las rutas públicas /vehicles y /vehicles/{id}. Por defecto '0'. |
Páginas predeterminadas y desinstalación
| Clave de opción | Propósito |
|---|
as24ci_create_default_pages | Cuando se marca al guardar, el plugin crea las páginas de Vehículos, Comparador y Favoritos si faltan. Las páginas existentes no se sobrescriben. |
as24ci_page_archive_id | ID de página de la página de Vehículos creada en la activación. |
as24ci_page_compare_id | ID de página de la página de Comparador creada en la activación. |
as24ci_page_favorites_id | ID de página de la página de Favoritos creada en la activación. |
as24ci_delete_data_on_uninstall | Cuando está en '1', la desinstalación elimina los vehículos, los leads, los archivos adjuntos importados y las páginas creadas en la activación. |
| Clave de opción | Propósito |
|---|
as24ci_lead_recipient_email | Sobrescribir el correo electrónico del destinatario para las notificaciones de leads. |
as24ci_lead_field_name, as24ci_lead_field_email, as24ci_lead_field_phone, as24ci_lead_field_message | Selectores de visibilidad por campo para el formulario de contacto. |
as24ci_lead_consent_enabled, as24ci_lead_consent_text, as24ci_lead_privacy_url | Configuración de la casilla de verificación de consentimiento. |
as24ci_lead_msg_success, as24ci_lead_msg_error | Mensajes de estado en el frontend. |
as24ci_lead_email_subject_dealer, as24ci_lead_email_subject_customer, as24ci_lead_email_template_dealer, as24ci_lead_email_template_customer | Plantillas de correo electrónico de notificación. |
Webhooks
| Clave de opción | Propósito |
|---|
as24ci_webhook_url_new_lead | URL de destino para el evento new_lead. Un valor vacío deshabilita el evento. |
as24ci_webhook_url_new_import | URL de destino para el evento new_import. Un valor vacío deshabilita el evento. |
as24ci_webhook_secret | Secreto de firma HMAC-SHA256. Sensible. Un valor vacío deshabilita la firma. |
AI Assistant (opcional)
Las funciones de IA utilizan la configuración gestionada de Google Gemini en ADP Car Market Hub. No existe ninguna opción de proveedor, modelo o clave de API en wp_options. La clave y el modelo gestionados de Gemini son constantes de PHP en AS24CI\Ai_Config (MANAGED_GEMINI_API_KEY, MANAGED_GEMINI_MODEL) aprovisionados por AD Promotion después de la instalación.
| Clave de opción | Propósito |
|---|
as24ci_ai_assistant_enabled | Interruptor maestro. |
as24ci_ai_assistant_language, as24ci_ai_assistant_tone, as24ci_ai_assistant_max_length | Parámetros de generación. |
as24ci_ai_assistant_auto_generate | Generar descripciones automáticamente al importar. |
as24ci_ai_assistant_custom_prompt | Plantilla de instrucción (prompt) personalizada opcional. |
as24ci_ai_gen_alt_text, as24ci_ai_gen_seo, as24ci_ai_extract_highlights | Selectores auxiliares de autogeneración. |
Reserva de prueba de conducción (opcional)
| Clave de opción | Propósito |
|---|
as24ci_test_drive_enabled | Interruptor maestro. |
as24ci_test_drive_available_days | Números de días de la semana separados por comas (0 = domingo). |
as24ci_test_drive_start_time, as24ci_test_drive_end_time | Ventana horaria diaria en HH:MM. |
as24ci_test_drive_slot_duration | Duración del intervalo en minutos. |
as24ci_test_drive_blackout_dates | Lista serializada de fechas inactivas (blackout). |
Alertas de búsqueda y selectores de características
| Clave de opción | Propósito |
|---|
as24ci_feature_search_agent | Habilitar alertas de búsqueda (Smart Stock Alerts). |
as24ci_feature_compare | Botones de comparación y página de comparador. |
as24ci_feature_favorites | Favoritos / lista de deseos. |
as24ci_feature_schema | Metadatos de Schema.org y Open Graph en páginas individuales. |
as24ci_feature_social_share | Botones para compartir en redes sociales. |
as24ci_social_share_placement | Ubicación de los botones para compartir en redes sociales en la página individual. |
as24ci_social_share_networks | Redes sociales activas para los botones de compartir. |
as24ci_feature_sitemap | Integración con el mapa del sitio (sitemap). |
as24ci_feature_dashboard_widget | Widget del panel de administración (dashboard). |
as24ci_feature_lazy_loading | Carga diferida de imágenes (lazy loading). |
as24ci_feature_bulk_actions | Acciones en lote en la lista de vehículos. |
as24ci_feature_export | Exportación CSV/JSON desde Herramientas. |
as24ci_feature_pdf_datasheet | Descarga de PDF datasheet (interruptor maestro para el botón "Descargar PDF" del frontend). |
as24ci_pdf_manager_settings | Matriz de ajustes de marca, diseño, QR y contenido para la salida del PDF datasheet. Independiente de as24ci_feature_pdf_datasheet. |
Analytics
| Clave de opción | Propósito |
|---|
as24ci_analytics_enabled | Interruptor maestro para el seguimiento de analíticas. |
as24ci_analytics_bi_enabled | Eventos extendidos de BI (búsquedas con filtros, aperturas de contacto, envíos de leads). |
as24ci_analytics_require_consent | Bloquear el seguimiento hasta que se otorgue el consentimiento del visitante. |
as24ci_analytics_filter_minimization | Eliminar el texto de entrada de búsqueda libre antes de almacenar los eventos. |
as24ci_analytics_retention_days | Ventana de retención para la tabla de analíticas (por defecto 180). |
as24ci_analytics_privacy_jurisdiction | Etiqueta de ley de privacidad (auto, gdpr, dsgvo, revdsg, uk_gdpr, generic). |
Comparador y financiación
| Clave de opción | Propósito |
|---|
as24ci_compare_max_vehicles | Máximo de vehículos comparados a la vez. Limitado entre 2 y 8. |
as24ci_financing_enabled | Habilitar la calculadora de financiación. |
as24ci_financing_default_rate | Tipo de interés anual predeterminado (%). Rango permitido 0–50. |
as24ci_financing_default_months | Plazo predeterminado del préstamo en meses (12, 24, 36, 48, 60, 72, 84). |
as24ci_financing_down_payment | Entrada inicial predeterminada (%). Rango permitido 0–100. |
as24ci_financing_placement | below_gallery, sidebar o end_of_page. |
Diseño y maquetación
El plugin expone una gran cantidad de opciones de diseño bajo los prefijos as24ci_design_*, as24ci_single_*, as24ci_archive_*, as24ci_fav_*, as24ci_comp_* y as24ci_badge_*. Controlan los colores, la tipografía, el espaciado, la apariencia de las etiquetas (badges) y el CSS personalizado. Consulte las constantes en AS24CI\Options para obtener la lista exhaustiva.
La maquetación a nivel de página utiliza claves dedicadas:
| Clave de opción | Propósito |
|---|
as24ci_layout_manager_enabled | Interruptor maestro para el Layout Manager. |
as24ci_lm_zone_*, as24ci_lm_block_* | Configuración por zona y por bloque. |
as24ci_layout_archive_columns | Número de columnas en la cuadrícula de archivo (1–4, por defecto 3). |
as24ci_archive_default_sort | Orden de clasificación predeterminado del archivo (date_desc, price_asc, price_desc, mileage_asc). |
as24ci_archive_per_page | Vehículos mostrados por página en el archivo (por defecto 24). |
as24ci_archive_list_excerpt_length | Caracteres máximos del extracto en la vista de lista (0–500, por defecto 75; 0 oculta el extracto). |
as24ci_layout_search_filters | Bloques de filtros activos en la zona de filtros de búsqueda. |
as24ci_layout_single_main, as24ci_layout_single_sidebar, as24ci_layout_single_bottom | Composición de la página de vehículo individual. |
Filtros y visibilidad de campos
| Clave de opción | Propósito |
|---|
as24ci_filters_enabled | Matriz de claves de filtro habilitadas para el archivo público (null significa todas habilitadas). |
as24ci_field_visibility | Mapa de visibilidad por vista para car_details, sidebar, compare y favorites. |
as24ci_mapping_overrides | Sobrescrituras de etiquetas y visibilidad por campo para los campos importados de AS24 (mapas serializados labels / visible). |
Hub API y ubicaciones
| Clave de opción | Propósito |
|---|
as24ci_hub_api_key | Clave de API para la integración con Hub / Market Insights. Sensible. |
as24ci_hub_target_market | Código de mercado de destino utilizado por la integración de Hub. |
as24ci_locations | Lista serializada de ubicaciones de concesionarios (nombre, dirección, Seller IDs, horarios). Autoload desactivado. |
CMH Team
| Clave de opción | Propósito |
|---|
as24ci_team_members | Lista serializada de miembros del equipo del concesionario gestionados por el plugin (contactos de ventas). Autoload desactivado. |
as24ci_team_location_defaults | Mapa de Seller ID de AutoScout24 → ID de miembro del equipo predeterminado (contacto predeterminado a nivel de ubicación). Autoload desactivado. |
as24ci_team_standards | Ajustes de contacto globales de respaldo / generales del concesionario (ID de miembro predeterminado global y datos de contacto generales). Autoload desactivado. |
as24ci_team_rules | Indicadores de comportamiento de asignación automática para CMH Team. Autoload desactivado. |
Supervisión de la calidad de los datos
| Clave de opción | Propósito |
|---|
as24ci_dq_scan_enabled | Interruptor maestro. |
as24ci_dq_scan_frequency | daily o twicedaily. |
as24ci_dq_scan_time | Hora de la primera ejecución en HH:00 (zona horaria del sitio WordPress). |
as24ci_last_term_hash, as24ci_taxonomy_anomalies | Estado del escaneo interno. |
Perfil del concesionario
Recopilado por el asistente de configuración (Setup Wizard) y reutilizado por el PDF datasheet, los cuadros de contacto, los datos estructurados y las ubicaciones. Se almacena como opciones simples de nivel superior.
| Clave de opción | Propósito |
|---|
as24ci_dealer_name | Nombre del concesionario. |
as24ci_dealer_street | Dirección (calle). |
as24ci_dealer_postal_code | Código postal. |
as24ci_dealer_city | Ciudad. |
as24ci_dealer_country | País. |
as24ci_dealer_phone | Número de teléfono. |
as24ci_dealer_email | Correo electrónico de contacto. |
as24ci_dealer_website | URL del sitio web. |
as24ci_dealer_logo_id | ID de archivo adjunto del logotipo del concesionario. |
as24ci_dealer_language | Idioma preferido del frontend (site_default o una configuración regional como de_DE). |
Setup Wizard
| Option key | Purpose |
|---|
as24ci_setup_wizard_completed | 1 una vez que se ha completado el asistente de configuración. |
as24ci_setup_wizard_skipped | 1 si se omitió el asistente de configuración. |
as24ci_setup_mode | Modo de configuración seleccionado. |
as24ci_setup_completed_at | Marca de tiempo de cuando se completó la configuración. |
as24ci_setup_completed_by | ID de usuario que completó la configuración. |
as24ci_setup_first_activation_at | Marca de tiempo de la primera activación del plugin. |
ENVKV (German energy labelling)
| Option key | Purpose |
|---|
as24ci_envkv_year | Año de referencia para el cálculo de costes de ENVKV. |
as24ci_envkv_price_petrol, as24ci_envkv_price_diesel, as24ci_envkv_price_electric | Precios de la energía por tipo de combustible. |
as24ci_envkv_co2_price_low, as24ci_envkv_co2_price_med, as24ci_envkv_co2_price_high | Tramos de precios de CO₂. |
as24ci_envkv_show_costs_100km | Mostrar costes estimados por cada 100 km. |
Content Studio (opcional)
Content Studio es un módulo delimitado con sus propias claves de opción (constantes en includes/class-as24ci-content-studio-options.php, AS24CI\Content_Studio_Options).
| Option key | Purpose |
|---|
as24ci_content_studio_db_version | Versión del esquema para las tablas personalizadas de Content Studio. |
as24ci_content_studio_google_api_key | Clave de API de Google propiedad del cliente utilizada por el cliente de texto de Content Studio. Sensible. |
as24ci_content_studio_default_language | Idioma de salida predeterminado para los Copy Packages generados. |
as24ci_content_studio_default_tone | Tono predeterminado para los Copy Packages generados. |
as24ci_content_studio_brand_voice | Indicación opcional de estilo de voz de marca del concesionario (máx. 800 caracteres). |
as24ci_content_studio_disclaimer_text | Texto de descargo de responsabilidad obligatorio opcional para el texto generado (máx. 500 caracteres). |
as24ci_content_studio_compliance_notes | Notas de cumplimiento opcionales para el texto generado (máx. 1000 caracteres). |
License activation
El plugin activa y vuelve a validar su licencia contra la API Platform de ADP Car Market Hub. Solo la clave de licencia y el secreto de la señal de actualización son secretos (almacenados cifrados en reposo mediante AS24CI\Secrets); todas las demás claves contienen un estado de licencia no secreto utilizado para restringir las funciones operativas de escritura.
| Option key | Purpose |
|---|
as24ci_license_key | Clave de licencia de la API Platform cifrada (sobre de secretos). Sensible. |
as24ci_license_status | Estado operativo de la licencia (License_Manager::STATUS_*). |
as24ci_license_last_checked_at | Marca de tiempo Unix de la última respuesta exitosa de la API Platform (0 = nunca). |
as24ci_license_last_error | Último error de licencia solo como un código estable. |
as24ci_license_prefix | Prefijo de clave de licencia seguro y no secreto devuelto por la API Platform. |
as24ci_license_plan | Etiqueta del plan de licencia. |
as24ci_license_support_until | Marca de tiempo ISO hasta la cual se incluye el soporte (informativo). |
as24ci_license_expires_at | Marca de tiempo ISO en la que expira la licencia (informativo). |
as24ci_license_installation_uid | UID de instalación emitido por la API Platform en la activación. |
as24ci_license_manifest | Objeto de manifiesto no secreto devuelto por la API Platform. |
as24ci_license_feature_rights | Mapa de derechos de características devuelto por la API Platform. |
as24ci_license_import_policy | Objeto de política de importación devuelto por la API Platform. |
as24ci_license_normalized_domain | Dominio normalizado para el cual se activó/validó la licencia por última vez. |
as24ci_license_last_reported_version | Versión del plugin confirmada más recientemente como reportada a la API Platform. |
as24ci_license_refresh_signal_secret | Secreto compartido cifrado por instalación utilizado para autenticar las señales entrantes de actualización de licencia. Sensible. |
La credencial de Google Gemini del cliente se entrega de servidor a servidor mediante la API Platform y es gestionada por AS24CI\Ai_Credential_Manager. La clave de Gemini se almacena únicamente en un sobre cifrado; todas las demás filas contienen metadatos seguros para la tarjeta de estado de administración.
| Option key | Purpose |
|---|
as24ci_ai_credential_envelope | Sobre de credencial de Gemini cifrado. Nunca se carga automáticamente, nunca se renderiza. Sensible. |
as24ci_ai_credential_provider | Valor bruto del proveedor devuelto por la API Platform (por ejemplo, google / gemini). |
as24ci_ai_credential_display_provider | Etiqueta del proveedor de cara al cliente (siempre "Google Gemini"). |
as24ci_ai_credential_api_model | Modelo exactamente como lo reporta la API Platform. |
as24ci_ai_credential_effective_model | Modelo de Gemini efectivo en tiempo de ejecución después de la validación/fallback. |
as24ci_ai_credential_fingerprint | Huella digital no secreta de la credencial entregada (marcador de rotación). |
as24ci_ai_credential_synced_at | Marca de tiempo Unix de la última sincronización exitosa de credenciales. |
as24ci_ai_credential_checked_at | Marca de tiempo Unix del último intento de sincronización. |
as24ci_ai_credential_status | Cadena de estado de disponibilidad local de la IA. |
as24ci_ai_credential_last_error | Último código de motivo de decisión/error de sincronización no sensible. |
as24ci_ai_usage_reporting_required | Si la API Platform requiere informes de uso de IA. |
Updates and update visibility
Registro seguro y no secreto para el flujo de actualización privada. Ninguna de estas filas se carga automáticamente y ninguna almacena una URL de paquete firmado, firma, secreto o clave de licencia.
| Option key | Purpose |
|---|
as24ci_update_last_check_diag | Diagnóstico de la última comprobación de actualización privada (solo metadatos no secretos). |
as24ci_update_visibility_last_refresh_at | Marca de tiempo Unix del último intento de actualización de visibilidad. |
as24ci_update_visibility_last_refresh_reason | Código de motivo estable para la última decisión de actualización. |
as24ci_update_visibility_last_refresh_result | Resultado del último intento de actualización (refreshed o skipped). |
as24ci_update_visibility_last_skip_reason | Código de motivo estable para la última actualización omitida. |
as24ci_update_visibility_last_inconsistency_refresh_at | Marca de tiempo de la última actualización activada para reparar un estado transitorio inconsistente. |
as24ci_update_last_transient_snapshot | Captura pequeña y segura del transitorio update_plugins para este plugin. |
Schema and migration tracking
| Option key | Purpose |
|---|
as24ci_db_version | Versión global de los datos del plugin. |
as24ci_caps_version | Versión de migración de capacidades/roles. |
as24ci_vehicles_db_version, as24ci_search_agent_db_version, as24ci_analytics_db_version | Versiones de esquema por tabla. |
No edite estos valores manualmente a menos que tenga la intención de forzar una nueva migración.
Operational notes
- Valores sensibles. Trate
as24ci_client_secret, as24ci_cron_token, as24ci_webhook_secret, as24ci_hub_api_key y as24ci_content_studio_google_api_key como credenciales. No los guarde en el control de código fuente ni los muestre en plantillas o registros. Las opciones cifradas en reposo as24ci_license_key, as24ci_license_refresh_signal_secret y as24ci_ai_credential_envelope se almacenan a través de AS24CI\Secrets. La clave gestionada de Gemini entregada en tiempo de ejecución es propiedad de AD Promotion en AS24CI\Ai_Config y no se almacena como una opción WordPress en texto plano. - Codificación booleana. La mayoría de los selectores booleanos se almacenan como las cadenas
'1' y '0'. Compare con cadenas o conviértalos mediante (string) antes de comparar. - Filtrado en tiempo de ejecución. Los filtros estándar de WordPress (
option_<key>, pre_option_<key>, default_option_<key>) funcionan para cualquier opción aquí. Esta es la forma recomendada de anular valores en el momento del despliegue sin escribir en la base de datos. - Multisitio. Todas las claves anteriores son por sitio. Configúrelas en cada sitio individualmente a menos que tenga implementada una automatización para toda la red.
- Valores predeterminados. Los valores predeterminados se aplican en el código. Los valores predeterminados exactos pueden cambiar entre versiones; verifíquelos con el código fuente actual antes de publicar.