web_listings Shortcode

El shortcode web_listings renderiza el componente de listados (Feed).

Los atributos siguientes coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis en crudo solo para contenido revisado que no pueda mantenerse mediante los controles visuales.

Uso

[web_listings]

Atributos

Atributo Predeterminado Valores aceptados Propósito
query_type default custom, default, single_post, current Últimas 12 entradas, una consulta guardada, los IDs seleccionados en orden o la petición actual de archivo/búsqueda.
posts_per_page Límite de la fuente Entero positivo o -1 para todos los resultados Sustituye el límite ordinario de la fuente; la búsqueda facetada gestiona su propio tamaño de página.
accessible_name Vacío Texto sin formato Asigna un nombre a la región de resultados para las tecnologías de asistencia.
single_post — Un valor seleccionado de WordPress Controla las entradas individuales. Disponible cuando query_type es single_post.
custom_query 1 Cadena salvo que se indique lo contrario Controla las consultas personalizadas. Disponible cuando query_type es custom.
related_split_<post-type-slug>_title Related <post-type label> Texto sin formato Personaliza el encabezado de cada tipo de contenido consultable públicamente cuando related_display_mode es split. El Page Builder crea un control por cada tipo de contenido disponible en el sitio actual.
faceted_search no yes, no Controla el uso con la búsqueda facetada.
submit_mode auto auto, manual Controla el modo de envío de facetas. Disponible cuando faceted_search es yes.
show_initial_results yes yes, no Controla la opción de mostrar resultados iniciales. Disponible cuando faceted_search es yes.
submit_on_reset yes yes, no Controla la opción de actualizar tras restablecer. Disponible cuando submit_mode es manual.
initial_results_placeholder — Cadena salvo que se indique lo contrario Controla el marcador de posición de los resultados iniciales. Disponible cuando show_initial_results es no.
only_related — yes Controla la opción de mostrar solo los relacionados con la entrada actual. Disponible cuando faceted_search es no.
exclude_current_post_from_query yes yes Si el feed se muestra en cualquier Single y la entrada actual aparece en la consulta, se omitirá. Disponible cuando faceted_search es no.
exclude_hidden_products yes yes Controla la opción de excluir los productos ocultos de WooCommerce. Disponible cuando faceted_search es no.
related_display_mode mix mix, split Controla el modo de visualización de las entradas relacionadas. Disponible cuando only_related es yes.
enable_pagination — yes Controla la opción de habilitar la paginación. Disponible cuando faceted_search es no.
prevent_pagination — yes Evita que la consulta principal pagine este feed. Disponible cuando faceted_search es no.
pagination paginated paginated, paginated_no_ajax, load_more, infinite Controla el estilo de la paginación. Disponible cuando enable_pagination es yes.
load_more_text Load more Cadena salvo que se indique lo contrario Controla el texto del botón «cargar más». Disponible cuando pagination es load_more.
load_more_style 1 1 o un slug de estilo de botón configurado Selecciona el estilo del botón Cargar más. Disponible cuando pagination es load_more.
style default default, default_masonry, only_image, horizontal_list, horizontal_list_thumbnail, horizontal_list_big, horizontal_list_title_over, horizontal_list_creative, wide_slider, full_screen, full_width_section, pricing_list, no_wrapper Controla el estilo del contenedor del feed.
layout default default o un slug de plantilla de feed personalizada configurado Selecciona la plantilla usada para cada resultado del feed.
columns_default 4 12, 6, 4, 3, 2 Controla el número de columnas. Disponible cuando style es default.
columns_default_tablet_h 12 12, 6, 4, 3, 2 Controla el número de columnas en tableta (horizontal). Disponible cuando style es default.
columns_default_tablet_v 12 12, 6, 4, 3, 2 Controla el número de columnas en tableta (vertical). Disponible cuando style es default.
columns_default_mobile 12 12, 6, 4, 3, 2 Controla el número de columnas en móvil. Disponible cuando style es default.
columns 2 1, 2, 3, 4, 5, 6, 7, 8, 9 Establece el número de columnas de resultados. Disponible cuando style es default_masonry o only_image.
gap Vacío (predeterminado del tema) default, minimal, small, medium, none Controla el espaciado de la cuadrícula o de masonry, incluida la cuadrícula con hover de imagen.
wide_slider_adapt — yes Controla la opción de habilitar la altura adaptativa. Disponible cuando style es wide_slider.
feed_wide_slider_ajax Vacío Atributo almacenado retenido Sin efecto independiente. Usa enable_pagination y pagination para cargar resultados adicionales del wide-slider.
loading_background_color — Cadena salvo que se indique lo contrario Elige el color de fondo de carga.
loading_background_alpha 50 Número Controla la opacidad del fondo de carga.
loading_background_image — Cadena salvo que se indique lo contrario Controla la imagen de fondo de carga.
device_visibility — Cadena salvo que se indique lo contrario Aplica la regla de visibilidad responsive seleccionada.
el_id — ID HTML único válido Introduce el ID de la sección (Nota: asegúrate de que sea único y válido según la especificación del W3C).
el_class — Cadena salvo que se indique lo contrario Si deseas aplicar a un elemento de contenido concreto un estilo diferente, usa este campo para añadir un nombre de clase y luego haz referencia a él en tu archivo CSS.

