Documentación · Guía del Frontend
Archivo de vehículos
Este documento cubre la página de archivo de vehículos del plugin ADP Car Market Hub WordPress: cómo se listan los vehículos, cómo funcionan los filtros y la ordenación, y qué pueden hacer los visitantes desde el archivo.
Cuándo usar este documento
Lea este documento si está configurando el archivo de vehículos por primera vez, solucionando problemas con el comportamiento de los filtros o la ordenación, o ayudando a un visitante a entender cómo buscar y explorar el inventario.
Descripción general
El archivo de vehículos muestra todos los vehículos importados como una lista navegable y filtrable. Los visitantes pueden acotar los resultados utilizando filtros de búsqueda, ordenar la lista por precio o kilometraje, cambiar entre las vistas de cuadrícula y lista, y navegar a las páginas de detalles de cada vehículo individual.
El archivo se renderiza mediante la plantilla de archivo integrada del plugin (archive-as24ci_car.php). Se puede mostrar de dos maneras:
- Archivo CPT nativo: WordPress sirve automáticamente el archivo en la URL del archivo del tipo de contenido personalizado (custom post type). El plugin registra el tipo de contenido
as24ci_care intercepta la plantilla de archivo a través del filtroarchive_template. - Página con shortcode: Coloque el shortcode
[as24ci_archive]en cualquier página de WordPress. El plugin renderiza el archivo completo, incluyendo los filtros y la paginación, en esa página. Este es el enfoque recomendado cuando se utilizan enlaces permanentes sencillos (no amigables) o cuando se desea controlar el slug de la URL del archivo.
Ambos métodos utilizan la misma plantilla y producen un resultado idéntico.
Requisitos o prerrequisitos
- El plugin debe estar instalado y activado.
- Se debe haber importado y publicado al menos un vehículo.
- Si se utiliza el método del shortcode, debe existir una página con
[as24ci_archive]en WordPress. - La página de archivo o la URL del archivo CPT debe ser accesible públicamente.
Instrucciones paso a paso
Mostrar el archivo de vehículos mediante shortcode
- En la administración de WordPress, vaya a Páginas → Añadir nueva.
- Asigne un título a la página, como "Nuestros vehículos" o "Inventario de coches".
- En el editor de contenido de la página, añada el shortcode
[as24ci_archive]. - Publique la página.
- En los ajustes del plugin, confirme que el ID de la página de archivo está configurado correctamente en la configuración del plugin, para que las migas de pan (breadcrumbs) y los enlaces de comparación apunten a la URL correcta.
Prefiltrar el archivo utilizando atributos del shortcode
Puede prefiltrar el archivo desde el shortcode para mostrar solo un subconjunto de vehículos:
[as24ci_archive make="bmw" fuel="diesel" per_page="12"]Atributos de shortcode admitidos:
| Atributo | Descripción | Valor de ejemplo |
|---|---|---|
make | Filtrar por marca (slug) | bmw, volkswagen |
model | Filtrar por modelo (slug) | 3-series, golf |
price_min | Precio mínimo | 5000 |
price_max | Precio máximo | 30000 |
fuel | Filtrar por tipo de combustible (slug) | diesel, electric |
body | Filtrar por tipo de carrocería (slug) | suv, sedan |
order_by | Campo de ordenación: price, mileage, o date | price |
order | Dirección de ordenación: asc o desc | asc |
per_page | Resultados por página: 12, 24, 48, 72, o all | 24 |
Los visitantes aún pueden interactuar con el formulario de filtro después de que se cargue la página. Los parámetros GET del formulario de filtro anulan los atributos del shortcode.
Referencia de configuración
Controles de filtro
El archivo incluye un formulario de filtro de búsqueda. Los filtros que aparecen se controlan mediante la zona Layout Manager → Search Filters (Gestor de diseño → Filtros de búsqueda) del plugin. Se admiten los siguientes campos de filtro:
Filtros estándar (visibles por defecto):
- Marca
- Modelo (dependiente de la selección de Marca)
- Año (rango mín./máx.)
- Kilometraje (rango mín./máx.)
- Precio (rango mín./máx.)
- Tipo de combustible
- Transmisión
- Tipo de tracción
- Estado
- Color exterior
Filtros avanzados (se muestran mediante un botón desplegable "Mostrar más"):
- Color interior
- Cilindrada del motor (rango mín./máx.)
- Etiqueta energética
- Ubicación
Filtros opcionales (desactivados por defecto, se pueden activar):
- Tipo de carrocería
- Puertas (rango mín./máx.)
- Asientos (rango mín./máx.)
Controles de la barra de herramientas (configurables):
- Criterio de ordenación
- Resultados por página
- Búsqueda por palabra clave (
q)
Cada filtro se puede activar o desactivar individualmente en el Layout Manager. Los filtros desactivados se ocultan a los visitantes, pero no afectan a los valores de filtro que estén activos en ese momento.
Parámetros GET aceptados por el archivo
El archivo procesa los siguientes parámetros GET, que el formulario de filtro envía automáticamente:
| Parámetro | Tipo | Descripción |
|---|---|---|
make | string | Slug de la marca del vehículo |
model | string | Slug del modelo del vehículo |
body_type | string | Slug del tipo de carrocería |
drive_type | string | Slug del tipo de tracción |
condition | string | Slug del estado (new o used) |
fuel_type | string | Slug del tipo de combustible |
transmission | string | Slug de la transmisión |
color_exterior | string | Slug del color exterior (se acepta color como alias) |
color_interior | string | Slug del color interior |
min_price | int | Precio mínimo |
max_price | int | Precio máximo |
mileage_min | int | Kilometraje mínimo en km |
mileage_max | int | Kilometraje máximo en km |
year_min | int | Año mínimo de matriculación |
year_max | int | Año máximo de matriculación |
displacement_min | int | Cilindrada mínima del motor en cc |
displacement_max | int | Cilindrada máxima del motor en cc |
energy_label | string | Slug de la etiqueta energética |
location | string | Nombre de la ubicación |
doors_min | int | Número mínimo de puertas |
doors_max | int | Número máximo de puertas |
seats_min | int | Número mínimo de asientos |
seats_max | int | Número máximo de asientos |
status | string | all, new, o used (pestaña de estado) |
q | string | Búsqueda por palabra clave (máx. 100 caracteres) |
sort | string | Criterio de ordenación (ver sección Ordenación) |
per_page | string | Resultados por página: 12, 24, 48, 72, o all |
paged | int | Número de página para la paginación |
Ordenación
El archivo admite las siguientes opciones de ordenación a través del parámetro GET sort:
| Valor | Descripción |
|---|---|
| (vacío) | Los más nuevos primero (fecha descendente) |
price_asc | Precio: de menor a mayor |
price_desc | Precio: de mayor a menor |
mileage_asc | Kilometraje: de menor a mayor |
mileage_desc | Kilometraje: de mayor a menor |
El criterio de ordenación por defecto se puede configurar en los ajustes del plugin. Si no se configura ningún valor por defecto, el archivo mostrará primero los más nuevos.
Opciones de diseño y visualización
Los siguientes ajustes de visualización están disponibles en la administración del plugin:
| Ajuste | Opciones | Descripción |
|---|---|---|
| Diseño del archivo | grid, list, both | Modo de visualización de las tarjetas. both añade un botón para cambiar de vista. |
| Columnas de la cuadrícula | 1, 2, 3, 4 | Número de columnas en la vista de cuadrícula |
| Resultados por página | 12, 24, 48, 72 o entero personalizado | Número predeterminado de vehículos por página |
| Longitud del extracto en lista | 0–500 caracteres | Límite de caracteres para el extracto mostrado en la vista de lista |
| Distintivos (Badges) | Nuevo, Usado, Oferta, Súper oferta | Activar/desactivar qué distintivos se muestran en las tarjetas de los vehículos |
Contenido de la tarjeta de archivo
Cada tarjeta de vehículo en el archivo muestra la siguiente información. Los elementos individuales se pueden reordenar o desactivar a través de la zona Layout Manager → Archive Cards (Gestor de diseño → Tarjetas de archivo):
- Imagen en miniatura del vehículo (se utiliza una imagen de marcador de posición si no hay ninguna disponible)
- Título del vehículo
- Precio (formateado con la moneda correspondiente)
- Distintivos de estado (Nuevo, Usado, Oferta, Súper oferta)
- Datos clave: año, kilometraje, tipo de combustible, transmisión, potencia, tipo de carrocería, color exterior, estado (configurable)
- Botón de favoritos (icono de corazón, si la función de favoritos está activada)
- Botón de comparación (si la función de comparación está activada)
- Texto del extracto (solo en la vista de lista, si la longitud del extracto es mayor que cero)
Pestañas de estado
La cabecera del archivo incluye tres pestañas: Todos, Nuevos y Usados. Cada pestaña muestra el número de vehículos que coinciden con el estado actual del filtro. Al hacer clic en una pestaña, se filtra por ese estado. Cuando se selecciona un estado a través del filtro desplegable de estado, los recuentos de las pestañas y la pestaña seleccionada se sincronizan con esa selección.
Notas de funcionamiento
- Los filtros categóricos (marca, modelo, tipo de combustible, estado, etc.) se implementan utilizando consultas de taxonomía de WordPress. Los filtros numéricos (precio, kilometraje, año, cilindrada) realizan consultas en la tabla de base de datos personalizada
{prefix}as24_vehiclesdel plugin. - El filtrado por ubicación resuelve el nombre de la ubicación en un conjunto de ID de vendedor (seller IDs) y luego filtra los vehículos por esos vendedores.
- Cuando se selecciona la opción
per_page=all, la paginación se oculta y todos los vehículos coincidentes se devuelven en una sola solicitud. - La plantilla de archivo se carga a través del filtro WordPress
archive_template. El tema activo puede anular la plantilla proporcionando un archivoarchive-as24ci_car.phpen el directorio del tema. - Al utilizar el shortcode, la acción del formulario apunta a la URL de la página actual en lugar de a la URL del archivo CPT. Esto garantiza que el envío de filtros y la paginación funcionen correctamente en la página del shortcode.
- El plugin encola su propio CSS y JavaScript únicamente en las páginas de archivo, en las páginas de un solo vehículo y en las páginas que contienen un shortcode reconocido del plugin.
Resolución de problemas
La página de archivo no muestra ningún vehículo.
- Confirme que se ha importado y publicado al menos un vehículo.
- Compruebe que la página correcta está configurada como la página de archivo en los ajustes del plugin.
- Si utiliza la URL de archivo del CPT, verifique que los enlaces permanentes amigables estén activados en WordPress Ajustes → Enlaces permanentes.
Los filtros no aparecen.
- Compruebe la zona Gestor de diseño → Filtros de búsqueda y confirme que los filtros deseados están activados.
- Si aparece el formulario de filtro pero falta un filtro específico, es posible que se haya desactivado en el Gestor de diseño.
La ordenación por precio o kilometraje no funciona correctamente.
- La ordenación por precio y kilometraje depende de la tabla de vehículos personalizada del plugin. Es posible que los vehículos importados antes de que se creara esta tabla no se ordenen correctamente hasta que se vuelvan a importar o se ejecute la herramienta de migración.
El shortcode [as24ci_archive] no se renderiza.
- Confirme que el plugin está activo y que el shortcode está colocado correctamente en el contenido de la página.
- Compruebe si existen conflictos con el tema o con otros plugins que puedan suprimir la salida del shortcode.
La paginación no funciona en una página de shortcode.
- Los parámetros GET
pagedypageson compatibles. Verifique que los enlaces de paginación de su tema generen uno de estos parámetros.