=== YardMetrik – Landscaping Material Calculator ===
Contributors: arisdigitaltools
Tags: landscaping, calculator, cubic yards, mulch, gravel
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

YardMetrik is a simple material calculator for mulch, topsoil, gravel, and decorative stone.

== Description ==

Add the `[landscaping_calculator]` shortcode to a post or page. Visitors can build one landscaping project from multiple separate areas. Each area can be a rectangle or circle with its own depth, while the selected material and extra-material allowance apply to the entire project.

YardMetrik presents shared project details, distinct project-area cards, and a clear results summary. It totals all project square footage and aggregates the individual area volumes, then shows the calculated amount, extra material allowance, and a recommended order amount rounded up to the next quarter cubic yard. Site administrators can optionally set a USD price per cubic yard for each material at Settings > YardMetrik – Landscaping Material Calculator. The settings page includes clear material-price guidance and shortcode usage instructions. When a valid USD price is configured, the calculator also shows an estimated material cost.

== Installation ==

1. Upload the `yardmetrik-landscaping-material-calculator` folder to `/wp-content/plugins/`, or install it through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Optionally configure material pricing at Settings > YardMetrik – Landscaping Material Calculator.
4. Add `[landscaping_calculator]` to a post or page.

== Frequently Asked Questions ==

= What shapes and units does the calculator support? =

Rectangles use length and width in feet. Circles use diameter in feet. Each area has its own depth measured in inches. Results are displayed in cubic yards.

= How is the recommended amount to order calculated? =

The calculator adds the selected extra-material percentage and rounds the result up to the nearest 0.25 cubic yard.

= Are prices required? =

No. Prices are optional and entered in USD; an estimated cost is shown only for materials with a valid configured price.

== Changelog ==

= 1.0.0 =

* Initial public release with multi-area rectangle and circle calculations, per-area depth, extra-material allowance, quarter-yard ordering recommendations, optional USD cost estimates, and WordPress admin pricing settings.

= 0.6.0 =

* Prepared the plugin for release with frontend translation-ready strings, realistic input limits, USD pricing clarity, and a release ZIP packaging script.
* Added individual depth inputs for each project area and aggregate volume calculations.

= 0.5.0 =

* Improved the YardMetrik settings page with clearer material pricing guidance and shortcode usage instructions.

= 0.4.0 =

* Refined the frontend layout, unit clarity, project-area cards, actions, and results summary.
* Made the rounded-up recommended amount more prominent while preserving existing calculations.

= 0.3.0 =

* Added multi-area project calculations with rectangle and circle support.
* Added aggregate project square footage and area-specific validation.

= 0.2.0 =

* Added material selection, extra-material allowance, quarter-yard ordering recommendations, optional material pricing, and a Settings page.

= 0.1.0 =

* Initial MVP release.
