Integración
WooCommerce
Plugin oficial de Koply para WooCommerce. Genera el feed de producto, añade el buscador a tu tienda y registra los pedidos, sin tocar código ni cambiar de tema.
Requisitos
- WordPress 6.3 o superior y WooCommerce 8.0 o superior
- PHP 7.4 o superior
- Una cuenta en koply.eu (el plan Free es gratuito de forma permanente)
Qué hace el plugin
- Genera tu feed de producto en formato Google Shopping y lo mantiene al día: se regenera cada hora si cambia el catálogo y, como mínimo, una vez al día. No necesitas otro plugin de feeds.
- Carga el widget de Koply en el campo de búsqueda de tu tienda.
- Añade al carrito desde los resultados con el carrito de WooCommerce. El mini-carrito se actualiza solo, también el del bloque de carrito.
- Registra los pedidos para que veas en Koply los ingresos que llegan tras una búsqueda. Viene activado.
1. Instala el plugin
- Descarga el plugin (archivo ZIP). No lo descomprimas.
- En el escritorio de WordPress ve a Plugins → Añadir nuevo plugin → Subir plugin, elige el ZIP y pulsa Instalar ahora.
- Pulsa Activar plugin.
El plugin añade la página WooCommerce → Koply Search, con los tres pasos de la conexión. De momento su interfaz está en inglés.
2. Copia la dirección de tu feed
En WooCommerce → Koply Search, el primer bloque (Your product feed) muestra la dirección del feed, con este aspecto:
https://tutienda.com/?koply-feed=8f3kQ…
Pulsa Copy. El plugin genera el feed en segundo plano en cuanto lo activas; si tienes prisa, pulsa Generate now. Debajo verás cuántos productos incluye y cuándo se generó.
Lleva una clave secreta: quien la tenga puede descargar tu lista de productos. Si se filtra, pulsa Change address para crear otra y pega la nueva en tu sitio de Koply.
Qué entra en el feed
| Dato | De dónde sale |
|---|---|
| Productos | Los publicados y visibles en la tienda o en la búsqueda: simples, variables, agrupados y externos. Los ocultos no entran. |
| Precio y oferta | Los que ve el cliente, con o sin IVA según los ajustes de impuestos de WooCommerce. En los productos variables, el precio más bajo de sus variaciones. |
| Imagen | La imagen principal del producto. Un producto sin precio o sin imagen se deja fuera y la página del plugin lo indica. |
| Categorías | Todas las del producto, con su jerarquía (Ropa > Camisetas). |
| Marca | La taxonomía de marcas de WooCommerce o la de los plugins de marcas más comunes; si no hay, un atributo marca o brand. |
| Stock | Disponible, agotado o en reserva. Los agotados se muestran como agotados; puedes excluirlos en los ajustes. |
| SKU | Se añade a la descripción para que se pueda buscar por referencia. |
3. Crea tu sitio en Koply
Crea tu cuenta y, en Sitios → Nuevo sitio, rellena:
- Dominio: el de tu tienda, el mismo que aparece en el bloque Create your site in Koply del plugin.
- URL del feed: la dirección que copiaste en el paso 2.
Koply lee el feed e indexa tu catálogo. Con unos cientos de productos tarda pocos minutos.
El dominio de tu sitio en Koply tiene que ser el mismo desde el que se carga la tienda. Si no coincide, Koply rechaza las búsquedas.
4. Pega la API key en el plugin
En Koply, abre Sitios → Código de integración y copia el valor de apiKey. En WordPress, pégalo en WooCommerce → Koply Search → Settings → API key y guarda.
El bloque Connect this store te dice cómo ha ido:
| Mensaje | Qué significa |
|---|---|
| Connected | Todo listo: el buscador de Koply ya funciona en tu tienda. |
| The site is not active yet | La clave es correcta, pero Koply aún está indexando el feed o el sitio está en pausa. Espera unos minutos y pulsa Check again. |
| Koply does not recognise this API key | La clave no es correcta. Vuelve a copiarla desde Sitios → Código de integración. |
5. Activa «Añadir al carrito»
En Koply, ve a Personalización, activa el botón de carrito y elige WooCommerce como plataforma. El plugin te avisa si falta este paso.
Los productos simples se añaden al carrito sin salir de la página. Los que necesitan elegir opciones (variables o agrupados) abren su ficha. Si en los ajustes de WooCommerce tienes activado que el cliente vaya al carrito después de añadir un producto, el plugin lo respeta.
6. Comprueba que funciona
- Abre tu tienda y escribe al menos dos letras en el buscador. Deben aparecer los resultados de Koply mientras escribes.
- En Koply, Sitios → Código de integración te dice cuándo llega la primera búsqueda.
- Si el buscador no se abre, tu tema puede usar un campo de búsqueda distinto de
input[type=search]. Indica su selector CSS en Settings → Search field o en Personalización.
Pedidos
Con Settings → Orders activado (lo está al instalar), la página de pedido recibido envía a Koply el número de pedido, el total, la moneda y, de cada línea, el producto, la cantidad y el precio unitario con IVA. No se envía ningún dato del comprador: ni nombre, ni email, ni dirección.
No tienes que configurar identificadores: el feed, los clics y los pedidos usan el mismo ID de producto de WooCommerce, así que Koply atribuye cada venta a la búsqueda que la originó. Los pedidos fallidos, cancelados o reembolsados no se envían, y recargar la página de confirmación no duplica nada. Cómo se calculan las cifras está en Registrar pedidos.
Ajustes del plugin
| Ajuste | Qué hace |
|---|---|
API key |
La clave de tu sitio en Koply. Sin ella el plugin no carga nada en la tienda. |
Search widget |
Activa o desactiva el buscador de Koply. Desactivarlo también detiene el registro de pedidos. |
Search field |
Selector CSS del campo de búsqueda. Vacío, se usa el de Koply (por defecto, el primer input[type=search]). |
Add to cart |
Añade al carrito de WooCommerce desde los resultados. |
Orders |
Envía los pedidos a Koply para medir los ingresos del buscador. |
Measurement consent |
Medir siempre, o esperar al consentimiento de tu banner de cookies (ver abajo). |
Product feed |
Incluir los productos agotados y listar cada variación (talla, color…) como un resultado aparte. Cada variación cuenta como un producto en el límite de tu plan. |
Cookies y consentimiento
El widget no pone cookies. Guarda un identificador aleatorio en el navegador durante 24 horas para unir la búsqueda con el clic y el pedido que vienen después. Si quieres que espere al consentimiento, elige Wait for consent from my cookie banner: la búsqueda funciona igual y la medición empieza cuando el visitante acepta.
- Si tu banner es compatible con la WP Consent API (por ejemplo, Complianz), el plugin lo detecta solo: basta con que el visitante acepte la categoría de estadísticas.
- Con otros banners, llama a
Koply.setConsent(true)cuando el visitante acepte.
Más detalle y un texto para tu política de cookies en Privacidad, cookies y consentimiento.
Temas con su propio carrito
Si tu tema añade al carrito a su manera, desactiva el del plugin en Settings → Add to cart y escucha el evento koply.cart.add:
document.addEventListener('koply.cart.add', function (event) {
var productId = event.detail.entity_id; // ID de producto de WooCommerce
var qty = event.detail.qty || 1;
// la lógica de tu tema
});
Para desarrolladores
El plugin expone filtros de WordPress para adaptarlo sin modificarlo:
| Filtro | Para qué sirve |
|---|---|
koply_feed_query_args |
Qué productos entran en el feed (argumentos de wc_get_products()). |
koply_feed_item |
Los datos de cada producto antes de escribirlo en el feed. |
koply_widget_config |
La configuración del widget (window.KoplyConfig). Lo que añadas tiene prioridad sobre el panel. |
koply_load_widget |
No cargar el buscador en una página concreta. |
koply_order_payload |
El pedido que se envía a Koply. |
koply_consent_category |
La categoría de la WP Consent API que autoriza la medición (por defecto, statistics). |
Sin el plugin
Si prefieres no instalarlo, Koply también funciona con un feed que ya generes (por ejemplo, el de Google Shopping) y el fragmento de código del panel pegado antes de </body>. Los pasos están en la guía rápida y el registro de pedidos, en Registrar pedidos.
¿Todavía comparas opciones? Qué mejora Koply en la búsqueda de WooCommerce.