=== CBM Calculator ===
Contributors: cbmcalculator
Tags: cbm calculator, cubic feet, cubic meter, volume & weight calculator, shipping calculator
Requires at least: 6.1
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2

Embed a fully customizable CBM Calculator on your site. Choose a template, match your brand colors, and toggle the fields you need.

== Description ==

**CBM Calculator** is a powerful shipping calculator plugin that helps you calculate cubic meters (CBM), cubic feet (CFT), volumetric weight, and container fitting — directly on your WordPress site.

Powered by the [CBM Calculator API](https://www.cbmcalculator.com/cbm-api/cbm-calculator-wordpress-integration?utm_source=wordpress&utm_medium=plugin-description&utm_campaign=cbm-calculator), the plugin delivers accurate real-time calculations as you type.

= Three Calculator Templates =

**Single Product**
Calculate CBM, CFT, volumetric weight (sea & air), and container fitting for one product at a time. Perfect for simple shipping queries.

**Multiple Products**
Add multiple products in a table layout, each with its own dimension unit and weight unit. Get per-row results and grand totals for CBM, CFT, and quantity.

**Container Fitting**
Visual card layout showing exactly how many units fit in a 20 FT, 40 FT, and 40 FT HC container.

= Key Features =

* Real-time calculations as you type — debounced for accuracy
* 3 calculator templates to suit different use cases
* Per-row unit of measurement in Multiple Products template
* Full color customization — Primary, Header, Button, Background, Text, Border
* Border radius control for sharp or rounded styling
* Show/hide optional fields — Volumetric Weight Sea, Volumetric Weight Air, Container Fit
* Reset to Defaults button in settings — preserves your API key
* Fully responsive — works on mobile, tablet, and desktop
* Simple shortcode: [cbmcal_calculator_plugin]

= Supported Units of Measurement =

Dimensions: cm, mm, meter, inch, feet, yard
Weight: kg, lb

= API Key =

This plugin requires a free API key from [cbmcalculator.com](https://www.cbmcalculator.com/profile.html?utm_source=wordpress&utm_medium=plugin-description&utm_campaign=cbm-calculator). You receive **100 free API calls for development**. Paid plans are available for production use.

= Usage =

Add the shortcode to any page or post:

`[cbmcal_calculator_plugin]`

Then go to **Settings → CBM Calculator** to configure your API key, choose a template, customize colors, and toggle fields.

== Installation ==

1. Install plugin from WordPress
2. Visit https://www.cbmcalculator.com/profile.html?utm_source=wordpress&utm_medium=plugin-readme&utm_campaign=cbm-calculator
3. Create a free account
4. Copy your API key from the profile page after login (100 free API calls for development)
5. Go to Settings > CBM Calculator and paste your API key
6. Choose a template, customize colors, toggle fields
7. Add shortcode [cbmcal_calculator_plugin] to any page or post

== Frequently Asked Questions ==

= Where do I get an API key? =

Visit [cbmcalculator.com/profile.html](https://www.cbmcalculator.com/profile.html?utm_source=wordpress&utm_medium=plugin-faq&utm_campaign=cbm-calculator), create a free account, and copy your API key from the profile page.

= How many free API calls do I get? =

You get 100 free API calls for development. For production use, paid plans are available on [cbmcalculator.com](https://www.cbmcalculator.com?utm_source=wordpress&utm_medium=plugin-faq&utm_campaign=cbm-calculator).

= Which shortcode do I use? =

Add `[cbmcal_calculator_plugin]` to any page, post, or widget.

= Can I customize the colors? =

Yes — go to Settings → CBM Calculator and you will find color pickers for Primary, Header, Button, Background, Text, and Border colors, plus a border radius slider.

= Can I hide certain fields? =

Yes — in Settings → CBM Calculator you can toggle Volumetric Weight Sea, Volumetric Weight Air, and Container Fit on or off.

= Does it work on mobile? =

Yes — the calculator is fully responsive and adapts to any screen size.

= Which units of measurement are supported? =

Dimensions: cm, mm, meter, inch, feet, yard. Weight: kg, lb.

== Screenshots ==

1. Single Product Calculator — clean layout with volume, weight and container results
2. Multiple Products Calculator — per-row unit selectors, CBM, CFT and container columns
3. Container Fitting Calculator — visual card layout showing units per container type
4. Settings Page — API key, template selector, color pickers and field toggles

== Changelog ==

= 1.2.0 =
* Tested up to WordPress 7.0
* New: 3 calculator templates — Single Product, Multiple Products, Container Fitting
* New: Per-row dimension and weight unit selectors in Multiple Products template
* New: Color customization — Primary, Header, Button, Background, Text, Border
* New: Border radius control
* New: Show/hide fields — Volumetric Weight Sea/Air, Container Fit
* New: Reset to Defaults button in settings (preserves API key)
* Improved: Debounced calculations — no more stale results on fast typing
* Improved: Responsive design, full width layout
* Fixed: Settings save issue with color fields

= 1.1.0 =
* Tested up to WordPress 6.8
* Replaced deprecated wp_print_scripts hook with wp_enqueue_scripts
* Moved inline event handlers to JavaScript
* Improved mobile responsiveness
* Fixed typo in error message
* Replaced deprecated new Object() with object literal syntax

= 1.0.0 =
* Initial release
