=== Weight Tracker === Contributors: aliakro Tags: weight,tracker,chart,history,macronutrient Requires at least: 6.0 Tested up to: 6.9.4 Stable tag: 10.20.4 Requires PHP: 7.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Donate Link: https://www.paypal.me/yeken Allow your users to track their weight, measurements, photos and custom data! Support for BMI, BMR, Calorie Intake, Macronutrients and much more! == Description == = Demo = Use our free site for tracking your weight which shows off some of the plugin's feature: [https://demo.yeken.uk - Demo Site](https://demo.yeken.uk "https://demo.yeken.uk") = Documentation = [Weight Tracker Website](https://weight.yeken.uk/ "Weight Tracker Website") = Core Features = An easy to use plugin that allows your users to track their weight, body measurements, photos and any custom fields you define. Their entries can be seen in various ways, charts, tables, shortcodes and widgets. The user is able to set targets and modify their entries. The admin area features a rich user interface to allow site owners and personal trainers interact with their user base and help them achieve their goals. Support for US/UK date formats as well as Imperial and Metric measurements. For further information read our documentation: [Weight Tracker - Documentation](https://weight.yeken.uk/shortcodes "Weight Tracker - Documentation") = Premium Version = * **[wt-kiosk]** - A shortcode enabling your administrators and staff to search for and edit user records directly from the front end of your website. * **Barcode scanner** - an integrated barcode scanner for seamless user ID scanning when utilising the [wt-kiosk] feature. * **Basal Metabolic Rate (BMR) calculations per user** - with shortcodes and enhanced admin screens to display and manage individual BMR data. * **Harris Benedict formula** - Shortcodes and expanded admin screens to view a person's required calorie intake for maintaining or losing weight. * **Recommended calorie intake per meal time** - Shortcodes and advanced admin screens to recommend how a person should distribute their daily calorie intake across meals. * **Macronutrients Calculator** - Shortcodes and enhanced admin screens to recommend how to divide calorie consumption among fats, carbohydrates, and proteins. * **Additional user preference fields** - Additional user preference fields and shortcodes for displaying Activity Level, Date of Birth, and Gender. * **Awards** - Awards and badges for achievements such as BMI Change, BMI Milestones, Weight Gain/Loss from the start, and Percentage of Weight Lost from the start. * **Challenges** - Create challenges for your users within a specified time frame, and showcase their achievements such as Total Weight Lost, BMI Change, Percentage of Body Weight Lost, Weight Tracker Streaks, and Meal Tracker Streaks in a league table. The shortcode will enable you to view all challenges and their data, as well as display the league table on your public-facing website. * **BMI Calculator** - A handy tool for users to quickly input their measurements and weight to calculate their BMI. * **Waist-to-Hip ratio Calculator** - A convenient tool for users to quickly enter their measurements and calculate their Waist-to-Hip ratio. * **Custom Fields** - Customise weight entry forms by creating and adding your own questions to collect additional information from users. * **Photo Custom Fields** - Enhance your weight entry forms by adding one or more photo fields, enabling users to upload photos showcasing their progress. Both users and administrators can view, update, and delete these photos. Convenient shortcodes are provided to display galleries, as well as the most recent and oldest photos. * **Access your user's data** - Administrators can view, edit, and delete user data, with tools for analysing user graphs, entry tables, BMI, targets, weight loss/gain statistics, and more. * **Challenges** - Develop and showcase challenges for users across different time frames, allowing for flexible goal-setting and progress tracking. * **Data Export.** - Export data for individual users in either JSON or CSV format * **Webhooks, Zapier & Slack** - Send weight entry data and targets to Slack channels, Zapier, or your custom webhooks for seamless integration and notifications. * **Groups** - Create user groups and assign users to them, then view collective Weight Difference statistics for each group. * **Admin notes** - Administrators can store notes for users, which can be set to visible so that users can view them through the [wt-notes] shortcode or receive them via email. * **Gamification** - Integrate with myCred, a popular gamification plugin, to reward users for logging weight entries and setting targets. * **Body Mass Index** - Allows users to enter their height, automatically displaying their BMI alongside each weight entry. Additionally, shortcodes are available to render the most recent and starting BMI. * **Email notifications** - Receive email notifications whenever a user updates their target or adds/edits their weight entries. * **Birthday Emails** - Automatically send birthday emails to your users on their special day. * **Comprehensive user statistics** - Shortcodes to display the total weight lost or gained by the community, and another to showcase a league table. * **Widgets** - Widgets to display a graph and a quick weight entry form in any widget area. * **Chart and form shortcodes** - Shortcodes that allow you to display the graph and quick weight entry form on any post or page. * **Progress Bar shortcode / widget** - A shortcode that visually displays the logged-in user's progress towards their target. * **Reminder shortcode** - A shortcode that prompts users to enter their target or weight for today. * **Message shortcode** - A shortcode that congratulates users when they achieve weight loss milestones and can also offer encouragement when they gain weight. * **Text Shortcodes** - Additional shortcodes for displaying the earliest and most recent dates entered. * **Admin: View / Delete user data** - Administrators will be able to view and delete existing user data. * **User preferences** - If enabled, users can choose to store their weight in either Metric or Imperial units, specify their preferred date format, and clear all their weight data. * **Bar Charts** - Fancy something different to a line chart? The plugin will also support Bar Charts. * **Delete existing entry** - A logged-in user can delete or edit their existing weight entries. * **Richer data tables** - Data can be visualised and interacted with through enhanced HTML tables. * **Admin: Additional settings** - Additional settings will be added for further customisation of the plugin, such as adjusting the number of plot points on graphs, the number of rows per page, and more. [Read more about features](https://weight.yeken.uk/features/ "Read more about features") = Languages support = The plugin is written in English (UK) but has support for other languages such as French, Spanish, Dutch, Italian, Norwegian, Portuguese-Brazil, etc. For a list of supported languages please visit: [Weight Tracker Website - Supported Languages](https://weight.yeken.uk/weight-units-date-formats-languages/ "Weight Tracker Website - Supported Languages") Need a translation? Please read the following guide: [Translating the Weight Tracker plugin](https://weight.yeken.uk/translating-weight-loss-tracker-plugin/ "Translating the Weight Tracker plugin") = Documentation = Need further help? Please visit the dedicated site: [Weight Tracker Website](https://weight.yeken.uk "Weight Tracker Website") == 3rd Party Libraries == As with most modern software, this plugins utilises other 3rd party plugins. Depending on how you use the plugin (i.e. which shortcodes) determines which libraries maybe used. Below is a list of the 3rd party libraries used: * [UI Kit](https://getuikit.com/) * [Chart.js](https://www.chartjs.org/) * [Font Awesome](https://fontawesome.com/) * [Footable](https://fooplugins.github.io/FooTable/) * [Selectize](https://github.com/selectize/selectize.js) * [jQuery Validation Plugin](https://jqueryvalidation.org/) * [jQuery Slider Pips](https://github.com/simeydotme/jQuery-ui-Slider-Pips) * [ProgressBar.js](https://kimmobrunfeldt.github.io/progressbar.js) * [ZOZO UI Tabs](http://www.zozoui.com) * [Unite Gallery](https://github.com/vvvmax/unitegallery) YeKen libraries: * [YeKen Shop API prices](https://shop.yeken.uk) - [Privacy Policy](https://shop.yeken.uk/privacy-policy/) == Installation == 1. Install "Weight Tracker" via the "Plugins" page in WordPress Admin (or download zip and upload). 2. Setup the plugin in WordPress Admin panel by goto to Settings > Weight Tracker 3. Create a page that users will visit. Within the page content add the shortcode [wlt]. 4. Voila == Frequently Asked Questions == = Do you have any guides / documentation? = Yes! Please visit our dedicated site [Weight Tracker Website](https://weight.yeken.uk "Weight Tracker Website") = What date formats doe it support? = Currently it supports both UK (dd/mm/yyy) and US (mm/dd/yyyy) date formats. = How do I add photo fields? = Photo fields can be defined using a Custom Field. = How do I add measurements? = Measurements can be defined using a Custom Field. = What measurement formats doe it support? = Measurements are created using Custom Fields. You can therefore specify the unit yourself, whether that's centimetres, inches, feet, etc, it's entirely up to you. == Screenshots == 1. All three tabs of the main [wlt] shortcode 2. Tab one of [wlt]: Chart, Target and Weight form. 3. Tab two of [wlt]: Target Weight and Weight History 4. Tab three of [wlt]: User preferences page 5. Examples of random placements of [wlt-chart] and [wlt-form] 6. Examples of the Chart and Form widgets 7. Settings page: General 8. Settings page: User Experience 9. Settings page: Chart 10. Settings page: Measurements 11. Admin - User data summary 12. Admin - Displaying a user's data card 13. Admin - User search results 14. Admin - Edit a user's data entry 15. Admin - User's data card displayed on a tablet 16. Admin - Displaying a another view of the user's data card 17. Admin - Displaying all Custom Fields 18. Admin - Add / Edit custom field == Upgrade Notice == 10.17: New feature: Expanded [wt-if] shortcodes to include comparison modes. == Changelog == ! Remember to update Release.json = 10.20.4 = * Maintenance: Updated and tested to WP version 6.9.4. = 10.20.3 = * Bug fix: Fixed an issue where some strings labelled "Adjust" were not being translated correctly. = 10.20.2 = * Removed some legacy references to Pro Plus rather than Premium. = 10.20.1 = * Updated WP version after compatibility tests. = 10.20 = * Improvement: Added "Email Address" to CSV exports. = 10.19 = * New feature: Unified licensing, Pro Plus and Pro merged into Premium. = 10.18.1 = * Bug fix: Fire data to web hooks (if enabled) on GravityForm submissions. = 10.18 = * New feature: Added "Re-send to Endpoint(s)" button to "Edit Entry" screen within WP Dashboard. When pressed, the entry as currently seen, is re-fired to all webhook endpoints. = 10.17 = * New feature: Expanded [wt-if] shortcodes to include comparison modes: 'equals', 'greater-than','greater-than-or-equal-to', 'less-than' or 'less-than-or-equal-to'. Read more: https://docs.yeken.uk/shortcodes/wt-if.html = 10.16 = * New feature: Added argument "custom-size" to shortcodes [wt-photo-oldest] and [wt-photo-recent]. Read more at https://docs.yeken.uk/custom-sizes.html. = 10.15.1 = * Info: Due the changes below, you will see the notifications for Setupp Wizard and message from Yeken again until dismissed. * Improvement: Switched Setup Wizard notice to use wp options over transients when storing whether to show or hide. * Improvement: Switched notices from Yeken to use wp options over transients when storing whether to show or hide. = 10.15 = * Bug fix: Fixed an issue where user preferences wouldn't submit if a slide field was on the from. = 10.14 = * Bug fix: Fixed an issue where photo uploads weren't allowed when "hide from shortcodes" was selected. = 10.13 = * Version bump to fix a deploy issue. = 10.12 = * Version bump to fix a deploy issue. = 10.11.1 = * Maintenance: Minor tweaks to text files. = 10.11 = * New feature: Added an auto updater. Since leaving WordPress, we needed our own way to auto update the plugin. = 10.10.4 = Bug fix: Update notices weren't dimissing correctly on live sites. = 10.10.3 = Forgot to minimise admin.js! = 10.10.2 = * New Feature: Admin notifications from YeKen.uk * Bug fix: Fixed an issue with "Show Wizard" not being dismissable. = 10.10.1 = * Updated Chart.js to 4.4.4. * Updated jqueryvalidation.js to 1.19.5. * Updated Selctize.js to 0.15.2. * Extra data escaping and sanitisation. * Updated Readme.txt and documentaion. * Added some new marketing shortcodes - for use on weighttracker.yeken.uk = 10.10 = Several fixes based upon WordPress's plugin feedback: * Included all non minified versions of 3rd party JS. * CDNs for the following have been removed, their files are now served via the plugins folder: Chart.js, FontAwesome * Updated Readme to include references to 3rd party libraries. * Moved inline