AC's Mortgage Calculator

Description

AC Mortgage Calculator Plugin (try it now!) with support for down payments, points, insurance, taxes and PMI. Create date-based payment schedules, and interactive charts.

Supports 90 currencies, six date formats, and 15 languages.

Now highly customizable via extensive configuration options.

Choose from four predefined sizes or customize via configuration options. Fully responsive with touch support.

Rebranding with your site’s name is supported and encouraged.

The plugin works via:
(a) Shortcode in posts/pages
(b) Widget area
(c) Template file

See usage under installation for details.

NEW: Upgrade to the free AC Mortgage Calculator Plus v2.0 for a printable schedule.

Screenshots

Installation

You can either (a) upload the fc-mortgage-calculator folder with all its files to the /wp-content/plugins/ directory, or (b) unzip the plugin’s zip file directly into the /wp-content/plugins/ directory.

Activate the plugin through the Plugins -> Installed Plugins menu in the WordPress admin dashboard.

Upgrading

Release 2.0 is a major update. Please test before upgrading.

Usage

There are 3 mutually exclusive ways you can deploy the calculator to an individual page (though you can use all three methods on different pages within a site):

1. Add the shortcode [fcmortgageplugin] in the content area of your page or post and optionally configure the shortcode parameters. WordPress v5.8 introduced the block editor. To install this plugin as a widget in WordPress v5.8 or later, first install the widget shortcode block and then copy this plugin’s shortcode into it.
2. Add the following code to your template where you want the calculator to appear. See below for options.
3. If your theme supports widgets, add the plugin to a widget area through the Appearance -> Widgets menu in WordPress.

Shortcode parameters

“|” means or, thus “tiny” | “small” | “medium” | “large” means pick one (include the quote marks!). Example: sc_size=”medium” Do NOT put spaces around the equal sign.

* sc_size= "tiny" | "small" | "medium" | "large"
* sc_custom_style= "No" | "Yes"
* sc_add_link= "No" | "Yes"
* sc_brand_name=""
* sc_price="505000.0"
* sc_pct_dwn="20.0"
* sc_loan_amt="0.0"
* sc_n_months="360"
* sc_rate="6.5"
* sc_points="0"
* sc_taxes="0"
* sc_insurance="0"
* sc_pmi="0"
* sc_currency=   (see: the file currency_and_date_conventions.txt)
* sc_date_mask=   (see: the file currency_and_date_conventions.txt)
* sc_theme_base_font_size="16px"
* sc_theme_primary_color="#28a745"
* sc_theme_primary_color_hover="#218838"
* sc_theme_primary_color_light="#30c853"
* sc_theme_primary_color_text="#fff"
* sc_theme_primary_color_text_inverse="#fff"
* sc_theme_background_muted="#f7f7f7"
* sc_theme_background_color_disabled="#efefef"
* sc_theme_background_calculator_color="#fff"
* sc_theme_background_modal_color="#fff"
* sc_theme_border_color="#dee2e6"
* sc_theme_text_color="#333333"
* sc_theme_tooltip_text_color="#fff"
* sc_theme_shadow_color="rgba(0, 0, 0, 0.1)"
* sc_theme_primary_font_family_stack="Roboto, 'Helvetica Neue', Helvetica, Arial, sans-serif"
* sc_theme_mono_font_family_stack="'Roboto Mono', 'Source Code Pro', ui-monospace, monospace"
* sc_calculator_min_width_tiny="150px"
* sc_calculator_max_width_tiny="250px"
* sc_calculator_min_width_small="200px"
* sc_calculator_max_width_small="300px"
* sc_calculator_min_width_medium="280px"
* sc_calculator_max_width_medium="340px"
* sc_calculator_min_width_large="280px"
* sc_calculator_max_width_large="440px"
* sc_hide_points= "No" | "Yes"
* sc_hide_taxes= "No" | "Yes"
* sc_hide_insurance= "No" | "Yes"
* sc_hide_pmi= "No" | "Yes"
* sc_hide_intl_conventions= "No" | "Yes"
* sc_hide_payment_method= "No" | "Yes"

Examples (First includes all options with their defaults):

