Shortcodes

Este documento enumera los shortcodes registrados por el plugin ADP Car Market Hub, sus atributos y los casos de uso comunes para incrustar el contenido del plugin dentro de páginas normales de WordPress.

Cuándo utilizar este documento

Lea este documento si necesita:

• Incrustar el archivo de vehículos, el filtro de búsqueda o la vista de comparación dentro de una página de destino existente, en lugar de depender del archivo del CPT.
• Añadir una página de favoritos a una página normal de WordPress.
• Colocar una tarjeta de ubicación o una tarjeta de horarios de apertura en las páginas de los concesionarios.
• Consultar los atributos compatibles para un shortcode existente.

Para conocer el flujo subyacente de carga de plantillas, consulte Frontend Template System.

Descripción general

El plugin registra los siguientes shortcodes:

Todos los shortcodes se pueden colocar en páginas estándar, entradas y en la mayoría de los contenidos basados en bloques. Utilizan las mismas plantillas y recursos que las páginas nativas del plugin.

Referencia de shortcodes

[as24ci_archive]

Muestra el archivo de vehículos en cualquier página.

• Comportamiento: Construye una WP_Query a partir de los parámetros $_GET mediante la misma lógica utilizada por el archivo del CPT (Archive_Filters::build_query_args_from_request()), intercambia temporalmente la variable global $wp_query y renderiza la plantilla archive-as24ci_car.php incluida. La consulta original se restaura posteriormente.
• Atributos (todos opcionales, todos anulables por URL):
• make, model — marca / modelo preestablecidos.
• price_min, price_max — límites del rango de precios (mapeados a min_price, max_price).
• fuel, body — slugs de tipo de combustible y carrocería.
• order_by — price, mileage o date. Combinado con order para producir el parámetro sort.
• order — asc (por defecto) o desc.
• per_page — 12, 24, 48, 72 o all.
• Los parámetros de la URL anulan los atributos para que los visitantes puedan refinar su búsqueda de forma interactiva.
• Paginación: lee ?paged= (preferido) o ?page= de la URL.

[as24ci_search_filter]

Renderiza el formulario de filtro de búsqueda (sin resultados) para que los visitantes puedan elegir los criterios antes de ser redirigidos a una página de resultados.

• Atributos:
• results_url — URL a la que se envía el formulario. Por defecto es la URL de archivo del tipo de contenido personalizado as24ci_car, con una alternativa final a /cars/ cuando no hay ninguna URL de archivo disponible.
• Conjunto de filtros: solo se renderizan los filtros habilitados en la zona de diseño Search filters. Gestiónelos en la configuración de Filters del administrador.
• Recuentos de estado: el formulario muestra recuentos en vivo para all, new y used utilizando la misma consulta basada en taxonomías que utiliza el archivo, de modo que los recuentos y los resultados sigan siendo coherentes.

[as24ci_compare]

Renderiza la página de comparación de vehículos (page-as24ci_compare.php).

• Selección: los vehículos se seleccionan a través del parámetro GET ids (IDs de entradas separados por comas).
• Atributos: ninguno documentado en el código fuente actual; verifíquelo antes de publicar si tiene la intención de exponer atributos.

[as24ci_favorites]

Renderiza la página de favoritos del visitante. La lista de favoritos se almacena en el lado del cliente en el navegador del visitante; el shortcode (y su endpoint REST complementario) hidrata esa lista con los datos actuales del vehículo.

• Comportamiento: encola la hoja de estilos de favoritos bajo demanda e hidrata los datos del vehículo desde POST /wp-json/as24ci/v1/favorites.
• Campos visibles: configurados por la zona de diseño Favorites en la configuración de Filters del administrador.

[as24ci_location_box]

Renderiza una tarjeta de resumen de ubicación para una única entrada de ubicación.

• Atributos:
• post_id — ID de la entrada de ubicación a renderizar. Cuando se omite, el shortcode intenta resolver la ubicación a partir del contexto actual.

[as24ci_hours_box]

Renderiza una tarjeta de horarios de apertura para una única entrada de ubicación.

• Atributos:
• post_id — ID de la entrada de ubicación a renderizar. Mismo comportamiento alternativo que [as24ci_location_box].

Instrucciones paso a paso

1. Abra o cree la página donde desea incrustar el shortcode.
2. Añada el bloque de shortcode (o pegue la cadena del shortcode en un editor clásico).
3. Establezca los atributos que necesite. Por ejemplo: - [as24ci_archive make="audi" per_page="24"] - [as24ci_search_filter results_url="/inventory/"] - [as24ci_location_box post_id="42"]
4. Publique o previsualice la página y verifique el renderizado.
5. Si el shortcode se encuentra en una página servida por una caché de página completa, vacíe la caché después de editar para que se sirva el contenido más reciente.

Notas operativas

• El plugin establece la variable global $as24ci_render_mode como 'shortcode' mientras se renderiza una plantilla de shortcode. Esto lo utilizan otras partes del plugin (carga de recursos, analíticas) 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 incluye su plantilla y llaman a wp_reset_postdata() después. Incrústelos dentro del área de contenido principal para evitar interferir con los componentes del tema que leen la consulta global de forma anticipada.
• [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 a través de campos de formulario ocultos, por lo que funciona tanto con enlaces permanentes estructurados como simples.
• Las plantillas de archivo y de filtro de búsqueda incluidas siempre utilizan los propios archivos del plugin. Las anulaciones del tema para archive-as24ci_car.php se aplican tanto al archivo del CPT como al shortcode [as24ci_archive], pero page-as24ci_compare.php y parts/search-filter.php no se cargan a través de locate_template() — no se pueden anular desde un tema sin cambiar el código fuente del plugin. Consulte Template Overrides.
• Todos los shortcodes devuelven cadenas (sin impresión directa), por lo que pueden incrustarse dentro de leyendas, celdas de tablas o patrones de bloques.

Solución de problemas

• El shortcode se muestra como texto sin formato: compruebe si hay errores tipográficos en 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: verifique que la URL no contenga ya 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 campos: no hay filtros habilitados en la zona Search filters. Abra la configuración de Filters del administrador y habilite los filtros que necesite.
• [as24ci_favorites] muestra una lista vacía: el visitante no tiene favoritos guardados en el navegador actual. Intente marcar un vehículo como favorito primero; los favoritos están limitados al navegador/dispositivo.
• Los enlaces de paginación de [as24ci_archive] devuelven un error 404: es posible que su estructura de enlaces permanentes no pase paged de forma limpia a través de la página de hosting. Intente usar ?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.

Documentos relacionados

• Frontend Template System
• Template Overrides
• REST API Endpoints
• Custom Post Types And Taxonomies
• Options And Settings Storage
• Analytics Tracking