Esta guía de Configuración avanzada de Better Order Filter cubre opciones avanzadas de exportación, columnas y comportamiento del módulo.
El módulo Better Order Filter proporciona una página de Configuración avanzada para ajustar cómo se comporta el módulo en toda su tienda. Esta configuración controla la detección de columnas personalizadas, la visualización de datos de productos, el rendimiento de exportación y las integraciones para desarrolladores.
Nota: Estos ajustes se aplican globalmente según su contexto activo de PrestaShop (una tienda específica, un grupo de tiendas o todas las tiendas). No son preferencias por empleado. Para preferencias personales como diseños de columnas y filtros activos, utilice los Conjuntos de filtros.
Configuración avanzada
Acceso a la página de configuración
Puede acceder a la configuración del módulo de dos maneras:
- Desde la página de pedidos: Haga clic en Editar filtros en el bloque Filtro de pedidos, luego haga clic en el ícono de engranaje de Configuración avanzada ubicado junto a la barra de Búsqueda rápida. Esto abrirá la página de configuración en una nueva pestaña. Este no es el engranaje separado que se muestra en la barra de herramientas de la cuadrícula de pedidos nativa.
- Desde el Gestor de módulos: Navegue hasta su Gestor de módulos de PrestaShop, busque «Better Order Filter» y haga clic en «Configurar».
Estos puntos de acceso requieren el permiso Configurar en Better Order Filter y Editar en Gestor de módulos. Consulte la documentación principal para la lista completa de permisos.
Configuración de columnas
Columnas añadidas manualmente o por otros módulos
Si ha añadido campos personalizados a su base de datos mediante cambios SQL manuales o módulos de terceros, puede forzarlos a aparecer en su lista de columnas configurables.
Introduzca una columna personalizada por línea utilizando este formato:
column_system_name|Etiqueta de columna
Nota técnica: El nombre del sistema debe coincidir con una clave de columna disponible en la consulta de la lista de pedidos. Si el objeto de pedido carece de una propiedad coincidente, el módulo intentará extraer los datos de una propiedad de la dirección de entrega coincidente. Solo se copia un subconjunto reducido de propiedades decimales del objeto de pedido como alternativa. No asuma que las propiedades de pedido de cadena o enteras ordinarias se copiarán automáticamente.
Deshabilitar la detección automática de columnas personalizadas
Por defecto, el módulo intenta detectar automáticamente nuevas columnas añadidas a la cuadrícula de pedidos por otros módulos. Habilite esta configuración si desea detener este comportamiento.
Esto es muy útil si otro módulo añade columnas internas y desordenadas que no desea que sus empleados vean en la lista de Editar filtros, o si las columnas detectadas automáticamente causan conflictos visuales. Aún puede añadir las columnas necesarias manualmente utilizando la configuración anterior. Las filas detectadas previamente pueden permanecer en ese campo. Elimine esas filas manualmente si ya no deben aparecer en la lista de columnas del modo de edición.
Configuración de visualización de productos
Estos ajustes controlan exactamente qué información se muestra cuando habilita las columnas Detalles del producto o Vista previa del producto en su cuadrícula.
Datos mostrados en la columna «Detalles del producto»
Elija qué puntos de datos aparecen directamente en la fila de la cuadrícula.
- Predeterminado:
image|name|reference|price|quantity - Campos disponibles: Imagen del producto, Nombre del producto, Referencia, Referencia del proveedor, EAN-13, UPC, MPN (PS 1.7.7+), Precio y Cantidad.
Datos mostrados en el cuadro emergente «Vista previa del producto»
Elija qué puntos de datos aparecen al pasar el cursor sobre el ícono compacto de vista previa del producto.
- Predeterminado:
image|name|reference|quantity|price - Campos disponibles: Títulos de columna, Imagen del producto, Nombre del producto, Referencia, Referencia del proveedor, EAN-13, UPC, MPN (PS 1.7.7+), Cantidad, Stock actual y Precio.
Configuración de rendimiento y comportamiento
Buscar por nombres de productos actuales
De forma predeterminada, el filtro de texto del Producto busca en los datos del producto pedido (el nombre del producto en el momento de la compra), pero este ajuste está habilitado por defecto para buscar también en su catálogo en vivo actual los nombres de productos coincidentes. La consulta de origen no está restringida a una fila del idioma actual de la tienda.
- Consejo de rendimiento: Si tiene un catálogo masivo y nota que las búsquedas de productos son lentas, desactivar este ajuste puede mejorar significativamente la velocidad de búsqueda.
Tamaño del lote de exportación (solo Symfony)
Para las versiones modernas de PrestaShop que utilizan listas de pedidos de Symfony, las exportaciones CSV se procesan en lotes para evitar tiempos de espera del servidor.
- Predeterminado: 2000 pedidos por lote.
- Si su servidor tiene límites estrictos de tiempo o memoria y sus exportaciones fallan, reduzca este número. Un número más bajo crea más solicitudes secuenciales en segundo plano, lo que garantiza que la exportación finalice de forma segura.
Mostrar la hora del último cambio de estado (solo Symfony)
Habilite esto para mostrar la fecha y hora exactas en que se aplicó el estado actual directamente dentro de la columna Estado en las listas de pedidos modernas de PrestaShop Symfony.
Configuración de desarrollador e integraciones
Devolución de llamada JavaScript
Si tiene módulos de terceros o scripts personalizados que modifican la lista de pedidos (por ejemplo, agregando botones personalizados o filas codificadas por colores), esas modificaciones podrían desaparecer cuando Better Order Filter actualice la cuadrícula a través de AJAX.
Puede pegar sentencias de JavaScript aquí para que se ejecuten automáticamente cada vez que el módulo finalice una recarga AJAX.
Nota: Introduzca sentencias de JavaScript sin formato, no una declaración de función completa. El módulo envuelve su código automáticamente.
Ejemplo:
window.dispatchEvent(new CustomEvent('pstof:refreshed'));
CSS personalizado
Agregue estilos CSS específicos del sitio para ajustar la apariencia de la barra de herramientas del filtro de pedidos o la cuadrícula de pedidos para que coincida perfectamente con su tema de back office.
Solución de problemas de su configuración
- Ajustes faltantes: Si no ve las opciones Tamaño del lote de exportación o Mostrar la hora del último cambio de estado, es probable que su tienda esté utilizando la ruta heredada de la lista de pedidos.
- Búsquedas lentas: Si la búsqueda por nombre de producto tarda demasiado, desactive la configuración Buscar por nombres de productos actuales.
- Columnas personalizadas en blanco: Si una columna personalizada añadida manualmente permanece en blanco en la cuadrícula, verifique dos veces que el column_system_name coincida exactamente con la clave de consulta de la base de datos o con el objeto de dirección de entrega de la ruta actual de la lista de pedidos de PrestaShop.
- Las columnas detectadas automáticamente siguen apareciendo: Si la desactivación de la detección automática de columnas personalizadas no elimina una columna personalizada existente, elimine la fila existente de Columnas añadidas manualmente o por otros módulos.
- Tiempos de espera de exportación: Reducir el tamaño del lote de exportación no acelera de manera inherente una exportación funcional.
- Devoluciones de llamada que no se ejecutan: Asegúrese de que su Devolución de llamada de JavaScript contenga sentencias ejecutables, no un contenedor de función con nombre.
- CSS que no se aplica: Si el CSS personalizado no se aplica visiblemente, confirme que el selector coincida con el marcado de back office renderizado por el módulo.
Guías relacionadas
- Aprenda a usar los filtros que ha configurado en la Guía de referencia de filtros de pedidos de PrestaShop.
- Comprenda cómo mostrar datos de productos utilizando la Guía de referencia de columnas de la lista de pedidos de PrestaShop.
- Aprenda a extraer sus datos utilizando la Guía de exportación CSV.
- Volver a la Documentación principal.
