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 logs. Esta guía también cubre la instalación mediante Toolbox Script, la actualización y la desinstalación.

Instalando con toolbox #

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

El Toolbox Script se ejecutará directamente desde una 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 puedas restaurarla si algo sale mal.

Qué necesitas #

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

Navegando a la carpeta #

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

ssh Stefan@mywebshop.com

2. Se te pedirá que escribas la contraseña de tu usuario (la terminal no dará ninguna respuesta mientras la escribes, pero la está registrando de todos modos).

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

cd /var/www/html

y escribiendo:

ls

El comando ls muestra las carpetas para que puedas encontrar tu directorio raíz de Magento.

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

En este punto, lo que tienes que hacer es entrar en la carpeta, lo puedes hacer escribiendo:

cd NOMBRE_CARPETA

NOMBRE_CARPETA se reemplaza 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 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 quieres instalar:

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

4. Ahora se te pedirá que escribas tu contraseña. Luego de hacer esto, el script hará una copia de seguridad de tu carpeta de Magento1 y empezará la instalación de la extensión:

5. ¡Listo! Ahora la extensión está instalada y puedes configurarla desde 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 se han dañado o faltan, puedes hacer una desinstalación forzosa así:

sudo sh clerk_toolbox_magento.sh -u --force

Restaurar En caso de que algo vaya mal en tu tienda, siempre puedes restaurarla usando la copia de seguridad que se crea al instalar la extensión.

Utiliza esta línea para ello:

sudo sh clerk_toolbox_magento.sh -r

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

sudo sh clerk_toolbox_magento.sh -b

Configuración de my.clerk.io #

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

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

Los siguientes ajustes están disponibles en la Extensión de Magento 1 a través del portal de administración de Magento 1.

Historial de pedidos #

Elige la cantidad de tiempo desde el cual deseas sincronizar datos de pedidos de tu tienda a Clerk de forma retroactiva.

Tamaño de página #

Elige el tamaño de página de tus datos sincronizados en el menú desplegable de abajo.

Tamaños de página más pequeños pueden ayudar a evitar timeouts 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 el tiempo sin respuesta antes de que el servidor agote el tiempo de espera, para proteger tus datos y asegurarte de que has dado suficiente tiempo para sincronizar conjuntos de datos grandes con Clerk.

El valor predeterminado es 60 segundos.

Análisis de datos #

Elige si quieres que los 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.

Tiempo de sincronización #

Establece 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 la v4.8.0 o una versión más reciente de la extensión, podrás acceder a los siguientes ajustes de dos maneras después de añadir tus Claves Públicas y Privadas 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 sincroniza con los cambios realizados en my.clerk.io y viceversa.

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

Haz clic en Edit en una configuración para ver sus opciones disponibles.

Descripción general 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 #

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

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

• Actualizaciones en tiempo real:

  • Campos adicionales

• Incluir páginas

  • Campos adicionales

• Recopilar Emails y carritos de clientes:

• Sync Subscribers: Importa el estado de suscriptores del boletín para usar en audiencias de email de Clerk.io.

• Desactivar sincronización de pedidos:

• Incluir productos sin stock

• Sólo sincronizar productos con visibilidad: Limita el feed de productos a los productos con los valores de visibilidad de Magento seleccionados.

• Activar seguimiento de devoluciones: Envía los productos devueltos a Clerk.io cuando Magento registra una devolución.

• Ancho/alto personalizado de la imagen: Define las dimensiones para las imágenes enviadas en el feed de productos. Déjalo vacío para usar los 210 píxeles predeterminados de la extensión.

• Idioma y URL de importación: Probablemente se configuraron al instalar la extensión Clerk y sincronizarlos con my.clerk.io. Si estos valores cambian, simplemente elige el nuevo idioma de la tienda o inserta aquí la URL de importación actualizada.

Ajustes de Search #

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

Ajustes de Search Page:

• Tras seleccionar Yes, introduce el nombre del Search Page Element que aparece en el campo data-template del código de inserción. Por ejemplo, utiliza search-page si ese es el nombre de tu Element.

• También puedes configurar aquí el texto del botón " Load More", así como el texto mostrado cuando no hay resultados para una consulta.

• Mostrar categorías, número de categorías, número de páginas y tipo de páginas controlan los resultados que no son productos en la Search Page.

Ajustes de Faceted Search:

