FC Mortgage Plugin A Free Calculator for WordPress Websites and Blogs

advertisement

Updated Oct. 2020 v1.4.3

Enter a "0" (zero) for one unknown value above.

  Original Size  
Paste these shortcodes in the page's content editor for above result:
[fcmortgageplugin sc_size="medium" sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Karl's" sc_hide_resize="No" sc_price="355000.0" sc_pct_dwn="15.0" sc_loan_amt="0.0" sc_n_months="360" sc_rate="5.5" sc_points="0" sc_taxes="6000" sc_insurance="600" sc_pmi="0"]

This plugin is also available for download at WordPress.org

The FC Mortgage Calculator WordPress Plugin is based on and uses the code from the very popular Mortgage Calculator. Not only will the plugin calculate the monthly payment amount, it can also solve for the affordable house price or calculate the down payment percentage. Or if the user provides a house price and down payment percentage, the calculator will calculate the mortgage amount that is required. Additionally, the calculator will optionally consider loan points, property taxes, hazard insurance and private mortgage insurance (PMI). It also creates amortization schedule and charts. Your site visitors can select their own currency and date convention which is ideal if the host site attracts visitors from around the globe. The website or blog owner can select from four predefined sizes or modify a CSS file to customize both size and colors.

Rebranding with your site's brand name is supported and encouraged.

The plugin may be

  1. used in a post or page's content area via a shortcode; or
  2. used in a sidebar widget area; or
  3. called from any template file.

Installation

  1. Either
    1. upload the fc-mortgage-calculator folder with all its files to the /wp-content/plugins/; or
    2. unzip the plugin's zip file in the /wp-content/plugins/  folder.
  2. Activate the plugin through the Plugins Installed Plugins menu in WordPress

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 configure shortcode parameters.
  2. Add the following code to your template where you want the calculator to appear.
    • <?php show_fcmortgage_plugin(); ?>
  3. If you are using widgets, just add the plugin to the sidebar through the Appearance Widgets menu in WordPress. Be sure to click Save.

Shortcode parameters

  • sc_size= "tiny" | "small" | "medium" | "large"
  • sc_custom_style= "No" | "Yes"
  • sc_add_link= "Yes" | "No"
  • sc_brand_name=
  • sc_hide_resize= "No" | "Yes"
  • sc_price=
  • sc_dwn_pct=
  • sc_loan_amt=
  • sc_n_months=
  • sc_rate=
  • sc_points=
  • sc_taxes=
  • sc_insurance=
  • sc_pmi=
  • sc_currency=
  • sc_date_mask=

Shortcode Examples:

advertisement

Copy and paste to page's or post's content area.

First example includes all options.

[fcmortgageplugin sc_size= "tiny" sc_custom_style= "No" sc_add_link= "Yes" sc_brand_name= "Karl's" sc_hide_resize= "Yes" sc_price= "360000.0" sc_dwn_pmt= "2.5" sc_loan_amt= "0" sc_n_months= "60" sc_rate= "5.5" sc_points= "2.5" sc_taxes= "12000.0" sc_insurance= "1200.0" sc_pmi= "0.75" sc_currency="83" sc_date_mask="2"]
[fcmortgageplugin sc_size="small" sc_custom_style="Yes" sc_hide_resize="Yes" sc_currency="83" sc_date_mask="2"]
[fcmortgageplugin sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Friendly Mortgage" sc_hide_resize="Yes" sc_loan_amt="30000" sc_n_months="60" sc_rate="5.5"]

Optional array parameter passed to
show_fcmortgage_plugin()

This can be copied and pasted to a template part.

Valid values for options are the same as the shortcode above.

<?php show_fcmortgage_plugin(array( 'op_size' => "medium", 'op_custom_style' => "No", 'op_add_link' => "Yes", 'op_brand_name' => "Green Valley Realtors", 'op_hide_resize' => "No", 'op_price' => "350000.0", 'op_dwn_pct' => "18.0", 'op_loan_amt' => "0.0", 'op_n_months' => "360", 'op_rate' => "5.5", 'op_points' => "5.5", 'op_taxes' => "5.5", 'op_insurance' => "5.5", 'op_pmi' => "5.5", 'op_currency' => "999", 'op_date_mask' => "999")); ?>
Notes:
  1. When setting default values for the calculator (price, down payment percentage, loan amount), one should be set to "0" so when the user clicks the "Calc" button, there will be an unknown value to calculate.
  2. If you want to add your brand to the calculator, the add link option must be set to "Yes".
  3. When branding, your brand name will be added before "Mortgage Loan Calculator".
  4. If custom style is set to "Yes", the plugin will load fin-calc-widgets-custom.css located in the plugin's CSS folder. If you set the option to "Yes" without making any changes, the calculator will change to a horrendous red which indicates the custom css is being used.
  5. The plugin is built and tested on HTML5/CSS3 pages.
  6. max-width: large: 440px, medium: 340px, small: 290px, tiny: 150px
  7. New: 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

New: Support for over 90 currency signs (using appropriate nummber formatting conventions) and 6 date formats (mm/dd/yyyy, dd/mm/yyyy, yyyy.mm.dd etc.). If neither the website developer or the user makes a selection, the calculator will read the browser's default currency and date options and automatically use them. Without doing anything, a website visitor from Japan visiting a website hosted in France will initially see a floating yen sign. The website developer can easily override this default behavior by setting either shortcodes or function options. The user (if the website designer keeps the feature enabled) can override both and select a currency and date format.

To summarize, the plugin determines what currency symbol (and date format) to use by applying the following rules:
  1. If a website allows a user to select a symbol, and the user makes a selection, the plugin uses the visitor's choice first.
  2. Otherwise, if a user has not made a selection, and the website owner has set a default currency (i.e., currency does not equal 999), the calculator uses the website's selection.
  3. Otherwise, the calculator plugin will attempt to read the browser's currency default and pick a currency symbol.
  4. Otherwise, the plugin defaults to using the '$' symbol.

Screenshots

advertisement
mortgage calculator plugin
Two of the predefined screen sizes showing relative difference between "large" and "tiny".
mortgage amortization schedule
Example loan schedule with detailed header and payment due dates.
mortgage charts
Creates three charts for visualization.
WordPress option page for mortgage calculator plugin
Configuration screen in WordPress's admin area
(only for when installing in a sidebar area).
advertisement

Comments, suggestions & questions welcomed...

* Required

Scroll
to plugin
to questions/comments
advertisement