Weight Tracker Documentation

Documentation and tips for setting up Weight Tracker on your WordPress site.

More:
WordPress.org / GitHub / YeKen.uk

[wt-beta]

This shortcode is currently in Beta. Please contact us to report issues or make suggestions.

This is the most popular shortcode for the Weight Tracker plugin and displays upto four sections / tabs when a user is logged into WordPress.

The following shortcode is available in both the free and Pro/Pro Plus version of the plugin. The Pro version has the following additional features:

  • Support for measurements and custom fields.
  • Advanced data table for viewing weight entries. Supporting sorting, paging, editing and deleting.
  • Support for BMI, BMR, suggested calorie intake and Macronutrients.
  • A settings page to allow the user to tailor the plugin to their needs.
  • Notes
  • Gallery
  • User Settings

Note: Please only place this shortcode once per page. If placed more than once you may experience unstable results.

Overview

Main Image

The main tab displays the following summary information to user as well as a chart of the user's weight and plottable custom field data (Pro feature)

Add/edit an entry

The next tab allows a user to add an entry. Here they can select a date, specify their weight anc complete any additional custom fields that have been setup.

Add

History

The history tab provides the following summary data as well as a data table containing the user's entries:

Table

Advanced

With a Pro Plus license an additional tab is present with "Advanced" data. This tab contains the following information;

For more information on these values, please read our guide on Weight Tracker calculations.

Advanced

Gallery

The photos tab will show the user their oldest and latest photo. Below this will be a gallery of all of their photos.

Gallery

Messages

If enabled, this tab shall display all of the messages sent to a user by an administrator.

Note: This is a Pro feature.

Messages

User Preferences

If enabled, the last tab allows the user to edit their profile (specifying height, gender, etc), preferred data units, and the option to delete all of their data.

Note: This is a Pro feature.

Settings

Shortcode arguments

The shortcode supports the following arguments:

Argument Description Options Example
bmi-format Specify the format that BMI should be displayed in. 'label' (default), 'both' or 'index' [wt-beta bmi-format='both']
custom-field-groups Specify one or more custom field group slugs. Specifying groups will ensure that only custom fields within those groups are displayed on the control. An individual slug or multiple slugs comma delimited. [wt custom-field-groups='measurements'] [wt-beta custom-field-groups='measurements,fitness-test']
custom-field-slugs Specify one or more custom field slugs. Specifying slugs will ensure only the fields specified are displayed on the control. An individual slug or multiple slugs comma delimited. [wt custom-field-slugs='waist'] [wt-beta custom-field-slugs='waist,bicep,distance-run']
disable-main-font If set to true will disable the main font used in the shortcode True or False (default) [wt-beta disable-main-font=true]
disable-theme-css If set to true will disable the additional CSS used in the shortcode True or False (default) [wt-beta disable-theme-css=true]
enable-week-ranges If enabled, a drop down of weeks shall be displayed above the "Weight History" table. When a week is selected, the table will be filtered to only show entries within that week. True or false (default). [wt-beta enable-week-ranges=true]
hide-advanced-narrative If set to true (default is false) hide the text on the Advanced tab which explains each section. True or false (default). [wt-beta hide-advanced-narrative=true]
hide-chart-overview Hide the chart from the "Overview" tab. True or false (default). [wt-beta hide-chart-overview=true]
hide-custom-fields-chart Hide custom fields from the chart. True or false (default). [wt-beta hide-custom-fields-chart=true]
hide-custom-fields-form Hide custom fields from the form. True or false (default). [wt-beta hide-custom-fields-form=true]
hide-custom-fields-table Hide custom fields from the table. True or false (default). [wt-beta hide-custom-fields-table=true]
hide-first-target-form Hide the target form from the Overview tab. True or false (default). [wt-beta hide-first-target-form=true]
hide-notes If set to true (default is false) hide the "notes" section of the form. True or false (default). [wt-beta hide-notes=true]
hide-photos If set to true (default is false) hide the photo upload section of the form. True or false (default). [wt-beta hide-photos=true]
hide-tab-advanced If set to true (default is false) hide the Advanced tab. True or false (default). [wt-beta hide-tab-advanced=true]
hide-tab-descriptions If set to true (default is false) hide the descriptions under the tab title. True or false (default). [wt-beta hide-tab-descriptions=true]
hide-tab-photos If set to true (default is false) hide the Photos tab. True or false (default). [wt-beta hide-tab-photos=true]
show-delete-data If set to false (default is true), the section allowing users to delete their own data is hidden. True (default) or false [wt-beta show-delete-data="false"]
summary-boxes-advanced Specify the summary boxes to display at top of the advanced tab. Comma delimited list, read more [wt-beta summary-boxes-advanced="number-of-entries,number-of-days-tracking,latest-weight,start-weight"]
summary-boxes-data Specify the summary boxes to display at top of the history tab. Comma delimited list, read more [wt-beta summary-boxes-data="bmi,bmr"]
summary-boxes-home Specify the summary boxes to display at top of the home tab. Comma delimited list, read more [wt-beta summary-boxes-home="latest-weight,start-weight"]
weight-mandatory By default, for a weight form, it is mandatory for a weight to be entered. If setting this argument to false, the form can be submitted with out. true or false (default) [wt-beta weight-mandatory='true']