Magento 1

Preguntas Frecuentes

Manejo de la conversión de divisas #

A partir de la v3.0.3 de la extensión Magento 1, la Conversión de Divisas está incluida por defecto, si estás utilizando la función de conversión estándar de Magento 1.

Se añade en my.clerk.io -> Diseños, con el formateador price_in_currency.

El ayudante se puede añadir a tu Diseño de la siguiente manera:

{%raw%}
<div class="clerk-product-price">
{{ product.price_final_excl_tax | price_in_currency }}
</div>{%endraw%}

El ayudante convertirá automáticamente el precio a la divisa de la sesión actual y añadirá el símbolo de la divisa.

Ejemplo de salida:

Uso de formateadores en diseños #

Clerk.js te permite escribir funciones javascript personalizadas, que añaden nueva funcionalidad a los Diseños.

Los formateadores se pueden añadir de dos maneras:

  • A través de my.clerk.io > Configuración > Formateadores, donde cada Formateador puede ser creado como entradas separadas.
  • Como una configuración para Clerk.js, en el script de seguimiento que se inserta en todas las páginas, donde se pueden añadir múltiples formateadores a la vez.

Para Magento 1, este archivo contiene el script de seguimiento:

app->design->frontend->base->default->template->clerk->tracking.phtml

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

    Clerk('config', {
      key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
      formatters: {
                form_key: function () {
                    return '<?php echo $this->getFormKey(); ?>';
                },
                price_in_currency: function(price) {
                    price =  Math.round(price * 100) / 100;
                    var price_converted = Math.round((price * <?php echo (float)$rates[$currentCurrencyCode]; ?>) * 100) / 100;
                    var retVal = <?php echo json_encode($currentCurrencySymbol); ?> + ' ' + price_converted.toFixed(2).toString();

                    return retVal;
                },
                log_price: function(price) {
                   console.log(price);
                }
            }
        });

Puedes escribir cualquier número de Formateadores, separados por comas:

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;
   }
}

Después de crear tus Formateadores, puedes usarlos en tus Diseños utilizando esta sintaxis:

{%raw%}{{ x  formatter | attribute }} {{ x | formatter | attribute1 | attribute2 }}{%endraw%}

Esto te permite crear cualquier funcionalidad en tus Diseños que necesites.

Sincronización con HTTP Auth #

A menudo se utiliza la autenticación HTTP en sitios de staging para evitar visitantes no invitados.

Esto también bloqueará el Importador de Clerk y mostrará un error de 401 No autorizado en el registro de sincronización.

Puedes verificar fácilmente el importador insertando la información de autenticación en la URL de Importación como se muestra a continuación, en Sincronización de Datos en my.clerk.io:

http//USER:PASS@magento.clerk.io/clerk/api/store/1:

Problemas comunes de sincronización #

Nota: Te aconsejamos que siempre actualices la extensión a la última versión para obtener todas las funciones actualizadas de Clerk.
Al importar datos con la extensión Magento 1, el servidor de la tienda es responsable de enviar los datos de producto, categoría y ventas a Clerk.io.

Sin embargo, en algunos casos, la configuración del servidor puede impedir que el Importador obtenga acceso, causando un error en Sincronización de Datos.

A continuación se muestra una lista de los errores más comunes y cómo solucionarlos.

Error 401 del Servidor: No autorizado #

Este error ocurre si tu entorno de tienda/desarrollo requiere autenticación HTTP para acceder.

Esto se resuelve simplemente insertando el Nombre de usuario y Contraseña como parte de la URL de Importación:

http://username:password@magento.clerk.io/clerk/api/store/1

Error 403 del Servidor: Prohibido #

Este error ocurre si tu servidor bloquea el acceso del importador. En la mayoría de los casos, simplemente necesitas agregar a la lista blanca la dirección IP del importador para darle acceso.

La última dirección IP se puede encontrar aquí.

También verifica que tu clave pública, clave privada y URL de importación sean correctas para la tienda en la que estás operando en my.clerk.io

¿Qué pasa si ya he agregado a la lista blanca pero el mismo error sigue ocurriendo?

Hay algunas instancias en las que has agregado a la lista blanca la dirección IP del importador, y el error persiste, entonces te recomendamos que revises estas partes:

  • La parte de autenticación del cuerpo puede haber sido eliminada de la solicitud del servidor de la tienda.

  • Límite de tasa para el servidor en relación con cloudflares.

Error 404 del Servidor: No encontrado #

Este error ocurre si el importador no pudo acceder al enlace que nos envía datos de la tienda. En la mayoría de los casos, ocurre porque la extensión está:

  • No instalada en absoluto

  • Una caché causa que el enlace no se inicialice

Primero asegúrate de haber instalado la extensión correctamente.

En segundo lugar, asegúrate de limpiar la caché de tu tienda antes de intentar una nueva importación.

Error 429 del Servidor: Demasiadas Solicitudes #

Este error ocurre si tu servidor niega el acceso al importador debido a demasiadas solicitudes entrantes.

