Extension

Configura los ajustes de tu extensión Magento 1, gestiona las opciones de sincronización de datos y personaliza las funciones de search, recommendations y registro de logs. Esta guía también cubre la instalación mediante Toolbox Script, la actualización y la desinstalación.

Instalación con toolbox #

El Clerk Toolbox Script se ha desarrollado para facilitar la instalación de la extensión Clerk en tu tienda online Magento, sin utilizar Magento Connect.

El Toolbox Script se ejecutará directamente desde una terminal.

Sugerimos estas opciones: - Apple: iTerm, que tendrás que descargar de Internet; - Windows: Símbolo del sistema, que ya está instalado en tu ordenador.

El script también crea una copia de seguridad de la carpeta de Magento para poder restaurarla si algo sale mal.

Lo que necesitas #

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

Navegar a la carpeta #

1. Empieza iniciando sesión en tu servidor Magento a través de una terminal, usando tu Nombre de usuario y Dominio de la siguiente manera:

ssh Stefan@mywebshop.com

2. Se te pedirá que escribas la contraseña de tu usuario (la terminal no mostrará ningún feedback al escribir la contraseña, pero la está registrando igualmente).

3. Navega a la carpeta raíz de Magento. A menudo puedes hacerlo 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, lo cual puedes hacer escribiendo:

cd NAME_FOLDER

NAME_FOLDER se sustituye por el nombre real de la carpeta.

Instalación de la extensión #

1. Cuando estés en tu Carpeta Raíz, necesitas descargar el Toolbox Script con esta línea:

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

2. Luego, escribe esta línea para ver una lista de las opciones disponibles dentro del Toolbox:

sh clerk_toolbox_magento.sh

3. Como quieres instalar la extensión, usarás -i junto con la versión. 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

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

5. ¡Listo! Ahora la extensión está instalada y puedes configurarla en el panel de administración de Magento1.

Comandos opcionales #

Desinstalar
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 se han dañado o faltan, puedes hacer una desinstalación forzada así:

sudo sh clerk_toolbox_magento.sh -u --force

Restaurar
Si algo sale mal en tu tienda online, siempre puedes restaurarla mediante 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

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

sudo sh clerk_toolbox_magento.sh -b

Configuración en my.clerk.io #

Para acceder a la configuración de sincronización entre Clerk y tu extensión Magento 1, dirígete a my.clerk.io, haz clic en “Data” en el menú lateral izquierdo y luego en “Configuration”.

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 Magento 1, accediendo a través de tu portal de administración de Magento 1, más abajo.

Historial de pedidos #

Elige el tiempo retroactivo desde el cual deseas sincronizar los datos de pedidos de tu tienda con Clerk 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 interrupciones o expiraciones 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 #

Define el tiempo máximo de espera sin respuesta antes de que el servidor cierre la conexión, para proteger tus datos y asegurar que haya suficiente tiempo para sincronizar conjuntos de datos grandes con Clerk.

El valor predeterminado es 60 segundos.

Análisis de datos #

Elige si deseas que tus datos de Magento 1 analicen los valores automáticamente en esta sección.

El análisis automático es la opción predeterminada y recomendada.

Hora de sincronización #

Configura la hora del día en la que deseas que los datos de tu tienda se sincronicen con Clerk.

El valor predeterminado es “cuando sea necesario”.

Configuración de la extensión #

Si usas la v4.8.0 o una versión posterior de la extensión, podrás acceder a las configuraciones abajo de dos formas después de agregar tus Public y Private Keys a la extensión:

• A través del backend de Magento en Clerk > Configuration > Settings

• A través de my.clerk.io, en Developers > Extensions

No importa dónde hagas 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 puedes ver tu versión actual de la extensión, tu plataforma y la versión de PHP.

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

Resumen de la extensión #

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

Configuración de Clerk #

Define los parámetros clave en la sección Clerk Settings de la extensión Magento 1.

Tu capacidad de habilitar/deshabilitar la extensión Clerk, así como tus claves públicas y privadas de API también se encuentran aquí.

• Actualizaciones en tiempo real:

  • Campos adicionales

• Incluir páginas

  • Campos adicionales

• Recopilar correos electrónicos y carritos de clientes:

• Desactivar sincronización de pedidos:

• Incluir productos sin stock

• Lenguaje y URL de Importación: Estos probablemente fueron configurados cuando instalaste por primera vez la extensión Clerk 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í.

Configuración de search #

Para habilitar tu Search Page, Search Page Facets y/o Live Search de Clerk, selecciona “Yes” en los desplegables correspondientes.

Configuración de Search Page:

• Después de seleccionar “Yes”, aparecerán opciones para introducir el nombre de tu Search Page Content, que debe coincidir con el campo data-template que se encuentra en el código de inserción de tu Content en my.clerk.io. En este ejemplo, search-page.

• También puedes configurar el texto para el botón " Load More", así como el texto que se muestra cuando no se encuentran resultados para una consulta.

Configuración de búsqueda facetada:

