Sync Data

Desactivar la sincronización de pedidos #

Después de que la primera sincronización de datos se haya ejecutado con éxito, la sincronización de pedidos desde Magento1 se puede desactivar ya que el seguimiento de ventas de la extensión toma el control.

Para desactivar la sincronización de pedidos, accede a tu backend de Magento1, elige SISTEMA en la barra de menú y presiona CONFIGURACIÓN:

Elige el sitio principal (el sitio que intentas afectar) bajo ALCANCE DE CONFIGURACIÓN ACTUAL:

Luego haz clic en AJUSTES bajo la pestaña CLERK en la barra lateral izquierda y cambia el campo junto a DESACTIVAR SINCRONIZACIÓN DE PEDIDOS de NO a SÍ. Presiona GUARDAR CONFIG para que los cambios surtan efecto de inmediato:

Cambiar tamaños de imágenes de productos #

Por defecto, la extensión Clerk.io para Magento obtiene imágenes con un tamaño de 210x210 px.

Esto se puede cambiar en el siguiente archivo:

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

En la parte superior de este archivo, las variables $imageHeight y $imageWidth controlan la altura y el ancho de cada imagen:

Cambia estos valores al tamaño que deseas que tengan las imágenes y guarda el archivo.

Luego ve a my.clerk.io -> Sincronización de Datos y ejecuta una nueva sincronización, haciendo clic en Iniciar Sincronización.

Tus nuevas imágenes ahora serán sincronizadas.

Elegir Productos Para Importar #

Mostrar productos fuera de stock #

Si también deseas mostrar productos que están fuera de stock en tus resultados de Clerk.io, puedes controlar esto fácilmente en el backend de Magento.

Comienza yendo a:

Sistema -> Configuración -> CLERK -> Ajustes

Elige tu Vista de Tienda desde el menú izquierdo y ve a Ajustes de Clerk.

Aquí, establece Incluir Productos Fuera de Stock en Sí y haz clic en Guardar Config:

Finalmente, ve a my.clerk.io -> Datos y haz clic en Iniciar Nueva Sincronización de Datos para importar todos los productos, incluidos los que están fuera de stock.

Cambios avanzados #

En Magento, el siguiente archivo controla qué productos se importan a Clerk.io:

app->code->community->Clerk->Clerk->Model->Productpage.php

La función load($page,$limit) es responsable de controlar la colección de productos que se envían a Clerk.io. Por defecto, solo se importan productos con visibilidad: ambos (Catálogo, Búsqueda) que también están en stock.

Esto se puede cambiar en los dos siguientes lugares:

Si cambias los productos importados por Clerk.io, recomendamos encarecidamente que también agregues un atributo adicional que indique cuándo un producto no es vendible o visible, para que puedas mostrarlo en tu Diseño y puedas filtrarlo.

Suponiendo que creas un atributo llamado is_saleable que es true o false, puedes usarlo así en Diseños:

{% if product.is_saleable %}
   <div class="in-stock">En Stock</div>
{% else %}
  <div class="not-in-stock">No En Stock</div>
{% endif %}

Finalmente, ve a my.clerk.io -> Datos y haz clic en Iniciar Nueva Sincronización de Datos para importar tus nuevos datos.

Personalizando Datos de Productos #

En Magento 1, puedes agregar atributos de producto personalizados a través del backend de Magento, o a través de la extensión Clerk.io en código, si es necesario.

Agregar atributos simples #

Nota: Esta función solo funciona desde v.4.2.3.

Si los atributos que deseas enviar ya están disponibles como atributos simples en tu administración de Magento, se pueden agregar fácilmente en la página de la Extensión.

1. En tu backend de Magento, comienza yendo a Catálogo -> Atributos -> Administrar Atributos

2. Encuentra los códigos de atributo de los atributos que deseas agregar:

3. Ve a Sistema -> Configuración

4. Bajo Clerk -> Ajustes escribe tus atributos en Campos Adicionales y haz clic en Guardar Config:

5. Después de implementar tus atributos, ve a my.clerk.io->Datos y haz clic en Iniciar Nueva Sincronización de Datos en la esquina superior derecha.

Si los atributos que deseas enviar ya están disponibles como parte de los datos de tus productos configurables/grupales en tu administración de Magento, se pueden sincronizar fácilmente en la última versión de tu complemento. Aparecerán como child_attribute, por ejemplo, child_color, child_skus, etc.

Agregar atributos a través del código #

Si tu atributo utiliza una función estándar de Magento, esto se puede implementar directamente en Product.php:

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

La función getClerkExportData() construye el objeto del producto, con todos los atributos:

Luego puedes agregar nuevos atributos en la lista con esta sintaxis:

$data->setAttributeName($this->insertMagentoLogic());

