Extension

Instalación con el script de Toolbox #

El script de Toolbox de Clerk.io ha sido creado 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, i ya está instalado en tu computadora.

El script también crea una copia de seguridad de la carpeta Magento2 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 y Contraseña.

1. Navegando a la carpeta Magento2 #

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 escribas 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).

Navega a la carpeta raíz de Magento2. 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 magento2. 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.

2. 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-magento2/master/clerk_toolbox_magento2.sh

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

sh clerk_toolbox_magento2.sh

2.3. Dado que deseas instalar la extensión, usarás -i junto con el número de versión más reciente de la extensión. Escribe esta línea:

sudo sh clerk_toolbox_magento2.sh -i

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

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

Opcionales #

Desinstalando

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

sudo sh clerk_toolbox_magento2.sh -u

Restaurando

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_magento2.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_magento2.sh -b

Configuraciones de my.clerk.io #

Para acceder y modificar la configuración de datos de tu Magento 2 en Clerk.io, 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”.

Nota: La información sobre la extensión de Magento 2 Clerk.io, disponible a través del portal de administración de Magento, se encuentra más adelante en este artículo.

Aquí, puedes establecer la URL de tu tienda, el tamaño de página de tus sincronizaciones de datos, así como la hora del día en que tus datos deben sincronizarse con Clerk.io (el valor predeterminado es “cuando sea necesario”).

Configuraciones de la extensión #

Si estás usando v6.7.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 Stores > Settings > Configuration > Clerk > Configuration
• 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 “Edit” en cualquier configuración, para ver las opciones disponibles:

Resumen #

Para acceder a tu extensión Clerk.io en Magento 2, inicia sesión en el portal de administración de tu tienda, luego sigue la ruta Stores > Settings > Configuration > Clerk > Configuration

General #

Encontrarás el número de versión de tu extensión Clerk.io, así como las claves API públicas y privadas de tu tienda en la sección General.

Para incluir Páginas en tu sincronización de datos con Clerk.io, elige “Sí” en el siguiente menú desplegable, y escribe cualquier campo adicional que te gustaría incluir con tus datos de página (como imágenes o tipo de página) como valores separados por comas.

También puedes establecer el idioma predeterminado para los datos de tu tienda sincronizados en el último menú desplegable en General.

Sincronización #

En la sección de Sincronización del plugin Clerk.io, tienes la opción de personalizar tus datos sincronizados de clientes, pedidos, cestas y productos.

Las opciones están deshabilitadas y no están disponibles para actualizar cuando se utiliza los datos del sitio web, indicado por la casilla marcada a la derecha de cada sección. Simplemente desmarca la casilla correspondiente para modificar.

• Usar Actualizaciones en Tiempo Real: elige “Sí” para habilitar actualizaciones en tiempo real para tus datos sincronizados con Clerk.io.

• Recoger Correos Electrónicos: selecciona “Sí” aquí para sincronizar correos electrónicos de clientes.

• Recoger Cestas: para recoger datos de cestas y sincronizarlos con Clerk.io, selecciona “Sí” aquí.

  • Para agregar cualquier campo de datos adicional de cesta, inclúyelos como valores separados por comas en la sección de “campos adicionales” a continuación.

• En los siguientes dos menús desplegables, selecciona “sí” para sincronizar solo productos en venta, y/o sincronizar solo productos con visibilidad a Clerk.io.

• Si necesitas deshabilitar la sincronización de pedidos, puedes hacerlo eligiendo “Sí” en este menú desplegable.

Sincronización de Clientes #

Habilita las sincronizaciones de datos de clientes eligiendo “Sí” en el menú desplegable en esta sección. Si tienes algún atributo adicional de cliente que te gustaría incluir en la sincronización de Clerk.io, escribe sus valores en el cuadro de texto aquí como una lista separada por comas.

Búsqueda #

Habilita la Página de Búsqueda de tu tienda eligiendo “Sí” en el menú desplegable aquí.

• Después de seleccionar “Habilitado”, ingresa el nombre de tu Contenido de 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, search-page.

• Puedes establecer el texto de " cargar más" y " sin resultados" que se muestra escribiendo la frase deseada en estos cuadros de texto.