[fcmortgageplugin sc_size="large" sc_custom_style="No" sc_add_link="No" sc_brand_name="" sc_hide_resize="No" sc_price="350000.0" sc_pct_dwn="20.0" sc_loan_amt="0.0" sc_n_months="180" sc_rate="6.25" sc_points="0" sc_taxes="0" sc_insurance="0" sc_pmi="0" sc_currency="0" sc_date_mask="0" sc_theme_base_font_size="16px" sc_theme_primary_color="#28a745" sc_theme_primary_color_hover="#218838" sc_theme_primary_color_light="#30c853" sc_theme_primary_color_text="#fff" sc_theme_primary_color_text_inverse="#fff" sc_theme_background_muted="#f7f7f7" sc_theme_background_color_disabled="#efefef" sc_theme_background_calculator_color="#fff" sc_theme_background_modal_color="#fff" sc_theme_border_color="#dee2e6" sc_theme_text_color="#333333" sc_theme_tooltip_text_color="#fff" sc_theme_shadow_color="rgba(0, 0, 0, 0.1)" sc_theme_primary_font_family_stack="Roboto, 'Helvetica Neue', Helvetica, Arial, sans-serif" sc_theme_mono_font_family_stack="'Roboto Mono', 'Source Code Pro', ui-monospace, monospace" sc_calculator_min_width_tiny="150px" sc_calculator_max_width_tiny="250px" sc_calculator_min_width_small="200px" sc_calculator_max_width_small="300px" sc_calculator_min_width_medium="280px" sc_calculator_max_width_medium="340px" sc_calculator_min_width_large="280px" sc_calculator_max_width_large="440px" sc_hide_intl_conventions="No" sc_hide_points="No" sc_hide_taxes="No" sc_hide_insurance="No" sc_hide_pmi="No" sc_hide_payment_method="No"]

[fcmortgageplugin sc_size="small" sc_custom_style="Yes" sc_hide_resize="Yes" sc_currency="83" sc_date_mask="2"]

[fcmortgageplugin sc_add_link="Yes" sc_brand_name="Friendly Mortgage" sc_hide_resize="Yes" sc_price="350000.0" sc_pct_dwn="20.0" sc_loan_amt="0.0" sc_n_months="360" sc_rate="6.5" sc_hide_points="Yes" sc_hide_taxes="Yes" sc_hide_insurance="Yes"]

NOTE: You only need to include with the shortcode the options you want to change.

Optional array parameter passed to show_fcmortgage_plugin()

The values available for template options are the same as the shortcodes above except you must change “sc_” to “op_”. Some examples:

<?php show_fcmortgage_plugin(array('op_size' => "medium",
    'op_custom_style' => "No",
    'op_add_link' => "Yes",
    'op_brand_name' => "",
    'op_hide_resize' => "No",
    'op_price' => "350000.0",
    'op_pct_dwn' => "20.0",
    'op_loan_amt' => "0.0",
    'op_n_months' => "48",
    'op_rate' => "5.5",
    'op_points' => "0",
    'op_taxes' => "0",
    'op_insurance' => "0",
    'op_pmi' => "0",
    'op_currency' => "999",
    'op_date_mask' => "999"
)); ?>

Notes:

1. If you want to add your brand to the calculator, the *_add_link option must be set to “Yes” (i.e. create a subtle follow link to AccurateCalculators.com).
2. When branding, the brand name will be added before “Mortgage Calculator”.
3. If _custom_style is set to “Yes”, the plugin will load css/accurate-calculators-custom.css located in the plugin’s CSS folder. You can modify the styles as needed. I suggest that you only include CSS selectors in this file that you actually change.
4. The plugin is built and tested on HTML5/CSS3 pages.
5. Default size (min-width): tiny: 120px, small: 160px, medium: 280px, large: 280px
6. Default size (max-width): tiny: 180px, small: 300px, medium: 340px, large: 440px
7. The modals used to show the schedule, currency select, help, etc are Bootstrap 5 modals. If your site uses an earlier Bootstrap version, you may have issues. Please contact me.
8. Website developers can set a default currency sign and preferred date format by setting <op/sc>_currency and <op/sc>_date_mask respectively. Set one or both to an integer value. For the list of integers to support 90 plus currency symbols and 6 date format options, see the file currency_and_date_conventions.txt in the plugin’s root folder. (example: India, Indian Rupee: ?1,23,45,678.99 = 83)

Enhanced Internationalization

Supports 90+ currency symbols (with proper number formatting) and 6 date formats (e.g., mm/dd/yyyy, dd/mm/yyyy, yyyy.mm.dd). If no selection is made by the website developer or user, the calculator automatically detects and applies the browser’s default currency and date format.

For example, a visitor from Japan accessing a website hosted in France will initially see amounts in Japanese yen. However, website developers can override this behavior using shortcodes or function options. If enabled, users can also manually select their preferred currency and date format.

How the plugin determines the currency symbol and date format:
1. If user selection is allowed and made, the plugin applies the user’s choice.
2. Otherwise, if the website developer has set a default currency (≠ 999), that selection is used.
3. Otherwise, the plugin reads the browser’s default currency and applies it.
4. If none of the above apply, the plugin defaults to ‘$’.