donde setAttributeName define el nombre que deseas que tenga en Clerk.io, y insertMagentoLogic(); utiliza una lógica de Magento para obtener un valor del producto.

Usando funciones de atributos personalizados #

A veces, un atributo de Magento puede requerir una lógica más avanzada que una función simple. En este caso, localiza este archivo:

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

En Productbase.php puedes escribir funciones PHP avanzadas para cargar atributos personalizados.

Después de definir una función, puedes incluirla en Product.php igual que las funciones existentes.

Por ejemplo:

$data->setAge($this->getAge());

Después de implementar tus atributos, ve a my.clerk.io->Datos y haz clic en Iniciar Nueva Sincronización de Datos en la esquina superior derecha.

Modificando La Extensión #

Agregar/Cambiar Datos de Productos #

En caso de que desees agregar atributos adicionales o cambiar los existentes para tus productos, debes encontrar estos archivos:

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

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

Product.php construye el modelo de producto y te permite agregar atributos simples.

Productpage.php te permite crear lógicas avanzadas para obtener atributos y usarlos en Product.php.

Cambiar Datos de Categoría #

Quizás necesites reestructurar los nombres de las categorías o eliminar categorías específicas de Clerk.io.

En estos casos, encuentra este archivo:

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

Este archivo maneja qué categorías están incluidas, y los datos id, nombre, URL y subcategorías para cada categoría.

No puedes agregar datos extra a cada categoría, pero puedes modificar lo que se envía.

Estilizando el Paso Agregar al Carrito (Powerstep) #

El powerstep tiene un estilo estándar, pero puede que desees cambiarlo para que coincida con tus diseños.

Estos archivos se utilizan para el estilo:

app->design->frontend->base->default->template->clerk->powerpage.phtml

app->design->frontend->base->default->template->clerk->powerpopup.phtml

skin->frontend->base->default->clerk->style.css

powerpage.phtml contiene el HTML para la página mientras que powerpopup.phtml es para el popup.

style.css contiene el CSS para todas las partes de la extensión Clerk.io, incluido el Powerstep.

Puedes usar estos archivos para modificar la apariencia del Powerstep.

Modificando la Página de Búsqueda #

Si deseas cambiar el diseño de la Página de Búsqueda, agregar un slider a la página de sin resultados, etc., necesitas encontrar este archivo:

app->design->frontend->base->default->template->clerk->powerpage.phtml

Esto te permite cambiar el código de inserción de búsqueda y otras partes de la página de búsqueda.

Cambiar títulos para Productos y Categorías en la Búsqueda en Vivo #

Los títulos mostrados en la Búsqueda en Vivo para productos y categorías se pueden cambiar en este archivo:

app->design->frontend->base->default->template->clerk->livesearch.phtml

Aquí, simplemente traduce Categorías y Productos a lo que desees:

Productos Agrupados Como Variantes #

Por defecto, Magento utiliza Productos Configurables para manejar productos principales y variantes. La extensión Clerk.io ha sido creada para soportar esto, ya que es la mejor práctica para Magento.

Sin embargo, si has configurado tus Variantes utilizando Productos Agrupados, tu seguimiento de ventas no funcionará, ya que estarás rastreando ID’s de productos que Clerk.io no ha importado desde tu tienda Magento. Esto se debe a que las Variantes generalmente no son visibles.

Clerk.io no podrá ver conexiones entre productos, cuando no son importados:

Para Clerk.io, generalmente no importa cuál variante se compra, siempre que el " principal" producto al que pertenece sea rastreado.

Para solucionar esto, necesitas cambiar 2 archivos en la extensión, para que coincidan con tu configuración.

El Seguimiento de Ventas #

El archivo que genera los datos de seguimiento de ventas es este:

app->code->Block->SalesTracking.php

En este archivo, generalmente alrededor de la línea 65, se utiliza el siguiente fragmento de código para obtener el ID del producto que ha sido comprado:

Esto necesita ser cambiado, para que no importe qué variante de producto agrupado ha sido comprada, siempre se envíe el ID del producto “principal”.

Los Pedidos Importados #

El mismo proceso debe hacerse para los pedidos anteriores que se importan para que sepamos qué productos “principales” han sido comprados anteriormente.

Este archivo lo maneja:

app->code->Model->Orderpage.php

Alrededor de la línea 44, en la función orderFormatter($order) se envía el ID del producto desde Magento:

Cambia esto a la misma lógica que el seguimiento de ventas.

Verifica si tus cambios funcionan #

Ahora, ve a my.clerk.io -> Datos y haz clic en Iniciar Nueva Sincronización de Datos para importar los datos más recientes:

Procede a realizar un pedido de prueba donde compres un producto que tenga variantes.

Después, ve a Pedidos Rastreado y verifica el pedido que acabas de realizar. Si puedes ver los productos Principales en el pedido, incluyendo su nombre e imagen, tu código funciona: