Extension

Instalación con el script de Toolbox #

El script de Toolbox de Clerk.io ha sido desarrollado para facilitar la instalación de la extensión Clerk.io en tu tienda Magento, sin usar Magento Connect.

El script de Toolbox se ejecutará directamente desde un terminal. Sugerimos estos: - Apple: iTerm, tendrás que descargarlo de Internet; - Windows: Command Prompt, ya está instalado en tu computadora.

El script también crea una copia de seguridad de la carpeta de Magento para que pueda ser restaurada si algo sale mal.

¿Qué necesito? #

Para instalarlo, necesitas acceso SSH o SFTP a tu tienda, incluyendo tu Nombre de usuario, Contraseña y Dominio.

Navegando a la carpeta de Magento #

1.1 Comienza iniciando sesión en tu servidor Magento a través de un terminal, usando tu Nombre de usuario y Dominio así:

ssh Stefan@mywebshop.com

1.2 Se te pedirá que ingreses la contraseña de tu usuario (el terminal no te dará ninguna retroalimentación mientras escribes la contraseña, pero la está registrando de todos modos).

1.3 Navega a la carpeta raíz de Magento. A menudo puedes hacer esto escribiendo:

cd /var/www/html

y escribiendo:

ls

Esto te dará una lista de carpetas, para ayudarte a encontrar la correcta:

En la lista de carpetas busca la carpeta correcta, en este caso sería magento1. En este punto lo que necesitas hacer es entrar en la carpeta, puedes hacerlo escribiendo:

cd NOMBRE_CARPETA

NOMBRE_CARPETA es sustituido por el nombre real de la carpeta.

Instalando la extensión #

2.1. Cuando estés en tu carpeta raíz, necesitas descargar el script de Toolbox con esta línea:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento/master/clerk_toolbox_magento.sh

2.2. Después, escribe esta línea para ver una lista de las opciones disponibles dentro del Toolbox:

sh clerk_toolbox_magento.sh

2.3. Dado que deseas instalar la extensión, usarás -i junto con el. Escribe esta línea donde x.x.x es la versión que deseas instalar:

sudo sh clerk_toolbox_magento.sh -i x.x.x

2.4. Ahora se te pedirá que ingreses tu contraseña. Después de hacer esto, el script hará una copia de seguridad de tu carpeta Magento1 y comenzará a instalar la extensión:

2.5. ¡Listo! Ahora la extensión está instalada, y puedes configurarla en tu backend de Magento1.

Opcionales #

Desinstalando El Toolbox también te permite desinstalar la extensión. Puedes hacerlo con esta línea:

sudo sh clerk_toolbox_magento.sh -u

En algunos casos, si los archivos han sido dañados o están faltando, puedes hacer una desinstalación forzada así:

sudo sh clerk_toolbox_magento.sh -u --force

Restaurando En caso de que algo salga mal en tu tienda, siempre puedes restaurarla a través de la copia de seguridad que se crea al instalar la extensión.

Usa esta línea para hacerlo:

sudo sh clerk_toolbox_magento.sh -r

Copia de seguridad Al instalar la extensión, el script siempre creará primero una copia de seguridad, pero también puedes crear copias de seguridad por separado con esta línea:

sudo sh clerk_toolbox_magento.sh -b

Configuraciones de my.clerk.io #

Para acceder a tus configuraciones de sincronización entre Clerk.io y tu extensión de Magento 1, dirígete a my.clerk.io, haz clic en “Data” en el menú de la izquierda, luego desplázate hacia abajo hasta “Data Sync Settings”.

Aquí, encontrarás opciones para personalizar cómo se sincronizan los datos de productos, clientes y pedidos con Clerk. Más información sobre la Extensión de Magento 1, accesible a través de tu portal de administración de Magento 1, a continuación.

Historial de Pedidos #

Elige la cantidad de tiempo que deseas sincronizar retroactivamente los datos de pedidos de tu tienda a Clerk.io aquí.

Tamaño de Página #

Elige el tamaño de página de tus datos sincronizados en el menú desplegable a continuación. Tamaños de página más pequeños pueden ayudar a evitar tiempos de espera del host durante la sincronización, mientras que tamaños de página más grandes pueden sincronizar más rápido.

Tiempo de Espera del Servidor #

Establece la duración de tiempo sin respuesta antes de que el servidor se agote, tanto para proteger tus datos como para asegurarte de que has permitido suficiente tiempo para que conjuntos de datos más grandes se sincronicen con Clerk.io. El valor predeterminado es 60 segundos.

