Description

Carb planner for runners lets runners, running clubs and endurance communities add a practical endurance nutrition planner to a WordPress page with a shortcode.

The plugin includes a built-in Dutch and English front-end. The WordPress settings interface is in English. The site administrator can choose the default public planner language under Settings > Carb planner, and an individual shortcode can override that setting with language="en" or language="nl".

The front-end planner is intentionally product-neutral. It does not recommend products, display shop prices, collect email addresses, create user accounts, set marketing cookies, load remote scripts, or call an external calculation API. Calculations run locally in the visitor’s browser.

The planner uses exercise duration, body weight, self-reported carbohydrate tolerance, average speed, sex, temperature conditions and self-reported sweating as inputs. It returns an indicative carbohydrate target, a 30-minute distribution, a fluid testing range and an estimated sodium-loss range.

The output is intended as a practical starting point for testing during training. It is not individual medical or sports-dietetic advice.

The plugin includes an optional Aeroob.nl attribution link. It is disabled by default and can only be enabled deliberately by the site administrator. The attribution is never shown on aeroob.nl itself.

Features

Add the planner with the [aeroob_koolhydraatplanner] shortcode.
Built-in Dutch and English front-end.
Set the default planner language in WordPress settings.
Override the language per shortcode with [aeroob_koolhydraatplanner language="en"] or language="nl".
Exercise-duration slider from 30 minutes up to 14 hours, in 15-minute steps.
Body-weight slider.
Carbohydrate-tolerance setting.
Average-speed slider.
Optional sex input used only as a small factor in fluid and sodium estimates.
Temperature conditions.
Self-reported sweating level.
Carbohydrate target per hour and total amount.
Distribution per 30 minutes.
Fluid testing range.
Estimated sodium-loss range.
Responsive front-end layout.
Keyboard-accessible form controls.
Configurable title, introduction and accent colour.
Optional Aeroob.nl attribution link, disabled by default and never displayed on aeroob.nl itself.
No WooCommerce dependency.
No account or email requirement.
No marketing tracking or external calculation API.

Privacy

The plugin does not create visitor accounts, collect email addresses, use marketing tracking, call a remote calculation service or send planner input values to Aeroob. Calculations are performed locally in the browser.

Methodology

Carbohydrate targets use broad duration-dependent ranges and the visitor’s stated carbohydrate tolerance to select a practical starting point. Fluid output is deliberately presented as a testing range rather than a fixed drinking prescription. Sodium output is presented as estimated possible loss and not as an automatic replacement target.

Users should test any nutrition and hydration strategy during training and adapt it to individual tolerance, thirst, measured sweat loss and circumstances. People with relevant medical conditions, medication use or previous fluid or electrolyte problems should seek individual professional advice.

Screenshots

The carbohydrate planner embedded on a running page, showing the input fields and indicative planning results.

Installation

Install and activate the plugin from the WordPress Plugin Directory.
Open Settings > Carb planner to adjust the title, introduction, accent colour, default planner language and optional attribution if desired.
Add [aeroob_koolhydraatplanner] to a page or post.
To force English on one specific planner, use [aeroob_koolhydraatplanner language="en"]. Use language="nl" to force Dutch.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Carb planner for runners” is open source software. The following people have contributed to this plugin.

aeroobnl

Translate “Carb planner for runners” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.9

Replaced the fixed public Aeroob.nl link with an explicit attribution toggle that is disabled by default.
Added friendly support copy from Tom, the creator of the Carb planner, next to the attribution option.
Prevented the attribution link from rendering on aeroob.nl and its subdomains even when the option is enabled.
Kept the attribution link as a normal followable link when a site administrator explicitly opts in.
Updated the stable tag and internal asset version to 1.0.9.

1.0.8

Moved the Aeroob.nl link out of the WordPress admin interface and into the public planner.
Added a fixed visible Aeroob.nl link below every rendered planner.
Changed all plugin-owned settings/admin interface copy to English, including field labels, help text and the save button.
Kept Dutch and English as selectable public planner languages.
Updated the stable tag and internal asset version to 1.0.8.

1.0.7

Changed the plugin display name to “Carb planner for runners” while retaining the approved WordPress.org repository slug for update compatibility.
Added a permanent Aeroob.nl link to the plugin row in WordPress admin; the settings and plugin metadata links remain in place.
Removed the FAQ section from the WordPress.org readme.
Kept the Dutch/English planner language option and shortcode language override.
Updated the stable tag and internal asset version to 1.0.7.

1.0.6

Added a built-in English translation for the complete public planner while retaining Dutch as the default.
Added a default language setting and per-shortcode language="en" / language="nl" override.
Removed the public Aeroob credit toggle and its front-end credit output.
Added a fixed Aeroob.nl developer link to the plugin settings screen and plugin metadata, without forcing a public-site credit link.
Updated the WordPress.org description and feature list for the bilingual release.
Added the first WordPress.org repository screenshot asset.
Updated the stable tag and internal asset version to 1.0.6.

1.0.5

Matched the public plugin name to the reserved WordPress.org slug: aeroob-koolhydraatplanner-voor-hardlopers.
Updated the plugin text domain and package directory to the reserved WordPress.org slug.
Added WordPress.org user aeroobnl to the Contributors field.
Updated human-facing plugin labels from “voor Clubs” to “voor Hardlopers”; the planner remains suitable for running clubs and endurance communities.
Updated the stable tag and internal asset version to 1.0.5.

1.0.4

Extended the maximum exercise duration from 12 to 14 hours while retaining 15-minute steps.
Synchronized the internal asset version with the plugin version.

1.0.3

The optional Aeroob credit link is now a regular followable link when a site administrator explicitly enables it. The credit remains disabled by default and is never required for plugin functionality.

1.0.2

Added GPL-compatible license information to the main plugin header.
Changed the text domain to match the plugin package used for that release.
Updated Tested up to to WordPress 7.0.
Rewrote the WordPress.org readme in English.
Changed the optional public Aeroob credit to opt-in and disabled it by default for WordPress.org directory guideline compliance.
Added uninstall cleanup for the plugin settings option.

1.0.1

Added a setting to show or hide the Aeroob credit below the planner.

1.0.0

Initial version for running clubs.