New for 2020: Added support for over 90 additional currencies including Japanese Yen (¥12,345,679), Indian Rupee/Lakh/Crore (₹1,23,45,678.99) & Swiss Franc (CHF12’345’678.99). Click on "More" above.
advertisement

Updated February 2020 v1.4.0


  Original Size  
Use these shortcodes in the page's content editor for above result:
[fcloanplugin sc_size="medium" sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Karl's" sc_hide_resize="no" sc_loan_amt="305000" sc_n_months="360" sc_rate="5.25"]

This plugin is also available for download at WordPress.org

The FC Loan Calculator WordPress Plugin is based on and uses the code from the very popular Loan Calculator. The plugin solves for the monthly payment amount and it creates an 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-loan-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 [fcloanplugin] 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_fcloan_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_loan_amt=
  • sc_n_months=
  • sc_rate=
  • sc_currency=
  • sc_date_mask=

Shortcode Examples:

advertisement

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

First example includes all options.

Optional array parameter passed to
show_fcloan_plugin()

This can be copied and pasted to a template part.

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

Notes:
  1. When setting default values for the calculator (loan amount, rate etc.), one should be set to "0" so when the user clicks on 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 "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 _currency and _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)

Screenshots

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

8 Comments on “Loan Calculator Plugin”

financial online calculator Join the conversation. Tell me what you think.
    • The calculators are designed for an international audience, and the user can pick the currency.

      However, if you don’t mind making an edit, to the source code, you (the website owner) can change the currency. Here’s how to do it:

      In the plugin folder, there is a js folder. Should be here with default install:

      \wp-content\plugins\fc-loan-calculator\js

      find this file:

      interface.LOAN-WIDGET.min.js

      With a plain text editor, such as notepad open it up and search for this text:

      a.CCY_CONVENTIONS=[{sep:”,”,dPnt:”.”,ccy:”$”,ccy_r:””}

      Should be around row 7. Change the “$” to whatever you need as the example below. Save, and refresh the webpage

      a.CCY_CONVENTIONS=[{sep:”,”,dPnt:”.”,ccy:”€”,ccy_r:””}

      If you want the € on the right, replace ccy_r instead.

      This will change the plugin’s default for you

      The downside with this hack is, no one visiting the page will be able to set the currency to “$”. Or at least I don’t think they will be able to. I didn’t actually test that.

      Hope this works for you.

  • Thank you, Karl

    I really appreciate the effort you have placed to create this calculator and taking it a step further to provide us with a WordPress plugin at no cost. I have looked at many similar plugins and yours is the best that I have come across.

    I am using the calculator for a client’s website and would like to hide the credits as per their requirements.

    Do you have a paid plugin with this feature?

    Kindly let me know as this would be greatly appreciated.

    • Hi Samir, Thank you for your kind words. I guess you are asking about the copyright notice? I do not have a version, paid or otherwise, with it removed.

    • Jyoti, I’ve never tried the calculator using 3 characters for the currency symbol. I image if you did that, that the maximum value that a user can enter will be too small since 2 places meant for numbers will now be used for currency.

      But in any event, feel free to try it. Here is the generic answer to your question.

      The calculator is designed so that the user can change the currency, not the website’s owner. Once the user selects the currency, it will be remembered the next time they visit the site. This seems to be the best approach for websites that have an international audience.

      However, if you want to make an edit to the source code, you (the website owner) can change the currency. Here’s how to do it:

      In the plugin folder, there is a js folder. Should be here with default install:

      example.com\wp-content\plugins\fc-loan-calculator\js

      find this file:

      interface.LOAN-WIDGET.min.js

      With a plain text editor, such as notepad open it up and search for this text:

      a.CCY_CONVENTIONS=[{sep:”,”,dPnt:”.”,ccy:”$”,ccy_r:””}

      Should be around row 7. Change the “$” to whatever you need as the example below. Save, and refresh the webpage

      a.CCY_CONVENTIONS=[{sep:”,”,dPnt:”.”,ccy:”Ksh”,ccy_r:””}

      This will change the plugin’s default for you

      The downside with this hack is, no one visiting the page will be able to set the currency to “$”. Or at least I don’t think they will be able to. I didn’t actually test that.

      Hope this works for you.

    • It’s always hard to answer these kinds of questions. Do you know how to program? If you know CSS, you can activate the custom style sheet and add rules to hide the payment method.

Comments, suggestions & questions welcomed...

Scroll
to plugin
to questions/comments
advertisement