• Tras habilitar la búsqueda facetada, tienes 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 que desees y elegir el orden en el que aparece cada faceta.

Utiliza Multiselect Attributes para permitir que los visitantes elijan más de un valor en una faceta al mismo tiempo.

Personalizar 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 ID de diseño se encuentra en el backend de Clerk, en la columna de la izquierda de cada diseño en la página de resumen de diseño y en la esquina inferior izquierda de la página una vez que entres para 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 manera que lo harías en Live Search, ofreciéndote una gama más amplia de información para captar la atención de tus clientes. Para más información, puedes consultar aquí.

Ajustes de Live Search

• Tras activar Live Search, puedes seleccionar si deseas que Categories aparezcan en tus resultados, así como la cantidad de resultados de sugerencias, categorías y contenido que se mostrarán dentro de Live Search.

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

  • Puedes elegir la posición del menú desplegable de live search respecto a tu caja de búsqueda con Dropdown Positioning.

• Proporciona el nombre del Element para tu live search, que se encuentra junto a data-template en tu Live Search embed code dentro de tu elemento en my.clerk.io. Probablemente sea live-search.

• Proporciona el Live Search Input Selector inspeccionando la caja de búsqueda de tu tienda e identificando el ID o la clase del input. Para un input con el ID search, usa #search.

• Form Selector es el selector para el formulario de búsqueda. Úsalo cuando tu tema tenga un formulario personalizado y la redirección de búsqueda predeterminada no sea correcta.

Ajustes de Recommendations #

Similar a Search, activa tus opciones Powerstep, Exit Intent, Category Page, Product Page y Cart seleccionando “Yes” en los menús desplegables correspondientes.

Tras seleccionar “Yes”, se te ofrece una caja para introducir el nombre del Element de las Recommendations de Clerk que quieras incluir en esa página.

• Encuentra el nombre del Element en el campo data-template del código de inserción bajo Recommendations > Elements en my.clerk.io. Por ejemplo, introduce category-page-popular en la configuración de la Category Page si ese es el nombre de tu Element.

• Puedes agregar múltiples nombres de elementos como valores separados por comas aquí, si deseas que se muestren varios elementos en esa misma página.

• Filter Duplicates está disponible para Powerstep, Category Page, Product Page y Cart. Actívalo para evitar mostrar el mismo producto en varios sliders de recomendaciones en esa página.

Logging #

Las configuraciones de Logging incluyen:

Logging Level

• Only Errors: Registrará cualquier error que impida que el módulo funcione correctamente.

• Error + Warn: También registra advertencias que no impiden que el módulo funcione, pero pueden requerir revisión.

• Error + Warn + Debug: Registra todo lo que el módulo toca. No debe activarse en una tienda en vivo 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.

Configura Enable en Yes antes de utilizar logging. Al registrar en un archivo, la extensión usa la ruta de archivos mostrada en la configuración. Debug Mode abre la guía de depuración de la extensión.

Traduciendo textos #

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

Puedes agregar fácilmente una traducción para tu idioma, para que la parte frontend se muestre 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 correspondiente a tu idioma (en la carpeta locale de Magento) y coloca aquí el archivo.

Traduce el texto de la columna de la derecha del archivo CSV y guárdalo.

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

Guarda los cambios #

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

• Guardado los archivos modificados localmente en tu FTP o

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

Normalmente, los archivos que más se modifican son Product.php y Productbase.php, que controlan los 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

Desactiva y desinstala #

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

1. Desactiva la extensión antigua 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 bien a través de Magento Connect o borrando los archivos desde FTP si la instalaste directamente desde allí.

De lo contrario, tu página de Configuration podría dejar de funcionar y ninguna de las extensiones funcionaría después.

Instala la última versión #

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

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

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

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

Desinstalación #

Para eliminar Clerk de tu tienda Magento 1, deberás desactivar la extensión dentro del 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, busca " Clerk" en el menú lateral izquierdo y elige " Settings".

Desde aquí, verás que aparecen las “Clerk Settings”. Junto a " Enable" selecciona " No" en el menú desplegable para dejar de habilitar la extensión Clerk.

Si implementaste Clerk.io a través de la extensión, también puedes desactivar módulos individuales configurando las opciones de Search y Recommendations en No.

Si instalaste algún elemento de Clerk directamente desde tus archivos FTP, asegúrate de eliminar los códigos de inserción correspondientes de esos archivos.