Developers

Shortcode

[sieve]

Renderiza un filtro completo y autónomo: facetas, cuadrícula de resultados, ordenación, chips de filtros activos y paginación. Lee el estado actual de los filtros desde la URL (sf_* query vars), por lo que el primer renderizado es del lado del servidor y se puede compartir.

Bloque

El bloque Sieve Filter (sieve/filter) es un bloque dinámico que renderiza el mismo widget que el shortcode. Añádelo desde el insertador de bloques.

Estado en la URL

El estado de los filtros se guarda en la URL, de modo que se puede marcar como favorito y usar el botón de retroceso con seguridad:

• sf_<facet> - los valores seleccionados de una faceta (separados por comas, min-max para un rango).
• sf_q - la consulta de búsqueda.
• sf_orderby - el orden de clasificación.
• sf_paged - la página actual.

REST API

POST /wp-json/sieve/v1/filter

Endpoint público de solo lectura que impulsa el filtrado AJAX. Body: { "query": { "sf_product_cat": "hoodies", "sf_orderby": "price" } }. Devuelve los fragmentos renderizados (facets_html, toolbar_html, results_html, pagination_html), el número de resultados y found. El frontend los sustituye en su lugar.

Endpoints de administración (capacidad manage_woocommerce):

• GET/POST /wp-json/sieve/v1/settings - leer o guardar la configuración de las facetas.
• GET /wp-json/sieve/v1/catalog - las fuentes de facetas descubiertas automáticamente.
• POST /wp-json/sieve/v1/reindex - reconstruir el índice.

Hook de extensión

Sieve dispara una acción tras arrancar, de modo que una extensión puede registrar servicios adicionales en el contenedor compartido:

add_action( 'sieve/booted', function ( \Sieve\Plugin $plugin ) {
    // Extend the container or register your own hooks.
} );