FacetWP – Blocks

FacetWP Blocks: Optimiza tus Listas de Publicaciones en WordPress

FacetWP Blocks transforma la forma en que gestionas las listas de publicaciones en tu sitio de WordPress. Esta poderosa adición te permite implementar filtros de facetas junto a bloques de WordPress compatibles, proporcionando una experiencia más rica y dinámica a los usuarios. En este artículo, exploraremos a fondo cómo configurar y utilizar FacetWP Blocks, además de resolver algunas dudas comunes.

¿Qué Son los FacetWP Blocks?

Los FacetWP Blocks son extensiones que permiten a los desarrolladores mostrar listas de publicaciones en WordPress y aplicarlas a través de facetas. Estas facetas son filtros que posibilitan al usuario refinar su búsqueda según diferentes criterios, como categorías, etiquetas, precios, y más. Esto no solo mejora la navegación en el sitio, sino que también incrementa la usabilidad y retención de visitantes.

Bloques Soportados por FacetWP

FacetWP es compatible con una variedad de bloques de WordPress, lo que amplía su funcionalidad al permitir que los desarrolladores creen listas dinámicas. Algunos de los bloques más destacados incluyen:

• WordPress Query Loop Posts List: Muestra las publicaciones más recientes.
• WooCommerce Products (Beta): Ideal para listar productos en un sitio de comercio electrónico.
• Stackable Posts: Permite organizar la información fácilmente.
• Spectra Post Grid y Loop Builder: Geniales para diseños de cuadrícula personalizados.

Esta compatibilidad ofrece un amplio rango de opciones para crear experiencias de usuario adaptadas a diferentes necesidades y estilos de diseño.

Requisitos y Configuración Inicial

Para que FacetWP funcione sin problemas, se recomienda utilizar WordPress en su versión 6.2.3 o superior, y asegurar que el Editor de Bloques (Gutenberg) esté activo. Si tu sitio está utilizando el editor clásico o cualquier plugin que desactive Gutenberg, no podrás aprovechar las funciones de FacetWP Blocks.

Cómo Configurar FacetWP Blocks

1. Instalación del Add-on: Descarga el complemento de FacetWP Blocks desde tu página de cuenta, instálalo y actívalo. Esto permitirá que el sistema reconozca los bloques compatibles.

2. Agregar Bloques al Editor: Accede a una página nueva o existente en el Editor de Bloques y elige un bloque soportado. Una vez añadido, podrás ver la opción “Habilitar FacetWP” en la configuración del bloque en la barra lateral derecha. Activa esta opción para permitir que FacetWP filtre dinámicamente la lista de publicaciones.

3. Implementación de Facetas: Puedes añadir las facetas utilizando bloques de shortcode, asegurándote de que cada faceta tenga su bloque individual. Asimismo, puedes agregar la paginación y clasificación según sea necesario.

4. Personalización de Mensajes: Tanto el mensaje de “Nada encontrado” como el contenido del bloque No Resultados son personalizables. Esto permite que puedas ofrecer un mensaje más adecuado al contexto de tu sitio.

Configuración Avanzada y Personalización

Usando FacetWP en Plantillas de Archivo

Si deseas utilizar bloques soportados en plantillas de archivo, asegúrate de habilitar la opción “Heredar consulta desde la plantilla” en los bloques que lo permitan. Esto es crucial para que las consultas funcionen correctamente.

Ignorar Consultas de Archivo

Si necesitas usar un bloque en una plantilla de archivo y deseas que FacetWP ignore dicha consulta, puedes hacerlo mediante el hook facetwp_is_main_query. Agrega el siguiente código al archivo functions.php de tu tema hijo:

php
add_filter('facetwp_is_main_query', function($is_main_query, $query) {
if ($query->is_archive() && $query->is_main_query()) {
$is_main_query = false;
}
return $is_main_query;
}, 10, 2);

Esto permite que la consulta del bloque se ejecute en lugar de la consulta de archivo de WordPress.

Manejo de la Paginación

FacetWP Blocks permite la utilización de facetas de paginación y ordenación. Sin embargo, los bloques de paginación por separado generalmente no son compatibles. Por ejemplo, si estás usando el bloque de Productos de WooCommerce, es necesario eliminar cualquier bloque de paginación que se añada automáticamente y que interacciones con FacetWP.

Estructura y Anidamiento de Bloques

Los bloques que utilizan una estructura de tipo “Query Loop” son bloques anidados que permiten una personalización profunda. Al usar estas estructuras, puedes diseñar cómo se muestran las publicaciones individualmente, lo que proporciona una gran flexibilidad.

Los bloques soportados, como el Query Loop de WordPress y los bloques de Posts de Stackable, permiten un gran control sobre la distribución del contenido.

Mensaje de No Resultados Personalizado

Si no hay resultados que mostrar, puedes personalizar el mensaje predeterminado “Nada encontrado”. Para bloques del tipo Query Loop de WordPress, es posible reemplazar este mensaje con un bloque No Resultados que contenga un contenido personalizado, dándole una apariencia más profesional.

Ejemplo de Uso de PHP Personalizado

Para personalizar aún más tus bloques y su funcionamiento, puedes inyectar código PHP en el archivo functions.php de tu tema. Esto permite ajustes finos según sea necesario y ofrece más control sobre cómo se gestionan las consultas y se muestran los resultados.

Personalizando la Consulta de Bloques

Por ejemplo, para limitar cuántas publicaciones se muestran en un bloque de publicaciones más recientes, puedes usar:

php
add_action('pre_get_posts', function($query) {
if (is_page(123) && $query->get('facetwp') === true) {
$query->set('posts_per_page', 9);
}
}, 11);

Esto se ejecutará solamente en una página específica y solo si FacetWP está habilitado, garantizando un funcionamiento óptimo.

Características Especiales y Limitaciones

Es importante tener en cuenta algunas limitaciones y problemas conocidos que pueden surgir al usar facetas. Por ejemplo, si se usa un patrón de diseño con múltiples Query Loops, FacetWP solo funcionará correctamente si hay un único bucle de consulta habilitado.

Resumen de Beneficios

Implementar FacetWP Blocks ofrece una serie de ventajas significativas. Primero, permite que las listas de publicaciones de WordPress sean dinámicas y personalizables gracias a las facetas, lo que mejora la experiencia del usuario. Segundo, la extensión ofrece un nivel de control y personalización que es difícil de alcanzar con otras soluciones.

Con FacetWP Blocks, puedes construir una interface de usuario más eficiente, fomentar la interacción y hacer que los usuarios encuentren más fácilmente lo que buscan en tu sitio. Si quieres poner todo esto en práctica, ¡es hora de llevar tu WordPress al siguiente nivel con FacetWP Blocks!