FC's Retirement Nest Egg Calculator


Retirement Nest Egg Calculator answers a question most people ask at one time or another, “Assuming regular investment amounts, how much will I have when I retire?”. The calculator easily answers the question and creates a detailed schedule with projected date based investments and charts. A site’s users can select their own currency and date convention used in the investment schedule. This is ideal if your site attracts visitors from around the globe. Select from four predefined sizes or modify CSS file to customize size and change colors. Supports touch devices and a responsive designed website. This plugin is based on and uses the code from my Retirement Calculator.

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

The plugin may be used (a) in a post or page’s content area via a shortcode; or (b) used in a sidebar widget area; or (c) called from any template file. See usage under installation for details.


Either (a) upload the fc-retirement-nest-egg-calculator folder with all its files to the /wp-content/plugins/ folder or (b) unzip the plugin’s zip file in the /wp-content/plugins/ folder.

Activate the plugin through the Plugins -> Installed Plugins menu in WordPress


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. If you are using widgets, just add the plugin to the sidebar through the Appearance -> Widgets menu in WordPress. Be sure to click Save.
  2. Add the following code <?php show_fcretirenestegg_plugin(); ?> to your template where you want the calculator to appear. See below for options.
  3. Add the shortcode [fcretirenesteggplugin] 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_save_amt=
* sc_n_months=
* sc_rate=
* sc_current_age=
* sc_retire_age=
* sc_current_savings=
* sc_invest_amt=
* sc_rate=
* sc_currency=
* sc_date_mask=

Examples (1st includes all options):

[fcretirenesteggplugin sc_size="medium" sc_custom_style="No" sc_add_link="No" sc_brand_name="" sc_hide_resize="No" sc_current_age="28" sc_retire_age="62" sc_current_savings="16000" sc_invest_amt="750.0" sc_rate="5.5" sc_currency="83" sc_date_mask="2"]

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

[fcretirenesteggplugin sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Friendly Financial Planners" sc_hide_resize="Yes" sc_current_age="28" sc_retire_age="62" sc_current_savings="16000" sc_invest_amt="750.0" sc_rate="5.5"]

Optional array parameter passed to show_fcretirenestegg_plugin()

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

<?php show_fcretirenestegg_plugin(array('op_size' => "large",
    'op_custom_style' => "No",
    'op_add_link' => "No",
    'op_brand_name' => "",
    'op_hide_resize' => "No",
    'op_current_age' => "28",
    'op_retire_age' => "62",
    'op_current_savings' => "18000",
    'op_invest_amt' => "750.0",
    'op_rate' => "5.5",
    'op_currency' => "999",
    'op_date_mask' => "999"
    )); ?>


  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 financial-calculators.com).
  2. When branding, the brand name will be added before “Retirement Calculator”.
  3. 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.
  4. The plugin is built and tested on HTML5/CSS3 pages.
  5. size (max-width): large: 440px, medium: 340px, small: 290px, tiny: 150px
  6. 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 modeal on the webpage you want to install this calculator on, either your modal or the calculator’s modal may not work.
  7. 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.


  1. Redesign that allows multiple calculators to work on the same web page – completed v.1.2.0.
  2. Allow website owner to select a default currency and date format – completed v.1.4.0
  3. Give website owners the ability to not let their visitors change the default date format or currency – completed v.1.3.0

Contact me if you would like to help test any of these new features.

Other Calculators

As of this writing, financial-calculators.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 for 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.

We have two more retirement calculators to complement this plugin (all links take you to the indicated WordPress Plugin Directory page).

  1. Retirement Age Calculator – answers, at what age will I be able to retire given my investment plan?
  2. Retirement Savings Calculator – how much do I have to invest periodically to reach my retirement goal?

Plus there are these other plugins:

  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. Savings Calculator – calculates the results of regular savings and investing


  • The Retirement Calculator's front end showing 2 of the 4 configurable sizes, one with custom brand and no sizing buttons.
  • Investment schedule shown in a lightbox. User can select how date is displayed from 3 international date conventions.
  • Charts shown in a lightbox.
  • Plugin's settings dialogue, as seen under Appearance Widgets page in WordPress's administration area.


Can the Retirement Nest Egg Calculator plugin be used on a commercial website?

Yes. I would be honored. Thanks.

Also, if you happen to be a financial blogger, I would encourage you to add a “Calculators” or “Tools” section to your site and include all my calculators. More content equals more opportunity. I expect to have six free plugins by early 2017.

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 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’m offering a “Plus” version of this plugin on my website. It is free for a limited time. There will be other calculators available shortly as well.

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 ad free website and check it out. In addition to providing some very advanced calculators, I think that I’m the only one that provides free support via a public forum. Take a look, and if you like what you see, please spread the word. That’s better than any monetary compensation.


April 21, 2020
I experienced a minor issue and received a prompt response and resolution. The calculators work beautifully and look great.
Read all 1 review

Contributors & Developers

“FC's Retirement Nest Egg Calculator” is open source software. The following people have contributed to this plugin.




  • 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


  • Fixed a bug that prevented website owners from having a period or comma in the branded name.


  • 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.


  • 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.


  • Multiple 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.


  • Updated the CSS so as to resolve a few reported compatibility issues with some sites.
  • Improved layout of international date and currency selection dialogue.


  • Fixed – some installations the currency / date dialogue was not accessible because the background overlay was on top of the dialogue.
  • 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


  • Improved styling
  • Converted project to use a single file CSS regardless of calculator size selected. Single file will be compatible across all financial-calculator.com plugins so site owners can modify style once and copy to all other plugins.
  • Fixed – plugin did not recognize all saved settings in WordPress’s widgets page administration area
  • Fixed – plugin did not recognize all saved settings passed in option array to show_fcretireage_plugin()


  • First release