Documentación · Referencia del administrador

Referencia del asistente de configuración

Este documento es una referencia para el Asistente de primera configuración (First Setup Wizard) del plugin ADP Car Market Hub. El asistente es un flujo de incorporación de seis pasos de estilo empresarial que ayuda a un administrador de WordPress a completar las tareas de configuración más comunes inmediatamente después de la primera activación.

El asistente es opcional. Cada opción que ofrece también se puede configurar manualmente utilizando las pestañas de administración habituales documentadas en otra parte de la Referencia del administrador. Para conocer el orden de configuración de extremo a extremo recomendado, consulte Primera configuración.

Cuándo utilizar este documento

Lea esto si necesita:

Entender cuándo y cómo aparece el aviso de bienvenida del Asistente de configuración.
Saber cómo iniciar, omitir o reanudar el asistente.
Comprender la diferencia entre la Configuración de demostración y la Configuración real de AutoScout24.
Saber qué opciones escribe el asistente y qué opciones nunca sobrescribe de forma silenciosa.
Comprender el modelo de seguridad (protección de capacidades y nonces, manejo del Client Secret).
Documentar el asistente para un traspaso interno o un procedimiento de incorporación de clientes.

Descripción general

El asistente está registrado como una página de administración oculta en:

wp-admin/admin.php?page=as24ci-setup-wizard

No aparece en el submenú Car Market Hub. Los puntos de entrada son:

El aviso de administración Bienvenido a ADP Car Market Hub que aparece después de la primera activación.
El enlace Ejecutar asistente de configuración cerca de la parte superior de Car Market Hub → Dashboard.
La tarjeta Asistente de configuración en la parte superior de Car Market Hub → Tools.

El asistente nunca redirige automáticamente después de la activación. El aviso de administración es informativo y proporciona dos botones: Iniciar asistente de configuración y Omitir por ahora.

Requisitos o prerrequisitos

Un usuario de WordPress con la capacidad de gestión del plugin (Plugin::CAP_MANAGE).
Una marca de tiempo de primera activación registrada por el hook de activación del plugin. Las instalaciones existentes que se actualicen sin volver a activarse no verán el aviso de bienvenida, pero aún podrán abrir el asistente manualmente desde el Dashboard o la pestaña Herramientas.
Para la configuración real: credenciales de la API de AutoScout24 (Client ID, Client Secret, Seller ID, URL base de la API).
Para la configuración de demostración: no se requieren credenciales de API.

Flujo del asistente

Paso 1 — Modo

Elija entre dos rutas de configuración:

Configuración de demostración: instala un conjunto seleccionado de vehículos de demostración, aplica valores predeterminados aptos para demostraciones y marca previamente la casilla de analytics para que las páginas Dashboard y Analytics tengan datos que mostrar. La configuración de demostración es una operación explícita de restablecimiento y siembra: activa la ruta existente de Demo_Data::install() al finalizar.
Configuración real de AutoScout24: guarda credenciales reales de AutoScout24 y las páginas y selectores de funciones seleccionados, pero no instala datos de demostración y no marca previamente analytics.

El Paso 1 también captura el país del concesionario (DE, CH, AT, Otro), la moneda predeterminada (EUR, CHF) y el idioma de administración (el predeterminado del sitio más una pequeña lista de permitidos explícita).

Paso 2 — Perfil del concesionario

Captura la identidad básica del concesionario utilizada por otras partes del plugin: nombre, calle, código postal, ciudad, país, teléfono, correo electrónico, sitio web y un ID de medio para el logotipo. Todos los campos son opcionales. Los valores enviados se desinfectan; los campos que se dejan vacíos conservan el valor almacenado existente (ningún campo se borra de forma silenciosa).

Paso 3 — AutoScout24

Captura la conexión de la API de AutoScout24: Client ID, Client Secret, Seller ID y URL base de la API. En el modo de demostración, este paso muestra una sugerencia para "omitir"; en el modo real, se recomiendan las credenciales.

El campo Client Secret se renderiza vacío intencionadamente. El asistente nunca vuelve a escribir el secreto almacenado en el HTML de administración. Enviar el formulario dejando el campo vacío (o solo con espacios en blanco) conserva el secreto almacenado existente. Enviar un valor no vacío lo reemplaza. Se aplica la misma regla en la pestaña de ajustes normal; consulte la Referencia de ajustes.

La URL base se valida contra una lista de permitidos de http/https; otros esquemas (por ejemplo, javascript:) se rechazan.

Paso 4 — Páginas

Para cada página pública, el asistente ofrece tres modos:

Crear automáticamente: se llama a wp_insert_post() con post_type=page, post_status=publish, el título canónico y el shortcode canónico como contenido de la página. Primero se realiza una búsqueda de título para evitar crear un duplicado cuando ya existe una página con el mismo título.
Usar página existente: el administrador introduce el ID de publicación de una página existente y se actualiza la opción correspondiente (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id).
Omitir: la página no se crea y se conserva el valor de la opción existente.

