Documentación · Guía del Frontend
Referencia de Shortcodes
Este documento es una referencia completa para todos los shortcodes de WordPress proporcionados por el plugin ADP Car Market Hub WordPress.
Cuándo usar este documento
Utilice este documento cuando necesite incrustar la salida del plugin en una página de WordPress y desee conocer la sintaxis exacta del shortcode, los atributos admitidos y el comportamiento esperado para cada uno de ellos.
Descripción general
El plugin registra los siguientes shortcodes:
| Shortcode | Descripción |
|---|---|
[as24ci_archive] | Renderiza el archivo completo de vehículos con filtros, ordenación y paginación |
[as24ci_search_filter] | Renderiza únicamente el formulario de filtro de búsqueda, sin resultados |
[as24ci_compare] | Renderiza la tabla de comparación de vehículos |
[as24ci_favorites] | Renderiza la lista de favoritos guardados del visitante |
[as24ci_location_box] | Renderiza el cuadro de dirección de la ubicación del concesionario para un vehículo |
[as24ci_hours_box] | Renderiza el cuadro de horarios de apertura del concesionario para un vehículo |
[as24ci_archive]
Renderiza el archivo completo de vehículos, incluyendo el formulario de filtro de búsqueda, la cuadrícula o lista de resultados, las pestañas de estado, los controles de ordenación, los controles de elementos por página y la paginación. Produce la misma salida que la URL nativa del archivo del custom post type.
Atributos
Todos los atributos son opcionales. Si un parámetro GET con el mismo nombre está presente en la URL, este anula el atributo del shortcode.
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
make | string | Prefiltro por el slug de la marca del vehículo | bmw |
model | string | Prefiltro por el slug del modelo del vehículo | 3-series |
price_min | int | Prefiltro de precio mínimo | 5000 |
price_max | int | Prefiltro de precio máximo | 30000 |
fuel | string | Prefiltro por el slug del tipo de combustible | diesel |
body | string | Prefiltro por el slug del tipo de carrocería | suv |
order_by | string | Campo de ordenación: price, mileage, o date | price |
order | string | Dirección de ordenación: asc o desc. Se usa con order_by. | asc |
per_page | string | Resultados por página: 12, 24, 48, 72, o all | 24 |
Ejemplos
Renderizar todos los vehículos:
[as24ci_archive]Renderizar solo SUV diésel ordenados por precio ascendente:
[as24ci_archive fuel="diesel" body="suv" order_by="price" order="asc"]Renderizar vehículos en un rango de precios con 12 resultados por página:
[as24ci_archive price_min="10000" price_max="50000" per_page="12"]Notas
- Los visitantes pueden interactuar con el formulario de filtro después de que se cargue la página. Cualquier selección de filtro por parte del visitante anula los atributos de prefiltro del shortcode a través de parámetros GET.
- La paginación utiliza el parámetro GET
pagedopage. - El shortcode utiliza la propia URL de la página como la acción del formulario de filtro. Asegúrese de que la página tenga una URL limpia y accesible.
[as24ci_search_filter]
Renderiza únicamente el formulario de filtro de búsqueda, sin resultados de vehículos. Utilice esto en una página de inicio o de destino para permitir que los visitantes establezcan sus criterios antes de ser redirigidos a la página de resultados.
Atributos
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
results_url | string | URL de la página de resultados a la que se envía el formulario. Por defecto es la URL del archivo del CPT o /cars/. | /inventory/ |
Ejemplos
Formulario de filtro que redirige al archivo predeterminado del CPT:
[as24ci_search_filter]Formulario de filtro que redirige a una página de resultados personalizada:
[as24ci_search_filter results_url="/car-inventory/"]Notas
- El formulario de filtro se renderiza con los mismos campos y la misma configuración del Layout Manager que el filtro de la página de archivo.
- Cualquier parámetro GET que ya esté presente en la página actual se reflejará en los valores preseleccionados del formulario de filtro.
- Cuando se utilizan enlaces permanentes sencillos (no amigables), es posible que no se pueda acceder a la URL del archivo del CPT. En ese caso, configure
results_urlexplícitamente a una página con el shortcode[as24ci_archive].
[as24ci_compare]
Renderiza la tabla de comparación de vehículos. Carga los ID de los vehículos desde el parámetro GET ids (una lista de ID de entradas separada por comas) y muestra cada vehículo como una columna en una tabla comparativa lado a lado.
Atributos
Este shortcode no tiene atributos configurables. Los ID de los vehículos se pasan a través de la URL.
Formato de URL
/compare-page/?ids=123,456,789El JavaScript de comparación construye esta URL automáticamente cuando el visitante hace clic en el botón Comparar.
Ejemplo
[as24ci_compare]Coloque este shortcode en una página dedicada a "Comparar vehículos". Los ajustes del plugin deben hacer referencia al ID de esta página como la página de comparación.
Notas
- La tabla de comparación solo renderiza vehículos publicados del custom post type del plugin.
- Se renderiza un máximo de 4 vehículos, independientemente de cuántos ID se pasen. Los ID que superen los 4 primeros se ignoran silenciosamente.
- Si no hay ningún parámetro
idspresente o todos los ID especificados no son válidos, la página mostrará "No se han seleccionado vehículos para comparar." - Los campos que se muestran en cada columna se configuran en el Layout Manager → zona Compare.
[as24ci_favorites]
Renderiza la lista de favoritos guardados del visitante. La lista se puebla dinámicamente mediante JavaScript utilizando los ID de vehículos almacenados en el localStorage del navegador. El plugin realiza una llamada a un endpoint REST interno para recuperar los datos actualizados del vehículo para cada ID guardado.
Atributos
Este shortcode no tiene atributos configurables.
Ejemplo
[as24ci_favorites]Coloque este shortcode en una página dedicada a "Mis favoritos".
Notas
- La página requiere JavaScript para funcionar. Sin JavaScript, la lista no se puede poblar.
- Si no hay vehículos guardados en el navegador del visitante, la página mostrará "Aún no tienes favoritos guardados."
- La API REST debe ser de acceso público. Los plugins de seguridad que bloquean los endpoints REST públicos impedirán que se cargue la lista de favoritos.
- Los campos que se muestran en cada tarjeta de favoritos se configuran en el Layout Manager → zona Favorites.
- Se recuperan hasta 50 ID de vehículos guardados por solicitud.
[as24ci_location_box]
Renderiza el cuadro de dirección de la ubicación del concesionario para un vehículo. El cuadro muestra el nombre del concesionario, el teléfono, la dirección y, opcionalmente, un botón "Visitar ubicación" si se ha configurado una URL de sitio web.
La ubicación se resuelve haciendo coincidir el Seller ID de AutoScout24 del vehículo con las ubicaciones configuradas en el plugin.
Atributos
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
post_id | int | ID de entrada de WordPress del vehículo. Por defecto es la entrada actual en el bucle. | 456 |
Ejemplos
Cuadro de ubicación para un vehículo específico:
[as24ci_location_box post_id="456"]Cuadro de ubicación para la entrada actual (cuando se usa dentro de una plantilla de página de vehículo):
[as24ci_location_box]Notas
- Devuelve una salida vacía si el vehículo no tiene Seller ID, o si ninguna ubicación configurada coincide con el Seller ID.
- En las páginas de detalles del vehículo, esta información también se renderiza automáticamente debajo del formulario de contacto, por lo que el uso manual del shortcode en la misma página daría como resultado una salida duplicada.
[as24ci_hours_box]
Renderiza el cuadro de horarios de apertura del concesionario para un vehículo. El cuadro muestra una columna por cada categoría de horario configurada, y cada una contiene filas con el rango de días y el rango de horas.
La ubicación se resuelve haciendo coincidir el Seller ID de AutoScout24 del vehículo con las ubicaciones configuradas en el plugin.
Atributos
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
post_id | int | ID de entrada de WordPress del vehículo. Por defecto es la entrada actual en el bucle. | 456 |
Ejemplos
Cuadro de horarios para un vehículo específico:
[as24ci_hours_box post_id="456"]Cuadro de horarios para la entrada actual:
[as24ci_hours_box]Notas
- Devuelve una salida vacía si el vehículo no tiene Seller ID, si no se encuentra ninguna ubicación coincidente o si la ubicación coincidente no tiene horarios de apertura configurados.
- En las páginas de detalles del vehículo, esta información también se renderiza automáticamente debajo del formulario de contacto.