Análisis de Datos #

Elige si deseas que tus datos de Magento 1 analicen valores automáticamente en esta sección. El análisis automático es la opción predeterminada y recomendada.

Tiempo de Sincronización #

Establece la hora del día en que deseas que los datos de tu tienda se sincronicen con Clerk.io. El valor predeterminado es “cuando sea necesario”.

Configuraciones de la Extensión #

Si estás utilizando v4.8.0 o una versión posterior de la extensión, podrás acceder a la configuración a continuación de dos maneras después de agregar tus Claves Públicas y Privadas a la extensión:

• A través del backend de Magento2 en Clerk > Configuration > Settings
• A través de my.clerk.io, bajo Settings > Extensions

No importa dónde realices los cambios, ya que la extensión se sincronizará con cualquier cambio realizado en my.clerk.io y viceversa.

En my.clerk.io también podrás ver tu versión actual de la extensión, tu plataforma y la versión de PHP.

Simplemente haz clic en “Editar” en cualquier configuración, para ver las opciones disponibles:

Resumen de la Extensión de Magento 1 #

Para acceder a tu extensión de Clerk.io para Magento 1, inicia sesión en la cuenta de administración de tu tienda y elige “Configuration” > “Clerk” > “Settings”.

Configuraciones de Clerk #

Establece parámetros clave dentro de la sección Configuraciones de Clerk de la extensión de Magento 1. Tu capacidad para habilitar/deshabilitar la extensión Clerk.io, así como tus claves API públicas y privadas también se encuentran aquí.

• Actualizaciones en tiempo real:

  • Campos Adicionales

• Incluir Páginas

  • Campos Adicionales

• Recoger Correos Electrónicos y Cestas de Clientes:

• Deshabilitar Sincronización de Pedidos:

• Incluir Productos Sin Stock

• Idioma & URL de Importación: Estos probablemente se establecieron cuando instalaste por primera vez la extensión Clerk.io y se sincronizaron con my.clerk.io. Si estos valores cambian, simplemente elige el nuevo idioma de la tienda o inserta la URL de Importación actualizada aquí.

Página de Búsqueda y Búsqueda en Vivo #

Para habilitar tu Página de Búsqueda de Clerk.io, Facetas de Página de Búsqueda, y/o Búsqueda en Vivo, selecciona “Sí” en los menús desplegables apropiados.

Configurar Página de Búsqueda:

• Después de seleccionar “Sí”, aparecen opciones para ingresar el nombre del contenido de tu Página de Búsqueda, que coincide con el campo data-template que se encuentra en el código de inserción de tu Contenido en my.clerk.io. En este ejemplo, página-de-búsqueda.

• También puedes establecer el texto para el botón " Cargar Más" aquí, así como el texto que se muestra cuando no se encuentran resultados para una consulta.

Configurar Búsqueda Facetada:

• Después de habilitar la búsqueda facetada, se te da la opción de ingresar los atributos que te gustaría que aparezcan como facetas en tu Página de Búsqueda. También puedes etiquetar estas facetas con los nombres deseados y elegir el orden en que aparece cada faceta.

Personalizando las Facetas de tu Página de Búsqueda

• Clerk.io te permite estilizar las facetas de tu página de búsqueda desde dentro del diseño y puedes mostrar esto haciendo referencia al campo de ID de diseño. El ID de diseño se puede encontrar en el backend de Clerk.io, en la columna de la izquierda de cada diseño en la página de resumen de diseño y en la parte inferior izquierda de la página una vez que entres en el diseño para editar.
  

Nota: Ahora puedes llamar a los datos para categorías y páginas en tu Página de Búsqueda de la misma manera que lo harías en tu Búsqueda en Vivo, dándote un rango más amplio de información para involucrar a tus clientes. Para más información puedes consultar aquí.

Configurar Búsqueda en Vivo

• Después de habilitar la Búsqueda en Vivo, puedes seleccionar si deseas que las Categorías se muestren en tus resultados, así como el número de sugerencias, categorías y resultados de contenido que se muestren dentro de la Búsqueda en Vivo.

  • También tienes la opción de elegir qué tipos de páginas se muestran como resultados de búsqueda, por ejemplo “Páginas CMS” o “Publicaciones de Blog”.

  • Puedes elegir la posición del menú desplegable de búsqueda en vivo desde tu cuadro de búsqueda con Posicionamiento del Menú Desplegable.

