FAQ
Instalación manual de elementos #
WooCommerce se basa en temas, lo que a menudo significa que el plugin Clerk.io no puede insertar nuestros códigos de inserción, porque los hooks no están colocados donde se supone que deben estar.
Esta guía explica cómo insertar códigos manualmente si ese es el caso.
1. Encuentra el archivo correcto #
1. Comienza localizando tu formulario de búsqueda. Puedes hacer esto revisando tu código fuente y encontrando un texto único para el campo.
2. Después de identificar esto, necesitas una buena manera de buscar en tus archivos para encontrarlo. Recomendamos usar Sublime Text.
3. Abre los archivos FTP de tu tienda en línea y localiza public_html -> wp-content -> themes
4. Arrastra los temas a tu escritorio para copiarlos a tu computadora. Esto te permitirá buscar en los archivos:
5. En Sublime ve a Project -> Add Folder to Project
6. Elige la carpeta themes que guardaste en tu computadora.
7. Ahora puedes buscar en los archivos, yendo a Find -> Find in Files. Incluso puedes optar por buscar solo en archivos .php, que es normalmente el tipo de archivo utilizado para archivos de temas en WooCommerce:
2. Hacer que el enlace a la página de búsqueda funcione #
Si ya has seguido la guía para configurar la búsqueda y has creado una página en WooCommerce para los Resultados de Búsqueda, pero tu campo de búsqueda no está enlazando correctamente, esto es lo que necesitas hacer.
1. Comienza mirando la tienda en línea en tu navegador. Recomendamos usar Chrome.
2. Localiza cualquier HTML que parezca ser único para el campo de búsqueda. Por ejemplo, searchform:
3. Busca esto en Sublime, para encontrar una lista de archivos en los que se encuentra:
4. Encuentra el archivo correspondiente en FTP.
5. Ahora puedes cambiar la configuración necesaria para que Clerk.io enlace a la página correcta. Las 3 cosas que necesitas cambiar son:
La URL a la que se vincula el cliente, que a menudo se encuentra en el elemento
El atributo “name” del campo de entrada, que necesita ser searchterm
El campo de entrada oculto con name=“post_type” necesita ser comentado.
6. Un formulario de búsqueda podría verse así antes de cambiarlo:
7. Y debería verse así después del cambio:
8. Ahora deberías estar vinculado a la página de búsqueda al buscar: www.mywebshop.com/soegeresultater?searchterm=test
Usando formateadores en diseños #
Clerk.js te permite escribir funciones de javascript personalizadas, que añaden nueva funcionalidad a los Diseños.
Los formateadores pueden ser añadidos de dos maneras:
- A través de my.clerk.io > Settings > Formatters, 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 WooCommerce, este archivo contiene el script de seguimiento:
wp-content->plugins->clerkio->includes->class-clerk-visitor-tracking.php
Un ejemplo se puede ver a continuación. Por favor, ten en cuenta que esta es Clerk V2 (última versión):
Clerk('config', {
key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
formatters: {
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%}{{ price | log_price }} {{ price | calculate_discount | special_price }}{%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 deseados.
Esto bloqueará el importador de Clerk también y mostrará un error de 401 Unauthorized 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 a continuación, en Sincronización de Datos en my.clerk.io:
https//USER:PASS@www.ewoksRus.com
Problemas comunes de sincronización #
Nota: Te aconsejamos que siempre actualices el plugin a la última versión para obtener todas las características actualizadas de Clerk.
Al importar datos con el plugin de WooCommerce de Clerk.io, el servidor de la tienda en línea es responsable de enviar los datos de productos, categorías y ventas a Clerk.io.
Sin embargo, en algunos casos, la configuración del servidor puede detener el acceso del importador, causando un error en Sincronización de Datos.
A continuación se presenta una lista de los errores más comunes y cómo solucionarlos.
401 Error del Servidor: No Autorizado #
Este error ocurre si tu entorno de tienda en línea/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@woocommerce.clerk.io
403 Error 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 mires estas partes:
La parte de autenticación del cuerpo puede ser eliminada de la solicitud del servidor de la tienda.
Límite de tasa para el servidor en relación con cloudflares.
404 Error del Servidor: No Encontrado #
Este error ocurre si el importador no pudo acceder al enlace que nos envía datos de la tienda en línea. En la mayoría de los casos, esto sucede porque el plugin está:
No instalado en absoluto
Desactivado debido a una actualización
Un caché causa que el enlace no se inicialice
Los enlaces permanentes de WooCommerce están configurados como Nombre de la publicación en lugar de Mes y nombre
Primero asegúrate de haber instalado el plugin correctamente y que esté activado.
Si recientemente actualizaste automáticamente el plugin, WooCommerce a veces desactiva el plugin. Si esto ha sucedido, simplemente ve a Plugins > Clerk y haz clic en Activar para volver a activarlo.
En segundo lugar, asegúrate de vaciar la caché de tu tienda en línea antes de intentar una nueva importación.
Si aún no se sincroniza correctamente, ve a Configuraciones => Enlaces permanentes y cambia la Configuración Común a Mes y nombre y presiona Guardar:
429 Error 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 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".
500 Error Interno del Servidor #
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 en línea.
Un ejemplo de tal error podría ocurrir una vez que actualizas tanto WooCommerce como Klarna. En este caso, el problema es creado por el plugin ‘woocommerce-gateway-klarna’ que no se actualiza.
Si esto te sucede, ve a woocommerce-gateway-klarna ->includes->variables-checkout.php .
Busca:
if ( ! is_admin() && ! empty( $klarna_country )) {
y cámbialo a:
if ( ! is_admin() && ! empty( $klarna_country ) && WC()->session ) {
503 Error 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 más tarde.
Si el problema continúa, podría significar que el servidor está sobrecargado con procesos y está cerca de su capacidad máxima.
Verifica la carga del servidor para identificar si este es el caso.
520 El Servidor Web Devolvió un Error Desconocido #
Generalmente, este error es devuelto por CloudFlare, y a menudo ocurre debido a un cuello de botella en WooCommerce que causa problemas con tamaños de página más altos. Para solucionarlo, simplemente establece tu Tamaño de Página en 50 y ejecuta una nueva sincronización:
522 Error del Servidor: Tiempo de Conexión Excedido #
Este error generalmente ocurre si el servidor está demasiado ocupado para responder, o si nuestro importador no tiene permitido acceder al servidor.
Primero, espera unos minutos y vuelve a intentar la sincronización, para ver si el servidor estaba ocupado.
Si aún no funciona, asegúrate de agregar a la lista blanca la IP del importador en la configuración de tu servidor. La última dirección IP se puede encontrar aquí.
Respuesta inválida devuelta desde la API de WooCommerce #
Este error generalmente ocurre si la Depuración de WooCommerce ha sido activada. Esto nunca es una buena idea tenerlo activado en una configuración en vivo porque ralentiza las páginas y potencialmente muestra mensajes de error en el frontend.
El problema de sincronización ocurre si WooCommerce encuentra un error al generar los datos del producto para la importación.
Esto se puede resolver desactivando la depuración en wp-config.php configurando define(WP_DEBUG’, false).
Esta guía lo explica con más detalle:
https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/
Y esta guía explica una solución alternativa:
https://aristath.github.io/blog/wp-hide-php-errors
Los errores aún se registrarán incluso cuando no estén en Modo de Depuración, pero se registrarán en un archivo en su lugar.
Actualizando a Clerk.js 2 #
Clerk.js 2 es una versión más rápida y flexible de nuestra biblioteca de JavaScript que facilita la instalación de Clerk.io en cualquier tienda en línea.
Sin embargo, dado que las dos versiones funcionan de manera ligeramente diferente, debes seguir estos pasos para actualizar con éxito.
Las dos principales diferencias 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ño.
Paso 1: Convertir 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. Usa el intuitivo Editor de Diseño para crear nuevos Diseños, como se describe en los siguientes puntos.
2. Convierte tus antiguos Diseños. Sigue esta guía para ver cómo hacerlo.
1.1 Comienza yendo a my.clerk.io -> Recomendaciones / Búsqueda -> Diseños y haz clic en Nuevo Diseño:
1.2. Elige el Tipo de Diseño y sigue el asistente de configuración de diseño.
1.3. En el Editor de Diseño, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc., para editarlo, o agrega nuevos elementos al Diseño para añadir 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 causará temporalmente que no aparezcan en tu tienda en línea hasta que termines con Paso 2. Elige el nuevo Diseño para todo el Contenido que deba ser actualizado.
1.7. ¡Listo! Ahora estás listo para cambiar a Clerk.js 2.
Paso 2: Actualizando tu plugin #
ADVERTENCIA: Recuerda hacer copias de seguridad de cualquier archivo modificado, ya que serán sobrescritos.
La actualización del Plugin se puede hacer directamente desde el administrador de WooCommerce.
Comienza yendo a Plugin->Agregar Nuevo
Luego, busca Clerk en el campo de búsqueda a la derecha y haz clic en Actualizar Ahora.
¡Eso es todo! Ahora estás ejecutando la última versión de Clerk.io para WooCommerce y Clerk.js 2 está funcionando en tu tienda en línea.
Si ya tienes la última versión, este botón simplemente dirá Activo.
La documentación completa para Clerk.js 2 se puede encontrar aquí:
https://docs.clerk.io/docs/clerkjs-quick-start
Enlaces que apuntan al backend #
De vez en cuando, los plugins de Wordpress / Woocommerce interfieren con la regla de reescritura de Wordpress.
La regla de reescritura es el conjunto de configuraciones que asegura que enlaces como este
domain.com/?p=123
se conviertan en enlaces bonitos y optimizados para SEO como
domain.com/product/my-beautiful-product/
y que realmente sean accesibles para ti y tus clientes.
Si tus enlaces no funcionan correctamente, haz lo siguiente:
1. Inicia sesión en tu backend de Wordpress
2. Luego ve a: Dashboard –> Settings –> Permalink
3. Desplázate hacia abajo y haz clic en el botón “Guardar cambios” en la parte inferior de la página sin cambiar nada. Eso sobrescribirá la regla de reescritura de Wordpress.
4. Una vez que la página se haya refrescado, vacía la caché de tu Wordpress (si la hay) y luego espera unos minutos. Deberías poder ver todas las páginas de tu sitio web nuevamente.
Si después de todo eso aún no puedes visitar las páginas de tu sitio web, contáctanos en support@clerk.io, ¡estamos aquí para ayudar!
Advertencias mostradas en el backend y frontend #
Este error generalmente ocurre si la Depuración de WooCommerce ha sido activada. Esto nunca es una buena idea tenerlo activado en una configuración en vivo porque ralentiza las páginas y potencialmente muestra mensajes de error en el frontend.
El problema de sincronización ocurre si WooCommerce encuentra un error al generar los datos del producto para la importación.
Esto se puede resolver desactivando el Modo de Depuración ya sea a través del plugin o directamente en los archivos de WooCommerce.
Manejo de require.js #
Esta guía solo se aplica al usar hasta v.1.7.1 de la extensión Clerk de WooCommerce.
En algunas configuraciones, Require.js impide que Clerk.js se cargue, lo que significa que no se mostrarán deslizadores 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:
wp-content -> plugins -> clerkio -> includes -> class-clerk-visitor-tracking.php
Incluir “clerk” en Require.js
El mejor enfoque es intentar hacer que Require.js reconozca Clerk.io.
Puedes hacer esto insertando require([‘clerk’], function() {}); en la parte inferior del script de seguimiento:
Usando el Plugin
Si estás utilizando Clerk.io v2.2.4 o posterior, la depuración se puede desactivar directamente desde la página del Plugin en tu backend de WooCommerce.
Ve a Clerk -> Configuración de Clerk -> Guía de Depuración y haz clic en Desactivar Modo de Depuración:
O directamente en los Archivos
El Modo de Depuración también se puede desactivar a través de FTP, en wp-config.php configurando define(WP_DEBUG’, false).
Esta guía lo explica con más detalle:
https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/
Y esta guía explica una solución alternativa:
https://aristath.github.io/blog/wp-hide-php-errors
Los errores aún se registrarán incluso cuando no estén en Modo de Depuración, pero se registrarán en un archivo en su lugar.
Ignorando 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.
Multi-idioma #
Al usar WPML en WooCommerce, deberías poder diferenciar tus idiomas por URL, así:
Si tienes URLs únicas como estas, puedes extender el plugin de WooCommerce para soportar WPML.
También está bien definir el idioma a través del parámetro lang. Ej.
Copiar Tienda #
La forma más fácil de implementar Clerk.io en múltiples dominios en configuraciones estándar es creando una Tienda separada para cada dominio en my.clerk.io. De esta manera, puedes separar productos, ventas, monedas, etc. para hacer un seguimiento de cada dominio.
Después de haber completado la configuración inicial, haz clic en la esquina superior izquierda del menú lateral y luego haz clic en "+ Agregar nueva tienda" la última opción de la lista desplegable (generalmente debajo de las tiendas existentes y el nombre de tu empresa).
En la página Agregar Nueva Tienda, completa los detalles de tu tienda en línea y elige tu Tienda principal del menú desplegable Copiar Contenido de la Tienda Existente, luego haz clic en Agregar Tienda:
Esto trasladará el Contenido y los Diseños de tu Tienda principal. Recuerda traducir Titulares al idioma correcto también.
Instalar y Configurar #
El soporte oficial para WPML ha sido añadido a la extensión de Clerk.io WooCommerce, lo que significa que mientras uses esa versión o una más nueva, WPML debería ser compatible.
En el panel de configuración de WooCommerce verás las configuraciones como de costumbre. Si WPML está activo y configurado en tu sitio de WordPress, verás Alcance Multi Idioma con el idioma actual hacia la parte superior de la página de configuración.
Para cambiar el idioma, simplemente usa el selector en el panel superior. Debes seleccionar el idioma para el cual deseas configurar Clerk y proporcionar tus configuraciones deseadas. Repite esto para cada idioma.
Ten en cuenta que seleccionar Todos los Idiomas de este menú desplegable no es aconsejable, al guardar tu configuración, ya que solo guardará tus configuraciones como una opción de respaldo.
Sincroniza tus dominios #
Una vez que hayas extendido el plugin, ahora puedes sincronizar cada una de tus Tiendas con su dominio de idioma.
Como ya has instalado la extensión, puedes omitir el primer paso y comenzar a configurarlo y sincronizar datos.
Cuando la Sincronización haya terminado, tu dominio estará listo y utilizando la misma configuración que tu Tienda principal.
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.