Extension

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

Instalación con toolbox #

El Toolbox Script de Clerk 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 ejecutará directamente desde un terminal.

Sugerimos estos: - Apple: iTerm, deberás descargarlo desde Internet; - Windows: Command Prompt, 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 instalarlo, necesitas acceso SSH o SFTP a tu tienda, incluyendo tu Nombre de usuario, Contraseña y Dominio.

Navegar hasta la carpeta #

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

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

3. Navega hasta 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 correcta, en este caso sería magento1.

En este punto solo necesitas ingresar en la carpeta, puedes hacerlo escribiendo:

cd NAME_FOLDER

NAME_FOLDER debe ser reemplazado por el nombre real de la carpeta.

Instalando 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. Después, escribe esta línea para ver una lista de las opciones disponibles dentro del Toolbox:

sh clerk_toolbox_magento.sh

3. Como deseas instalar la extensión, debes usar -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á la instalación de la extensión:

5. ¡Listo! Ahora la extensión está instalada, y puedes configurarla en el backend de tu 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 han sido dañados o faltan, puedes realizar 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 usando la copia de seguridad que se realiza al instalar la extensión.

Utiliza 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 de seguridad por separado con esta línea:

sudo sh clerk_toolbox_magento.sh -b

Configuraciones en my.clerk.io #

Para acceder a tus configuraciones 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ú lateral izquierdo y luego ve a “Configuration”.

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

Más información sobre la Magento 1 Extension, a la que se accede 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 siguiente menú desplegable.

Tamaños de página más pequeños pueden ayudar a evitar que el host supere el tiempo de espera 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 el tiempo sin respuesta antes de que el servidor supere el tiempo de espera, tanto para proteger tus datos como para asegurar que hayas dado suficiente tiempo para que grandes conjuntos de datos se sincronicen con Clerk.

Por defecto 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 por defecto y recomendada.

Hora de sincronización #

Elige 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”.

Ajustes de la extensión #

Si usas v4.8.0 o una versión posterior de la extensión, podrás acceder a los siguientes ajustes 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 realices los cambios, ya que la extensión se sincronizará con los cambios realizados 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 ajuste para ver las opciones disponibles:

Descripción general de la extensión #

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

Ajustes de Clerk #

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

Aquí también se encuentra tu habilidad de habilitar/deshabilitar la extensión Clerk, así como tus claves públicas y privadas de la API.

• Actualizaciones en tiempo real:

  • Additional Fields

• Incluir páginas

  • Additional Fields

• Recopilar Emails y carritos de clientes:

• Desactivar sincronización de pedidos:

• Incluir productos agotados

• Idioma y URL de importación: Es probable que estos se hayan configurado 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 ingresa la nueva URL de importación aquí.

Ajustes de Search #

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

Ajustes de Search Page:

• Después de seleccionar “Yes”, aparecerán opciones para ingresar el nombre de tu elemento Search Page, que coincide con el campo data-template que se encuentra en el embed code de tu Element en my.clerk.io. En este ejemplo, search-page.

• También puedes establecer el texto para el botón " Load More" aquí, así como el texto que aparecerá cuando no se encuentren resultados para una consulta.

Ajustes de Faceted Search:

• Después de habilitar la búsqueda facetada, tendrás la opción de ingresar los atributos que te gustaría 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 search page desde el diseño y puedes mostrarlas haciendo referencia al campo ID de diseño.

El diseño ID puede encontrarse 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 a editar el diseño.

Nota: Ahora puedes llamar los datos de categorías y páginas en tu página de Search de la misma forma que lo harías en tu Live Search, dándote una mayor variedad de información para captar la atención de tus clientes. Para más información puedes consultar aquí.

Ajustes de Live Search

• Después de habilitar Live Search, puedes seleccionar si quieres que Categories se muestren en tus resultados, así como el número de resultados de búsqueda por suggestions, categories y content que se mostrarán en Live Search.

  • También tienes la opción de elegir qué tipos de página se mostrarán 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 elemento para tu live search a continuación, que puede encontrarse junto a data-template en tu embed code de Live Search dentro de tu Element de my.clerk.io. Lo más probable es que sea live-search.

• Por último, proporciona tu Live Search Input Selector, que puede identificarse inspeccionando la caja de búsqueda de tu tienda con el navegador, y localizando el ID o clase asociados con su input. En este ejemplo, #search.

Ajustes de Recommendations #

De forma similar a Search, activa tus ajustes de Powerstep, Exit Intent, Category Page, Product Page y Cart de Clerk seleccionando “Yes” en los menús desplegables correspondientes.

Después de seleccionar “Yes” en el menú desplegable correspondiente, se te dará una casilla para ingresar el nombre del Elemento de Clerk Recommendations que deseas incluir en esa página.

• Igual que en las funcionalidades de Search, puedes encontrar el nombre del elemento junto a data-template en el embed code dentro de my.clerk.io > Recommendations > Elements. En este ejemplo, hemos activado los ajustes de Category Page e incluido category-page-popular como nuestro elemento.

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

Registro de actividad (Logging) #

Los ajustes de Logging incluyen:

Nivel de Logging

• Solo Errores: Registrará cualquier error que impida al módulo funcionar correctamente.

• Error + Warn: También registra advertencias que no detienen el funcionamiento del módulo, pero que podrían ser necesarias solucionar igualmente.

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

Logging to

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

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

Traducción de textos #

La extensión Clerk para Magento incluye traducciones integradas para danes, 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 hacerlo, 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.

Busca la carpeta para tu idioma (en la carpeta locale de Magento) y pega el archivo aquí.

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 hacia la más reciente.

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 tener:

• Guardado los archivos modificados localmente en tu FTP o

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

Usualmente, los archivos que más cambian los desarrolladores son Product.php y Productbase.php, que controlan product attributes.

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 #

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 configura Enable como No y haz clic en Save Config.

2. Después, desinstálala ya sea mediante Magento Connect o eliminando los archivos desde FTP si la instalaste directamente aquí.

De lo contrario, es posible que tu página de Configuration deje de funcionar y ninguna de las extensiones funcione después.

Instala la última versión #

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

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

Verifica en System->Configuration->Clerk para asegurarte de que todo sigue ahí.

¡Ahora tienes la versión más reciente de Clerk para Magento instalada!

Desinstalación #

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

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

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

Aquí verás “Clerk Settings”. Junto a “Enable”, selecciona “No” en el menú desplegable para deshabilitar la extensión Clerk.

Si implementaste Clerk usando la extensión, también puedes deshabilitar los módulos individuales seleccionando “No” en los menús desplegables de Search y Recommendations correspondientes 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 embebidos correspondientes de esos archivos.