Calculadora de cantidades por superficie y volumen: instalación y configuración
Instalación, configuración de productos, márgenes de corte, páginas SEO de calculadora, seguimiento en el carrito y resolución de problemas.
Instalación
Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP, o copie la carpeta dfsurfacecalculator en el directorio /modules/ de su tienda y haga clic en Instalar.
Al instalarse, el módulo crea tres tablas (ajustes por producto, valores por combinación, cálculos guardados en los carritos), registra sus hooks y añade la pestaña Calculadora de cantidades en el menú Catálogo. El botón Configurar del gestor de módulos abre la misma página.
La calculadora no aparece en ninguna ficha mientras no haya un producto configurado, así que puede instalar el módulo en una tienda en producción sin ningún cambio visible inmediato.
Los cinco tipos de cálculo
- Azulejos y suelos (m²): largo × ancho de cada estancia, o superficie conocida. El contenido de una unidad es la superficie que cubre una caja o un paquete.
- Pintura (litros): largo × alto de cada pared, número de manos, rendimiento en m² por litro, puertas y ventanas descontadas. El contenido de una unidad es el volumen del bote.
- Papel pintado (rollos): ancho y alto de cada pared. El módulo cuenta las tiras, redondea el largo de cada tira al rapport del motivo y calcula el número de tiras completas por rollo.
- Volumen: hormigón, grava, tierra (m³): largo × ancho × espesor en centímetros, o volumen conocido. El resultado se da en m³ por unidad, o en sacos si indica la densidad del material y el peso de un saco.
- Longitud: rodapiés, perfiles (m): longitud de cada pared o tramo. El contenido de una unidad es la longitud de una pieza.
Configurar un producto
Abra la ficha del producto, pestaña Módulos, bloque Calculadora de cantidades.
- Marque Mostrar la calculadora en este producto.
- Elija el Tipo de cálculo y la unidad de venta en Se vende por (caja, paquete, bote, cubo, rollo, saco, pieza, palé o unidad). Es la unidad que ve el cliente: «Necesita 12 cajas».
- Indique el contenido de una unidad. La etiqueta del campo cambia según el tipo de cálculo: superficie cubierta por una unidad, volumen de un bote, rollos por unidad, volumen de una unidad o longitud de una pieza.
- Complete los campos propios del tipo de cálculo (ver más abajo).
- Haga clic en Guardar los ajustes de la calculadora. Los ajustes también se guardan con el botón de guardado general de la ficha de producto.
Pintura
Indique el Rendimiento en m² por litro, tal como figura en el bote, y el número de Manos propuestas por defecto. La opción Permitir al cliente descontar puertas y ventanas añade dos campos a la calculadora; la superficie descontada por puerta y por ventana se ajusta en la configuración del módulo (1,7 m² y 1,5 m² por defecto).
Papel pintado
Indique el Ancho del rollo en centímetros, la Longitud del rollo en metros y el Rapport del motivo en centímetros (0 o vacío para un papel liso). Si el producto se vende por rollo, deje vacío el campo «Rollos por unidad». Cada tira mide la altura de la pared más 10 cm de recorte, redondeada al rapport siguiente.
Volumen vendido en sacos
Para un producto vendido al peso, deje vacío el volumen por unidad e indique la Densidad del material en kg/m³ y el Peso de una unidad en kg. El módulo convierte entonces el volumen en peso y luego en número de sacos. Valores orientativos: grava 1500 a 1700, arena 1600, mortero seco 2000.
Margen de corte propio del producto
El campo Margen de corte por defecto para este producto sustituye el margen preseleccionado solo para este producto. Déjelo vacío para usar el valor del módulo. Si el valor introducido no está entre las opciones ofrecidas, se añade a las opciones de este producto.
Valores por combinación y combinación de formatos
Si el producto tiene combinaciones, aparece una tabla Valores por combinación. Rellene solo las combinaciones cuyo contenido difiere del valor del producto, por ejemplo un bote de 2,5 L y uno de 10 L. Para un producto vendido al peso, el valor introducido es el peso de una unidad en kg.
Si sus combinaciones son formatos de envase, marque Las combinaciones son formatos de envase: proponer la combinación de tamaños más barata. Bajo el resultado, la calculadora muestra entonces la combinación de tamaños que cubre la necesidad al precio más bajo, el ahorro frente al tamaño seleccionado y un botón que añade todas las líneas al carrito. La búsqueda abarca los cinco tamaños con mejor precio por unidad de contenido.
Usar una característica de producto
Si su catálogo ya indica el contenido de una unidad en una característica (por ejemplo «Superficie por caja: 1,44»), selecciónela en Característica con el contenido por unidad en la configuración. Sirve de valor predeterminado cuando el campo del producto está vacío. El mismo principio se aplica al rendimiento de la pintura con Característica con el rendimiento de la pintura. El módulo lee el primer número del valor, con coma o punto.
Activación masiva por categoría
En la página del módulo, el bloque Asignación masiva por categoría activa o desactiva la calculadora en todos los productos de las categorías seleccionadas, subcategorías incluidas si la casilla está marcada. Elija el tipo de cálculo y la unidad de venta a aplicar. Por defecto, los productos ya configurados conservan sus ajustes; marque Cambiar también el tipo y la unidad de los productos ya configurados para sobrescribirlos. Los valores de envase ya introducidos nunca se borran.
Un producto activado sin información de envase, ni en su campo ni en la característica elegida, permanece oculto en la tienda. Aparece con el estado Incompleto en la lista de productos configurados, con un enlace para abrir su ficha.
Ajustes del módulo
Visualización
- Posición en la ficha de producto: bajo el botón Añadir al carrito (hook
displayProductAdditionalInfo), junto a las acciones del producto (displayProductActions) o hook personalizado. - Color de acento: color de los botones, de las opciones de margen y del resultado.
- Precio por m², litro, metro o m³: muestra «es decir, 22,85 € / m²» bajo el precio, en la ficha de producto y en los listados.
- Guardar el cálculo con la línea del carrito: conserva las medidas del cliente para el carrito y la página del pedido en el back office.
- Superficie de puerta descontada y Superficie de ventana descontada en m².
Márgenes de corte
Para cada tipo de cálculo, introduzca las opciones ofrecidas al cliente, en porcentaje y separadas por comas (por ejemplo 5,10,15), y el margen preseleccionado. Valores instalados: azulejos 5, 10 y 15 % (10 por defecto), pintura 0 a 15 % (10), papel pintado 0 a 10 % (5), volumen 0 a 10 % (5), rodapiés 5 a 15 % (10).
Hook personalizado
Para colocar la calculadora en otro lugar de la ficha, elija la posición «Hook personalizado» y añada esta línea a la plantilla de producto de su tema:
{hook h='displayDfSurfaceCalculator' product=$product}Páginas SEO de calculadora
Cada tipo de cálculo puede tener su propia página pública, con la calculadora, sus productos del mismo tipo con la cantidad y el precio calculados para las medidas del visitante, una explicación del método y enlaces a las demás calculadoras. Las direcciones siguen el modelo /calculadora/azulejos-suelos, /calculadora/pintura, /calculadora/papel-pintado. La lista de páginas publicadas y sus enlaces figura en la parte superior de la página del módulo.
- Activar las páginas de calculadora y Páginas a publicar: publique solo los tipos que corresponden a su catálogo.
- Prefijo de URL: común a todos los idiomas, definido en la instalación según el idioma predeterminado de la tienda.
- Productos mostrados por página: 12 por defecto, 0 oculta la lista.
- Para cada página y cada idioma: URL amigable, Título (H1 y etiqueta title), Meta descripción y Texto de introducción. Títulos y direcciones redactados para las búsquedas habituales vienen rellenados en 8 idiomas.
Las páginas declaran un canonical, las etiquetas hreflang de los idiomas activos y unas migas de pan. Se añaden automáticamente al sitemap del módulo gsitemap de PrestaShop en su siguiente generación. La dirección de otro idioma redirige con un 301 a la del idioma mostrado. Si cambia una URL amigable, la dirección anterior deja de servirse: prevea una redirección si la página ya estaba indexada.
El texto de introducción es un buen lugar para sus consejos de colocación y el vocabulario de sus clientes. Evite copiar palabra por palabra la explicación del método, que ya se muestra bajo la calculadora.
Lo que ve el cliente
El cliente introduce una o varias estancias, paredes o zonas. Cada bloque muestra su subtotal. A partir de la segunda zona, la casilla Descontar esta zona permite restar una isla, un ventanal o un armario. Después elige el margen entre sus valores.
El resultado indica la superficie o el volumen, la necesidad con el margen incluido, el número de unidades, el total cubierto con lo que sobra y el precio estimado. El botón Añadir 12 cajas al carrito rellena el campo de cantidad y activa el botón de carrito del tema. El enlace Usar esta cantidad solo rellena el campo. Si el producto está agotado, solo se ofrece este enlace.
Un valor no numérico se marca en rojo y bloquea el resultado. Un valor muy alto, por ejemplo 120 m para el largo de una estancia, muestra un recordatorio de la unidad esperada. Las medidas se conservan durante la sesión: el visitante las recupera entre la página de calculadora y la ficha de producto.
Carrito y pedidos
Cuando el cliente añade al carrito desde la calculadora, sus medidas se guardan con la línea. El carrito muestra un resumen bajo el producto, por ejemplo «Superficie 14,7 m² + 10% = 16,17 m². Calculado: 12 cajas», e indica si la cantidad se modificó después. En el back office, la página del pedido muestra un bloque Cálculos de cantidades con la misma información.
Resolución de problemas
La calculadora no aparece en la ficha de producto
Compruebe en la lista de productos configurados que el producto está activo y que su estado no es Incompleto. Compruebe después que el hook de la posición elegida existe en su tema; en caso de duda, pruebe la otra posición o el hook personalizado. Vacíe la caché de la tienda tras cada cambio.
El mensaje «Falta la información de embalaje para esta opción»
La combinación seleccionada no tiene contenido, ni el producto tampoco. Indique el valor del producto o el de la combinación en la tabla de valores por combinación.
La página de calculadora devuelve un error 404
Compruebe que las páginas están activadas y que el tipo está marcado en Páginas a publicar. Si las URL amigables de la tienda están desactivadas, la página sigue accesible por su dirección larga, indicada en la parte superior de la página del módulo.
La combinación de formatos no se muestra
La opción debe estar marcada, al menos dos combinaciones deben tener contenido y precio, y la combinación solo se propone si cuesta menos que el tamaño seleccionado.
El precio por m² no aparece en los listados
Se muestra mediante el hook displayProductPriceBlock de tipo unit_price, que algunos temas no llaman en las miniaturas de producto. Añada la llamada a la plantilla de miniatura o desactive la opción.
Compatibilidad
- PrestaShop 8.0 a 9.x, el mismo ZIP cubre las dos ramas.
- Multitienda y multiidioma.
- Arquitectura ModuleAdminController, sin dependencias Composer.
- Interfaz y textos de la calculadora disponibles en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.