Documentación · Referencia del administrador

Referencia de mapeo

Este documento es una referencia para la pantalla de Mapeo del plugin ADP Car Market Hub (Car Market Hub → Mapping). Explica cómo se mapean los campos entrantes de AutoScout24 en WordPress, qué se puede personalizar por campo y cómo exportar o restablecer la configuración.

Cuándo usar este documento

Lea esto cuando desee cambiar el nombre de un campo que aparece en el frontend, ocultar un campo que no deba mostrarse a los visitantes o auditar el mapeo entre los campos de origen de AutoScout24 y las meta keys de WordPress utilizadas por las plantillas del plugin.

Descripción general

Cada vehículo importado de AutoScout24 se almacena como una entrada as24ci_car en WordPress, con los campos de origen escritos en meta keys dedicadas de la entrada. La pantalla de Mapeo expone ese mapeo como una serie de tablas agrupadas. Para cada campo puede:

  • Ver el nombre del campo original de AS24 y la meta key de WordPress subyacente.
  • Personalizar la Etiqueta que las plantillas utilizan para ese campo.
  • Alternar el estado Visible del campo para ocultarlo en el frontend.

Una tarjeta separada de Equipamiento y características enumera cada código de equipamiento compatible (almacenado como un array serializado en una sola meta key) con los mismos controles de Etiqueta y Visible. Una tarjeta de Exportar y restablecer le permite realizar una copia de seguridad de la configuración en formato JSON o CSV, o revertir todas las anulaciones a los valores predeterminados del plugin.

Requisitos o prerrequisitos

  • Permiso para administrar el plugin (la misma capacidad utilizada en otras partes de Car Market Hub).
  • Al menos un vehículo importado, para que los cambios de etiquetas y visibilidad sean visibles en el frontend.

Instrucciones paso a paso

Personalizar la etiqueta de un campo u ocultar un campo

  1. Abra Car Market Hub → Mapping.
  2. Opcionalmente, escriba en Buscar campos para filtrar las filas de todos los grupos por nombre de campo, etiqueta o meta key. A medida que escribe, la barra de búsqueda muestra un recuento en vivo de (N coincidencias) de las filas que coinciden.
  3. En la tabla del grupo correspondiente, edite la columna Etiqueta para el campo al que desea cambiar el nombre. Los valores vacíos vuelven a la etiqueta traducida por defecto.
  4. Utilice el interruptor Visible para ocultar el campo en las plantillas del frontend.
  5. Haga clic en Guardar ajustes de mapeo en la parte inferior de la sección. Los cambios se aplican inmediatamente en la siguiente carga de página del frontend.

Personalizar códigos de equipamiento / características

  1. Desplácese hasta la tarjeta Equipamiento y características.
  2. Edite la columna Etiqueta para cualquier código de característica que desee mostrar con un nombre diferente.
  3. Desactive el interruptor Visible para cualquier código de característica que no deba mostrarse.
  4. Haga clic en Guardar ajustes de mapeo.

Exportar el mapeo actual

  1. Abra la tarjeta Exportar y restablecer.
  2. Haga clic en Exportar JSON o Exportar CSV para descargar una instantánea de la configuración de mapeo actual, incluidas las anulaciones de etiquetas y visibilidad.

Restablecer todas las anulaciones

  1. Abra la tarjeta Exportar y restablecer.
  2. Haga clic en Restablecer valores predeterminados. Se eliminan todas las etiquetas personalizadas y las anulaciones de visibilidad; cada campo vuelve a su etiqueta predeterminada integrada y a su estado visible.

Referencia de configuración

Grupos de campos