Puedes solucionar esto aumentando el límite de solicitudes para tu servidor o configurando el Tamaño de Página a un valor más alto en el Clerk.io importador, lo que hace que el importador realice menos solicitudes, pero más grandes:

Si estás utilizando el proveedor de alojamiento Byte.nl, el importador generalmente devuelve este error debido a su limitador de tasa. En este caso, simplemente contacta a Byte.nl y pídeles que agreguen a la lista blanca el User-Agent del importador " clerk".

Error 500 del Servidor Interno #

Este error significa que tu servidor encontró un error interno y no pudo especificar qué error ocurrió.

En estos casos, puedes revisar tu Registro del Servidor para identificar qué proceso falló y por qué. En la mayoría de los casos, es simplemente debido a un producto con un atributo inválido, o una función que se llama incorrectamente en la tienda.

Error 503 del Servidor: Servicio No Disponible #

Este error suele ser temporal y es causado por el servidor que está demasiado ocupado para manejar la solicitud. Intenta nuevamente un poco más tarde.

Si el problema continúa, podría significar que el servidor está sobrecargado de procesos y está cerca de su capacidad máxima.

Verifica la carga del servidor para identificar si este es el caso.

API de Magento: "" #

Este error también significa que tu servidor encontró un error interno y no pudo especificar qué error o código de error ocurrió.

En estos casos, puedes revisar tu Registro del Servidor para identificar qué proceso falló y por qué. En la mayoría de los casos, es simplemente debido a un producto con un atributo inválido, o tu límite de memoria fue excedido.

Paso de agregar al carrito no mostrado #

Si el paso de Agregar al Carrito no está activado, generalmente se debe a dos razones:

  • Tienes otro popup o función de agregar al carrito habilitada que bloquea la función de Clerk.io

  • Se han insertado los IDs de Contenido incorrectos en la extensión.

Otro popup de agregar al carrito está habilitado

Comienza revisando tu instalación existente de Magento, para ver si ya tienes un popup o desplegable que se muestra al agregar un producto al carrito.

Estos pueden normalmente detener el paso de agregar al carrito de Clerk.io de mostrarse.

Si este es el caso, desactívalo y vuelve a intentarlo.

Se han insertado los IDs de Contenido incorrectos en la Extensión

Si no tienes otro popup de agregar al carrito, y tu paso de poder está activado pero no se muestra, es probable que se hayan insertado los IDs de plantilla incorrectos en la configuración de la extensión Clerk.io. Esto hará que el paso de poder falle.

Para solucionar esto, comienza iniciando sesión en tu administrador de Magento y ve a Sistema->Configuración->Clerk->Configuración

Luego elige el Ámbito de Configuración correcto que coincida con tu tienda.

Bajo Configuración del paso de poder, verifica el campo de Plantillas.

Este campo debe contener los IDs correctos separados por comas, si usas más de uno.

Para asegurarte de que tus IDs son correctos, inicia sesión en my.clerk.io.

Elige la Tienda correcta y ve a Recomendaciones/Búsqueda -> Contenido.

Haz clic en Editar Contenido para un slider que deseas mostrar en el paso de poder.

Verifica la última pestaña " Insertar en el sitio web" y localiza el código de inserción.

El ID encontrado en data-template es el ID que necesitas copiar a la extensión de Magento:

Haz clic en Guardar Configuración en la extensión de Magento, y el paso de poder debería funcionar después.

Si has activado el popup del paso de poder y aún no se muestra al agregar un producto al carrito, el problema suele ser debido a la Caché.

1. Comienza yendo a Sistema => Caché y limpia todas las Cachés Internas y de Terceros.

2. Si no resuelve el problema, es probable que estés utilizando Caché de Página Completa, que solo impacta las páginas que un visitante ya ha visto en su sesión. Desactivarlo tendrá un impacto mínimo en la velocidad de la página.

3. La captura de pantalla a continuación muestra exactamente cuál desactivar:

Una vez que hayas desactivado la Caché de Página Completa, el popup de Clerk debería aparecer. Si no lo hace, por favor contacta al Soporte de Clerk desde el ícono de chat en vivo en la esquina inferior derecha, y podemos ayudar a encontrar una solución para tu configuración específica 😃

Los sliders de la página principal siempre muestran los mismos productos #

Normalmente esto solo sucede si se insertan códigos de inserción a través de las Páginas CMS de Magento en el backend, ya que la página principal está en caché:

En su lugar, tus códigos de inserción deben ser insertados directamente en los archivos de la Página Principal, a través de FTP:

Magento no almacenará en caché los resultados cuando se inserten de esta manera.

Clerk no muestra imágenes #

Cuando se limpia la caché de imágenes de Magento, ya sea manual o automáticamente, todos los caminos de las imágenes cambian.

Esto significa que los caminos de las imágenes enviados a Clerk.io ya no funcionan.

Esto se puede solucionar fácilmente haciendo lo siguiente:

  1. Inicia sesión en my.clerk.io

  2. Haz clic en la Tienda donde faltan imágenes

  3. Ve a Datos

  4. Haz clic en Iniciar Nueva Sincronización de Datos en la esquina superior derecha

