AC Retirement Nest Egg Calculator Plus plugin

Introduction

Updated: October 2026 v3.0.1

In brief: A retirement future value calculator to create printable date based schedules and charts. It is rebrandable and supports 90 currencies, seven date formats, and 15 languages.

Below is just one example of how the AC Retirement Nest Egg Calculator Plus plugin for WordPress might look (and work) when displayed in the content area of a website or blog. You can select from 4 predefined sizes or customize it as needed. Installation is simple.

Select your preferred currency symbol and date format:
$ : mm/dd/yyyy

To use your preferred currency and date format, click $ : mm/dd/yyyy in the bottom right corner of the calculator. More below

The AC Retirement Nest Egg Calculator Plus plugin creates printable date-based investment schedules and charts. Calculate the amount you'll have at retirement (the future value).

It supports 90 currencies, seven date formats, and 15 languages.

Choose from four predefined sizes or customize it via the configuration options. It is fully responsive with touch support.

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

• in a post or page's content area via a shortcode;
• in a widget area;
• in any template file; or
• as a native WordPress block (WordPress 6.3 or later).

See the Usage section under Installation for details.

Requires WordPress 5.8 or later. Native blocks require WordPress 6.3 or later.

This Plus plugin is free and proprietary. It is distributed through AccurateCalculators.com rather than the WordPress Plugin Directory. The package includes PHP and CSS source and production JavaScript, but not the private JavaScript source.

Upload the ac-retirement-nest-egg-calculator-plus folder (with all its files) to the /wp-content/plugins/ directory or unzip the plugin's zip file into the /wp-content/plugins/ folder.

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 back up your work prior to upgrading the plugin. Existing shortcode, template and widget placements continue to work in 3.0; conversion to blocks is optional.

Usage

There are four ways to add the calculator to a page. Use only one retirement nest egg calculator per page, including calculators placed in templates or sidebars. You can use different methods on different pages within a site:

1. In the block editor (WordPress 6.3 or later), insert the AC Retirement Nest Egg Calculator Plus block and configure it using the block settings sidebar, as described below.
2. Add the shortcode [acretirenesteggplus_sc] in the content area of your page or post and optionally configure the shortcode parameters. In a block editor, you can also paste the shortcode into a Shortcode block.
3. Add the following code <?php ac_retirenesteggplus_show_gui(); ?> to your template where you want the calculator to appear. See below for options.
4. If your theme supports widgets, add the plugin to a widget area through the Appearance -> Widgets menu in WordPress.

Using the AC Retirement Nest Egg Calculator Plus block

1. Open a page or post in the WordPress block editor. Click +, search for AC Retirement Nest Egg Calculator Plus, and select it. You can also find it in the Widgets category.
2. Select the calculator block. Open the editor's settings sidebar if it is hidden, then select the Block tab.
3. Under Retirement values, set the initial current age, retirement age, current retirement savings, monthly investment amount and annual interest rate.
4. Use Layout and visibility to choose a size and whether to show resize and international-conventions controls. Under Branding, enable Link to and enter your brand name if desired. Use Currency and date to choose the default conventions, and Style options. to customize colors, fonts, and widths.
5. The block starts with a current age of 28, retirement age of 62, current savings of 16000.0, monthly investment amount of 750.0 and annual interest rate of 5.5. Each setting's Reset button restores that setting's shortcode default. The preview updates as you change settings, including all five inputs and five populated, disabled result fields. Use the page preview to calculate, open schedules, charts and dialogs, or print schedules.
6. Save or update the page to publish your settings. Move the calculator between other blocks using the editor's normal move or drag controls.

Block settings are separate from legacy widget settings. The editor preview reflects the configured defaults without applying saved browser currency/date preferences; visitors' saved preferences continue to apply on the published page. Existing shortcode, template, and widget placements do not need to be converted to blocks.

The editor warns about other recognizable calculator blocks or shortcodes. Calculators inserted through templates or sidebars cannot always be detected, so check that the page contains only one calculator.

Block settings do not include recipient or preparer defaults. Enter title-page details through the calculator's normal Investment Schedule path on the published page. Preparer details continue to use the visitor's browser storage. Do not place base Retirement Nest Egg and Retirement Nest Egg Plus together on the same page; they share element IDs.

Shortcode Parameters

The pipe symbol ("|") indicates a choice. For example:
"tiny" | "small" | "medium" | "large"
means you must pick one:
sc_size="medium"
Include the quotation marks around the size.
Whitespace around the equals sign is allowed; these examples omit it for consistency.

Available 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_current_age="28"
• sc_retire_age="62"
• sc_current_savings="16000.0"
• sc_invest_amt="750.0"
• sc_rate="5.5"
• sc_currency="999" (automatic; current convention IDs: 0-104)
• sc_date_mask="999" (automatic; date format IDs: 0-6)
• 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="200px"
• sc_calculator_max_width_medium="400px"
• sc_calculator_min_width_large="200px"
• sc_calculator_max_width_large="440px"
• sc_hide_intl_conventions="No" | "Yes"