Páginas canónicas y shortcodes:

Página	Shortcode	Opción
Cars	`[as24ci_archive]`	`as24ci_page_archive_id`
Compare Cars	`[as24ci_compare]`	`as24ci_page_compare_id`
Favorites	`[as24ci_favorites]`	`as24ci_page_favorites_id`

Si la opción ya apunta a una página existente (get_post() devuelve una página publicada), el asistente la conserva y no crea un duplicado. El asistente nunca elimina páginas existentes.

Las alertas de búsqueda no tienen intencionadamente ninguna página pública en el asistente. Las suscripciones a alertas de búsqueda se gestionan a través de la barra lateral de filtros de [as24ci_archive] y desde la pestaña de administración de la Referencia de alertas de búsqueda.

Paso 5 — Características

Alterna los valores predeterminados de las características más comunes. Cada interruptor se registra con una marca explícita de "presente", por lo que volver a ejecutar el asistente a mitad de camino nunca borra un ajuste que no estaba en el formulario:

Botones para compartir en redes sociales
Ficha técnica en PDF
Código QR en PDF
Costes de funcionamiento por 100 km
Comparar
Favoritos
Alertas de búsqueda
Seguimiento de Analytics

En el modo de demostración, la casilla de analytics está marcada previamente. En el modo real, está desmarcada a menos que el administrador la habilite explícitamente.

Los valores predeterminados ocultos en los que se basa el asistente (ubicación para compartir en redes sociales, el conjunto completo de redes, diseño de archivo = ambos, extracto de lista = 150) se siembran solo cuando falta la opción correspondiente; se conservan los valores existentes.

Paso 6 — Finalizar

Un resumen de solo lectura de las elecciones realizadas. En el modo de demostración, el botón de finalización tiene la etiqueta Instalar datos de demostración y finalizar y activa la ruta existente de Demo_Data::install(). En el modo real, el botón de finalización solo guarda los ajustes recopilados por el asistente.

Después de finalizar con éxito:

Se establece as24ci_setup_wizard_completed.
Se establece as24ci_setup_completed_at con una marca de tiempo UTC ISO-8601.
Se establece as24ci_setup_completed_by con el ID de usuario de WordPress.
El administrador es redirigido de vuelta al Dashboard con un aviso de éxito temporal.

Comportamiento del aviso de administración

El aviso de bienvenida se renderiza solo cuando se cumplen todas las siguientes condiciones:

El usuario actual tiene la capacidad de gestión del plugin.
Existe as24ci_setup_first_activation_at (registrado por Plugin::activate() solo cuando falta, por lo que las instalaciones existentes que se actualizan sin volver a activarse no reciben el aviso).
No se ha establecido as24ci_setup_wizard_completed.
No se ha establecido as24ci_setup_wizard_skipped.
La pantalla actual no es la propia página del asistente.

Se ofrecen dos botones:

Iniciar asistente de configuración abre el asistente.
Omitir por ahora envía una solicitud a admin-post.php?action=as24ci_setup_wizard_skip (con comprobaciones de capacidad y nonce). Establece as24ci_setup_wizard_skipped=1 y redirige de vuelta al Dashboard. El aviso no vuelve a aparecer en las siguientes cargas de páginas de administración.

El asistente nunca fuerza la redirección después de la activación.

Referencia de configuración

Opciones de estado

Opción	Propósito
`as24ci_setup_first_activation_at`	Marca de tiempo de la primera activación. Registrada una vez a través de `add_option()`; nunca se sobrescribe en posteriores (re)activaciones.
`as24ci_setup_wizard_completed`	Se establece en `1` después de finalizar con éxito.
`as24ci_setup_wizard_skipped`	Se establece en `1` cuando el administrador hace clic en Omitir en el aviso de bienvenida.
`as24ci_setup_mode`	Ya sea `demo` o `live`.
`as24ci_setup_completed_at`	Marca de tiempo UTC ISO-8601 del evento de finalización.
`as24ci_setup_completed_by`	ID de usuario de WordPress que completó el asistente.

Opciones del perfil del concesionario

as24ci_dealer_name, as24ci_dealer_street, as24ci_dealer_postal_code, as24ci_dealer_city, as24ci_dealer_country, as24ci_dealer_phone, as24ci_dealer_email, as24ci_dealer_website, as24ci_dealer_logo_id, as24ci_dealer_language.

Opciones existentes que el asistente puede escribir

CLIENT_ID, CLIENT_SECRET, SELLER_IDS, BASE_URL, DEFAULT_CURRENCY, FEATURE_SOCIAL_SHARE, SOCIAL_SHARE_PLACEMENT, SOCIAL_SHARE_NETWORKS, FEATURE_PDF_DATASHEET, FEATURE_COMPARE, FEATURE_FAVORITES, FEATURE_SEARCH_AGENT, ANALYTICS_ENABLED, ENVKV_SHOW_COSTS_100KM, PDF_MANAGER_SETTINGS (clave show_qr), DESIGN_ARCHIVE_LAYOUT, ARCHIVE_LIST_EXCERPT_LENGTH, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id.

