Tiny Yardage Calcul’ator

Description

A simple form to calculate how many yards of material (’such as bark mulch, soil, concrete, gravel, etc) are needed to cover square feet to a given depth in inches.

By default, the calcul’ator is for rectangular areas. User enters length and width in feet and depth in inches; the calcul’ator returns yards of material needed, rounded up to the nearest whole number. You can also round to two decimal places (hundredths) by adding a parameter to the shortcode, like this:

[yardagecalc rounding="hundredths"]

I’ve also included calculations for circular and right triangular areas– just modify the shortcode like this:

CIRCLE

[yardagecalc type="circle"]

TRIANGLE

[yardagecalc type="triangle"]

The calcul’ator has no dependencies, adds ✨nothing✨ to your WordPress dashboard, and is style agnostic.

Screenshots

  • How to add the calculator to any page using the shortcode [yardagecalc]
  • How the calculator appears when you add it to a page with no custom css styling. It will fit whatever CSS styles you use, so by default it should fit in with your theme.

Installation

  1. Upload the plugin files to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen.

  2. Activate the plugin.

  3. Use the shortcode [yardagecalc] to add the calcul’ator wherever you want it. Alternatively, you could also include the form in a page template with php. Just add the following wherever you want the calcul’ator to appear: <?php echo do_shortcode("[yardagecalc]"); ?>

FAQ

Can I adjust the calcul’ator to round values to two decimal points (hundredths place)?

Sure! Just add rounding="hundredths" to your shortcode, like so:

[yardagecalc rounding="hundredths"]

Can I calculate areas that aren’t rectangular, like circles and right triangles?

Yes! Just add type="circle" or type="triangle" to your shortcode. Examples:

CIRCLE

[yardagecalc type="circle"]

TRIANGLE

[yardagecalc type="triangle"]

How do I change the text on the form labels?

Optionally, you may change the text on the form labels by adding attributes to your shortcode. For example, if you wanted to change just the label on the re’sult field, you would use the following shortcode:

[yardagecalc result_label="Your custom text here"]

Just replace the text inside the quotes with your own text. Wrapping your custom text in quotes, as in the example above, is necessary to en’sure your labels display properly.

Here’s examples of all three calculation types with ALL the labels customized:

RECTANGLE

[yardagecalc form_label="Your custom text here" length_label="Your custom text here" width_label="Your custom text here" depth_label="Your custom text here" result_label="Your custom text here"]

CIRCLE

[yardagecalc type="circle" form_label="Your custom text here" radius_label="Your custom text here" depth_label="Your custom text here" result_label="Your custom text here"]

TRIANGLE

[yardagecalc type="triangle" form_label="Your custom text here" base_label="Your custom text here" height_label="Your custom text here" depth_label="Your custom text here" result_label="Your custom text here"]

You can choose to replace or translate the text on all, some, or none of your fields. If you want to use the default text on a label, just leave that attribute out of the shortcode. The bare shortcode [yardagecalc] will use the default labels for all fields.

Does this plugin work with the block editor?

Yes! Just choose the shortcode block type and type the [yardagecalc] shortcode exactly as you would using the classic editor.

Reviews

Avost 3, 2022
With the added ability to customize the verbiage shown, it went from 5 to 10 stars in my eyes! Works great, matches into the page beautifully, thank you again!
Avost 5, 2022
**edit** The Author has contacted me and has been nothing but helpful!! I have just installed this plugin and see nothing in the admin. I applied the short code, and the widget appears, but it is not working. I input numbers, and nothing happens.
Avrîl 28, 2020
What a time saver this plugin was for me. Thanks
Read all 4 reviews

Contributors & Developers

“Tiny Yardage Calcul’ator” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2

  • Added two new calcul’ator types, circle and triangle
  • Changed default function name from calc() to tyc_calc() to prevent possible conflicts with other plugins
  • Added option to return values rounded to two decimal places (hundredths place)
  • Added some classes to form elements to make it easier to style the form with your own CSS

1.1

  • Added shortcode attributes to be able to optionally customize calcul’ator field labels

1.0

  • Published plugin