Documentación · Guía del Frontend
Calculadora de financiación
Este documento cubre el widget de la calculadora de financiación del plugin ADP Car Market Hub WordPress: dónde aparece, cómo funciona para los visitantes, cómo se configura y cuáles son sus limitaciones.
Cuándo usar este documento
Lea este documento si va a activar la calculadora de financiación por primera vez, si va a ajustar sus valores por defecto o si desea ayudar a un visitante a comprender lo que muestra la calculadora.
Descripción general
La calculadora de financiación es un widget interactivo que se muestra en las páginas de detalles de cada vehículo. Permite a los visitantes estimar una cuota mensual de préstamo en función del precio del vehículo, un porcentaje de entrada, un plazo de amortización y un tipo de interés anual.
Todos los campos son ajustables por el visitante. La calculadora actualiza la cuota mensual estimada al instante a medida que cambian los valores, sin necesidad de recargar la página ni realizar peticiones al servidor. El cálculo se realiza íntegramente en el navegador mediante una fórmula de anualidad estándar.
La calculadora tiene únicamente fines estimativos. El resultado se etiqueta claramente como una estimación, y el widget incluye un descargo de responsabilidad que recuerda a los visitantes que deben consultar a su banco o entidad financiera para conocer las condiciones reales de financiación.
Requisitos o prerrequisitos
- La calculadora de financiación debe estar activada en los ajustes del plugin (
FINANCING_ENABLED). Está desactivada por defecto. - La página de detalles del vehículo debe tener un precio de vehículo superior a cero. La calculadora no se renderiza si el precio del vehículo es cero o no está disponible.
Instrucciones paso a paso
Activar la calculadora de financiación
- En la administración de WordPress, abra los ajustes del plugin.
- Vaya a la sección de configuración de la Calculadora de financiación.
- Active el interruptor principal.
- Opcionalmente, ajuste el tipo de interés por defecto, el plazo del préstamo y el porcentaje de entrada.
- Guarde los ajustes.
La calculadora aparecerá en todas las páginas de detalles de vehículos que tengan un precio asignado.
Visitante: uso de la calculadora de financiación
- Abra una página de detalles de vehículo.
- Desplácese hasta la sección Calculadora de financiación.
- La calculadora muestra el precio del vehículo y los valores por defecto precargados para los tres campos ajustables.
- Mueva el deslizador de Entrada para ajustar el porcentaje del precio del vehículo que se paga por adelantado. La etiqueta sobre el deslizador muestra el porcentaje actual.
- Seleccione el Plazo del préstamo en el menú desplegable. Las opciones disponibles son 12, 24, 36, 48, 60, 72 y 84 meses.
- Edite el campo Tipo de interés anual. Acepta valores de 0% a 30% en incrementos de 0,1%.
- La Cuota mensual estimada se actualiza inmediatamente al cambiar cualquier valor.
- Un resumen debajo de la cuota muestra el importe del préstamo, el coste total y el total de intereses.
- El descargo de responsabilidad de la parte inferior recuerda al visitante que el resultado es solo una estimación.
Referencia de configuración
Ajustes de la calculadora
| Ajuste | Clave de opción | Por defecto | Descripción |
|---|---|---|---|
| Activar calculadora | as24ci_financing_enabled | Desactivado (0) | Interruptor principal para la función de calculadora de financiación |
| Tipo de interés por defecto | as24ci_financing_default_rate | 3.9 | Tipo de interés anual precargado en porcentaje |
| Plazo del préstamo por defecto | as24ci_financing_default_months | 48 | Plazo del préstamo preseleccionado en meses |
| Entrada por defecto | as24ci_financing_down_payment | 20 | Entrada precargada como porcentaje del precio del vehículo |
Campos ajustables por el visitante
| Campo | Tipo | Rango | Descripción |
|---|---|---|---|
| Entrada | Deslizador de rango | 0% – 100% | Porcentaje del precio del vehículo pagado como entrada |
| Plazo del préstamo | Desplegable | 12 / 24 / 36 / 48 / 60 / 72 / 84 meses | Duración del préstamo |
| Tipo de interés | Entrada numérica | 0% – 30% | Tipo de interés anual en porcentaje |
Resultados de la calculadora
El widget muestra:
| Resultado | Descripción |
|---|---|
| Cuota mensual estimada | Cuota mensual calculada mediante la fórmula de anualidad |
| Importe del préstamo | Precio del vehículo menos el importe de la entrada |
| Coste total | Importe del préstamo más el total de intereses pagados durante el plazo |
| Total de intereses | Diferencia entre el coste total y el importe del préstamo |
Todos los valores monetarios se formatean utilizando la moneda del vehículo y la configuración regional del sitio.
Ubicación en el diseño
La ubicación de la calculadora de financiación en la página de vehículo individual se controla mediante el Layout Manager. Cuando la función está activada, el bloque de la calculadora está disponible en la barra lateral de vehículo individual y también se puede colocar en el área de contenido principal o en la sección inferior a través del Layout Manager. Si el mismo bloque se coloca en varias zonas, solo se renderiza la primera instancia aplicable.
Notas de funcionamiento
- El cálculo de la anualidad se realiza íntegramente en JavaScript (
as24ci-financing.js). El servidor solo proporciona los datos iniciales (precio del vehículo, moneda, ajustes por defecto) a través de un objeto de script localizado (as24ciFinancing). No se realizan más peticiones al servidor cuando el visitante ajusta la calculadora. - La calculadora se renderiza únicamente cuando el precio del vehículo es superior a cero. Si un vehículo no tiene precio, el widget se omite silenciosamente incluso si la función está activada y el bloque está en el Layout Manager.
- Los recursos JavaScript y CSS para la calculadora se encolan únicamente en las páginas de vehículo individual (
is_singular), no en el archivo ni en otras páginas. - El widget utiliza propiedades personalizadas de CSS del sistema de diseño del plugin (color primario, radio de borde, fondo, colores de texto), por lo que hereda automáticamente los colores del tema configurados.
- El texto del descargo de responsabilidad ("Esto es solo una estimación. Las tasas reales pueden variar. Por favor, consulte con su banco o entidad financiera para conocer las condiciones exactas.") está codificado en la plantilla y no se puede configurar desde los ajustes de administración.
- La calculadora de financiación no envía ningún dato al servidor, no crea ningún lead y no contacta con ningún servicio de financiación externo.
Resolución de problemas
La calculadora de financiación no aparece en la página de detalles de un vehículo.
- Confirme que la función está activada en los ajustes del plugin.
- Verifique que el vehículo tenga un precio superior a cero.
- Confirme que el bloque de la calculadora de financiación esté activo en el Layout Manager para la página de vehículo individual.
- Revise la consola del navegador en busca de errores de JavaScript.
La cuota mensual muestra un guion (—) y no se actualiza.
- La calculadora requiere JavaScript para funcionar. Verifique que JavaScript no esté bloqueado en el navegador.
- Compruebe si hay conflictos con scripts de otros plugins que puedan interferir con los escuchadores de eventos de la calculadora.
Los valores de la calculadora no reflejan la moneda o la configuración regional del sitio.
- La moneda y la configuración regional se pasan a JavaScript cuando se carga la página, basándose en la moneda guardada del vehículo y en la configuración regional del sitio de WordPress. Cambiar estos ajustes requiere borrar cualquier caché de página.