El asistente solo actualiza las opciones cuyos campos de formulario están realmente presentes en la carga útil POST enviada. Los campos no enviados conservan su valor existente.

Seguridad

Control de capacidad. Cada punto de entrada (la página del asistente, el controlador de guardado del formulario y el controlador de omisión) llama a current_user_can( Plugin::CAP_MANAGE ) y sale con wp_die() si falta la capacidad.
Nonces. El guardado del formulario utiliza wp_nonce_field() / check_admin_referer(); la URL de omisión utiliza wp_nonce_url() / check_admin_referer().
Client Secret. El secreto almacenado nunca se vuelve a renderizar en el HTML de administración. Los envíos vacíos o solo con espacios en blanco conservan el valor almacenado.
Validación de URL. La URL base y el sitio web del concesionario deben usar el esquema http o https; otros esquemas se rechazan.
Validación de correo electrónico. El correo electrónico del concesionario se valida con is_email(). Una entrada no válida conserva silenciosamente el valor existente; un envío vacío lo borra.
Desinfección. El modo, el país, la moneda, el idioma y el modo de página se comprueban contra listas de permitidos explícitas. Los campos de texto utilizan sanitize_text_field(). Los ID de página utilizan absint().
Escape de salida. Cada valor dinámico renderizado por el asistente utiliza esc_html, esc_attr o esc_url.

Notas operativas

El asistente nunca modifica los ajustes al activar el plugin. La activación solo siembra valores predeterminados no destructivos a través de add_option().
El asistente nunca modifica los ajustes cuando se carga un paso; los ajustes solo se actualizarán cuando el administrador envíe un paso.
La configuración de demostración sigue siendo un restablecimiento y siembra explícitos: restablece deliberadamente las opciones controladas por la demostración e inserta vehículos de demostración. Utilícela únicamente en sitios dedicados a demostraciones o evaluaciones.
La configuración real no es destructiva con respecto a los vehículos y los ajustes del cliente. Guarda los ajustes y las páginas seleccionados en el asistente, pero no instala datos de demostración.
Analytics se marca previamente solo en el modo de demostración. En el modo real, el interruptor requiere consentimiento explícito. Consulte Retención de Analytics para consideraciones de privacidad.
El asistente no ejecuta el aprovisionamiento de IA, las importaciones automáticas, la programación ni la sincronización completa. Estos se configuran más adelante en las pestañas de administración correspondientes.
El asistente no sustituye a una herramienta de consentimiento de cookies, un CMP, una política de privacidad o una revisión legal. Habilite analytics en un sitio real solo después de haber verificado estos requisitos.

Resolución de problemas

El aviso de bienvenida no aparece. El asistente ya se ha completado (as24ci_setup_wizard_completed) o se ha omitido (as24ci_setup_wizard_skipped), el usuario actual carece de la capacidad de gestión, o no se ha registrado la marca de tiempo de la primera activación (típico en actualizaciones que no activaron una instalación limpia). En su lugar, abra el asistente desde Car Market Hub → Tools → Setup Wizard.
Omití el asistente. ¿Cómo lo vuelvo a abrir? Utilice el enlace Ejecutar asistente de configuración en Car Market Hub → Dashboard o la tarjeta Asistente de configuración en Car Market Hub → Tools.
El asistente no creó mis páginas. Ya existía una página con el mismo título y se reutilizó, o se seleccionó la opción Omitir para esa página en el Paso 4. Abra Pages en WordPress y confírmelo. El asistente nunca elimina páginas.
El campo Client Secret está vacío cuando vuelvo a abrir el Paso 3. Esto es por diseño. El secreto almacenado nunca se vuelve a renderizar. Dejar el campo vacío conserva el valor almacenado.
Analytics no está habilitado después de la configuración en vivo. En el modo Live (en vivo), el interruptor de analíticas es de consentimiento voluntario (opt-in). Vuelva a abrir el asistente y habilítelo en el Paso 5, o actívelo en la pestaña Analytics. Confirme primero el consentimiento de cookies y los requisitos de privacidad.
No se instalaron los datos de demostración. Asegúrese de haber seleccionado Configuración de demostración en el Paso 1 y de haber hecho clic en Instalar datos de demostración y finalizar en el Paso 6. La configuración en vivo no instala datos de demostración.
Las secciones de Comparar o Favoritos están vacías en la demostración. Las funciones de Comparar y Favoritos se basan en localStorage; la demostración genera un valor de respaldo que alimenta el localStorage en la primera carga de la página. Abra la página de Comparar o Favoritos una vez en la misma sesión del navegador para activar esta carga inicial.
El asistente no sobrescribe mis ajustes existentes. Correcto. El asistente solo escribe las opciones cuyos campos de formulario se envían. Volver a ejecutarlo a mitad de camino nunca borra ajustes no relacionados.