Shopware 6

Get Started

Conectando tu Tienda #

El primer paso para instalar Clerk.io es conectar tu tienda con tu cuenta de Clerk.io.

El video a continuación te muestra lo que debes hacer, paso a paso. Usa el resto de la guía como referencia :)

Después de seguir estos sencillos pasos, podrás ver tu Live Demo Store, que te dará una visión personalizada de cómo funcionará Clerk.io en tu tienda online. Comunícate con tu persona de contacto en Clerk.io para ver el Live Demo.

1. Añadir Tienda #

  1. Inicia sesión en my.clerk.io. La primera vez que lo hagas, verás la página de Añadir Nueva Tienda.

  2. Escribe el Nombre y Dominio de tu tienda online.

  3. Elige Shopware 6 como la Plataforma y selecciona tu Moneda.

  4. Haz clic en Add Store.

2. Instalar y configurar el plugin #

Para Shopware v6.4 y posteriores, el plugin puede instalarse desde la Shopware Extension Store o subiéndolo manualmente desde GitHub.

Opción A: Instalar desde Extension Store

  1. En tu panel de administración de Shopware, ve a Extensions > Store y busca “Clerk”.
  2. Haz clic en Add extension para instalar.

Opción B: Instalar manualmente desde GitHub

Si el plugin no está disponible en la Shopware Extension Store, puede descargarse desde GitHub y subirse manualmente.

  1. Ve a Clerk Shopware 6.4 plugin releases en GitHub y descarga el último archivo .zip.
  2. En tu panel de administración de Shopware, ve a Extensions > My extensions.
  3. Haz clic en Upload extension y selecciona el archivo .zip descargado.
  4. Una vez subido, haz clic en Install y después activa el plugin.

Para Shopware v6.3 y anteriores:

  1. Descarga el plugin: Releases for v6.3 and earlier.
  2. En tu panel de administración de Shopware, ve a Settings > System > Plugins.
  3. Haz clic en Upload plugin, elige el archivo descargado, luego ... > Install y activa.

Configura el plugin:

  1. Haz clic en ... > Config. en el plugin Clerk.
  2. Selecciona el Sales Channel correcto.
  3. En General, establece Status como Enabled.
  4. Ingresa tu Public Key y Private Key, luego haz clic en Save.

Ubicación de las claves: Tu Public Key y Private Key están en my.clerk.io > Developers > API Keys.

3. Sincroniza tus datos #

Sincronizar datos conecta tu tienda Shopware 6 con Clerk, permitiendo que Clerk acceda a tus productos, pedidos, clientes y otra información de la tienda. Esto permite que Clerk proporcione recomendaciones personalizadas y resultados de búsqueda basados en los datos reales de tu tienda. Sigue los pasos en la guía de Sync Data para configurar la sincronización de datos.

Configuraciones headless #

Para instalaciones headless de Shopware, crea un Sales Channel Storefront oculto con los mismos idiomas y monedas que tu tienda principal. Clerk utiliza el canal Storefront para resolver referencias de idiomas y monedas durante la sincronización.

  • Crea un Sales Channel Storefront y mantenlo oculto de la navegación.
  • Agrega todos los idiomas y monedas que usa tu tienda headless.
  • Selecciona este Sales Channel Storefront en la configuración del plugin Clerk al configurar la sincronización.

Esto asegura que todas las referencias de idioma y moneda estén disponibles para que la sincronización de datos se complete correctamente.

Para más detalles sobre cómo crear y configurar Sales Channels, consulta la documentación de Shopware: Sales Channel settings.

Múltiples idiomas #

Shopware utiliza Language IDs para identificar cada idioma único en la tienda. Estas no son visibles en el backend de Shopware, así que deben encontrarse a través del HTML del frontend.

Mira este video para ver cómo identificar los Language IDs.

La mejor manera de manejar múltiples idiomas en Clerk es crear Stores únicos para cada idioma y sincronizarlos con el Language ID correcto.

De esta manera, puedes separar productos, ventas, monedas, etc. para llevar un control de cada idioma.

  1. Comienza creando tu main Store y sigue la Guía de Configuración para conectar tu Store a Clerk.io, y elige los Recommendations y/o Search Results que deseas mostrar en tu tienda online.

  2. Cuando hayas terminado la configuración inicial, vuelve a la página de inicio de my.clerk.io (haciendo clic en el logo de Clerk.io en la esquina superior izquierda del menú lateral) y luego haz clic en "+ Add new store", la última opción de la lista desplegable (generalmente debajo de tus tiendas existentes y de tu nombre de empresa):

3. En la página Add New Store, haz clic en Advanced para ver todas las configuraciones.

  1. Completa los detalles de tu tienda y elige tu Store principal desde el menú desplegable Copy Elements From Existing Store, luego haz clic en Add Store. Esto transferirá los Elements y Designs desde tu Store principal.

  2. Ahora puedes seguir la Guía de Configuración nuevamente para activar Clerk.io haciendo clic en Getting Started, para Sync Data para este idioma. Recuerda usar el correct Language ID como se describe en el video al inicio de la guía. La Store URL, Access Key, y Secret Access Key serán las mismas para todas las Stores.

  3. Cuando el Data Sync haya terminado, tu tienda online estará lista y utilizará la misma configuración que tu Store principal.

  4. Recuerda traducir los Headlines, en Element-> Edit -> Select Design al idioma correcto también.

    Puedes seguir este proceso para todos los idiomas de la tienda online con los que quieras usar Clerk.io.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.