Esto iniciará una nueva sincronización completa de tus productos, lo que hará que Clerk.io obtenga los caminos de imágenes correctos.

En la extensión de Magento de Clerk.io v2.1.0 este problema se soluciona, iniciando automáticamente una Sincronización cuando se limpia la caché de imágenes.

Si estás utilizando una versión anterior de la extensión, te recomendamos encarecidamente actualizar a la última versión.

Actualizando a Clerk.js 2 #

Clerk.js 2 es una versión más rápida y flexible de nuestra biblioteca JavaScript que hace que instalar Clerk.io en cualquier tienda sea muy fácil.

Sin embargo, dado que las dos versiones funcionan de manera ligeramente diferente, necesitas seguir estos pasos para actualizar con éxito.

Las dos diferencias principales en Clerk.js 2 son que los Diseños en my.clerk.io utilizan el Liquid lenguaje de plantillas, pero también se pueden crear fácilmente utilizando el Editor de Diseños.

Convirtiendo Diseños #

Dado que Clerk.js 2 tiene un enfoque diferente para los Diseños, necesitas crear nuevos.

Puedes crear tus Diseños de Clerk.js 2 de una de dos maneras:

1.1 Comienza yendo a my.clerk.io -> Recomendaciones / Búsqueda -> Diseños y haz clic en Nuevo Diseño:

1.2. Elige tu Tipo de Diseño.

1.3. En el Editor de Diseños, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc. para editarlo, o selecciona nuevos elementos para añadir al Diseño para agregar más información sobre los productos.

1.4. Haz clic en Publicar cuando hayas terminado, y ve al Paso 2 en la guía.

1.5. Por último, ve a Recomendaciones / Búsqueda -> Contenido y cambia tu contenido de Clerk.io para usar tu nuevo Diseño.

1.6. Haz clic en Actualizar Contenido. Esto hará que temporalmente no se muestren en tu tienda hasta que termines con el Paso 2. Elige el nuevo Diseño para todo el Contenido que deba ser actualizado.

1.9. ¡Listo! Ahora estás listo para cambiar a Clerk.js 2.

Actualizando tu extensión #

Si ya tienes la última versión de la extensión de Clerk.io para Magento, puedes omitir este paso.

Puedes descargar la última extensión desde este enlace:

https://github.com/clerkio/clerk-magento/releases/latest

2.1. Guarda cualquier cambio en los archivos de la extensión

Antes de intentar actualizar, asegúrate de haber:

  • Guardado los archivos modificados localmente en tu FTP o

  • Hecho una copia de seguridad de cualquier archivo modificado, que puedas transferir a la nueva extensión.

Normalmente, los archivos que la mayoría de los desarrolladores cambian son Product.php y Productbase.php, que controlan atributos de producto.

Estos archivos se encuentran aquí:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

app->code->community->Clerk->Clerk->Model->Catalog->Productbase.php

Desactiva y desinstala la extensión existente

Antes de intentar actualizar, es muy importante que hagas esto:

2.2.1. Desactiva la antigua extensión en la página de Sistema->Configuración->Clerk->Configuración de Magento. Simplemente establece Habilitar en No y haz clic en Guardar Config.

2.2.2. Después, desinstálala ya sea a través de Magento Connect o eliminando los archivos

desde FTP si la instalaste directamente aquí.

De lo contrario, tu página de Configuración podría dejar de funcionar y ninguna de las extensiones funcionará después.

2.3. Instala la última extensión

Por último, instala nuevamente la última extensión y mueve cualquier archivo que hayas respaldado a tu servidor FTP.

Tu configuración debería guardarse, incluso al instalar la nueva versión. Verifica Sistema->Configuración->Clerk para asegurarte de que todo sigue allí.

¡Ahora tienes la última versión de Clerk.io para Magento instalada, y Clerk.js 2 está funcionando en tu tienda!

La documentación completa para Clerk.js 2 se puede encontrar aquí:

https://docs.clerk.io/docs/clerkjs-quick-start

Manejo de require.js #

Esto solo se aplica cuando se utiliza la v.3.7.2 o inferior de la extensión Magento 1 Clerk.

En algunas configuraciones, Require.js detiene la carga de Clerk.js, lo que significa que no se mostrarán sliders ni resultados de búsqueda.

Cuando esto sucede, se mostrará el siguiente error en tu consola:

Uncaught ReferenceError: Clerk is not defined

Hay dos formas de manejar Require.js. Ambos enfoques requieren que realices cambios en el script de seguimiento en este archivo:

app->design->frontend->base->default->template->clerk->tracking.phtml

Incluir “clerk” en Require.js #

El mejor enfoque es intentar hacer que Require.js reconozca a Clerk.io.

Puedes hacer esto insertando require([‘clerk’], function() {}); en la parte inferior del script de seguimiento:

Ignorar Require.js #

Si la solución anterior no funciona, es posible ignorar Require.js.

Puedes hacer esto insertando window.__clerk_ignore_requirejs = true;

en la parte superior del script de seguimiento:

Después de usar uno de estos enfoques, Require.js ahora será compatible con 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.