Extension

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

Instalación con toolbox #

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

El Toolbox Script se ejecuta directamente desde un terminal.

Sugerimos los siguientes: - Apple: iTerm, que tendrás que descargar de Internet; - Windows: Command Prompt, que ya está instalado en tu ordenador.

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

Qué necesitas #

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

Navegando a la carpeta #

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

ssh Stefan@mywebshop.com

2. Se te pedirá que introduzcas la contraseña de tu usuario (el terminal no mostrará retroalimentación al escribir la contraseña, pero sí la está registrando).

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 que encuentres la correcta:

En la lista de carpetas, busca la carpeta correcta, en este caso sería magento1.

En este punto, lo que debes hacer es entrar en la carpeta, lo 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, debes 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 introduzcas 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 backend 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 En caso de que algo salga mal en tu tienda, siempre puedes restaurarla a través de la copia de seguridad que se realiza 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á una copia de seguridad primero, pero también puedes crear una copia aparte con esta línea:

sudo sh clerk_toolbox_magento.sh -b

Ajustes en my.clerk.io #

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

Aquí encontrarás opciones para personalizar cómo se sincronizan tus datos de productos, clientes y pedidos con Clerk.

Más información sobre la Magento 1 Extension, 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 datos de pedidos de forma retroactiva desde tu tienda hacia Clerk aquí.

Tamaño de página #

Elige el tamaño de página de tus datos sincronizados en el desplegable a continuación.

Tamaños de página más pequeños pueden ayudar a evitar que el host se agote 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 #

Configura la cantidad de tiempo sin respuesta antes de que el servidor agote el tiempo de espera, para proteger tus datos y asegurar que des tiempo suficiente para sincronizar grandes conjuntos de datos con Clerk.

El predeterminado es 60 segundos.

Procesamiento de datos #

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

El procesamiento 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.

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 la siguiente configuración de dos maneras 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 podrás 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 la cuenta de administrador de tu tienda y elige “Configuration” > “Clerk” > “Settings”.

Ajustes de Clerk #

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

También aquí puedes habilitar/deshabilitar la extensión Clerk, así como tus claves públicas y privadas de la API.

• Actualizaciones en tiempo real:

  • Campos adicionales

• Incluir páginas

  • Campos adicionales

• Recopilar Emails y carritos de clientes:

• Deshabilitar sincronización de pedidos:

• Incluir productos sin stock

• Idioma y URL de importación: Probablemente se configuraron 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í.

Ajustes de búsqueda #

Para habilitar tu Search Page, Search Page Facets y/o Live Search de Clerk, selecciona “Sí” en los menús desplegables correspondientes.

Ajustes de Search Page:

• Después de seleccionar “Sí”, aparecen opciones para introducir el nombre del Search Page Element, que debe coincidir con el campo data-template que se encuentra en el código embed de tu Element en my.clerk.io. En este ejemplo, search-page.

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

Ajustes de búsqueda facetada:

• Después de habilitar la búsqueda facetada, tienes la opción de ingresar 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 que aparece cada faceta.

Personalización de facetas #

Clerk te permite diseñar las facetas de tu página de búsqueda desde el diseño y puedes mostrar esto referenciándolo con el campo del ID del diseño.

El ID de diseño se encuentra en el backend de Clerk, en la columna más a la izquierda de cada diseño en la página de resumen de diseños y en la esquina inferior izquierda de la página una vez que entras al diseño para editarlo.

Nota: Ahora puedes llamar los datos de categorías y páginas en tu Search page de la misma forma que en tu Live search, ofreciéndote un mayor rango de información para atraer a tus clientes. Para más información puedes consultar aquí.

Ajustes de Live Search

• Tras habilitar Live Search, puedes seleccionar si quieres que se muestren las Categories en los resultados, así como la cantidad de resultados para suggestions, categories y content dentro de Live Search.

  • También puedes optar por elegir qué tipos de página mostrar como resultados de búsqueda, 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 del Element para tu búsqueda en vivo, que se encuentra junto a data-template en tu código embed de Live Search dentro de tu Element en my.clerk.io. Probablemente sea live-search.

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

Ajustes de Recommendations #

Al igual que Search, habilita tus configuraciones Clerk de Powerstep, Exit Intent, Category Page, Product Page y Cart seleccionando “Sí” en los menús desplegables correspondientes.

Al seleccionar “Sí” en el desplegable adecuado, tú recibes una caja para introducir el nombre del Element de Recommendations de Clerk que deseas incluir en esa página.

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

• Si lo deseas, puedes agregar varios nombres de elementos separados por comas aquí si quieres mostrar múltiples elementos en la página, por ejemplo.

Registro de eventos #

La configuración de Logging incluye:

Nivel de Logging

• Solo errores: Registrará cualquier error que haga que el módulo deje de funcionar correctamente.

• Error + Warn: También registra advertencias que no hacen que el módulo deje de funcionar, pero que quizás debas arreglar igualmente.

• Error + Warn + Debug: Registra todo lo que el módulo hace. Esto no debe estar habilitado en una tienda en producción, ya que ralentizará el sitio.

Logging a

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

• my.clerk.io: Todo será registrado en Developers->Logs dentro del backend de my.clerk.io.

Traducción de textos #

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

Puedes añadir fácilmente una traducción para tu idioma, de modo que las partes del frontend se muestren correctamente.

Para ello, debes ir a esta carpeta en FTP:

app->locale

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

Busca la carpeta de tu idioma (en la carpeta locale de Magento) e inserta el archivo allí.

Ahora puedes traducir los textos a tu idioma en el lado derecho 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

Guarda cambios #

Antes de intentar actualizar, asegúrate de que has:

• Guardado los archivos modificados localmente en tu FTP o

• Hecho una copia de seguridad de los archivos modificados, que puedas transferir a la nueva extensión.

Normalmente, los archivos que más suelen cambiar los desarrolladores son Product.php y Productbase.php, que controlan los atributos de productos.

Estos 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 esto:

1. Desactiva la antigua extensión desde 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 desde Magento Connect o eliminando los archivos por FTP si la instalaste directamente allí.

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

Instalar la última versión #

Por último, instala nuevamente la última extensión y transfiere cualquier archivo del que haya hecho respaldo a tu servidor FTP.

Tu configuración debería conservarse, incluso al instalar la versión nueva.

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

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

Desinstalación #

Para eliminar Clerk de tu tienda Magento 1, debes desactivar la extensión en tu portal de administración de Magento 1.

Accede al portal de Magento 1 de tu tienda y selecciona " System" > " Configuration" en el menú superior.

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

Desde aquí verás aparecer “Clerk Settings”. Al lado de " Enable", selecciona " 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 seleccionando “No” en los desplegables correspondientes de 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 embed correspondientes de esos archivos.