{"id":279854,"date":"2026-02-13T22:47:57","date_gmt":"2026-02-13T22:47:57","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/calcslive-article-embed\/"},"modified":"2026-02-19T06:55:45","modified_gmt":"2026-02-19T06:55:45","slug":"calcslive-article-embed","status":"publish","type":"plugin","link":"https:\/\/yor.wordpress.org\/plugins\/calcslive-article-embed\/","author":23447126,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.4","stable_tag":"1.1.4","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Unit Converter & Sizing Calculator for Product Pages","header_author":"CalcsLive","header_description":"Embed interactive CalcsLive articles with unit-aware calculations into your WordPress site using simple shortcodes or Gutenberg blocks.","assets_banners_color":"edf2eb","last_updated":"2026-02-19 06:55:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.calcslive.com\/services\/embed","header_author_uri":"https:\/\/www.calcslive.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":220,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.2":{"tag":"1.1.2","author":"dreamwell","date":"2026-02-13 22:55:06"},"1.1.3":{"tag":"1.1.3","author":"dreamwell","date":"2026-02-19 06:14:38"},"1.1.4":{"tag":"1.1.4","author":"dreamwell","date":"2026-02-19 06:55:45"}},"upgrade_notice":{"1.1.4":"<p>Added shortcode examples in readme. No functional changes.<\/p>","1.0.0":"<p>Initial release with calculator embed and Gutenberg block support.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3461103,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3461103,"resolution":"1544x500","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"calcslive\/article-embed":{"name":"calcslive\/article-embed","title":"CalcsLive Article"}},"tagged_versions":["1.1.2","1.1.3","1.1.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3464770,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3464770,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3464770,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"AC Sizing Calculator embedded on a portable air conditioner product page - helps customers choose the right BTU capacity","2":"Concrete Mix Calculator on a product page - customers calculate exactly how many bags they need","3":"Belt Selection Calculator integrated with Gates A36 product - technical specifications with interactive sizing"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[256158,159092,205431,256157,19417],"plugin_category":[56,59],"plugin_contributors":[255838],"plugin_business_model":[],"class_list":["post-279854","plugin","type-plugin","status-publish","hentry","plugin_tags-product-calculator","plugin_tags-product-specification","plugin_tags-quantity-calculator","plugin_tags-sizing-calculator","plugin_tags-unit-converter","plugin_category-social-and-sharing","plugin_category-utilities-and-tools","plugin_contributors-dreamwell","plugin_committers-dreamwell"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/calcslive-article-embed\/assets\/icon-256x256.png?rev=3461103","icon_2x":"https:\/\/ps.w.org\/calcslive-article-embed\/assets\/icon-256x256.png?rev=3461103","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/calcslive-article-embed\/assets\/screenshot-1.png?rev=3464770","caption":"AC Sizing Calculator embedded on a portable air conditioner product page - helps customers choose the right BTU capacity"},{"src":"https:\/\/ps.w.org\/calcslive-article-embed\/assets\/screenshot-2.png?rev=3464770","caption":"Concrete Mix Calculator on a product page - customers calculate exactly how many bags they need"},{"src":"https:\/\/ps.w.org\/calcslive-article-embed\/assets\/screenshot-3.png?rev=3464770","caption":"Belt Selection Calculator integrated with Gates A36 product - technical specifications with interactive sizing"}],"raw_content":"<!--section=description-->\n<p>Enhance your product pages with inline unit conversion and interactive unit-aware sizing calculators powered by CalcsLive. Makes it easier for customers to choose the right size and quantity before checkout. Help <strong>Reduce support inquiries and product returns<\/strong>.<\/p>\n\n<p><strong>Free:<\/strong> Unit converter shortcodes that let visitors toggle between metric and imperial units in your product specifications\u2014no account required.<\/p>\n\n<p><strong>Pro:<\/strong> Embed powerful sizing and quantity calculators from <a href=\"https:\/\/www.calcslive.com\">CalcsLive<\/a> that guide customers to the right product configuration.<\/p>\n\n<h4>Perfect For<\/h4>\n\n<ul>\n<li><strong>E-commerce stores<\/strong> \u2013 AC sizing, concrete quantity, flooring coverage, paint calculators<\/li>\n<li><strong>Technical products<\/strong> \u2013 Specifications with live unit conversion (mm \u2194 inches, kg \u2194 lbs)<\/li>\n<li><strong>Building materials<\/strong> \u2013 \"How many bags do I need?\" calculators<\/li>\n<li><strong>Industrial equipment<\/strong> \u2013 Belt sizing, cylinder selection, capacity calculators<\/li>\n<\/ul>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Unit Converter Shortcodes<\/strong> \u2013 Free, no API key needed: <code>[calcslive_qty value=25 unit=\"mm\"]<\/code><\/li>\n<li><strong>Calculator Embed<\/strong> \u2013 Embed full calculators: <code>[calcslive id=\"YOUR_ID\"]<\/code><\/li>\n<li><strong>Gutenberg Block<\/strong> \u2013 Visual editor with live preview<\/li>\n<li><strong>Responsive<\/strong> \u2013 Works on desktop, tablet, and mobile<\/li>\n<li><strong>Lightweight<\/strong> \u2013 Scripts load only on pages that use them<\/li>\n<\/ul>\n\n<h4>Buying Calculations: Reduce Returns, Increase Confidence<\/h4>\n\n<p>Technical products often require customers to determine <strong>the right size<\/strong> and <strong>the right quantity<\/strong> before purchase. Without guidance, they guess\u2014leading to returns, exchanges, and frustration.<\/p>\n\n<p><strong>Buying Calculations<\/strong> solve this by embedding pre-purchase calculators directly on product pages:<\/p>\n\n<ul>\n<li><strong>Sizing calculators<\/strong> \u2013 Help customers choose correct dimensions, capacity, or fit<\/li>\n<li><strong>Quantity calculators<\/strong> \u2013 Calculate how many bags, sheets, or units are needed<\/li>\n<\/ul>\n\n<h4>Create Calculators Without Coding<\/h4>\n\n<p>Traditional product calculators require custom development. CalcsLive changes this:<\/p>\n\n<ul>\n<li>Create calculation logic using familiar technical data<\/li>\n<li>Turn it into an interactive, unit-aware calculator<\/li>\n<li>Embed on WordPress with a simple shortcode<\/li>\n<\/ul>\n\n<p><strong>From days of development to under one hour<\/strong>\u2014no coding required.<\/p>\n\n<p>Product teams, engineers, or office staff can create and deploy calculators themselves, shifting calculator creation from a development task to a content task.<\/p>\n\n<h4>How It Works<\/h4>\n\n<p><strong>For unit converters (free, no account):<\/strong>\n1. Add to any page:<br \/>\n  - <code>[calcslive_qty value=25.4 unit=\"mm\"]<\/code> for single quantity<br \/>\n  - <code>[calcslive_qty_pair values=\"10,20\" unit=\"cm\"]<\/code> for quantity pair, and \n  - <code>[calcslive_qty_triplet values=\"1,2,3\" unit=\"m\"]<\/code> for quantity triplet.\n2. Visitors click to convert between compatible units<\/p>\n\n<p><strong>For embedded calculators:<\/strong>\n1. Create your calculator on <a href=\"https:\/\/www.calcslive.com\">CalcsLive<\/a>\n2. Get your embed API key and article ID\n3. Add <code>[calcslive id=\"YOUR_ID\"]<\/code> to your product page\n4. Customers use the calculator interactively<\/p>\n\n<h4>Free Tier<\/h4>\n\n<p>Start free with CalcsLive:\n* 2 embedded calculators\n* 1 domain\n* Full calculator functionality\n* Unit converter shortcodes (unlimited, no account needed)<\/p>\n\n<p><a href=\"https:\/\/www.calcslive.com\/auth\/register\">Get started free<\/a><\/p>\n\n<h4>Third-Party Service<\/h4>\n\n<p>This plugin relies on the <strong>CalcsLive<\/strong> external service to display interactive calculations. When an embed is rendered, your visitor's browser loads content directly from CalcsLive via an iframe.<\/p>\n\n<p><strong>What is sent:<\/strong><\/p>\n\n<ul>\n<li>Your embed API key and domain (included in the iframe URL)<\/li>\n<li>The article ID you specify in the shortcode or block<\/li>\n<\/ul>\n\n<p><strong>No visitor data<\/strong> (such as IP addresses, cookies, or personal information) is collected or sent to CalcsLive by this plugin. The iframe loads in the visitor's browser like any standard embedded content.<\/p>\n\n<ul>\n<li>CalcsLive website: <a href=\"https:\/\/www.calcslive.com\">calcslive.com<\/a><\/li>\n<li>Terms of Service: <a href=\"https:\/\/www.calcslive.com\/terms\">calcslive.com\/terms<\/a><\/li>\n<li>Privacy Policy: <a href=\"https:\/\/www.calcslive.com\/privacy\">calcslive.com\/privacy<\/a><\/li>\n<\/ul>\n\n<h3>Demo Site<\/h3>\n\n<p>See live examples at <a href=\"https:\/\/cl.donwen.com\">cl.donwen.com<\/a>:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/cl.donwen.com\/product\/portable-air-conditioner\/\">Portable Air Conditioner<\/a> - AC sizing calculator<\/li>\n<li><a href=\"https:\/\/cl.donwen.com\/product\/concrete-mix\/\">Concrete Mix<\/a> - Quantity calculator<\/li>\n<li><a href=\"https:\/\/cl.donwen.com\/product\/gates-a36\/\">Gates A36 Belt<\/a> - Belt selection tool<\/li>\n<li><a href=\"https:\/\/cl.donwen.com\/product\/mcm-m-series-round-body-air-cylinder\/\">Air Cylinder<\/a> - Air Cylinder Sizing Calculator<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to <code>\/wp-content\/plugins\/calcslive-article-embed\/<\/code>, or install directly through the WordPress plugins screen.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Use <code>[calcslive_qty]<\/code> shortcodes immediately for inline unit conversion (no API key needed).<\/li>\n<li>For embedded calculators: Go to Settings \u2192 CalcsLive to configure your API key.<\/li>\n<li>Use the <code>[calcslive id=\"...\"]<\/code> shortcode or CalcsLive block to embed calculators.<\/li>\n<\/ol>\n\n<h4>Unit Converter Shortcodes<\/h4>\n\n<p>No API key needed. These shortcodes render interactive values that visitors can click to convert between units:<\/p>\n\n<p><strong>Single value:<\/strong>\n    [calcslive_qty value=25.4 unit=\"mm\"]<\/p>\n\n<p><strong>Value pair (e.g., dimensions):<\/strong>\n    [calcslive_qty_pair values=\"10,20\" unit=\"cm\"]<\/p>\n\n<p><strong>Value triplet (e.g., L x W x H):<\/strong>\n    [calcslive_qty_triplet values=\"1,2,3\" unit=\"m\"]<\/p>\n\n<p><strong>Optional attributes:<\/strong><\/p>\n\n<ul>\n<li><code>dp<\/code> - Decimal places (default: 2)<\/li>\n<li><code>show_unit_arrow<\/code> - Show\/hide unit dropdown arrow (default: true)<\/li>\n<\/ul>\n\n<h4>Getting Your API Key<\/h4>\n\n<ol>\n<li>Sign up or log in at <a href=\"https:\/\/www.calcslive.com\">CalcsLive<\/a><\/li>\n<li>Go to Account \u2192 API &amp; Integration Settings<\/li>\n<li>Create a new API key with service type \"Website Embedding\"<\/li>\n<li>Add your WordPress domain to the allowed domains<\/li>\n<li>Copy the API key to your WordPress settings<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20get%20an%20api%20key%3F\"><h3>Where do I get an API key?<\/h3><\/dt>\n<dd><p>You can get an API key from your CalcsLive account at <a href=\"https:\/\/www.calcslive.com\/account\/api-keys\">calcslive.com\/account\/api-keys<\/a>. You need to create an embed-type API key and add your WordPress domain.<\/p><\/dd>\n<dt id=\"how%20do%20i%20find%20my%20article%20id%3F\"><h3>How do I find my article ID?<\/h3><\/dt>\n<dd><p>The article ID is the short code at the end of your CalcsLive article URL. For example, in <code>https:\/\/www.calcslive.com\/view\/3M7EJLZQ2-4N5<\/code>, the article ID is <code>3M7EJLZQ2-4N5<\/code>.<\/p><\/dd>\n<dt id=\"can%20i%20embed%20multiple%20calculators%20on%20one%20page%3F\"><h3>Can I embed multiple calculators on one page?<\/h3><\/dt>\n<dd><p>Yes! Each article can contain multiple calculations with different namespaces. You can also embed multiple articles on the same page using multiple shortcodes.<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20page%20builders%20like%20elementor%3F\"><h3>Does this work with page builders like Elementor?<\/h3><\/dt>\n<dd><p>Yes, you can use the shortcode <code>[calcslive id=\"...\"]<\/code> in any page builder that supports WordPress shortcodes.<\/p><\/dd>\n<dt id=\"is%20this%20free%3F\"><h3>Is this free?<\/h3><\/dt>\n<dd><p>The WordPress plugin is free and open source. CalcsLive offers a free tier with 2 embed pages, or you can upgrade for more pages and domains.<\/p><\/dd>\n<dt id=\"can%20customers%20enter%20their%20own%20values%3F\"><h3>Can customers enter their own values?<\/h3><\/dt>\n<dd><p>Yes! The embedded article is fully interactive. Customers can change input values and units, and the calculations update in real-time.<\/p><\/dd>\n<dt id=\"do%20the%20unit%20converter%20shortcodes%20need%20an%20api%20key%3F\"><h3>Do the unit converter shortcodes need an API key?<\/h3><\/dt>\n<dd><p>No. The <code>[calcslive_qty]<\/code>, <code>[calcslive_qty_pair]<\/code>, and <code>[calcslive_qty_triplet]<\/code> shortcodes work entirely client-side with no external service. They use the bundled <a href=\"https:\/\/www.npmjs.com\/package\/physical-quantity\">physical-quantity<\/a> web component library.<\/p><\/dd>\n<dt id=\"where%20is%20the%20source%20code%20for%20the%20bundled%20javascript%3F\"><h3>Where is the source code for the bundled JavaScript?<\/h3><\/dt>\n<dd><p>The <code>pq.umd.js<\/code> file is built from the <a href=\"https:\/\/www.npmjs.com\/package\/physical-quantity\">physical-quantity<\/a> npm package (MIT licensed). The source is human-readable and includes version metadata in a banner comment.<\/p><\/dd>\n<dt id=\"what%20units%20are%20supported%3F\"><h3>What units are supported?<\/h3><\/dt>\n<dd><p>The unit converter supports length, mass, temperature, energy, force, pressure, volume, area, and more. Visitors click the unit dropdown to convert between compatible units (e.g., mm \u2194 inches, kg \u2194 lbs, \u00b0C \u2194 \u00b0F).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Added shortcode examples for qty, pair, and triplet in readme<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Renamed plugin for better discoverability in WordPress directory<\/li>\n<li>Improved readme with clearer feature descriptions and use cases<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Added unit converter shortcodes: <code>[calcslive_qty]<\/code>, <code>[calcslive_qty_pair]<\/code>, <code>[calcslive_qty_triplet]<\/code><\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Bundled physical-quantity web component library (v1.1.92)<\/li>\n<li>PQ script loads only on pages using PQ shortcodes<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Updated tested WordPress version to 6.9<\/li>\n<li>Added third-party service disclosure for WP.org compliance<\/li>\n<li>Added languages directory for i18n support<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Shortcode support: <code>[calcslive id=\"...\" width=\"...\" height=\"...\"]<\/code><\/li>\n<li>Gutenberg block with live preview<\/li>\n<li>Settings page for API key and default dimensions<\/li>\n<li>Responsive iframe embedding<\/li>\n<\/ul>","raw_excerpt":"Add unit converters to product specs and embed sizing calculators that help customers buy the right size and quantity.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/279854","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=279854"}],"author":[{"embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/dreamwell"}],"wp:attachment":[{"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=279854"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=279854"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=279854"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=279854"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=279854"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/yor.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=279854"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}