Language Translations

As of v1.5, the plugin supports 14 languages in addition to English.

Each language below links to a page where you can test all seven plugins in that language—no installation needed.

Supported Languages:
– da – Dansk – Danish
– de – Deutsch – German
– es – Espa?ol – Spanish
– fi – Suomalainen – Finnish
– fr – Fran?ais – French
– hu – Magyar – Hungarian
– it – Italiano – Italian
– lt – Lietuvi? – Lithuanian
– nl – Nederlands – Dutch
– pl – Polski – Polish
– pt – Português – Portuguese
– ro – Romanesc – Romanian
– ru – Русский – Russian
– sv – Svenska – Swedish

Notes:
1. The plugin automatically displays in the correct language based on the site’s “Site Language” setting in WordPress. If necessary, language files in the languages folder can be renamed.
– Example: The default Portuguese translation uses pt_PT (Portugal). If your site is set to use the Brazilian Portuguese locale, rename the file pt_PT.mo to pt_BR.mo.

1. A translation template file (.POT) is included in the languages folder. Website owners can use a POT/PO file editor to translate the plugin into any WordPress-supported language. A fluent speaker can also edit an included .PO file and regenerate the .MO file to alter a current translation.

2. Contribute Your Edits!

   • If you enhance a translation and would like to share it, I will regenerate the .MO and, if needed, the .JSON files for you.

Support

I’m happy to provide support for all my plugins! If you have a question or run into an issue, please visit the WordPress plugin’s support forum and post your question.

When submitting a request, please:
– Specify whether you’re using the original plugin or the “Plus” version.
– Provide a link to the page where the plugin is installed.

Including a direct link to the affected page can help me diagnose and resolve the issue more quickly.

Other Calculators

As of now, AccurateCalculators.com offers seven plugins in the WordPress Plugin Directory, with additional plugins available on the website. All plugins share a consistent feature set, styling, and functionality, ensuring a seamless look and feel across your site.

Below are links to each plugin’s page in the WordPress Plugin Directory.

1. Auto Loan Calculator – solves for several unknowns and creates a payment schedule.
2. Loan Calculator – a general purpose loan calculator with amortization schedule and charts.
3. Mortgage Calculator – optionally incorporates points and insurance and creates a payment schedule
4. Retirement Age Calculator – answers, at what age will I be able to retire given my investment plan?
5. Retirement Nest Egg Calculator – answers, what will be the value of my retirement fund when I retire?
6. Retirement Savings Calculator – how much do I have to invest periodically to reach my retirement goal?
7. Savings Calculator – calculates the results of regular savings and investing

Also

New seven, free, Plus plugins with printable schedules.

FAQ

Can the Mortgage Calculator plugin be used on a commercial website?

Yes. Your use is appreciated.

If you’re a financial blogger, consider adding a “Calculators” or “Tools” section to your site and including all my calculators. More content equals more opportunity.

Does your plugin have any embed advertising?

Absolutely not.

Is your plugin self-contained?

Yes. 100% of the plugin is installed on your server. There are no external dependencies.

Does the plugin include any backlinks?

No, not by default. If you decide to brand the calculator with your brand and / or set the add_link option to Yes, one discreet link is added to my site. (User will not know there is a link unless their mouse passes over it.) The link is around the copyright in the lower left. ?

Is the calculator plugin responsive?

Yes. In fact, I use it on a Bootstrap v5.x responsive site.

Does the calculator support touch devices?

Yes. Users use the calculator with all types of devices.

What are the differences between the “Plus” version of your plugins and the “Non-Plus” versions?

1. The “Plus” versions allows the schedule to be printed.
2. The “Plus” version has improved numeric editing. Thousand separators are inserted as your user types which makes it easier to enter large numbers.
3. The “Plus” version includes all PHP and CSS source code, but not the JavaScript source code.
4. The “Plus” version sends to my site the domain name you install it on. I may link to your site to provide an example of the plugin’s use. (The plugin collects no other information.)

Reviews

The Best

mariongroup1 April 21, 2020

These calculators look and work great. I needed help with a couple of them and the developer responded immediately and took care of the issue.

Contributors & Developers

Changelog

2.0

• Improved design responsiveness, particularly at smaller screen sizes.
• Added dozens of easily configurable display and style options. No programming required.
• Added support to hide “points”, “taxes”, “insurance”, “PMI” or “payment method” via individual configuration options.
• Many technical changes (dropped jQuery, Featherlight, updated to Bootstrap 5).
• Improved the overall quality of all the language translations.

Supported and updated continuously since 2016. See: changelog.txt