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

1. Instala el plugin

  1. Descarga el plugin (archivo ZIP). No lo descomprimas.
  2. En el escritorio de WordPress ve a Plugins → Añadir nuevo plugin → Subir plugin, elige el ZIP y pulsa Instalar ahora.
  3. 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ó.

No compartas la dirección del feed
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:

Koply lee el feed e indexa tu catálogo. Con unos cientos de productos tarda pocos minutos.

El dominio debe coincidir
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.

El aspecto del buscador se gestiona desde Koply: colores, idioma, textos y CSS propio están en Personalización. No hace falta tocar WordPress para cambiarlos.

6. Comprueba que funciona

  1. Abre tu tienda y escribe al menos dos letras en el buscador. Deben aparecer los resultados de Koply mientras escribes.
  2. En Koply, Sitios → Código de integración te dice cuándo llega la primera búsqueda.
  3. 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.

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.