• Después de habilitar la búsqueda facetada, tendrás la opción de introducir los atributos que deseas que aparezcan como facetas en tu Search Page.

También puedes etiquetar estas facetas con los nombres deseados, y elegir el orden en el que cada faceta aparecerá.

Personalizar facetas #

Clerk te permite personalizar el diseño de las facetas de tu página search desde la sección de diseño y puedes mostrar esto haciendo referencia al campo design ID.

El design ID puede encontrarse en el backend de Clerk, en la columna izquierda de cada diseño en la página de vista general de diseño y en la esquina inferior izquierda de la página al entrar al diseño para editarlo.

Nota: Ahora puedes llamar los datos de categorías y páginas en tu página Search de la misma manera que en tu Live Search, dándote un rango más amplio de información para interactuar con tus clientes. Para más información puedes consultar aquí.

Configuración de Live Search

• Después de habilitar Live Search, puedes elegir si quieres que se muestren Categorías en tus resultados, así como el número de sugerencias de búsqueda, categorías, y resultados de contenido que se mostrarán dentro de Live Search.

  • También tienes la opción de elegir qué tipos de página mostrar como resultados, por ejemplo “CMS Pages” o “Blog Posts”.

  • Puedes elegir la posición del desplegable de búsqueda en vivo desde tu caja de búsqueda con Dropdown Positioning.

• Proporciona el nombre de Content de tu live search a continuación, que puedes encontrar junto a data-template en el código de inserción de tu Live Search en tu Content de my.clerk.io. Probablemente sea live-search.

• Por último, proporciona tu Live Search Input Selector, que puedes encontrar inspeccionando la caja search de tu tienda con tu navegador, identificando el ID o la clase asociada a su input. En este ejemplo, #search.

Configuración de recommendations #

Similar a Search, habilita tus configuraciones Clerk Powerstep, Exit Intent, Category Page, Product Page y Cart seleccionando “Yes” en los respectivos desplegables.

Después de seleccionar “Yes” en el desplegable correspondiente, se te proporciona un campo para introducir el nombre del elemento de Clerk Recommendations que te gustaría incluir en esa página.

• Al igual que en las funcionalidades Search, puedes encontrar el nombre del elemento junto a data-template en el código de inserción dentro de my.clerk.io > Recommendations > Elements. En este ejemplo, hemos habilitado la configuración Category Page e incluido category-page-popular como nuestro elemento.

• Puedes añadir varios nombres de elementos, separados por comas aquí, si deseas mostrar varios elementos en esa página, por ejemplo.

Registro de logs #

La configuración de registro de logs incluye:

Nivel de log

• Solo Errores: Registrará cualquier error que impida que el módulo funcione correctamente.

• Error + Warn: También registra advertencias que no detienen el módulo, pero podrían requerir resolución.

• Error + Warn + Debug: Registra todo con lo que interactúa el módulo. No debe habilitarse en una tienda online activa porque ralentizará el sitio.

Registrar en

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

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

Traducción de textos #

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

Puedes añadir fácilmente una traducción para tu idioma, así las partes del frontend se verán correctamente.

Para ello, debes ir a esta carpeta en FTP:

app->locale

Empieza accediendo a la carpeta danesa llamada da_DA y copia el archivo Clerk_Clerk.csv.

Busca 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 la columna derecha del archivo CSV:

Actualización #

Esta guía te muestra cómo actualizar desde versiones anteriores de nuestra extensión a la última.

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

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

Guardar cambios #

Antes de intentar actualizar, asegúrate de:

• Guardar los archivos modificados localmente en tu FTP, o

• Hacer una copia de seguridad de los archivos modificados para transferirlos a la nueva extensión.

Generalmente, los archivos que más suelen cambiar los desarrolladores son Product.php y Productbase.php, que gestionan los atributos del producto.

Estos archivos se encuentran aquí:

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

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

Desactivar y desinstalar #

Antes de intentar actualizar, es muy importante que hagas lo siguiente:

1. Desactiva la antigua extensión en la página System->Configuration->Clerk->Settings de Magento. Simplemente pon 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 el FTP si la instalaste directamente allí.

De lo contrario, tu página de Configuration puede dejar de funcionar y ninguna extensión funcionará después.

Instalar la última versión #

Por último, instala nuevamente la extensión más reciente y transfiere los archivos que has guardado a tu servidor FTP.

Tu configuración debe mantenerse incluso después de instalar la nueva versión.

Revisa System->Configuration->Clerk para asegurarte de que todo sigue allí.

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

Desinstalación #

Para eliminar Clerk de tu tienda Magento 1, deberás desactivar la extensión desde el portal de administración de Magento 1.

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

En la siguiente página, busca “Clerk” en el menú lateral izquierdo y elige “Settings”.

Desde aquí verás “Clerk Settings”. Al lado de “Enable”, elige “No” en el desplegable para desactivar la extensión Clerk.

Si implementaste Clerk usando la extensión, también puedes desactivar los módulos individuales eligiendo “No” en los desplegables relevantes para Search y Recommendations en esta sección:

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