Elige una consulta y una plantilla

Usa una consulta personalizada guardada cuando el listado tenga reglas de selección reutilizables. Usa el contexto de archivo actual para un área de resultados de archivo. Selecciona deliberadamente una plantilla de feed personalizada para cada tarjeta y verifica que contenga los campos que necesita el visitante.

Cuando faceted_search="yes", añade facetas y controles para el mismo contexto. Elige el envío automático o manual y decide si la lista sin filtrar debe ser visible.

Solo se renderiza el contenido público, publicado y sin protección por contraseña permitido por los permisos del tipo de contenido actual. Las selecciones explícitas vacías, las consultas eliminadas y las intersecciones relacionadas vacías no producen alternativas no relacionadas. El modo de contexto actual requiere una petición real de archivo/búsqueda. Los tamaños de página definidos, las consultas de todos los resultados y las selecciones de IDs en orden se conservan, incluso durante la paginación por AJAX. El modo dividido de relacionados agrupa todos los resultados relacionados coincidentes sin paginadores independientes; usa el modo mixto para paginar. La expansión recursiva de tarjetas permanece acotada sin truncar una colección ordinaria de nivel superior.

Los valores de separación de cuadrícula minimal, small, medium y none aplican los helpers de relleno por lado existentes de 0.375rem, 0.75rem, 1.25rem y cero. Masonry conserva su escala de separación Isotope existente. Los cuatro anchos de columna, el espaciado y la visibilidad se mantienen coherentes en las páginas AJAX posteriores. Los IDs explícitos identifican el listado, no sus clases.

El equivalente Listings block usa el mismo renderizador y los mismos recursos. La administración heredada puede desactivarse sin desactivar el renderizado público del shortcode. La paginación admite el almacenamiento en caché de HTML estático de páginas sin un nonce de visitante que caduque. Los paginadores almacenados en caché previamente se recuperan desde una página pública de referencia cuando su configuración guardada actual es identificable, incluyendo listados múltiples, contenido publicado incluido explícitamente, patrones sincronizados y widgets nativos de texto/bloque. Se aceptan duplicados equivalentes. Los paginadores antiguos de contexto archivado/dividido, las plantillas suministradas dinámicamente, los listados indistinguibles o la ausencia de páginas de referencia del mismo sitio requieren HTML de página nuevo. Las consultas proporcionadas por el navegador y las rutas de plantilla nunca se ejecutan. No es necesaria ninguna migración de shortcodes almacenados.

Comportamiento de la consulta guardada

Una consulta personalizada existente con un tamaño de página vacío, cero u omitido usa 100 resultados a menos que el shortcode proporcione una sustitución. Las fuentes de últimas entradas conservan su valor predeterminado de 12 resultados; la salida dividida de relacionados tiene su propio comportamiento de todos los resultados. Las filas históricas del selector de taxonomía usan cualquier término seleccionado dentro de una taxonomía y requieren todos los grupos de taxonomía seleccionados. Las consultas de taxonomía estructuradas explícitamente conservan sus propias condiciones AND/OR anidadas.

URL canónicas para páginas numeradas

Una página que contiene un shortcode nativo web_listings con enable_pagination="yes" usa su URL numerada como canónica en la página 2 y posteriores. Por ejemplo, /projects/page/2/ permanece distinta de /projects/. Esto se aplica a la salida canónica de WordPress, Rank Math y Yoast. Una canónica explícita que apunte a otro recurso se conserva.

El listado debe participar en la paginación normal de la página: prevent_pagination="yes" y faceted_search="yes" quedan excluidos. Los bloques Listings nativos equivalentes en la página guardada, incluidos los bloques anidados, también conservan canónicas numeradas. Los listados incluidos indirectamente mediante patrones sincronizados o plantillas externas quedan fuera de esta detección. Los bloques divididos de relacionados no exponen páginas numeradas independientes.

Después de guardar, abre la primera página y una página numerada. Comprueba que los resultados cambian e inspecciona el enlace canónico de cada página en el código fuente HTML. Los formatos de cadena de consulta y de enlaces permanentes bonitos siguen la configuración de enlaces permanentes de WordPress del sitio.

La paginación estándar sin AJAX asigna a sus enlaces de flecha los nombres traducidos «Previous page» y «Next page». Comprueba ambas flechas en una página intermedia con un teclado o un lector de pantalla; sus iconos siguen siendo decorativos y los destinos siguen las mismas URL de paginación de WordPress.

Verificación

Prueba web_listings con conjuntos de resultados con contenido, vacíos y extensos, y verifica que la fuente seleccionada pertenezca al sitio actual. Presta especial atención a query_type y single_post.

Shortcode `web_fsearch_submit`
Anterior
Shortcode `web_search_gateway`
Siguiente