• Proporciona el nombre del contenido para tu búsqueda en vivo a continuación, que se puede encontrar junto a data-template en tu código de inserción de Búsqueda en Vivo dentro de tu contenido my.clerk.io. Esto probablemente sea búsqueda-en-vivo.

• Por último, proporciona tu Selector de Entrada de Búsqueda en Vivo, que se puede encontrar inspeccionando el cuadro de búsqueda de tu tienda con tu navegador e identificando el ID o clase asociada con su entrada. En este ejemplo, #search.

Configuraciones de Powerstep, Intención de Salida, Página de Categoría, Página de Producto y Carrito #

Similar a la Búsqueda, habilita tus configuraciones de Powerstep, Intención de Salida, Página de Categoría, Página de Producto y Carrito de Clerk.io seleccionando “Sí” en los menús desplegables apropiados.

Después de seleccionar “Sí” en el menú desplegable apropiado, se te proporciona un cuadro para ingresar el nombre del contenido para las Recomendaciones de Clerk.io que te gustaría incluir en esa página.

• Al igual que las funcionalidades de Búsqueda, puedes encontrar el nombre del contenido junto a data-template en el código de inserción dentro de my.clerk.io > Recomendaciones > Contenido. En este ejemplo, hemos habilitado la configuración de la Página de Categoría e incluido categoría-página-popular como nuestro contenido.

• Puedes agregar múltiples nombres de contenido como valores separados por comas aquí, si deseas mostrar múltiples deslizadores en esa página, por ejemplo.

Registro #

Las configuraciones de Registro incluyen:

Nivel de Registro

• Solo Errores: Registrará cualquier error que detenga el módulo de funcionar correctamente.

• Error + Advertencia: También registra advertencias que no están causando que el módulo deje de funcionar, pero que podrían ser necesarias para solucionar también.

• Error + Advertencia + Depuración: Registra todo con lo que interactúa el módulo. Esto no debe habilitarse en una tienda en vivo ya que ralentizará el sitio.

Registro a

• Archivo: Guardará el registro en un archivo en el servidor de Magento.

• my.clerk.io: Registrará todo en Data->Logs en el backend de my.clerk.io.

Traduciendo textos #

La extensión Clerk.io para Magento viene integrada con traducciones para danés, inglés, holandés e italiano.

Puedes agregar fácilmente una traducción para tu idioma, para que las partes del frontend se muestren correctamente.

Para hacer esto, debes ir a esta carpeta en FTP:

app->locale

Comienza yendo a la carpeta danesa llamada da_DA y copia el archivo Clerk_Clerk.csv.

Encuentra la carpeta para tu idioma (en la carpeta locale de Magento), e inserta el archivo aquí.

Ahora puedes traducir los textos a tu idioma, en el lado derecho del archivo CSV:

Actualizando #

Esta guía te muestra cómo actualizar desde versiones anteriores de nuestra extensión, a la más reciente.

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

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

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

Antes de intentar actualizar, asegúrate de haber:

• Guardado los archivos cambiados localmente en tu FTP o

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

Generalmente, 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

2. Desactivar y desinstalar la extensión existente #

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

1. Desactiva la antigua extensión en la página System->Configuration->Clerk->Settings de Magento. Simplemente establece Enable en No y haz clic en Save Config.

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 extensión funcionará después.

3. Instalar la última extensión #

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

Tu configuración debería estar guardada, incluso al instalar la nueva versión. Verifica System->Configuration->Clerk para asegurarte de que todo siga allí.

¡Ahora tienes la última versión de Clerk.io para Magento instalada!

Desinstalando #

Para eliminar Clerk.io de tu tienda Magento 1, necesitarás deshabilitar la extensión dentro de tu portal de administración de Magento 1.

Inicia sesión en el portal de Magento 1 de tu tienda, luego selecciona " System" > " Configuration" en el menú superior.

En la siguiente página, encuentra " Clerk" en el menú de la izquierda, y elige " Settings". Desde aquí verás aparecer “Configuraciones de Clerk”. Al lado de " Enable", selecciona " No" en el menú desplegable para no habilitar más la extensión Clerk.io.

Si implementaste Clerk.io usando la extensión, también puedes deshabilitar los módulos individuales seleccionando “No” en los menús desplegables relevantes de Búsqueda y Recomendaciones en esta sección:

Si instalaste algún elemento de Clerk.io directamente a través de tus archivos FTP, asegúrate de eliminar los códigos de inserción apropiados de esos archivos.