Selector de visualización de impuestos: configuración y ayuda

Sube el ZIP en Módulos > "Module Manager" > "Upload a module". Instálalo y haz clic en "Configure". Usa la pantalla Configuración > "Configuration" del módulo, con el título Configuración general.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

En multitienda, selecciona el contexto que quieres configurar. Los ajustes se resuelven en el orden tienda, grupo de tiendas y ámbito global.

Haz clic en Guardar. Este formulario no tiene un selector de posición independiente.

Para un grupo de clientes que normalmente deba ver precios sin impuestos, configura su método de visualización de precios en PrestaShop y deja "Default Display" en "Follow customer group (default)". Los valores nativos son 0 para impuestos incluidos y 1 para impuestos excluidos.

El módulo guarda las claves multilingües LABEL_INCL, LABEL_EXCL, SUFFIX_INCL y SUFFIX_EXCL. No son cuatro campos editables en el formulario actual de ajustes generales.

La instalación inicializa las etiquetas por idioma. Los valores ingleses son Incl. VAT, Excl. VAT, incl. VAT y excl. VAT. El alemán usa inkl. MwSt. y zzgl. MwSt.. El francés usa TTC y HT. El polaco usa brutto y netto. El italiano usa IVA incl. y IVA escl.. El español usa con IVA y sin IVA. Los demás códigos de idioma usan los valores ingleses de respaldo durante la instalación.

Si necesitas un texto personalizado, adapta la plantilla del widget del tema o realiza un cambio controlado de configuración. No busques campos de etiquetas que este formulario no ofrece. Las etiquetas compactas del selector y el texto de ayuda también usan las traducciones del módulo.

En PrestaShop 1.7 y versiones posteriores, el widget puede mostrarse en displayNav1 o displayNav2. Se muestra una sola vez, en la primera llamada aplicable. En PrestaShop 1.6 también puede usar displayTop.

Si falta el hook en una cabecera personalizada, añade la llamada nativa adecuada en la posición deseada:

{hook h='displayNav2'}

Para una cabecera de PrestaShop 1.6:

{hook h='displayTop'}

El módulo no se muestra mediante displayTop en 1.7 y versiones posteriores. Si ya se ha ejecutado otro hook de navegación compatible, la protección para mostrarlo una sola vez puede impedir una segunda copia en la nueva posición. Comprueba el orden real de los hooks al moverlo.

Para personalizar la estructura HTML, copia la plantilla del módulo en tu tema y edita la copia:

/themes/your_theme/modules/mprtaxdisplayswitcher/views/templates/hook/switcher.tpl

El estilo de interruptor incluye un control de ayuda. El comportamiento del tooltip usa la integración de tooltips Bootstrap disponible en el tema.

El script del front-office guarda la preferencia directamente en la cookie pública mpr_tax_display antes de actualizar los precios. En esta revisión no llama a un endpoint AJAX de cambio de modo.

Una selección distinta de la predeterminada guarda:

mpr_tax_display=0
mpr_tax_display=1

Volver al modo predeterminado configurado elimina la cookie. La cookie usa la ruta /, SameSite Lax y Secure en HTTPS. Una petición posterior lee la preferencia antes de preparar la visualización de precios. Cambia el método de visualización del grupo guardado en caché para esa petición sin actualizar el registro almacenado del grupo.

El módulo proporciona datos de precio ocultos mediante displayProductPriceBlock solo para llamadas al hook con type="weight". Prepara los precios de venta y habituales en ambos modos y les da formato en la moneda activa. Por ejemplo:

<span class="mpr-tax-prices"
      style="display:none"
      data-si="120.00"
      data-se="100.00"
      data-ri="150.00"
      data-re="125.00"
      data-d="1"></span>

Estos atributos contienen cadenas con formato en el resultado real. JavaScript usa una estructura HTML compatible de productos y listados para sustituir los precios visibles.

El cambio es instantáneo cuando todos los precios visibles detectados tienen datos .mpr-tax-prices correspondientes. Si faltan datos, un precio no se puede asociar o la cobertura es incompleta, el script guarda la preferencia y recarga la página para que el servidor muestre el modo elegido. Las páginas del carrito y del proceso de compra se recargan incluso cuando las recomendaciones de productos contienen datos de precio.

El módulo controla la presentación de precios. Las reglas fiscales, los precios de productos guardados, la obligación tributaria real y la contabilidad de pedidos siguen usando la configuración fiscal y del proceso de compra de la tienda. Para datos de visualización cuyos valores nativos con y sin impuestos sean iguales con los impuestos activados, el módulo puede calcular un precio de visualización con impuestos de respaldo a partir del tipo impositivo del país predeterminado. Prueba este caso por separado en tiendas cuyo comportamiento dependa de la dirección del cliente y del IVA.

Abre una página de la tienda sin caché y sin una preferencia guardada. Confirma que use "Default Display". Cambia de modo e inspecciona tanto el precio visible como mpr_tax_display en el almacenamiento del navegador.

Navega inmediatamente a otro producto. Confirma que el modo elegido persista. Vuelve al modo predeterminado configurado y confirma que la cookie desaparezca.

Prueba un listado de productos, un producto simple, un producto con combinaciones y los precios habituales y de venta con descuentos. Cambia la moneda y repite. Prueba el carrito y el proceso de compra por separado, comparando la visualización con los totales reales y las líneas de impuestos. Inspecciona los diseños personalizados donde falten los elementos span de precio ocultos o solo se actualicen algunos nodos.

Para comprobar en modo de solo lectura los datos nativos de visualización de grupos, usa tu prefijo de tabla e ID de idioma reales:

SELECT g.id_group, gl.name, g.price_display_method
FROM ps_group AS g
INNER JOIN ps_group_lang AS gl ON gl.id_group = g.id_group
WHERE gl.id_lang = 1;

Usa las clases y variables CSS del módulo en la hoja de estilos de tu tema. Por ejemplo:

:root {
  --mpr-primary: #1f7a5c;
  --mpr-border: #d6d6d6;
  --mpr-text: #222;
  --mpr-text-muted: #777;
}
.mprtaxswitch-host { margin-left: 12px; }
.mprtaxswitch__btn { text-transform: uppercase; }
.mprtaxswitch-tooltip .tooltip-inner { max-width: 320px; }

Si falta el control, comprueba "Enable Tax Switcher", los hooks del tema, la visualización una sola vez y la carga de recursos del front-office. Usa la pantalla "Integrity" del módulo para comprobar la infraestructura.

Si los precios no cambian, inspecciona .mpr-tax-prices y la llamada del tema a displayProductPriceBlock con el tipo weight. Comprueba los errores de script del navegador y si la estructura HTML coincide con los contenedores de precio del script.

Si una recarga restaura el modo equivocado, inspecciona los permisos de cookies, su ámbito y la caché de página. Prueba sin una respuesta HTML en caché. Si faltan sufijos, comprueba "Show Price Suffix", los valores de los sufijos, los errores de script del navegador y el marcado de precios del tema.

La preferencia se guarda en la cookie del navegador. No existe una URL de cambio independiente en /module/mprtaxdisplayswitcher/switch ni en /ajax.

Establece "Enable Tax Switcher" en No para detener el widget y la sustitución conservando los ajustes. Desinstala mediante "Module Manager" para eliminar el menú y la configuración del módulo.

La desinstalación deja las cookies de preferencia existentes en los navegadores de los visitantes. Puedes borrar mpr_tax_display en el navegador al comprobar el comportamiento predeterminado. Elimina por separado las personalizaciones de las plantillas del tema.