Documentación · Apéndices

Referencia de shortcodes

Este apéndice es una referencia rápida para los shortcodes registrados por el plugin ADP Car Market Hub.

Cuándo utilizar este documento

Utilice esta referencia cuando necesite buscar el nombre de un shortcode, sus atributos compatibles o un ejemplo para copiar y pegar. Para la explicación conceptual de los shortcodes (cuándo usar cada uno, cómo interactúan con las plantillas), consulte Shortcodes en la documentación técnica y Referencia de shortcodes en la guía del frontend.

Descripción general

Todos los shortcodes son registrados por el bootstrap principal del plugin y están disponibles en cada página o entrada de WordPress (sujeto al editor activo y a cualquier restricción a nivel de bloque). Devuelven cadenas de texto en lugar de imprimirlas directamente (echo), por lo que pueden incrustarse dentro de leyendas, celdas de tablas o patrones de bloques.

Shortcode	Renderiza	Notas
`[as24ci_archive]`	El archivo de vehículos (filtrable, ordenable, paginado).	Los parámetros de la URL anulan los atributos del shortcode.
`[as24ci_search_filter]`	El formulario de filtro de búsqueda independiente, sin resultados.	Envía los datos a la URL de resultados que elija.
`[as24ci_compare]`	La página de comparación de vehículos.	Vehículos seleccionados a través del parámetro de URL `ids`.
`[as24ci_favorites]`	La página de favoritos del visitante.	Se hidrata desde el asistente REST de favoritos; los favoritos se almacenan en el lado del cliente.
`[as24ci_location_box]`	Una tarjeta de ubicación para una única entrada de ubicación.	Resuelve la ubicación desde `post_id` o el contexto.
`[as24ci_hours_box]`	Una tarjeta de horarios de apertura para una única entrada de ubicación.	Mismo comportamiento de reserva que `[as24ci_location_box]`.

Referencia de atributos

`[as24ci_archive]`

Todos los atributos son opcionales. Los parámetros de la URL con el mismo nombre anulan el atributo del shortcode, de modo que los visitantes pueden refinar los resultados de forma interactiva.

Atributo	Valores permitidos	Efecto
`make`	Slug de la marca	Pre-filtrar por marca.
`model`	Slug del modelo	Pre-filtrar por modelo.
`price_min`	Número	Límite inferior del filtro de precio (mapeado a `min_price`).
`price_max`	Número	Límite superior del filtro de precio (mapeado a `max_price`).
`fuel`	Slug del tipo de combustible	Pre-filtrar por tipo de combustible.
`body`	Slug del tipo de carrocería	Pre-filtrar por tipo de carrocería.
`order_by`	`price`, `mileage`, `date`	Campo de ordenación. Combinado con `order` para producir el parámetro `sort`.
`order`	`asc`, `desc`	Dirección de ordenación. Por defecto `asc`.
`per_page`	`12`, `24`, `48`, `72`, `all`	Elementos por página.

La paginación utiliza ?paged= (preferido) o ?page= de la URL.

Ejemplo:

[as24ci_archive make="bmw" price_max="40000" order_by="price" order="asc" per_page="24"]

`[as24ci_search_filter]`

Atributo	Valores permitidos	Efecto
`results_url`	URL absoluta o relativa	URL a la que se envía el formulario. Por defecto es la URL del archivo del tipo de contenido personalizado `as24ci_car`, recurriendo a `/cars/` cuando no hay una URL de archivo disponible.

Solo se renderizan los filtros habilitados en la zona de diseño Filtros de búsqueda. Gestiónelos en la pestaña de administración Referencia del gestor de diseño (Layout Manager).

Ejemplo:

[as24ci_search_filter results_url="/inventory/"]

`[as24ci_compare]`

No hay atributos documentados en la versión actual. La selección se realiza mediante el parámetro de URL ids, una lista separada por comas de IDs de entradas de vehículos.

URL de ejemplo: /compare/?ids=123,456

`[as24ci_favorites]`

No hay atributos documentados. Los campos visibles se configuran mediante la zona de diseño Favoritos en el Referencia del gestor de diseño (Layout Manager). Los datos del vehículo se obtienen de POST /wp-json/as24ci/v1/favorites para los IDs que el visitante ha almacenado localmente.

`[as24ci_location_box]`

Atributo	Valores permitidos	Efecto
`post_id`	Entero	ID de la entrada de ubicación a renderizar. Cuando se omite, el shortcode resuelve la ubicación desde el contexto actual.

`[as24ci_hours_box]`

Atributo	Valores permitidos	Efecto
`post_id`	Entero	ID de la entrada de ubicación a renderizar. Mismo comportamiento de reserva que `[as24ci_location_box]`.

Notas de funcionamiento

El plugin establece la variable global $as24ci_render_mode en 'shortcode' mientras se renderiza una plantilla de shortcode. La carga de recursos y las analíticas utilizan esta marca para que las páginas basadas en shortcodes se comporten de manera coherente con el archivo nativo del CPT.
[as24ci_archive] y [as24ci_compare] intercambian la variable global $wp_query mientras se renderiza su plantilla y llaman a wp_reset_postdata() después. Incrústelos en el área de contenido principal para evitar interferir con los componentes del tema que leen la consulta global de forma temprana.
[as24ci_search_filter] construye su URL action a partir de la URL de resultados configurada (o por defecto) y conserva cualquier parámetro de consulta presente en esa URL mediante campos de formulario ocultos, de modo que funciona tanto con enlaces permanentes estructurados (pretty permalinks) como simples.
Las plantillas integradas de archivo y de filtro de búsqueda siempre utilizan los propios archivos del plugin. Las anulaciones del tema para archive-as24ci_car.php se aplican tanto al archivo del CPT como a [as24ci_archive], pero page-as24ci_compare.php y parts/search-filter.php no se cargan a través de locate_template() y no se pueden anular desde un tema sin editar el código fuente del plugin. Verifique esto con la versión actual del plugin antes de publicar.
Las páginas servidas por un sistema de caché de página completa deben purgarse después de editar una página que utilice estos shortcodes para que se sirva el contenido más reciente.

Solución de problemas

El shortcode se muestra como texto sin formato. Compruebe el nombre del shortcode; los nombres distinguen entre mayúsculas y minúsculas. Utilice la forma en minúsculas documentada anteriormente.
[as24ci_archive] muestra los vehículos incorrectos. Es probable que la URL ya contenga parámetros de filtro de una página anterior; los parámetros de la URL siempre anulan los atributos del shortcode.
[as24ci_search_filter] no muestra ningún campo. No hay filtros habilitados en la zona de diseño Filtros de búsqueda. Abra el Referencia del gestor de diseño (Layout Manager) y habilite los filtros que necesite.
[as24ci_favorites] muestra una lista vacía. El visitante no tiene favoritos almacenados en el navegador actual. Los favoritos están limitados al navegador/dispositivo.
Los enlaces de paginación devuelven un error 404. Es posible que su estructura de enlaces permanentes no transmita paged limpiamente a través de la página de destino. Pruebe con ?page=N o actualice la estructura de enlaces permanentes.
La página de comparación está vacía. Falta el parámetro ids en la URL. Añada al menos dos IDs de vehículos (?ids=123,456).

Cuándo utilizar este documento

Descripción general

Referencia de atributos

[as24ci_archive]

[as24ci_search_filter]

[as24ci_compare]

[as24ci_favorites]

[as24ci_location_box]

[as24ci_hours_box]