=== Land & Timber Calculators ===
Contributors: dodsondevelopment1
Tags: calculator, land value, timber, farmland, cash rent
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Land value, cash rent, board foot, timber, land loan, acreage and cord calculators, plus USDA state and county land value pages.

== Description ==

Land & Timber Calculators adds seven calculators and thousands of ready-made data pages to any WordPress site about land, farming, forestry, hunting or rural real estate.

**Calculators** (they run in the visitor's browser; nothing is sent or stored):

* Land value: acres times the USDA state average for farm real estate, cropland or pasture, or your own per-acre figure.
* Board foot: Doyle, Scribner and International 1/4" log rules.
* Timber sale value: volume by product, stumpage prices, logging and forester costs.
* Land loan: payment, total interest and payoff schedule.
* Acreage: acres from dimensions, with unit conversions.
* Firewood cord: cords in a stack and price per cord.
* Land lease income: income per acre, per month and return on land value.

**Data pages** built from USDA National Agricultural Statistics Service (NASS) figures:

* Land values per acre for every state with USDA estimates, with history, rank and a calculator.
* Cash rent per acre for every state and about 2,900 counties, with history for each county.
* A separate sitemap for the data pages (/ltc-sitemap.xml), added to robots.txt.
* Titles, descriptions, canonical URLs and breadcrumb structured data, compatible with Yoast SEO and Rank Math.
* County pages with fewer than two survey years are marked noindex so thin pages stay out of search results.

**Embeds:** each calculator has embed code you can give to other sites. Embedded calculators show a small credit link back to your site and never show ads.

**Ads:** optional ad code above and below calculators (Settings > Land Calculators). Leave it empty if you use AdSense Auto ads.

= Shortcodes =

* `[ltc_land_value]` `[ltc_lease_income]` `[ltc_board_foot]` `[ltc_timber_value]` `[ltc_land_loan]` `[ltc_acreage]` `[ltc_cord]`
* `[ltc_land_values]` on one page creates /that-page/state/ pages.
* `[ltc_cash_rent]` on one page creates /that-page/state/ and /that-page/state/county/ pages.

Settings > Land Calculators can create all of these pages for you in one click.

== External services ==

This plugin downloads public statistics from a data service run by the plugin author, **Store Lead Index** (https://storeleadindex.com). The files are USDA NASS land values and cash rents republished as JSON with checksums.

* What is sent: a plain HTTPS GET request for the files at the data address (default https://storeleadindex.com/data/v1/land). The request carries your server's IP address and a standard WordPress user agent. No visitor data, personal data or site content is sent.
* When: once a day by WP-Cron, and when an administrator presses "Sync now".
* You can change the data address in Settings > Land Calculators, or leave the data pages unused; the calculators work without it.
* Store Lead Index terms: https://storeleadindex.com/terms
* Store Lead Index privacy policy: https://storeleadindex.com/privacy

The underlying statistics come from USDA NASS Quick Stats. This product uses the NASS API but is not endorsed or certified by NASS.

== Installation ==

1. Install and activate the plugin.
2. Go to Settings > Land Calculators and press "Sync now" to load the data.
3. Tick the pages you want under "Create pages" and press "Create selected pages".
4. Add the new pages to your menu.

== Frequently Asked Questions ==

= Are the figures an appraisal? =

No. They are USDA survey averages for a whole state or county. Every data page and calculator says so.

= Does it slow my site down? =

The data is stored in two database tables and read with indexed queries. Calculators load one small script and stylesheet only on pages that use them.

= What happens if the data service is down? =

The site keeps showing the last good data. A sync only switches over after every file has downloaded and passed its checksum.

= Can I use my own per-acre figures? =

Yes. Every value calculator accepts a typed per-acre figure.

== Screenshots ==

1. Land value calculator with USDA state averages.
2. A state land value page with history.
3. A county cash rent page.
4. Settings screen.

== Changelog ==

= 1.2.0 =
* Hooks for add-ons (ltc_enqueued, ltc_embed_credit, ltc_embed_head, ltc_embed_assets).

= 1.1.0 =
* Embeddable calculators, noindex for thin county pages, SEO plugin integration.

= 1.0.0 =
* First release.
