Nutrition Facts Label Creator
Created: May 08, 2023. Last updated: May 08, 2023. Version: 1.0.0. Author: SaurabhSharma. email: xconsau@gmail.com
Introduction
Dear buyer, thank you for purchasing "Nutrition Facts Label Creator" plugin. I have handcrafted this document to lessen your efforts in configuring and using this plugin seamlessly. If you find any bug or issue which is beyond the scope of this documentation file, feel free to contact me through my CodeCanyon profile page here. Thanks so much!
Table of Contents
Install WordPress
If you have not set up your WordPress installation yet, you can download a copy of latest WordPress archive from WordPress.org. Next, go through the installation instructions inside readme.html file and set up your WordPress installation. A detailed installation guide can be found on official WordPress Site.
Install Elementor Page builder Plugin
The "Total Recipe Generator" plugin is an extension/addon for Elementor Page Builder. Elementor is available in both free and pro versions. It will be required to install and activate Elementor plugin in order to use Total Recipe Generator. Kindly follow these steps for installing Elementor Plugin:
1. Log in to WordPress admin and navigate to Plugins > Add New
2. Inside "Search Plugins" field, type "Elementor" and hit Enter key.
3. From the search results, install Elementor plugin and activate it.
For detailed documentation on using Elementor plugin, please browse articles on the official documentation page of Elementor Plugin.
Install Nutrition Facts Label Creator Plugin
In order to install the plugin, follow these steps:
1. Download plugin archive from your codecanyon.net account's downloads section. You can download main archive or installable plugin zip archive.
2. If you have downloaded the main archive, unzip/extract this archive and look for the folder named nutrition-facts-label-creator-el.zip. This zip archive shall be used for installation in WordPress admin.
3. Log in to WordPress and navigate to Plugins > Add New. Click on the "Upload Plugin" button.
Upload Plugin
4. Click on the "Choose file" button and browse the nutrition-facts-label-creator-el.zip plugin file.
Browse Plugin
5. Next, click on the "Install now" button. The plugin will be installed.
6. After installation, navigate to Plugins > Installed Plugins, and activate the "Nutrition Facts Label Creator" plugin.
Activate Plugin
Manual installation using FTP or File Manager
You can also install the plugin manually using FTP or File Manager. For that, log in to your site's Control Panel > File Manager, or log in to FTP and upload the extracted plugin folder to /wp-content/plugins/ directory. So your installed plugin address will be /wp-content/plugins/nutrition-facts-label-creator-el/. After uploading the folder, log in to WordPress and activate the plugin inside Plugins > Installed Plugins.
Create Nutrition Facts Label
Once the plugin is installed and activated, it shall be available inside the "General" tab of the Elementor widgets library. Drag this widget inside the content area and create a Nutrition Facts label, as shown below in the video.
Styling the plugin
It is recommended to use the standard Nutrition Facts Label format. But fi you wish to express the label in your own style, you can do so by editing the colors, fonts and table style, as shown below:
Using the typography and color settings, you can style the table to match your current website theme.
Translating the Plugin
The Nutrition Facts Label Creator plugin is translation ready with language files included in plugin. You can translate the plugin with any translation plugin like WPML, qTranslateX or Loco Translate. But if you wish to translate it manually using the PO files, kindly follow these steps.
1. Download poEdit Software from https://poedit.net/ and install on your computer.
2. Open poEdit software and click on File > New from POT/PO file.
3. Browse the nutrition-facts-label-creator-el.pot file. A language popup will appear. Choose your language and click on "OK".
Choose translation language
4. For example, choose "Dutch" language. Next, click on any message string and write it's translation inside the "Translation" field.
Edit Translation
5. After making necessary translations, go to File > Save as. Here, provide the file name as nflc_el-language_country. Please note that the "nflc_el" textdomain name is required here. So if it is Dutch, the filename would become nflc_el-nl_BQ.po
6. Once the file is saved, an MO file will be compiled and generated.
7. Now you need to define the language inside WordPress settings. For that, log in to WordPress admin and navigate to Settings > General. From the "Site Language", choose the language in which you have created the PO file. Then save changes.
The plugin shall now display translated strings successfully.
Frequently Asked Questions
Below are some Frequently Asked Questions that may help you in finding a solution to your specific issue.
1. I have just uploaded the download zip file to WordPress, but it is showing an error. Why?
Your download zip file is not the plugin itself. It is a collection of plugin and documentation. It will be required to unzip this folder first. Next look for the folder named "nutrition-facts-label-creator-el.zip". Use this zip folder for uploading the plugin via WordPress.
2. How to update the plugin
Plugin can be updated in several ways, as shown below:
2.1) From the WordPress admin: Navigate to Plugins > Installed Plugins. Deactivate the "Nutrition Facts Label Creator" plugin and delete it. Next, install the latest copy of plugin by browsing the nutrition-facts-label-creator-el.zip file from your computer.
2.2) From the FTP or Control Panel: Log in to your FTP or Control Panel of hosting account and locate the /wp-content/plugins/nutrition-facts-label-creator-el/ folder. Delete this folder and update the latest extracted folder from your computer.
2.3 Automatic updates: For automatic updates, download and install the Envato Market plugin. After configuring the plugin with your purchase code and Envato market account, it shall automatically update themes and plugins purchased from the Envato market. More details on using the plugin can be found on the plugin page itself.
3. How is the "Calories from Fat" calculated?
The calories from fat is 9 times the total fat amount in grams. So the value of "Total Fat" will be multiplied by 9 and shown as "Calories from Fat". E.g. If total fat is 10g, then calories from fat will be 10*9 = 90 cal.
4. How are standard values for Nutrition Facts determined?
The reference for standard daily values (DVs) are taken from Wikipedia and FDA Guidance Document. The standard values for various nutrients are set inside nflc_templates/default.php file.
5. How to change standard daily value of a nutrient?
Standard daily values can be changed using action filter hooks. A filter can be used by adding the following code inside theme's functions.php file:
// Modify Total Fat standard value
add_filter( 'total_fat_sv', function() { return 75 } );
For complete list of filter names, see /includes/widget-nflc-el.php file. The filters are located inside the following function:
function nflc_el( $atts, $content = null ) {}
Once again, thanks so much for purchasing this plugin. I'd be glad to help you if you have any questions relating to this plugin. If you have a more general question relating to the plugins on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Saurabh Sharma