Shortcode web_finder
El shortcode web_finder muestra un formulario de búsqueda con la consulta, los campos y la configuración de resultados actuales. La familia Finder de Gutenberg usa el mismo renderizador y los mismos recursos; ninguno de los dos requiere que la búsqueda facetada esté activada.
Los atributos siguientes coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis sin procesar solo para contenido revisado que no pueda mantenerse mediante los controles visuales.
Shortcodes secundarios permitidos: web_finder_content.
Uso
[web_finder]
Content
[/web_finder]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
web_finder_action |
— | Cadena salvo que se indique lo contrario | La página que se abre al enviar el formulario. Déjalo en blanco para volver a cargar la página actual. Este ajuste no se usa cuando AJAX está activado. |
web_auto_submit |
— | yes |
Indica si el formulario debe enviarse automáticamente cada vez que se actualiza un campo. |
web_finder_ajax |
— | yes |
Cuando AJAX está activado, no es necesario volver a cargar la página. |
web_finder_ajax_show_default_results |
— | yes |
Si está marcada, los resultados de búsqueda se mostrarán al cargar la página. Disponible cuando web_finder_ajax es yes. |
web_finder_ajax_loading_img |
Vacío; texto de carga | URL de medio | Imagen que se muestra antes de cargar los resultados. Disponible cuando web_finder_ajax es yes. |
web_finder_ajax_button_style |
1 |
1 o un slug de estilo de botón configurado |
Selecciona el estilo del botón Cargar más. Disponible cuando web_finder_ajax es yes. |
web_finder_ajax_button_text |
Load more results |
Cadena salvo que se indique lo contrario | Texto personalizado para el botón Cargar más. Disponible cuando web_finder_ajax es yes. |
taxonomy_relation |
OR |
OR, AND |
Especifica la relación entre taxonomías. Esto no solo tiene en cuenta las elegidas en el módulo de taxonomía, sino que también incluye las especificadas en la consulta seleccionada. |
web_query |
1 |
Cadena salvo que se indique lo contrario | Puedes crear nuevas consultas desde la sección Consultas personalizadas en los ajustes del Theme. |
device_visibility |
— | Cadena salvo que se indique lo contrario | Aplica la regla de visibilidad adaptable seleccionada. |
el_id |
— | ID HTML único y válido | Introduce el ID del elemento (Nota: asegúrate de que sea único y válido según la especificación w3c). |
el_class |
— | Cadena salvo que se indique lo contrario | Si quieres dar un estilo diferente a un elemento de contenido concreto, usa este campo para añadir un nombre de clase y después haz referencia a él en tu archivo CSS. |
Contenido incluido
El contenido entre las etiquetas de apertura y cierre se procesa como contenido de shortcode de WordPress. Mantén la estructura padre/hijo mostrada por el constructor visual para que los componentes anidados reciban el contexto que esperan.
Composición del Finder
Esta etiqueta pertenece a la familia de componentes Finder. Conserva su anidación generada de padre, fila, columna y campos al editar contenido de shortcode sin procesar.
Verificación
Rellena web_finder con web_finder_row y confirma que cada elemento secundario siga siendo accesible en el orden previsto. Presta especial atención a web_finder_action y web_auto_submit.
Comportamiento compartido y límites
Usa un campo de resultados y hasta 50 controles por Finder. Una acción en blanco usa POST; un destino usa GET y debe contener un ID de Finder coincidente. AJAX siempre actualiza el formulario actual. Las URL compartidas pueden preseleccionar campos creados sin form_submit. Un form_id proporcionado debe coincidir con el Finder de destino. Varios formularios permanecen aislados; los ID deben ser únicos por página. La ordenación, los filtros y el tamaño de página se validan con respecto a los campos creados.
Solo se devuelve contenido público actual, publicado y sin contraseña permitido por los permisos de tipo de entrada del visitante. Se conservan los tamaños de página de las consultas guardadas y las selecciones de todos los resultados. Los controles de tamaño de página aceptan solo enteros positivos creados o -1 para todos los resultados. Las selecciones públicas de taxonomía y autor no se truncan en 200; los números de página permanecen limitados a 1.000. Las consultas que faltan fallan de forma segura. La retroalimentación de carga, vacío y error usa el marcado existente del theme. Un Finder básico no carga recursos de galería/carrusel; las dependencias de campos y resultados permanecen condicionales con la administración del Page Builder activada o desactivada.
Las páginas públicas de Finder admiten el almacenamiento en caché de HTML estático. Su configuración firmada no tiene caducidad basada en tiempo ni en sesión del visitante; cada solicitud AJAX sigue comprobando la consulta guardada actual y los permisos de contenido. Mantén las respuestas AJAX fuera de la caché de página. Purga una página al cambiar sus campos creados o el diseño de resultados para que los visitantes reciban esos cambios.
Los formularios WPAS previamente almacenados en caché pueden recuperarse desde una página publicada con un referrer del mismo sitio, incluidos formularios múltiples identificables y formularios en contenido publicado incluido explícitamente, patrones sincronizados o widgets nativos de texto/bloque. Se aceptan configuraciones duplicadas equivalentes. Los formularios que no pueden distinguirse de sus antiguos campos guardados e identidad de consulta, las fuentes solo de archivo, los widgets generados dinámicamente o los referrers retenidos requieren HTML de página nuevo. Las fuentes protegidas siguen sin estar disponibles. Las matrices de consulta y las rutas de plantilla proporcionadas por el cliente nunca se ejecutan. No se requiere migración de base de datos ni cambio de nombre de shortcodes. El diseño de resultados y las columnas pertenecen a web_finder_content_results_field, no a este elemento padre.
Cuando Relevanssi está activo, las búsquedas de texto conservan el manejo de consultas de ese proveedor. El hook wpas_response_filter recibe la matriz de resultados, el WP_Query actual y los valores de solicitud validados. Las respuestas contienen tarjetas renderizadas y metadatos públicos de resultados; las extensiones no deben añadirles objetos de consulta, datos privados ni rutas de plantilla ejecutables.
Los campos heredados de radio y casilla de verificación conservan las clases de grupo/contenedor de WPAS y la estructura adyacente de entrada/etiqueta para el CSS existente del sitio. Las etiquetas de campo en blanco no crean un encabezado genérico visible. Las opciones de taxonomía conservan los ancestros con descendientes coincidentes. Los resultados iniciales de WooCommerce conservan los filtros de visibilidad de catálogo sin añadir una condición de taxonomía vacía.