תיאור
AC's Loan Calculator Plugin is a general purpose loan calculator that solves for a monthly loan payment and creates a detailed amortization schedule with date based payments. Additionally, your visitors can view a set of charts so they can visualize the cost of a loan. Your visitors can also select their own currency and date convention used in the loan schedule. This is ideal if your site attracts visitors from around the globe. Select from one of four predefined sizes or modify the CSS file to customize both the size and colors. Supports touch functionality and is designed for responsive websites. The plugin is based on and uses the code from my very popular Loan Calculator.
Rebranding with your site's brand name is supported and encouraged.
The plugin can be used (a) in a post or page’s content area via a shortcode; (b) in a widget area; or (c) in any template file. See usage under installation for details.
NEW: Sites are encouraged to install the free, enhanced AC Loan Calculator Plus v2.0 with a printable amortization schedule and dozens of additional configuration and styling options.
צילומי מסך
התקנה
You can either (a) upload the fc-loan-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
If you translated the plugin from English to another language, please backup your work prior to upgrading the plugin.
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):
- If your theme supports widgets, add the plugin to a widget area through the Appearance -> Widgets menu in WordPress. WordPress v5.8 introduced the block editor to the Admin's widget management screen. To install this plugin as a widget in WordPress v5.8 or later, install first the widget shortcode and then copy this plugin's shortcode into it.
- Add the following code to your template where you want the calculator to appear. See below for options.
- Add the shortcode [fcloanplugin] in the content area of your page or post and configure shortcode parameters.
Shortcode parameters
* sc_size= tiny | small | medium | large
* sc_custom_style= No | Yes
* sc_add_link= No | Yes
* sc_brand_name=
* sc_hide_resize= No | Yes
* sc_loan_amt=
* sc_n_months=
* sc_rate=
* sc_currency=
* sc_date_mask=
Examples (the first example includes all options):
[fcloanplugin sc_size="tiny" sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Best's Auto" sc_hide_resize="Yes" sc_loan_amt="30000" sc_n_months="60" sc_rate="5.5" sc_currency="83" sc_date_mask="2"]
[fcloanplugin sc_size="small" sc_custom_style="Yes" sc_hide_resize="Yes" sc_currency="83" sc_date_mask="2"]
[fcloanplugin 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_fcloan_plugin()
Valid values for options are the same as the shortcode above.
<?php show_fcloan_plugin(array('op_size' => "medium",
'op_custom_style' => "No",
'op_add_link' => "Yes",
'op_brand_name' => "Karl's",
'op_hide_resize' => "No",
'op_loan_amt' => "32500.0",
'op_n_months' => "48",
'op_rate' => "5.5",
'op_currency' => "999",
'op_date_mask' => "999"
)); ?>
Notes:
- To add your brand to the calculator, you must set the *_add_link option to 'Yes' which adds a subtle follow link to AccurateCalculators.com.
- When branding, the brand name will be added before "Loan Calculator".
- 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 red color to indicate that the custom CSS is in use.
- The plugin is built and tested on HTML5/CSS3 pages.
- size (max-width): large: 440px, medium: 340px, small: 290px, tiny: 150px
- The modal dialog that allows users to select a default currency and date format is NOT compatible with some other dialogs. If you have a modal on the webpage you want to install this calculator on, either your modal or the calculator's modal may not work.
- Website developers can set a default currency symbol and preferred date format by setting <op/sc>_currency and <op/sc>_date_mask respectively. To find the integer values that correspond to specific currency symbols and date formats, refer to the file currency_and_date_conventions.txt in the plugin's root folder. This file contains a list of over 90 supported currency symbols and 6 different date formats (for example, India uses the Indian Rupee: ₹1,23,45,678.99, which corresponds to the integer value 83).
Enhanced Internationalization
Support for over 90 currency signs (using appropriate number 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 shortcodes or function options, as needed. 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:
- If a website allows a user to select a symbol, and the user makes a selection, the plugin uses the visitor's choice first.
- 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.
- Otherwise, the calculator plugin will attempt to read the browser's currency default and pick a currency symbol.
- Otherwise, the plugin defaults to using the '$' symbol.
Language Translations
New in v1.5, support for 14 languages in addition to English. The plugin also includes a translation template file (.POT) in the "languages" folder. Using a POT/PO file editor, website owners can translate this plugin to any language supported by WordPress.
The supported languages are:
da : Danish : Dansk
nl : Dutch : Nederlandse
fi : Finnish : Suomalainen
fr : French : Français
de : German : Deutsch
hu : Hungarian : Magyar
it : Italian : Italiano
lt : Lithuanian : Lietuvių
pl : Polish : Polski
pt : Portuguese : Português
ro : Romanian : Românesc
ru : Russian : Русский
es : Spanish : Español
sv : Swedish : Svenska
Notes: (1) The plugin depends on the site's "Site Language" setting to display to your visitors the correct language. The files in the language folder can be renamed if needed. For example, if you want the plugin to display in Portuguese, the .MO and .JSON files assume your site's language setting is Portuguese (Portugal) with the locale pt_PT. But if your site is in Brazil, you'll need to rename the plugin's language files to use pt_BR. (2) Currently, these translations are computer-generated. A fluent speaker can edit the included .PO file and regenerate the .MO file to improve accuracy. (3) If you are willing to allow me to include your edits with the plugin, I'll regenerate the .MO, and if needed the .JSON files for you.
I am offering many of the other calculators free-of-charge to bloggers who assist with translations.
Support
I'm happy to offer support for all my plugins. If you have a question or encounter an issue, please go to the WordPress plugin's support forum and leave your question. Please specify if you are using the original plugin or the "Plus" plugin. Also, please provide a link to a page where you have installed the plugin. Providing a link to the page where the issue occurs may help me to resolve it faster.
Other Calculators
As of this writing, AccurateCalculators.com has seven plugins listed in the WordPress Plugin Directory with several more available on the website. All plugins have the same general feature set and are consistent in their styling and the way they work. This means you can install all these plugins and maintain a consistent look and feel across your website or blog. If you blog about money, you are encouraged to install all the plugins on your site. It's simple. The more pages, the more opportunity.
The links below will take you to the respective WordPress Plugin Directory pages, or for the Plus versions to the AccurateCalculators.com support page.
- Auto Loan Calculator – solves for several unknowns and creates a payment schedule.
- Loan Calculator Plus – a free (for now), enhanced version that includes a printable schedule.
- Mortgage Calculator – optionally incorporates points and insurance and creates a payment schedule
- Retirement Age Calculator – answers, at what age will I be able to retire given my investment plan?
- Retirement Nest Egg Calculator – answers, what will be the value of my retirement fund when I retire?
- Retirement Savings Calculator – how much do I have to invest periodically to reach my retirement goal?
- Savings Calculator – calculates the results of regular savings and investing
New Plus plugins (links take you to the AccurateCalculators.com website).
- Auto Loan Calculator Plus Plugin – a car loan calculator with printable amortization schedule and charts. Supports international conventions. (free – with citation or review)
- Loan Calculator Plus Plugin – a general purpose loan calculator with printable amortization schedule and charts. Supports international conventions. (free – with citation or review)
- Mortgage Calculator Plus Plugin – a mortgage calculator with printable payment schedule and loads of configuration options. Supports international conventions. (free – with citation or review)
- Retirement Age Calculator Plus Plugin – At what age will I be able to retire? With a printable investment schedule and charts. Supports international conventions. (free – with citation or review)
- Retirement Nest Egg Calculator Plus Plugin – Assuming regular investing, what will be the value of my retirement account? With printable investment schedule and charts. Supports international conventions. (free – with citation or review)
- Retirement Savings Calculator Plus Plugin – Assuming regular investing, how much will I have to invest each period to reach my retirement goal? With printable investment schedule and charts. Supports international conventions. (free – with citation or review)
- Savings Calculator Plus Plugin – Assuming regular savings, what will be the future value? With printable savings schedule and charts. Supports international conventions. (free – with citation or review)
שאלות נפוצות
Can the Loan Calculator plugin be used on a commercial website?
Yes. I would be honored. Thanks.
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. I in fact use it on a Bootstrap responsive site.
Does the calculator support touch devices?
Yes. Users use the calculator with all types of devices. (A previous issue with some Android devices is fixed.)
Do you offer other calculator plugins?
Yes, I have six additional plugins available in the WordPress.org plugin directory. You can also explore my calculator plugin page, where you’ll find “Plus” versions of this and the other plugins. The "Plus" plugins will be free (with citation) for a limited time.
I like your plugin and I'd like to contribute something but I notice you don't have a link for contributions, why not?
Thank you. That's very kind of you. Actually, you can contribute, and it won't cost you a cent. Please stop by my website and check it out. In addition to providing some very advanced calculators, I think that I'm the only one who hosts a public question and answer site to provide support. Take a look, and if you like what you see, please spread the word. That's better than any monetary compensation.
סקירות
מפתחים
"AC's Loan Calculator" הוא תוסף קוד פתוח. האנשים הבאים תרמו ליצירת התוסף הזה.
תורמיםניתן לתרגם את "AC's Loan Calculator" לשפה שלך.
מעוניינים בפיתוח?
עיינו בקוד, ראו את הקוד ב-SVN repository, או הירשמו ללוג פיתוח באמצעות RSS.
שינויים
1.5.4.3
- Fixed name as it appears on WordPress' Plugin page. Rebranded from "FC" to "AC's".
1.5.4.2
- Corrected documentation errors in readme.txt
1.5.4.1
- Added schema.org microdata markup. This enhancement may improve your SEO.
- Replaced missing "assets" folder in project (screenshots).
1.5.4
- Changed all references to author's website from financial-calculators.com to AccurateCalculators.com.
1.5.3
- Fixed issue impacting some IOS devices preventing users from entering decimal precision. Example, users could only enter 4%, not 4.25%.
1.5.2
- Fixed problem initializing calculator when site selected a currency convention that uses ',' as the decimal separator.
1.5.1
- Not released.
1.5.0
- Added initial support for language translations
- Change in the minimum required WordPress version to v5.0 (requires i18n support)
- Added documentation how site owners can hide or disable an input from visitors near the top of source file: en/calulator.gui.php
- Renamed file js/interface.LOAN-WIDGET.min.js to js/interface.LOAN-WIDGET.js (the file is still minified)
1.4.4
- Fixed a style which made the calculator way too tall on some themes (specifically Neve Theme by Themeisle).
- Fixed a calculation error in the chart. Not all prior values were cleared.
1.4.3
- Fixed a display bug that only impacted some sites if they installed plugin via a sidebar.
- Tweaked styling to make it cleaner.
1.4.2
- Fixed a bug that prevented your website users from selecting a currency of their choice in some situations.
- Added support for Nigeria's Naira currency symbol
1.4.1
- Internal change. Never released.
1.4.0
- Added currency sign support for 80 plus additional currencies.
- Added three additional date styles.
- Now the first time a visitor tries the calculator, the calculator will detect their browser's currency symbol and date style and use them.
- Website owner has the ability to set a preferred currency sign and date format for all first time visitors.
- Website owner can give the visitor an option to select their preferred currency symbol and date format.
- IMPROVEMENT: on mobile devices calculator opens numeric keyboard by default.
- UPDATE: some layout and style settings
- BUG FIX: Fixed an input issue on Android devices that required a long press to input numbers for some Android users.
1.3
- Slight style changes
- Tweaks to work better with WordPress 5.0
- Switched from Bootstrap v3 to Bootstrap v4 utilities. If your site is built using Bootstrap 3, this may cause conflicts. Test on a dev machine.
- Since there are no user enhancements, I would only upgrade if you have experienced a style issue.
1.2.0
- Multiple AC/FC calculators can now be used on a single web page.
- On a few sites, the text in the dropdowns was cut off – fixed.
- Previously, if site had opted to allow backlinks, 2 had been inserted. Now one is inserted.
1.1.2
- Updated the CSS so as to resolve a few reported compatibility issues with some sites.
- Improved layout of international date and currency selection dialogue.
1.1.1
- Fixed – some installations the currency / date dialog was not accessible because the background overlay was on top of the dialog.
- Fixed – some installations the Help text was visible on the main page and not just when the Help button was clicked
- Fixed – missing "+" "-" signs for the optional resizing feature
1.1
- Improved styling
- Converted project to use a single file CSS regardless of calculator size selected. Single file will be compatible across all AccurateCalculators.com plugins so site owners can modify style once and copy to all other plugins.
1.0.2
- Fixed readme.txt, 2 errant commas in source and optional copyright backlinks.
1.0
- First release (2016)