La tarjeta de campos estándar está organizada en los siguientes grupos lógicos (cada grupo enumera los campos de AS24 que contiene y una breve descripción):

  • Identificación y estado: identificadores principales, referencias del vendedor, marcas de tiempo y estados de la publicación.
  • Base / tipo de vehículo: marca, modelo, identificadores de versión, detalles de certificación, categoría del vehículo.
  • Carrocería y dimensiones: estilo de carrocería, color exterior e interior, asientos, número de puertas, dimensiones físicas, incluidas las medidas del maletero.
  • Motor y transmisión: tipo de combustible, sistema de tracción, transmisión, cilindrada, configuración de cilindros, cifras de potencia.
  • Consumo, emisiones y energía: consumo de combustible y gas (urbano / extraurbano / combinado), emisiones de CO₂, clase de norma de emisiones, etiqueta energética.
  • Electrificación y carga: capacidad de la batería, estado de salud, precio de alquiler, autonomía eléctrica, tipos de conectores de carga AC/DC, potencias nominales, tiempos de carga.
  • Kilometraje y matriculación: estado del vehículo, fecha de primera matriculación, lectura del odómetro, estado de la inspección técnica.
  • Peso, remolque y carga útil: peso en vacío, peso bruto del vehículo, capacidad de carga útil, límite de remolque con freno.
  • Precio y garantía: precio de venta, precio de lista del fabricante, detalles completos de la garantía (tipo, duración, cobertura de kilometraje).
  • Descripción y multimedia: texto de introducción del anuncio, descripción completa, campos de la galería de imágenes.

Controles por campo

ColumnaNotas
Campo AS24El nombre del campo original de AutoScout24 (solo lectura).
EtiquetaEditable. Vacío = etiqueta traducida por defecto. Longitud máxima: 120 caracteres. Las filas con una etiqueta personalizada guardada muestran una etiqueta de personalizado.
Meta key de WordPressLa meta key de la entrada bajo la cual se almacena el valor (solo lectura).
VisibleInterruptor. Desactivado significa que las plantillas omitirán este campo incluso si el vehículo importado tiene datos para él.

Exportar y restablecer

AcciónNotas
Exportar JSONDescarga un archivo JSON que contiene las anulaciones guardadas.
Exportar CSVDescarga un archivo CSV con los mismos datos.
Restablecer valores predeterminadosElimina por completo la opción de anulaciones; todos los campos vuelven a sus valores predeterminados integrados.

Notas de funcionamiento

  • Todas las anulaciones se almacenan en una única opción de WordPress, no en metadatos de entradas individuales. Esto significa que los cambios se aplican a todos los vehículos importados al instante sin necesidad de volver a importar los datos.
  • Al guardar el formulario se almacena el estado visible de cada campo conocido. Cualquier elemento que no esté presente en el formulario se trata como visible por defecto.
  • Las etiquetas de los campos están preparadas para su traducción. Si su sitio está en un idioma diferente al inglés, la columna Etiqueta muestra el valor predeterminado traducido hasta que establezca una anulación.
  • La pantalla de mapeo no cambia la forma en que se importan los datos; solo controla cómo se etiquetan los datos almacenados y si aparecen en el frontend. Para cambiar qué imágenes o datos se descargan, consulte la Referencia de importación y límites.
  • Ocultar un campo aquí también afecta a la visibilidad del campo configurada por zona en el Gestor de diseño, ya que ambas capas deben permitir un campo para que este se renderice.

Resolución de problemas

  • No aparece un cambio de etiqueta. Confirme que hizo clic en Guardar ajustes de mapeo en la misma tarjeta y que se ha borrado cualquier caché del frontend o de la CDN.
  • Un campo sigue oculto después de habilitarlo. Compruebe el Gestor de diseño: el bloque o zona correspondiente también debe incluir el campo.
  • La descarga de la exportación está vacía o falla. Asegúrese de que ningún otro plugin esté interceptando las solicitudes de admin-post.php y que el usuario tenga la capacidad de administración. La ruta CSV utiliza el flujo php://output de PHP; algunos hostings restrictivos pueden bloquearlo. Verifique en la versión actual del plugin antes de publicar.
  • El restablecimiento de valores predeterminados no hizo nada. El restablecimiento solo elimina las anulaciones. Si las etiquetas siguen apareciendo personalizadas, es posible que tenga un archivo de traducción activo que anule la etiqueta predeterminada.
  • Los cambios en las etiquetas de equipamiento no se muestran en un vehículo. Es posible que ese vehículo se haya importado antes de que se completara el campo de equipamiento, o que el código de la característica esté oculto en Equipamiento y características. Vuelva a comprobar el interruptor de Visible y vuelva a importar el vehículo si es necesario (consulte la Referencia del importador de vehículos).

Documentos relacionados