Preguntas frecuentes

¿Tienes problemas con tu integración de SmartWeb Classic? Este FAQ cubre los problemas más comunes y sus soluciones, desde formatters hasta la actualización a Clerk.js 2.

Uso de formatters #

Clerk.js te permite escribir funciones JavaScript personalizadas que añaden nuevas funcionalidades a tus Designs.

Los formatters pueden añadirse de dos maneras:

• A través de my.clerk.io > Developers > Formatters, donde cada Formatter puede crearse como una entrada separada.

• Como una configuración para Clerk.js, en el tracking-script que se inserta en todas las páginas, donde pueden añadirse múltiples formatters a la vez.

Ejemplo de formatter #

Un ejemplo se puede ver a continuación. Ten en cuenta que esto es para Clerk V2 (última versión):

Clerk('config', {
  key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
  formatters: {
    log_price: function(price) {
      console.log(price);
    }
  }
});

Múltiples formatters #

Puedes escribir cualquier cantidad de Formatters, separados por coma:

formatters: {
  log_price: function(price) {
    console.log(price);
  },
  calculate_discount: function(price, special_price) {
    return price - special_price;
  },
  substring: function(text) {
    var short_string = text.substring(0, 20);
    return short_string;
  }
}

Uso en Designs #

Después de crear tus Formatters, puedes usarlos en tus Designs usando esta sintaxis:

{%raw%}{{ price | log_price }} {{ price | calculate_discount | special_price }}{%endraw%}

Esto te permite crear cualquier funcionalidad en tus Designs que requieras.

Autenticación HTTP #

La autenticación HTTP se utiliza frecuentemente en sitios de staging para evitar visitantes no deseados.

Esto bloqueará el importador de Clerk y mostrará un error 401 Unauthorized en el registro de sincronización.

Puedes solucionar esto insertando la información de autenticación en la URL de importación.

En my.clerk.io > Data > Configuration, actualiza tu URL de importación así:

http://USER:PASS@www.ewoksRus.com

Actualizar a Clerk.js 2 #

Clerk.js 2 es una versión más rápida y flexible de nuestra biblioteca JavaScript.

Hace que instalar Clerk en cualquier tienda online sea más fácil.

Sin embargo, dado que las dos versiones funcionan de manera ligeramente diferente, debes seguir estos pasos para actualizar exitosamente.

Las dos principales diferencias en Clerk.js 2 son:

• Los Designs en my.clerk.io usan el lenguaje de plantillas Liquid, pero también pueden crearse fácilmente usando el Design Editor.

• El script debe ser insertado justo antes de la etiqueta </head> en la plantilla de tu tienda online.

Crear Designs #

Dado que Clerk.js 2 tiene un enfoque diferente para los Designs, es necesario crear nuevos.

Puedes crear tus Designs de Clerk.js 2 de dos maneras:

• Usa el intuitivo Design Editor para crear nuevos Designs, como se describe en los siguientes puntos.

• Convierte tus antiguos Designs. Sigue esta guía para ver cómo hacerlo.

Opción Design Editor #

1. Ve a my.clerk.io > Recommendations/Search > Designs > New Design.

2. En la siguiente pantalla, dale un Nombre a tu Design (recomendamos agregar “V2” para que sea obvio que estás usando Clerk.js 2).

3. Elige el Tipo de Design y sigue el asistente de configuración de diseño.

4. Cuando termines, haz clic en Create Design.

5. En el Design Editor, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc. para editarlo, o agrega nuevos elementos al Design para incluir más información sobre los productos.

6. Haz clic en Publish cuando hayas terminado y ve a Step 2 en la guía.

7. Ve a Recommendations/Search > Elements y cambia tu Clerk Element para que use tu nuevo Design.

8. Haz clic en Update Element. Esto hará que temporalmente no se muestren en tu tienda online, hasta que termines el Step 2. Elige el nuevo Design para todos los Elements que deban actualizarse.

Ahora estás listo para pasarte a Clerk.js 2.

Reemplazar script #

1. Ubica el archivo de plantilla que se usa para mostrar todas las páginas de la tienda online, y donde se encuentra el script original de Clerk.js cerca de la parte inferior.

2. Elimina el script antiguo del archivo:

3. Ve a my.clerk.io > Developers > Tracking Code.. Esta página ahora contiene tu código de seguimiento de Clerk.js 2.

4. Copia este código e insértalo justo antes de la etiqueta </head> en la plantilla:

5. Guarda tu plantilla.

¡Felicidades! ¡Ahora estás usando la configuración mejorada de Clerk.js 2!

Puedes ver la documentación completa de Clerk.js 2 aquí: https://docs.clerk.io/docs/clerkjs-quick-start