Examples:

1. Explicit standard defaults:

   [acretirenesteggplus_sc sc_size="large" 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.0" sc_invest_amt="750.0" sc_rate="5.5" sc_currency="999" sc_date_mask="999" 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="200px" sc_calculator_max_width_medium="400px" sc_calculator_min_width_large="200px" sc_calculator_max_width_large="440px" sc_hide_intl_conventions="No"]

2. Minimum configuration (accepts shortcode defaults):

   [acretirenesteggplus_sc]

3. Minimal configuration:

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

4. Custom branding:

   [acretirenesteggplus_sc sc_custom_style="No" sc_add_link="Yes" sc_brand_name="Friendly Mortgage" sc_hide_resize="Yes" sc_current_age="28" sc_retire_age="62" sc_current_savings="16000.0" sc_invest_amt="750.0" sc_rate="5.5"]

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

Defaults: The first example explicitly selects the large layout and automatic currency/date selection. Omit an attribute to leave it unspecified; the text null in a shortcode is a literal string, not a null value. Saved user currency/date preferences can override website settings as described below.

Calculator defaults: Rendering, shortcodes, and activation use ages 28 and 62, savings 16000.0, periodic investment 750.0, and rate 5.5. Whole-record admin repair instead initializes savings to 16750.0 and investment to 775.0. Template calls and widgets can inherit saved options, while shortcodes have their own defaults.

Activation, including reactivation, replaces the saved calculator options with activation defaults. Back up customized settings before reactivating the plugin.

Optional Array Parameterforac_retirenesteggplus_show_gui()

The available options are the same as for the shortcodes, except that you must replace sc_ with op_, for example:

<?php ac_retirenesteggplus_show_gui(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' => "16000.0",
'op_invest_amt' => "750.0",
'op_rate' => "5.5",
'op_currency' => "999",
'op_date_mask' => "999",
'op_theme_base_font_size' => "16px",
'op_theme_primary_color' => "#28a745",
'op_theme_primary_color_hover' => "#218838",
'op_theme_primary_color_light' => "#30c853",
'op_theme_primary_color_text' => "#fff",
'op_theme_primary_color_text_inverse' => "#fff",
'op_theme_background_muted' => "#f7f7f7",
'op_theme_background_color_disabled' => "#efefef",
'op_theme_background_calculator_color' => "#fff",
'op_theme_background_modal_color' => "#fff",
'op_theme_border_color' => "#dee2e6",
'op_theme_text_color' => "#333333",
'op_theme_tooltip_text_color' => "#fff",
'op_theme_shadow_color' => "rgba(0, 0, 0, 0.1)",
'op_theme_primary_font_family_stack' => "Roboto, 'Helvetica Neue', Helvetica, Arial, sans-serif",
'op_theme_mono_font_family_stack' => "'Roboto Mono', 'Source Code Pro', ui-monospace, monospace",
'op_calculator_min_width_tiny' => "150px",
'op_calculator_max_width_tiny' => "250px",
'op_calculator_min_width_small' => "200px",
'op_calculator_max_width_small' => "300px",
'op_calculator_min_width_medium' => "200px",
'op_calculator_max_width_medium' => "400px",
'op_calculator_min_width_large' => "200px",
'op_calculator_max_width_large' => "440px",
'op_hide_intl_conventions' => "No"
)); ?>

Notes:

1. To display your brand, set sc_add_link or op_add_link to "Yes" and supply the corresponding brand name option. This enables links to AccurateCalculators.com in the calculator heading and copyright footer.
2. When branding, the brand name will be added before "Retirement Calculator".
3. If sc_custom_style or op_custom_style is set to "Yes", the plugin will load dist/css/accurate-calculators-custom.css relative to the plugin's root 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: 150px, small: 200px, medium: 200px, large: 200px
6. Default size (max-width): tiny: 250px, small: 300px, medium: 400px, large: 440px
7. The modals used for showing 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. Set sc_currency/op_currency and sc_date_mask/op_date_mask to convention IDs, or 999 for automatic selection. The current runtime supports currency IDs 0-104 and date IDs 0-6. See currency_and_date_conventions.txt in the plugin's root folder for the corresponding conventions. Example: India uses currency ID 83.

Supports international currency and number-formatting conventions, plus 7 date formats (e.g., mm/dd/yyyy, dd/mm/yyyy, yyyy.mm.dd). Currency and date format are selected independently using the order below.

Automatic selection uses the browser's regional locale, not the visitor's physical location or the server's location. For example, a browser using the Japanese locale can select Japanese yen even when the website is hosted in France.

How the plugin determines the currency symbol and date format:

