Documentación · Referencia del administrador

Referencia de shortcodes y widgets

Este documento es una referencia para la pantalla Shortcodes & Widgets del plugin ADP Car Market Hub (Car Market Hub → Shortcodes & Widgets). Documenta cada shortcode que registra el plugin, los atributos y parámetros de URL compatibles, las integraciones con editores y constructores de páginas, y los widgets de escritorio incluidos con el plugin.

Cuándo utilizar este documento

Lea esto si es editor, creador de sitios o desarrollador y necesita:

Incrustar listados de vehículos, formularios de búsqueda, tablas de comparación, favoritos, cuadros de ubicación o cuadros de horarios de apertura en una página.
Prefiltrar el inventario en el momento de la inserción utilizando atributos de shortcode.
Enviar tráfico prefiltrado a la página de inventario utilizando parámetros de URL.
Sobrescribir una plantilla del plugin en su tema activo.
Comprender qué widgets de escritorio proporciona el plugin.

Descripción general

El plugin registra seis shortcodes públicos:

Shortcode	Propósito
`[as24ci_archive]`	Inventario completo de vehículos con filtros, ordenación y paginación.
`[as24ci_search_filter]`	Formulario de búsqueda independiente, diseñado para páginas de destino o de inicio.
`[as24ci_compare]`	Tabla de comparación de vehículos para los vehículos seleccionados por el visitante.
`[as24ci_favorites]`	Página de favoritos del visitante (las entradas se almacenan en el lado del cliente en `localStorage`).
`[as24ci_location_box]`	Tarjeta de contacto de la sucursal del concesionario vinculada a un vehículo.
`[as24ci_hours_box]`	Tarjeta de horarios de apertura de la sucursal del concesionario vinculada a un vehículo.

Cada shortcode también aparece en la pantalla como su propia entrada con un botón dedicado Copiar y una sección desplegable Atributos y ejemplos que muestra los atributos compatibles y ejemplos listos para usar para ese shortcode.

En la parte superior de la pantalla, cinco mosaicos de KPI resumen el uso de los shortcodes de un vistazo:

Mosaico de KPI	Muestra
Shortcodes disponibles	Cuántos shortcodes públicos registra el plugin.
Shortcodes en uso	Total de apariciones de shortcodes encontradas en las páginas y entradas analizadas.
Integraciones con constructores	Cuántas familias de integración con editores / constructores de páginas compatibles están disponibles.
Páginas que usan el plugin	Número de páginas y entradas publicadas que contienen al menos un shortcode del plugin.
Sobrescrituras de plantillas	Número de plantillas del plugin actualmente sobrescritas por su tema activo.

Debajo de los mosaicos, una tarjeta de introducción ofrece botones de copia rápida con un solo clic para los cuatro shortcodes más utilizados — [as24ci_archive], [as24ci_search_filter], [as24ci_compare] y [as24ci_favorites] — para que pueda copiarlos al portapapeles sin tener que escribirlos.

La pantalla también muestra una tabla de Descripción general del uso de shortcodes que enumera las páginas y entradas publicadas que contienen cualquier shortcode del plugin (hasta los 100 resultados más recientes), y una tarjeta de Notas para desarrolladores que documenta las sobrescrituras de plantillas y los parámetros de URL compatibles.

Requisitos o prerrequisitos

Un usuario con una capacidad que le permita editar páginas o entradas.
Para [as24ci_compare] y [as24ci_favorites], la opción de función correspondiente debe estar activada en Car Market Hub → Settings. Cuando una función está desactivada, la pantalla marca el shortcode con una etiqueta de Desactivado.
Para [as24ci_location_box] y [as24ci_hours_box], se debe configurar al menos una ubicación en Ubicaciones y los ID de vendedor deben coincidir con el vehículo.

Instrucciones paso a paso

Incrustar un shortcode en una página

Abra la página o entrada en su editor.
Inserte el shortcode utilizando el control nativo del editor: - Editor de bloques (Gutenberg): añada un bloque de Shortcode. - Elementor: añada un widget de Shortcode. - Divi, Beaver Builder, WPBakery: utilice el módulo de shortcode o de texto. - Editor clásico: escriba el shortcode directamente en el contenido.
Pegue el shortcode deseado (con atributos si es necesario).
Guarde y previsualice.

El plugin carga sus propios estilos y scripts únicamente en las páginas que contienen un shortcode del plugin, por lo que las páginas no relacionadas no se ven afectadas.

Prefiltrar el archivo en el momento de la inserción

Utilice atributos de shortcode en [as24ci_archive], por ejemplo:

[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]
[as24ci_archive fuel="electric" body="suv" per_page="12"]

Dirigir el filtrado dinámico desde enlaces o formularios externos

Añada parámetros GET a la URL del archivo (los parámetros de URL sobrescriben los atributos del shortcode):

/inventory/?make=BMW&max_price=20000
/inventory/?condition=new&sort=price_asc

Referencia de configuración

Atributos de `[as24ci_archive]`

Todos los atributos son opcionales. Los parámetros de URL sobrescriben los atributos del shortcode.

Atributo	Descripción	Ejemplo
`make`	Prefiltrar por marca.	`make="BMW"`
`model`	Prefiltrar por modelo (usar junto con `make`).	`model="3 Series"`
`price_min`	Precio mínimo (numérico).	`price_min="10000"`
`price_max`	Precio máximo (numérico).	`price_max="40000"`
`fuel`	Tipo de combustible, por ejemplo `petrol`, `diesel`, `electric`.	`fuel="electric"`
`body`	Tipo de carrocería, por ejemplo `suv`, `sedan`, `coupe`.	`body="suv"`
`order_by`	Campo de ordenación: `price`, `mileage`, o `date` (por defecto).	`order_by="price"`
`order`	Dirección de ordenación: `asc` (por defecto) o `desc`.	`order="asc"`
`per_page`	Elementos por página: `12`, `24` (por defecto), `48`, `72`, `all`.	`per_page="12"`