Búsqueda en Vivo #

• Después de seleccionar “Habilitado” en el menú desplegable para habilitar la Búsqueda en Vivo, selecciona si deseas que se muestren Categorías dentro de tus resultados de búsqueda.

  • También puedes seleccionar el número de sugerencias de búsqueda, categorías y resultados de contenido que se mostrarán en la Búsqueda en Vivo además de tus resultados de productos.

• 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”, “Publicaciones de Blog”, o “Todo”.

• 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 de 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 de my.clerk.io. Esto es probablemente live-search.

• Por último, tienes la opción de proporcionar tu Selector de Entrada de Búsqueda en Vivo y Selector de Formulario, que se pueden encontrar inspeccionando el cuadro de búsqueda de tu tienda con tu navegador, e identificando el ID o clase asociada con su entrada y formulario.

  • En este ejemplo, #search como el selector de entrada, y usando el sitio web se elige para identificar el selector de formulario.

Navegación Facetada #

Para agregar facetas a tu Página de Búsqueda, primero asegúrate de seleccionar la casilla “Habilitado” bajo Navegación Facetada.

• Haz clic en los atributos que te gustaría agregar a tus facetas y haz clic en guardar configuración.

• Una vez agregados, tus atributos añadidos aparecerán bajo Títulos. En esta sección, puedes crear el Título que se mostrará para esa faceta, y qué posición en la lista de facetas te gustaría que apareciera ese atributo.

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í.

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.
  
  

Powerstep e Intención de Salida #

Similar a la Búsqueda, habilita tu Powerstep de Clerk.io seleccionando “Sí” en el menú desplegable, luego elige el tipo de powerstep que te gustaría que apareciera (ya sea Página o Popup).

• Proporciona el nombre de Contenido para tu Powerstep, que se encuentra junto a data-template en el código de inserción dentro de tu Contenido de Powerstep en my.clerk.io, power-step-others-also-bought en este ejemplo.

• Sigue el mismo proceso que arriba para habilitar tu Intención de Salida, e identificar y agregar el Contenido de Intención de Salida apropiado.

Página de Categoría, Producto y Carrito #

También similar a la Búsqueda, habilita tus Configuraciones de Página de Producto, Categoría y Carrito de Clerk.io seleccionando “Habilitado” en los menús desplegables apropiados.

• 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 > Recommendations > Content.
  • En este ejemplo, hemos habilitado la Página de Producto, la Página de Categoría y las configuraciones de la Página de Carrito, e incluido category-page-popular como nuestro contenido de Página de Categoría, product-page-alternatives y product-page-others-also-bought en nuestra Página de Producto, así como cart-others-also-bought como nuestro contenido de Página de Carrito.

Registro #

Lo primero que tienes que hacer para cambiar la configuración de registro es ir a tu backend de Magento2 y elegir Stores => Configuration => Clerk => Configuration:

Encuentra el menú desplegable llamado Configuraciones de Registro y establece tus configuraciones de registro preferidas. Termina haciendo clic en Guardar:

Las configuraciones de registro incluyen:

Elegir 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 arreglar 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.

Elegir dónde registrar

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

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

Actualización #

Si estás usando una versión anterior a 3.0.0, actualizar romperá tus Diseños, ya que se usará Clerk.js 2. Si usas una versión anterior, sigue esta guía en su lugar.

Actualizar la extensión de Magento 2 se realiza a través de línea de comandos.

Se hace siguiendo estos pasos:

1. Inicia sesión en tu servidor a través de línea de comandos.

2. Navega a tu carpeta raíz web (generalmente " /var/www/tu_dominio/public_html").

3. Habilita Acceso Raíz escribiendo su y luego ingresa tu contraseña.

4. Escribe los siguientes comandos en orden:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Espera a que la extensión termine.

Tu Magento 2 ahora está actualizado a la última versión.

Desinstalando #

Al igual que cuando instalas extensiones en Magento 2, desinstalar debe hacerse a través de Línea de Comandos.

Simplemente escribe los siguientes comandos en orden para eliminarlo:

1. php bin/magento setup:module:disable Clerk_Clerk

2. composer remove clerk/magento2