FitCalc Documentation

Quick start

1. Activate FitCalc Free from the WordPress Plugins screen.
2. Edit a page in Gutenberg and add the “FitCalc Tool” block, or paste one shortcode from the tables below.
3. Select metric or imperial units where offered, then test the page on desktop and mobile.
4. Keep the general-wellness disclaimer visible and avoid presenting estimates as diagnosis or treatment.

Current compatibility: FitCalc Free 1.4.4 requires WordPress 5.2 or newer and PHP 7.4 or newer. FitCalc Pro 1.2.6 also requires PHP 7.4 or newer. Both release packages exclude editor backups, debug logs, nested ZIP files, and operating-system metadata.

---

Shortcode reference

Add any FitCalc tool to a page

Copy the shortcode you need and paste it into a WordPress Shortcode block. Each item is shown in a clear, responsive layout for desktop, tablet, and mobile.

Calculator shortcodes

Use one calculator or display the complete calculator suite.

• Complete calculator suite[fitcalc_all]
• BMI Calculator[fitcalc_bmi]
• Basal Metabolic Rate[fitcalc_bmr]
• Total Daily Energy Expenditure[fitcalc_tdee]
• Ideal Weight Calculator[fitcalc_ideal_weight]
• Daily Water Intake[fitcalc_water]

Wellness shortcodes

Add a focused wellness tool or show the complete wellness suite.

• Complete wellness suite[fitcalc_wellness]
• Daily Habit Tracker[fitcalc_habits]
• Workout Interval Timer[fitcalc_timer]
• Guided Breathing[fitcalc_breathing]
• Healthy Challenge[fitcalc_challenge]
• Upgrade to Pro button[fitcalc_upgrade_button]

Important: Add these in a Shortcode block, not a Code block. A Code block displays the shortcode as text and does not load the tool.

Result saving, email and voice guidance

• Free habit and challenge progress is designed for local browser storage; visitors should not rely on one browser as a permanent medical record.
• Pro lead submissions require consent, nonce validation, server-side field limits, and a short anti-abuse rate limit. Stored leads integrate with WordPress personal-data export and erasure tools plus scheduled retention cleanup.
• Pro email-result features require a working WordPress mail transport. SMTP fields are configured on this demo, but production delivery should be confirmed with the mail account owner before launch.
• ChallengeOS guest enrollment is rate-limited before account creation. Daily reminder and coach safety-alert emails are optional per member and can be enabled or disabled from enrollment and check-in forms.
• Administrator PDF downloads require capability and nonce checks. Temporary generated reports use a guarded server temporary directory with owner-only file permissions and scheduled cleanup.
• BMI, BMR, TDEE, Ideal Weight, and Water Intake can provide browser speech guidance after a user calculation. Browser audio permissions and device speech support still apply.
• Audio should remain user initiated and optional. Visitors can continue using every calculator without sound.

AI BYOK readiness

The Pro AI interface is currently in demo/mock mode. A site administrator must select a supported provider and supply their own API credential before live AI requests are enabled. Provider keys are encrypted at rest, hidden from visitors, and can be permanently removed with the Remove saved key setting. Do not place provider keys in page content, shortcodes, screenshots, or public documentation.

Transformation Hub requests use task-specific server-side field allowlists, strict input and output limits, hourly abuse protection, adult consent, and verified JPG/PNG/WebP upload checks. Public visitors receive privacy-safe provider failure messages; detailed diagnostics remain restricted to administrators.

Before enabling AI, review what user text is sent to the selected provider, publish the relevant privacy disclosure, obtain appropriate consent, and define a retention policy. FitCalc’s AI output is general wellness information and is not medical advice.

Commerce and Upgrade to Pro

The Free plugin includes an optional, clearly labelled Upgrade to Pro path. While purchasing is disabled, Free upgrade controls link only to the internal Pro information page and the Pro Buy shortcode outputs no public checkout link. Both plugins use a default-off publisher approval gate. Hosted checkout URLs must use HTTPS on a Freemius domain, and plan fields accept only a confirmed numeric Freemius plan ID. Purchasing remains disabled on this demo until the owner approves final pricing, renewals, taxes, checkout behavior, and legal copy.

Privacy and accessibility checklist

• Keep labels associated with inputs and maintain visible keyboard focus.
• Test forms at narrow mobile widths and at 200% browser zoom.
• Provide text results in addition to optional speech output.
• Honor reduced-motion preferences for decorative animation.
• Use consent controls before storing or emailing personal details.
• Publish retention, deletion, AI-provider, privacy, and medical-information disclosures before production use.

Troubleshooting

A shortcode is visible as plain text

Confirm FitCalc is active, use the exact shortcode spelling, and place it in a Shortcode block rather than a Code block.

A calculator looks narrow or overflows

Use a full-width or wide page container, clear page and optimization caches, and retest without builder column padding.

Voice guidance does not play

Run the calculation from a direct button click, confirm the tab is not muted, and check that the browser supports speech synthesis for the current language.

An email result is not delivered

Run the SMTP plugin’s test email, inspect its event log, confirm the From address is authorized, and check the receiving spam folder. Do not repeatedly submit a public lead form for testing.