Atributos de `[as24ci_search_filter]`

Atributo	Descripción	Ejemplo
`results_url`	URL de la página de resultados. Por defecto es la URL del archivo de vehículos del plugin.	`results_url="/inventory/"`

`[as24ci_compare]`

Sin atributos. Colóquelo en una página de comparación dedicada. La pantalla de Ajustes puede crear esta página automáticamente.

`[as24ci_favorites]`

Sin atributos. Colóquelo en una página dedicada a favoritos o lista de deseos. Los favoritos se almacenan en el navegador del visitante a través de localStorage; no se requiere cuenta y no se envían datos al servidor.

Atributos de `[as24ci_location_box]` y `[as24ci_hours_box]`

Atributo	Descripción	Ejemplo
`post_id`	ID de la entrada del vehículo. Por defecto es la entrada actual en el bucle.	`post_id="123"`

La sucursal vinculada al vehículo se resuelve mediante el ID de vendedor de AutoScout24. Si no se encuentra ninguna coincidencia, se utiliza la primera ubicación (por defecto) de Ubicaciones.

Parámetros de URL compatibles

Estos parámetros se pueden añadir a la URL del archivo. Los parámetros de URL sobrescriben los atributos del shortcode.

Parámetro	Descripción	Ejemplo
`make`	Filtrar por marca.	`?make=BMW`
`model`	Filtrar por modelo (requiere `make`).	`?model=3+Series`
`min_price` / `max_price`	Filtrar por rango de precios.	`?min_price=5000&max_price=20000`
`mileage_max`	Kilometraje máximo.	`?mileage_max=80000`
`condition`	`all`, `new`, o `used`.	`?condition=new`
`sort`	`price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`.	`?sort=price_asc`
`per_page`	Elementos por página (`12`, `24`, `48`, `72`, `all`).	`?per_page=12`
`q`	Búsqueda por palabra clave.	`?q=diesel`

Compatibilidad con constructores y editores

Controles de shortcode nativos en el Editor de bloques (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery y el Editor clásico. La franja de KPI en la pantalla informa de cuatro familias de integración compatibles.

Widgets de escritorio

El plugin añade los siguientes widgets al escritorio estándar de WordPress:

Widget	Contenido
CMH – Company Overview	Recuentos de vehículos, tiempos de importación, totales de leads y valor de la cartera.
CMH – AI and SEO Monitor	Cola de textos de IA, cola de SEO de imágenes y estado de la conexión de la API.
CMH – Current Leads	Actividad reciente de leads entrantes para sus vehículos.
CMH – Car Performance	Vehículos más vistos e interacción de un vistazo.
CMH – Price Information	Instantánea de información de precios para su inventario.

Tabla de descripción general del uso de shortcodes

La tabla de descripción general del uso enumera cada página o entrada publicada que contiene un shortcode del plugin, con las siguientes columnas:

Columna	Muestra
Título del contenido	Título de la página o entrada.
Tipo de contenido	Si la entrada es una página o una entrada.
Shortcodes utilizados	Qué shortcode(s) del plugin contiene el contenido.
Recuento	Cuántas apariciones de shortcodes del plugin hay en ese contenido.
Última actualización	Cuándo se modificó la página o entrada por última vez.
Acciones	Un enlace de Editar que abre la página o entrada en el editor.

Sobrescrituras de plantillas

La salida del shortcode utiliza las mismas plantillas que el CPT de vehículo nativo. Para sobrescribir una plantilla, copie el archivo en la raíz de su tema activo; WordPress cargará su versión automáticamente.

Plantilla	Utilizada para
`archive-as24ci_car.php`	Salida del archivo de vehículos y del listado de shortcodes.
`single-as24ci_car.php`	Página de detalles del vehículo individual.
`page-as24ci_compare.php`	Página de comparación de vehículos.

Notas de funcionamiento

La Descripción general del uso de shortcodes analiza hasta las 100 páginas y entradas publicadas modificadas más recientemente que contienen cualquier shortcode del plugin. Los tipos de contenido personalizados (CPT) no se incluyen por defecto.
El mosaico de KPI Shortcodes en uso cuenta el total de apariciones en el mismo análisis.
El mosaico de KPI Sobrescrituras de plantillas cuenta las plantillas del plugin actualmente sobrescritas por su tema activo.
Desactivar Comparar o Favoritos en Ajustes no elimina el shortcode de su contenido; solo lo marca como desactivado en esta referencia y puede suprimir su salida en el frontend. Vuelva a activar la función para que el shortcode vuelva a estar activo.

Resolución de problemas

Un shortcode se muestra como texto plano. WordPress no ejecutó el análisis de shortcodes en ese campo. Coloque el shortcode en el contenido principal de la página o entrada, en un bloque de Shortcode o en un módulo de constructor que admita shortcodes.
El archivo muestra todo a pesar de un atributo. Un parámetro de URL sobrescribe los atributos del shortcode. Elimine el parámetro de URL o alinéelo con el filtro deseado.
[as24ci_compare] o [as24ci_favorites] aparece vacío. Compruebe que la función correspondiente esté activada en Ajustes. La pantalla también muestra una etiqueta de Desactivado en este caso.
La ubicación y las horas recurren a la sucursal por defecto. El ID de vendedor del vehículo no está asignado a ninguna ubicación; añádalo en Ubicaciones.
No se detecta una sobrescritura de tema. El archivo debe estar en la raíz del directorio del tema activo (o hijo) y debe utilizar el nombre de archivo exacto indicado anteriormente.