1. A previously saved user preference in the browser's local storage takes precedence, even if the currency/date selector is currently hidden.
2. If no saved preference exists, an explicit website setting for that convention is used. The value 999 means automatic selection.
3. Otherwise, the plugin attempts to select the convention from the browser's regional locale.
4. If the selected or detected convention is unavailable or invalid, the plugin falls back to U.S. currency formatting ($) or the MM/DD/YYYY date format, respectively.

When the currency/date selector is visible, users can change either convention; their choices are saved in local storage for subsequent visits.

Language Translations

The plugin supports 14 languages in addition to English. A translation template file (.POT) is included in the languages folder. Using a POT/PO file editor, website owners can translate this plugin into any language supported by WordPress.

Supported languages — try fully functional plugins in your language via the links below:

Translation notes:

• WordPress's Site Language setting selects the translation. PHP text uses .MO files; JavaScript text uses .JSON files.
• To adapt the Portuguese translation for Brazilian Portuguese, copy the .PO translation, set its locale to pt_BR, and regenerate both catalogs. Retain the plugin prefix and script handle in the filenames: ac-retirement-nest-egg-calculator-plus-pt_BR.mo and ac-retirement-nest-egg-calculator-plus-pt_BR-ac-i18n-retirement-nest-egg-plus.json. Updating or renaming only the .MO file does not update JavaScript translations.
• Use the .POT template for a new language, or edit an included .PO file. Regenerate the .MO and matching .JSON files after editing. New untranslated block editor messages fall back to English.

Support is available for all plugins. If you have a question or encounter an issue, please visit the plugin's support forum and indicate whether you are using the original plugin or the Plus version. Please also provide a link to the page where the issue occurs to help resolve the problem more quickly.

(See: hex colors for explanation about web colors.)

Can the AC Retirement Nest Egg Plus plugin be used on a commercial website?
Yes. Your use is appreciated.

Does your plugin include any embed advertising?
Absolutely not.

Is the plugin self-contained?
The calculator runs on your server. The Plus plugin also contacts AccurateCalculators.com for plugin information, updates, and activation/deactivation reporting, as described below.

Does the plugin include any backlinks?
No clickable backlinks are added by default. Setting add_link to "Yes" adds links to AccurateCalculators.com in the calculator heading and copyright footer. To display your brand, also supply brand_name; a brand name alone does not enable branding or links.

Is the calculator plugin responsive?
Yes. It is designed for responsive use. I use it on a Bootstrap v5.x responsive site, and responsiveness has been greatly improved in version 2.

Does the calculator support touch devices?
Yes. The calculator is compatible with all device types. A previous issue with some Android devices has been resolved.

v. 3.0.1

• Corrected WordPress compatibility metadata in update notifications and plugin details to use the "Tested up to" version declared in readme.txt.

v. 3.0

• Added optional native WordPress block support, with sidebar controls for retirement defaults, layout, visibility, branding, currency/date conventions, and appearance. Requires WordPress 6.3 or later.
• Added a read-only block preview with all five inputs and five calculated-result fields initialized using the configured conventions; saved visitor preferences continue to apply on the published page.
• Added translation support for block editor controls and messages, reusing existing translations with English fallback for untranslated text.
• Corrected the legacy widget name and description translation domains so existing translations are applied.
• Reorganized calculator PHP and JavaScript into smaller functions and modules while preserving existing shortcode, template, and widget interfaces.
• Corrected documentation, configuration examples, and descriptions of Plus reporting and browser storage.

v. 2.1

• Bug fix: Users were not able to view the schedule when using Safari on macOS.
• Enhancement: Improved compatibility with page builders - specifically Elementor and Avada Builder (formerly Fusion Builder).
• Enhancement: Improved screen reader accessibility.
• Enhancement: A few CSS style tweaks.

v. 2.0.1

• Updated documentation.
• Tweaks to translations.

v. 2.0

• Improved design responsiveness, particularly at smaller screen sizes.
• Added dozens of easily configurable display and style options. No programming required.
• 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

1. The Plus versions provide printable schedules and an optional title page with your brand, marketing information, and contact details.
2. The Plus versions insert grouping separators while users type, making large numbers easier to enter.
3. The Plus versions are free proprietary downloads from AccurateCalculators.com. They include PHP and CSS source and production JavaScript, but not the private JavaScript source.
4. On activation and deactivation, the Plus plugin sends the full installation site URL, plugin name, and activation status to AccurateCalculators.com. Calculator inputs and title-page details are not included in this payload. The plugin also requests plugin information and updates from AccurateCalculators.com.
5. Both base and Plus versions support native blocks, shortcodes, widgets, template functions, and configurable appearance. Calculator-specific features and Plus printing options differ.

If you install any "Plus" plugin on a public facing website, you are required to provide a public citation. A citation does not need to be a link to this site (though it may be). It could be a published review on WordPress.org or other site, or a social media mention with link. If you are not sure, ask. An annual subscription could be introduced with a future update. It is expected to be $499. Whether a subscription fee is introduced depends largely on the compliance with the request for a citation.