Sync Data
Sincroniza tus productos, atributos y datos de pedidos de Magento 1 con Clerk. Esta guía cubre la personalización de datos de producto, elegir qué productos importar, cambiar tamaños de imagen y gestionar la sincronización de pedidos.
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 puede desactivarse ya que el seguimiento de ventas de la extensión toma el control.
Para desactivar la sincronización de pedidos, acceda al backend de Magento1, seleccione SYSTEM en la barra de menú y presione CONFIGURATION:
Elija el sitio principal (el sitio que está intentando afectar) bajo Ámbito de configuración actual:
Luego haga clic en SETTINGS bajo la pestaña CLERK en la barra lateral izquierda y luego cambie el campo junto a DISABLE ORDER SYNCHRONIZATION de NO a SÍ.
Presione GUARDAR CONFIGURACIÓN para que los cambios tengan efecto de inmediato:
Cambio de tamaños de imágenes #
Por defecto, la extensión Clerk para Magento obtiene las 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 desees que tengan las imágenes y guarda el archivo.
Luego ve a my.clerk.io -> Datos y realiza una nueva sincronización haciendo clic en Iniciar sincronización.
Tus nuevas imágenes ahora estarán sincronizadas.
Elegir productos para importar #
Mostrar productos fuera de stock #
Si también quieres mostrar los productos que están fuera de stock en tus resultados de Clerk, puedes controlarlo fácilmente desde el backend de Magento.
Comienza yendo a:
Sistema -> Configuración -> CLERK -> Ajustes
Elige tu Vista de Tienda desde el menú de la izquierda y ve a Ajustes de Clerk.
Aquí, establece Incluir productos fuera de stock a Sí y haz clic en Guardar Configuración:
Finalmente, ve a my.clerk.io -> Datos y haz clic en Iniciar Nueva Sincronización de Datos para importar todos los productos, incluyendo los que están fuera de stock.
Cambios avanzados #
En Magento, el siguiente archivo controla qué productos se importan a Clerk:
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.
Por defecto, solo se importan los productos con visibility: both (Catálogo, Search) que también están en stock.
Esto se puede cambiar en los dos lugares siguientes:
Si cambias los productos importados por Clerk, recomendamos encarecidamente que también añadas 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 sea true o false, puedes usarlo así en Diseños:
{% if product.is_saleable %}
<div class="in-stock">In Stock</div>
{% else %}
<div class="not-in-stock">Not In 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.
Personalización de datos de producto #
En Magento 1, puedes añadir atributos de producto personalizados a través del backend de Magento, o mediante la extensión Clerk en código, si es necesario.
Añadir atributos simples #
Nota: Esta función solo funciona desde la versión v.4.2.3.
Si los atributos que quieres enviar ya están disponibles como atributos simples en tu administrador de Magento, se pueden añadir fácilmente en la página de Extensión.
En tu backend de Magento, empieza yendo a Catálogo -> Atributos -> Administrar Atributos
Encuentra los códigos de atributos de los atributos que deseas agregar:
- Ve a Sistema -> Configuración
- Bajo Clerk -> Settings escribe tus atributos en Campos Adicionales y haz clic en Guardar Configuración:
- 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 quieres enviar ya están disponibles como parte de tus datos de productos configurables/grupados en tu administrador de Magento, pueden sincronizarse fácilmente en la última versión de tu plugin.
Aparecerán como child_attribute, por ejemplo, child_color, child_skus etc.
Añadir atributos mediante código #
Si tu atributo usa 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 producto, con todos los atributos:
Luego puedes añadir nuevos atributos a la lista con esta sintaxis:
$data->setAttributeName($this->insertMagentoLogic());
donde setAttributeName define el nombre que quieres que tenga en Clerk, 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 podría requerir una lógica más avanzada que una simple función.
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.
Modificación de la extensión #
Añadir/cambiar datos de producto #
En caso de que quieras añadir atributos extra o cambiar los existentes para tus productos, deberías localizar 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 añadir atributos simples.
Productpage.php te permite crear lógicas avanzadas para obtener atributos, y usarlas en Product.php.
Cambiar datos de categoría #
Quizá necesites reestructurar los nombres de las categorías, o eliminar categorías específicas de Clerk.
En estos casos, localiza este archivo:
app->code->community->Clerk->Clerk->Model->Catalog->Product.php
Este archivo maneja qué categorías se incluyen, y los datos id, name, URL y subcategorías para cada categoría.
No puedes añadir datos extra a cada categoría, pero puedes modificar lo que se envía.
Estilizando Powerstep #
Powerstep tiene un estilo estándar, pero quizá quieras 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 Clerk extensión, incluyendo Powerstep.
Puedes usar estos archivos para modificar la apariencia de Powerstep.
Modificando la página de Search #
Si quieres cambiar la distribución de la Search Page, añade un slider a la página de no resultados, etc. necesitas encontrar este archivo:
app->design->frontend->base->default->template->clerk->powerpage.phtml
Esto te permite cambiar el código de incrustación de búsqueda y otras partes de la Search Page.
Cambiar títulos de Live-Search #
Los títulos que se muestran en la Live-Search para productos y categorías se pueden cambiar en este archivo:
app->design->frontend->base->default->template->clerk->livesearch.phtml
Aquí, simplemente traduce Categories y Products a lo que quieras:
Productos agrupados como variantes #
Por norma, Magento usa Configurable Products para manejar productos principales y variantes.
La extensión Clerk ha sido diseñada para soportarlo, ya que es la mejor práctica para Magento.
Sin embargo, si has configurado tus Variants usando Grouped Products, tu seguimiento de ventas no funcionará, ya que estarás rastreando ID’s de productos que Clerk no ha importado desde tu tienda Magento.
Esto se debe a que Variants normalmente no son visibles.
Clerk no podrá ver las conexiones entre productos cuando no estén importados:
Para Clerk, normalmente no importa cuál variante se compre, siempre que el producto “main” al que pertenece esté rastreado.
Para arreglar 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, normalmente 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 debe modificarse, para que no importe qué variante de producto agrupado haya sido comprada, siempre se envíe el ID del producto “main”.
Los pedidos importados #
El mismo proceso debe hacerse para los pedidos anteriores que se importan para saber qué productos “main” se han adquirido anteriormente.
Este archivo lo maneja:
app->code->Model->Orderpage.php
Alrededor de la línea 44, en la función orderFormatter($order) el ID del producto se envía desde Magento:
Cambia esto por la misma lógica que el seguimiento de ventas.
Verificar 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 y abre el pedido que acabas de realizar.
Si puedes ver los productos Main en el pedido, incluyendo su nombre e imagen, tu código funciona:
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.