Añadir el buscador AJAX de YITH WooCommerce en tu plantilla (con una línea de código)
Hola, amigos de Piensa para Crear. 👋
Si tienes una tienda online en WooCommerce, sabes que el buscador es una de las herramientas más importantes para tus clientes. Un cliente que no encuentra lo que busca, se va a la competencia.
Hoy quiero hablarte de una solución que mejora muchísimo la experiencia de búsqueda: el plugin YITH WooCommerce Ajax Search. Y lo mejor: puedes insertarlo en cualquier parte de tu plantilla con una sola línea de código.
En este tutorial te explico cómo funciona, dónde conseguir el plugin y cómo insertarlo paso a paso.
🧠 ¿Qué es YITH WooCommerce Ajax Search?
Es un plugin gratuito que reemplaza el buscador estándar de WooCommerce por uno con búsqueda en tiempo real (AJAX) .
¿Qué significa "AJAX"? Que mientras el usuario escribe, los resultados aparecen sin recargar la página. Es el mismo sistema que usa Amazon o Mercado Libre: escribes "cami" y ya ves las camisetas disponibles.
Ventajas principales:
Búsqueda instantánea: resultados en tiempo real.
Personalizable: puedes configurar colores, tamaños y qué información mostrar (título, precio, imagen, SKU, etc.) .
Integración con el catálogo: busca en productos, categorías, etiquetas y atributos .
📦 Paso 1: Instalar el plugin
Ve a Plugins → Añadir nuevo en tu WordPress.
Busca "YITH WooCommerce Ajax Search".
Importante: Para que el plugin funcione, la REST API de WordPress no debe estar bloqueada. Si usas algún plugin de seguridad que la bloquee, necesitas permitir el endpoint ywcas/v1/ .
🛠️ Paso 2: Insertar el buscador en tu plantilla
YITH ofrece tres formas de insertar el buscador :
Widget: desde Apariencia → Widgets, busca "YITH WooCommerce Product Search".
Shortcode en el editor: escribe
[yith_woocommerce_ajax_search]en cualquier entrada o página.Código PHP en la plantilla: esta es la opción que te explico ahora.
📄 El código
Inserta esta línea exactamente donde quieras que aparezca el buscador:
<?php echo do_shortcode('[yith_woocommerce_ajax_search]');?>¿Qué hace cada parte?
<?php ?>: abre y cierra el bloque de PHP.echo: imprime el resultado en pantalla.do_shortcode(): función de WordPress que procesa el shortcode y lo convierte en el formulario real .'[yith_woocommerce_ajax_search]': el shortcode del plugin YITH.
📍 ¿Dónde ponerlo?
Depende de dónde quieras el buscador:
| Ubicación | Archivo de plantilla |
|---|---|
| Cabecera | header.php |
| Barra lateral | sidebar.php |
| Pie de página | footer.php |
| Página de tienda | archive-product.php |
| Cualquier plantilla | El archivo .php correspondiente |
🧩 Paso 3: Ejemplo práctico en header.php
Imagina que quieres el buscador debajo del logo, en la cabecera de tu tienda:
<div class="site-branding"> <?php the_custom_logo(); ?> </div> <div class="buscador-yith"> <?php echo do_shortcode('[yith_woocommerce_ajax_search]');?> </div>
Guardas el archivo, recargas tu tienda, y el buscador aparece justo ahí.
🎨 Personalizar el diseño
YITH Ajax Search permite personalizar casi todo desde su panel de configuración :
Placeholder: el texto que aparece dentro del buscador.
Colores: fondo, borde, texto, placeholder.
Bordes: tamaño y radio.
Botón de búsqueda: icono, texto, o ambos.
Resultados: qué mostrar (título, precio, imagen, SKU, stock, categorías) .
"View all results": enlace a la página completa de resultados.
¿Dónde configurar? Ve a YIT Plugins → Ajax Search en tu panel de WordPress.
⚠️ Consideraciones importantes
1. El plugin NO reemplaza tu buscador actual automáticamente
YITH Ajax Search no sustituye el buscador nativo de tu tema. Si lo insertas con el shortcode, tendrás dos buscadores .
Solución: Si quieres reemplazar el buscador del tema, necesitas editar la plantilla y eliminar el código del buscador original, dejando solo el de YITH.
2. Rendimiento
El buscador AJAX carga resultados en tiempo real, lo que consume más recursos que un buscador normal. En tiendas muy grandes (miles de productos), asegúrate de que tu hosting tenga buenos recursos.
3. Compatibilidad con temas
Funciona con cualquier tema de WordPress, pero si tu tema tiene un buscador muy personalizado, puede haber conflictos de estilos. En ese caso, añade CSS personalizado.
4. REST API
Como mencioné antes, el plugin necesita que la REST API de WordPress esté accesible. Si usas plugins de seguridad (Wordfence, iThemes Security), verifica que no bloqueen el endpoint ywcas/v1/ .
🎯 Conclusión: búsqueda profesional con una línea
YITH WooCommerce Ajax Search es una de las mejores formas de mejorar la experiencia de búsqueda en tu tienda. Y lo mejor: insertarlo en tu plantilla es tan simple como pegar:
<?php echo do_shortcode('[yith_woocommerce_ajax_search]');?>Resumen del proceso:
Instala y activa el plugin.
Configura el diseño desde YIT Plugins → Ajax Search.
Pega el código donde quieras el buscador.
Prueba en tu tienda.
Si prefieres no tocar código, usa el widget o el shortcode desde el editor.
💬 ¿Necesitas ayuda para personalizar el buscador de tu tienda o integrarlo con tu tema?
En Piensa para Crear ofrecemos servicios de personalización, desarrollo y optimización para tiendas online.
Contáctanos aquí y hablemos.
❓ Preguntas frecuentes
¿Dónde pongo el código?
En el archivo de plantilla de tu tema hijo donde quieras que aparezca: header.php, sidebar.php, footer.php, etc.
¿Necesito un tema hijo?
Sí, es muy recomendado. Si editas el tema padre, perderás los cambios al actualizar.
¿Puedo usar esto sin tocar código?
Sí. YITH ofrece un widget y un shortcode que puedes usar desde el editor o desde Apariencia → Widgets .
¿El plugin reemplaza mi buscador actual?
No automáticamente. Tendrás dos buscadores si no eliminas el original de tu tema .
¿Es gratis?
Sí, la versión gratuita incluye búsqueda AJAX, personalización básica y funciona perfectamente para tiendas pequeñas y medianas .
¿Funciona en móvil?
Sí, el diseño es 100% mobile-friendly .
¿Qué pasa si mi REST API está bloqueada?
El plugin no funcionará. Necesitas permitir el endpoint ywcas/v1/ en tu plugin de seguridad .
Comentarios
Publicar un comentario