=== TEG-LAWNCARE — Landscaping, Lawn Care & Crews ===
Contributors: theeldestgeek
Tags: lawn care, landscaping, routes, crews, field service
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.22.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The back office for a lawn care and landscaping firm: routes rather than appointments, with the drive time between stops measured and charged against the job, recurring plans that cope with rain, chemical application records kept the way an inspector asks for them, crews, properties that are not the billing address, and a visitor page that quotes from the turf area.

== Description ==

Forty lawns on a Tuesday are not forty appointments. They are one route, worked by one crew, with driving in between. A $45 lawn cut in twenty minutes looks like $135 an hour; add the twenty-five minutes it took to get there and it is $60 an hour. TEG-LAWNCARE carries the drive time on every stop, so every revenue figure is per crew hour including the driving.

* **Routes** - the day as a route in order, worked by one crew, with drive time between stops. Estimated at first; replaced by measured times once crews record arrived and left.
* **Revenue per crew hour including driving** - on the dashboard and in the reports, with the flattering on-site figure beside it and never on its own.
* **Plans and visits** - a plan is what the customer agreed (this lawn, this service, this often, at this price, for this season); visits are generated a few weeks ahead and can be moved, skipped or canceled without touching the plan. Rain pushes work into the following days rather than deleting it.
* **Chemical applications** - applicator and certificate number, product and registration number, rate, amount, area, times, weather, target and re-entry interval. An applicator without a current certificate, or an application above the wind limit, is refused unless a manager overrides it, and the override goes in the audit trail under their name.
* **Materials** - cost tracking for mulch, seed and fertilizer, and the regulatory details for herbicides, pesticides and fungicides.
* **Customers and properties apart** - one customer can have many properties on one invoice; properties carry location, turf area and access notes.
* **Crews** - the unit of work and of cost, with an hourly cost per crew; applicator licenses belong to the person, with their own expiry dates.
* **Equipment** - service intervals counted in engine hours from the routes a machine's crew ran, plus a cost log.
* **Price list** - per visit (by lawn size, with a minimum), per 1,000 sq ft, per unit or per hour.
* **Estimates** - accepted from a link at the amount shown; recurring lines turn into a plan the moment the customer accepts.
* **Invoices** - per visit or monthly, chosen per customer, with payments.
* **Ways to pay** - under Settings > Money and billing, tick the payment methods you accept (Zelle, PayPal, Venmo, credit card, check, cash) and type the one line the customer needs for each - your Zelle phone, your PayPal.me link, who checks are payable to. Card, check and cash are ticked to begin with. Every new invoice offers what you accept; open an invoice to untick a method for that customer. The customer's invoice page and the invoice e-mail list the ways to pay with your details, and "Payments received" once money comes in. Recording a payment keeps the method, a note for the office only, who recorded it and when, and e-mails the customer a receipt only if you tick the box.
* **Notifications** - the day-before message so gates are unlocked and dogs are in (on as shipped, to customers who agreed to hear from you). "We have been today", the rain-off notice and the re-entry e-mail after an application are each a switch under Settings > Notifications and are OFF as shipped; once on, the re-entry e-mail goes whatever the customer's marketing preference because it is a safety notice.
* **Crew route page** - `[teg-lawncare-route]`, signed in, for a phone beside the trailer: the stops in order, arrived and left, and property notes.
* **TEG Rover (new in 1.5.0)** - the office side of the TEG Rover phone app for your crew members out on jobs. Under TEG-LAWNCARE > Visits & deliveries (called TEG Rover before 1.22.0) the office makes a call from a scheduled visit (its customer, property, service and day come with it), an estimate visit or a one-off job, sets a priority, a time window and the checklist for that service, and either assigns a crew member or puts the call on the open board, where the first one to claim it gets it (two can never take the same call). Claiming a visit moves it to that person's crew - unless it is already on another crew's route for the day, which it stays on. Each phone pairs once with its own revocable key (TEG-LAWNCARE > Setup > Device pairing: scan the QR code with the app, or paste the pairing code), no passwords; phone keys are never restored from a backup. The phone sends its GPS position every 5-10 minutes ONLY while the crew member is on shift; the office sees each person's last check-in, a live map with the calls as pins (OpenStreetMap, or Mapbox with a map token from TEG on a paid license), a route for any day, who is closest, and a "probably on site" hint when someone is at the property but has not pressed Arrived. Finishing a scheduled visit on the phone marks it done exactly as "Mark done" does (the plan moves on, a per-visit customer is invoiced) and puts the crew's notes on the visit and the property; an estimate visit turns into a draft estimate with one click; a one-off job asks for before and after photos. A visit cannot be completed until every checklist item is ticked and the photos the call requires have been sent. The phone gets the lawn size, the slope and the crew notes, and the gate code, the dog and the access notes only once the call is that person's. Money taken at the door is recorded with its method and waits for the office to confirm it before it goes on the invoice (no card processor on the phone yet). Photos and signatures are private files only signed-in office staff can open (to keep them outside the website's folders altogether, define TLC_PRIVATE_DIR in wp-config.php as a folder outside the web root); location check-ins are deleted after 30 days by default and are part of WordPress's personal data export and erase. The TEG Rover app is Android first and needs version 0.2.2 or later to pair with TEG-LAWNCARE (earlier versions only know TEG-REPAIRSHOP). Runs on this plugin's own license; the data stays on your own site, and there is no monthly fee per crew member.
* **Customer page** - `[teg-lawncare-account]` by link, no login (the link is on the customer's screen): when the crew is coming, what was applied and when it is safe again, and what is owed. The crew's own notes are not shown. `[teg-lawncare-quote]` and `[teg-lawncare-pay]` show an estimate or invoice; the links work even with no page carrying the shortcode.
* **Visitor page** - `[teg-lawncare]`, with a quote worked out from the square footage and the same price list the office uses.
* **Reports, permissions and backup** - the figures a lawn care firm is run on, a permission matrix per role (recording an application is its own permission), and backup and restore under Settings > Backup.

Data lives in the site's own tables, not in posts.

= License =

TEG-LAWNCARE is licensed like The Eldest Geek's Doctor tools. A 30-day Pro trial is baked in and starts the first time the plugin runs on the site; there is nothing to sign up for. A purchased code from theeldestgeek.com (annual or lifetime, single site or an agency pack) is entered under Settings > License. It is bound to the name and e-mail on the order and verified offline against a public key; a paid code is re-checked with the license server once a day and keeps working when the server cannot be reached.

Without a valid license - once the trial has ended, or if a license has been revoked - adding and changing records pauses. Nothing is lost: everything already recorded stays readable and can be exported, customers can still book and use their portal, and entering a license carries on exactly where you left off. The license also decides which updates can be installed. A lifetime license installs any version. A current license installs any version. An expired one keeps installing every version released before it expired, forever, and nothing released after.

= Companion app =

TEG Companion is the phone app for running the business away from the desk: customers and properties, visits (marked done or skipped by the website's own rules), notes, photos and signatures, estimates and invoices, payments taken and the day's takings. It talks to this plugin as the person it was paired for, so it can do only what that person can do here. Pair a phone under TEG-LAWNCARE > Setup > Device pairing (one key list serves TEG Rover and TEG Companion); photos and signatures are kept in a private folder, never in the Media Library; nothing is ever e-mailed to a customer by the app, and a payment taken from the phone sends no receipt.

== Installation ==

1. Plugins > Add New > Upload Plugin, choose the zip, and activate. The tables are created and the trial is already running.
2. Lawn care > Settings: the firm's details, routing, the season, chemicals, money and billing.
3. Add crews with their hourly cost, the price list, and your customers and their properties.
4. Put `[teg-lawncare]` on a page for the visitor page, `[teg-lawncare-account]` on another for the customer's page, and `[teg-lawncare-route]` on a page for the crews. The estimate and invoice pages are `[teg-lawncare-quote]` and `[teg-lawncare-pay]` (full list: Help Center > Shortcodes).

Later versions arrive through Dashboard > Updates. The download is checked against its published SHA-256 before it is installed, and an update replaces the files in place without touching your data.

== Changelog ==

= 1.22.0 =
* New: a "Send with Rover" button on each visit still to be worked (Scheduled or On a route) under Field work > Visits. It makes a Scheduled visit call for the TEG Rover phone app, with the customer, property, service and day already filled in. A visit has one open call at a time.
* New: three more reasons a crew can give when a visit could not be done: grass too long, ground too wet, a dog in the yard.
* Changed: the Field work menu entry "TEG Rover" is now called "Visits & deliveries". The phone app is still TEG Rover, and it stays on as before.
* Crew phones need the current TEG Rover app.

= 1.21.4 =
* The page shortcodes are renamed: [teg-lawncare-estimate] is now [teg-lawncare-quote] and [teg-lawncare-invoice] is now [teg-lawncare-pay]. The old names stop working, so put the new ones on your pages (the one-click setup pages already use them).

= 1.21.3 =
* A coupon can no longer be used twice when two people at two tills apply it at the same moment; the second till is asked to try again.
* Changed: a coupon that would take off more than an invoice still owes (after a part payment, say) is now refused, with the amount still owed. Before, it was applied.
* Payments from the phone app that you confirm (Zelle, Venmo, PayPal) no longer get stuck if the confirm is interrupted. The shop works out whether the payment was recorded, and if it cannot tell, it shows two "I checked" buttons on the payment so you decide.
* A customer import that stopped half-way no longer blocks Undo for ever, and two Undo clicks at once can no longer clash.
* A late delivery report from the text provider can no longer turn a delivered text back into "sent", and a held text can no longer go out twice when two scheduled runs overlap.

= 1.21.2 =
* Resume on a paused plan now brings the paused visits back, from today on, on their route if they were on one and at the plan's current price. A plan set back to Active after it was Ended gets its visits back the same way.
* A visit that was skipped or is already finished can no longer be finished or invoiced a second time from the route screen, the TEG Companion app or TEG Rover. If the office skipped or cancelled a visit before the crew reported it, the crew is told to ring the office and nothing is invoiced.
* An estimate the customer already accepted or declined is not sent again by an old link, so its plans are never made twice.
* An old Pause or Resume link clicked a second time changes nothing and says so.
* The plan form and the Pause, Resume and End buttons now do the same thing: saving a plan as Paused or Ended takes its coming visits out of the diary and records it in the audit trail, like the buttons. Clicking End a second time does nothing more.
* A Paused or Ended plan no longer shows a next-visit date.
* Changed: an invoice past its due date now stays Overdue after a part payment, showing what is still owed, until it is paid in full. It no longer moves to Part paid, so it is listed under Overdue.

= 1.21.1 =
* "What's new" no longer opens by itself after an update. The dashboard has a button "What's new in <version>"; press it to read the notes.

= 1.21.0 =
* The TEG Companion and TEG Rover phone apps can show their screens in another language when your shop has the Pro edition and a language pack. This needs the next update of the apps; until then nothing changes.
* An estimate or invoice opened on the phone always shows exactly what your customer gets, in the shop language.
* The line a finished visit puts on an invoice is always written in the shop language, whoever marks it done.
* Help Center and menu refresh.

= 1.20.0 =
* New: a Language screen in Settings. Pick the language the shop works in; with Same as WordPress it follows your site.
* Each staff member can choose their own language for the screens they work in (Users > Profile > My language in the shop).
* The shop has a language of its own for everything customers receive - estimates, invoices, notices, e-mails and texts - so what a customer gets no longer depends on who clicked the button.
* Application records (the notice and record of a spray application) print in the shop language too.
* Text messages sent by the stock templates now use the shop language, and a tax label you never changed shows in the shop language.
* Language packs (Spanish first) arrive later as downloads and need the Pro edition. With no pack installed, everything stays in English exactly as before.
* Help: a Language section in the manual and questions in the FAQ.

= 1.19.4 =
* New: Licenses & permits (TEG-LAWNCARE > Setup > Licenses & permits) - keep your licences, permits, insurance and equipment checks in one place, with reminders before they expire and a printable binder for inspectors. The presets are the pesticide business license, each commercial applicator's certification and each registered technician's registration, general liability insurance and the business license (BPOL), or anything else, with the number, who issued it, the dates and the scanned certificate. Renewing keeps the old one as history; each shows Current, Expiring (60 days), Expired or Missing.
* Sprayer calibration (optional, switch it on under Licenses & permits > Settings; the menu then reads Licenses & equipment): each sprayer with its calibrations and certificates; a reading out of tolerance flags it.
* Reminder e-mails 60, 30 and 7 days before anything expires or falls due and when overdue; a dashboard box while anything required is missing or expired; a one-click inspection binder (print, PDF or a ZIP of the scans) and a 7-day view link for an inspector.
* Scans are kept in a private folder (never the media library) with their hidden metadata removed, every view is logged, and the register and its scans are in every backup. Loading sample data never touches it, and deleting the plugin keeps it unless you choose otherwise. The presets are examples (Virginia first), not legal advice.
* Help: a Licenses & permits section in the manual and two new questions in the FAQ.

= 1.19.3 =
* TEG Companion reports can show older months too (this month, last month and up to 10 more; set how many in Companion).

= 1.19.2 =
* One-click setup: on first activation (and from Settings > Backup, Run setup again) a setup page saves your business details, makes the public pages with their shortcodes and a menu, makes any missing staff roles (Lawn crew, Lawn lead, Lawn office), and can load safe sample data that Finish removes again (unless you keep it). Help has a new First-time setup section.
* Gift Coupons (Sales & money): coupon codes that take money off an invoice before tax - money off, percent off, or on one service - with minimum spend, dates, use limits, campaigns, batches, a printable coupon and a campaign report; applied from the invoice screen and shown as "Discount" on the customer's invoice page. Pay by Zelle: a line with your Zelle address and the invoice number for the memo on every invoice that still owes money, on the customer's invoice page and in the invoice e-mail. Incoming payments: a Zelle payment that fits one invoice is recorded by itself (no receipt sent); anything else waits on Incoming payments for you to pick the invoice.
* Fixed: Skip on Visits now skips the visit (with a reason) and takes it off its route; it used to say "Visit skipped" and change nothing.
* Fixed: the rain button pushes the day you pick, not always today, and opens on the day the visits moved to.
* Fixed: the Dashboard's "has not been cut for N days" shows the real number of days (it always said 0).
* Fixed: "One off" plans make exactly one visit and end when it is done, and "A set number of visits a season" spreads the number you type (new Visits a season box) across your season; both used to repeat every week.
* Plans: End on every plan (its coming visits come out of the diary), Saturday and Sunday as plan days, and changing a plan's crew moves its coming visits too.
* Visits: Set crew on every visit (a visit with no crew is flagged in red, and today's are listed on the Dashboard), and Mark done from the office with the minutes and a note - it does what Finished here does, including the route stop.
* Edit and Remove for properties, crews, crew members, services, materials and equipment, and Remove for customers. Remove hides the record from lists and pick-lists and keeps its history (needs Delete records); removing a customer or property ends its plans.
* Materials: "Stock in, or a stock count" books a delivery or a count; Restricted-use can be set.
* Time clock: Clock in / Clock out on Crews and at the top of the crew route page, with hours this month per person, so Reports' paid hours are no longer always 0.
* Machines on a crew gain hours as that crew's visits are finished, so service-due warnings come by themselves.
* Customer e-mails, all OFF as shipped (nothing new e-mails a customer until you switch it on, Settings > Notifications): "Tell people it is done" now really sends "We have been today"; new "Tell people when rain moves them"; new "E-mail the re-entry time". The old "Tell people it is done" box, which never sent anything, is retired so a site that had it ticked does not start e-mailing on update.
* The "Happy to hear from us" box on the customer form now says what it covers. The day-before reminder still goes to every customer with an e-mail address (a service message).
* Website inquiries are kept under Customers > Website inquiries (Make a customer, or Delete), not only e-mailed.
* The customer's private account link is shown on the customer's screen.
* Estimate, invoice and account links (?e=, ?i=, ?c=) work without the shortcode on your home page: the plugin shows the page itself when the page the link lands on does not carry it.
* Crew notes written at "Finished here" are listed on the property's screen, newest first, and the office can add one.
* Applications: an override box for managers (recorded in the audit trail with the rules it broke), a "lawn sign was put up" box, and the screen returns to Applications after recording.
* Settings now do what they say: Document footer prints under estimates and invoices, Length of a crew day flags a route that runs longer, New customers are billed sets the Billing default, Track posted notices switches the re-entry time. Removed the boxes nothing used: Minimum charge for a visit (use each service's minimum), Late fee, Rows per page, Crews start at (each crew has its own), and the hidden logo setting.
* Editing a customer, property or service keeps any column its form does not show.
* The restore warning names this plugin's records instead of another product's, and the table-emptying sample loader can no longer be triggered from an admin link (Setup > Settings > Sample data, which adds and removes its own records, is unchanged).
* Updating adds the coupon, sale, Zelle and incoming-payment tables by themselves; every customer, plan, visit, invoice and setting stays exactly as it was.

= 1.19.1 =
* Payments: the currency symbol always matches the currency (a US shop never shows £).
* TEG Companion's payments list shows the date your region's way.

= 1.19.0 =
* Dates now follow your region: US shops see 03/14/2026 and 2:30 pm, UK shops 14/03/2026 and 14:30, EU shops their country's own way - on every screen, print, e-mail and in TEG Companion and TEG Rover. WordPress's own date setting no longer leaks in. Leave the date format blank to follow the region, or type your own; documents already issued keep the dates they were issued with.
* TEG Companion now learns the shop's date format when it connects, so the phone writes and reads dates the same way the shop does.
* TEG Companion: a visit is labelled "Visit 3 Oct 2025" in UK and EU shops ("Visit Oct 3, 2025" in the US).
* Off-site backups and "What's new": the backup panel's times follow your region too.

= 1.18.1 =
* Sample firm: two open invoices are paid earlier today - a check in the morning post and a card over the phone - so the day close and TEG Companion's Today show money on a fresh demo. No other sample payment is dated today.

= 1.18.0 =
* Invoices: add labor to an open invoice. "Add labor" on the invoice puts one labor line on it - hours at your hourly rate, shown as "2 hrs @ $60.00 /hr" - and works out the total and tax again; pressing it again adds hours to the same line. The visits on the invoice stay exactly as they were charged.
* Invoices: the invoice screen now shows its lines. The labor line can be changed or removed there; the visit lines cannot.
* Settings > Money and billing: new rows for the labor line - Labor line (Offered or Off), Hourly labor rate, labor below or above the visits, and Is labor taxable? (No = labor is never taxed). Set your hourly rate before you add labor: it starts at 0.
* The customer's invoice page shows each line as "1 x $45.00" or "2 hrs @ $60.00 /hr". TEG Companion shows the same lines and can add labor from the phone.

= 1.17.2 =
* Square Terminal: a payment cancelled from TEG Companion is only shown as cancelled once Square confirms it; unconfirmed cancels are retried automatically and a forgotten checkout is cancelled after 15 minutes.
* TEG Rover and TEG Companion: an update a phone sends late, after being out of signal, is recorded once with the time it really happened, and the job's timeline says "Recorded offline" when it waited.
* Device pairing works when only TEG Companion is switched on (before, it could refuse with "This shop does not hand out that kind of phone key").
* Online card payments: Square payment notices are no longer missed when the address in your Square dashboard was typed with or without www, and a PayPal payment is checked against the right bill before it is taken.

= 1.17.1 =
* New: Optimize order on Routes. It suggests a shorter order for a route from road drive times (OSRM, free and keyless, by default; or Mapbox with your own token). It shows the drive time and distance now and with the suggested order, side by side, and changes nothing until you press Accept this order or Keep the current order. An accepted order can be undone while nothing on the route has changed.
* Lock a planned stop to keep it where it is. Started and finished stops, stops with no map position and your depot (set it under Route optimization settings at the foot of Routes) never move. You can also always keep the first or last stop in place.
* If the road service does not answer, the order is worked out nearest-stop-first and the times are estimated from straight-line distance. The suggestion says so.
* Fixed: the old "Put it in a sensible order" button always said there were not enough stops and did nothing. It is replaced by Optimize order, and an old link to it now opens the suggestion.
* Stops with no latitude and longitude are looked up once (only the street address is sent) and the position is kept on the property. Answers are remembered.
* Updating adds one column to route stops (locked, off for every stop); every route, stop, visit and setting stays exactly as it was. DB 1.8.0 -> 1.9.0.
* Built against the shared route optimization module (WINDOCTOR feat/route-optimize, routing-core 1.0.0, not yet merged there).

= 1.17.0 =
* New: automatic texts (TEG's shared texting module, through your own Vonage account). Four messages, each OFF until you tick it under TEG-LAWNCARE > Text messages > Settings, each with its own wording: the visit reminder the day before (sent once per visit by the hourly run), "On my way" when the crew taps On the way in TEG Rover (or from TEG Companion), and the estimate and invoice links when the office presses Send (the invoice text carries the Pay online link when online payments are set up).
* Texts go only to customers who may be texted: a new "May be texted" box on the customer, kept in step with the customer's own replies (STOP unticks it, START ticks it again). Nothing is sent in quiet hours (21:00-08:00 by default; a text written then waits). Every text in and out is in the Text messages log. Texting starts switched off and in test mode, so updating sends nothing.
* No overdue reminders and no review requests are ever texted.
* Updating adds the "May be texted" column to customers and two tables (the text log and the consent list); every customer, visit, invoice and setting stays exactly as it was. DB 1.7.0 -> 1.8.0.
* Built against the shared texting module 1.1.0 (WINDOCTOR feat/auto-texts).

= 1.16.1 =
* Fixed: TEG Back Office's staff list now also offers everyone else who can open the back office (the office) and every administrator, as well as your crew members and the people with a Lawn role - the same rule as every TEG shop. Each person is listed once, your crews first. Hours are worked out exactly as before.

= 1.16.0 =
* New: TEG Back Office reads your crews for payroll. Its staff list is your crew members who have a login (the WordPress user ID on the Crews screen) and the people with the Lawn crew, Lawn lead or Lawn office role, instead of everyone who can open the back office; their paid hours come from the crew time clock, day by day. See Crews in TEG Back Office in the manual.
* Payments, TEG Companion and TEG Rover brought up to date: Settings > Payments has "Also recorded by hand" for a bank transfer a customer sends you (never offered online), Report cards dates follow your date format, the Device pairing page masks the addresses it shows, and the Help Center is the newest one.
* Every crew, visit, invoice, payment and setting stays exactly as it was.

= 1.15.15 =
* Sample data: the demo firm now has its money - invoices back to January of last year, monthly customers billed on the 1st and per-visit customers on the day, most paid, some part paid, a few overdue, with their payments - so Invoiced, Owed, the aging tiles, the sales cards (this month, last month, this year and last) and the Companion's documents have figures. Visits run from January of last year, the North crew works its other rounds on the other weekdays (so this month's earlier days are done), and the rained-off Tuesday's visits were done the next day. Invoice numbers follow the year they were issued in. The one-click sample has last season too.
* Reports: "By crew" lists every crew with finished visits in the dates (a crew made inactive since included), and the "guessed from wages alone" footnote only appears when a crew has no hourly cost set. Reports, the billing run and the export default to the firm's own month (they took the server's, a day out on the last evening of a month).
* US spelling in the sample and the errand presets ("program", "center", "checks"); Settings says "ZIP code".

= 1.15.14 =
* Estimates: "Quotes won" counts an estimate in the month it was accepted or declined (one written last month and accepted this month was counted nowhere). A line priced from the list shows the price each (six yards of mulch at $95.00, not $570.00 a yard), a job-by-job line cannot be sent at $0.00, and an accepted estimate with no recurring line says that no plan was made. Plans made from an estimate are named like the others.
* Reports: the crew time on routes is counted per person, like the time clock, so the yard time is the real gap; with nothing on the clock the screen says so instead of "0 hours paid". Early in a month, "Properties that do not pay" lists every lawn visited and says to widen the dates.
* Dashboard: the Today table's "Per crew hour" is the same figure as Routes (it always showed a dash).
* Words, not keys: invoice, estimate, visit, stop and plan statuses ("Part paid"); rates and units ("1.2 fl oz per 1,000 sq ft"); no "0.0000" rate; "1 stop", "1 hour" and other singulars.
* TEG Companion: a visit's "Minutes on site" is blank until there is a time.
* Sample data: dates follow the firm's own day; this month always has spray records; varied weather and stock; a mulch rate; invented EPA numbers that say so (DEMO-/SAMPLE-); one e-mail domain and one name separator; a time clock that follows the rounds; crew costs that leave the tight round in profit; crew notes dated on their visit; an accepted estimate that became a plan; no crew arriving before the round starts and no payment dated today.

= 1.15.13 =
* Licence check knows the new TEG Total Auction Management (TAM) product.

= 1.15.12 =
* Back Office shows as Back Office in Setup; the pairing page is called Device pairing everywhere.
* Help has a new "Set up your shop" chapter: a step-by-step checklist from installing the plugin to going live, plus a few setup questions in the FAQ.

= 1.15.11 =
* Field work now sits after Sales & money in the menu, like the other TEG shops.
* The admin menu is grouped the same way as the other TEG shops: Help is now "Help & Tutorials", the phone pairing page is "Device pairing", and Settings is the last row of Setup.

= 1.15.9 =
* In the Companion app, Zelle, Venmo and PayPal payments wait for the office to confirm them; a manager can apply them at once.
* Invoices can show pay-by-QR codes (Venmo, Cash App, Zelle) under Ways to pay - Settings > Payments.

= 1.15.8 =
* The sample data now fills this week's routes straight away.

= 1.15.7 =
* The licence check and the updater now share one tested core: a slow licence server can no longer slow the shop down.

= 1.15.6 =
* The sample customer is now James Rockford.

= 1.15.5 =
* Money in another currency is always written with its own symbol.
* Product names in the licence screen use the new spelling (TEG-DELI, TEG-FOODTRUCK, TEG-BUTCHER, TEG-BAKERY).
* Take payment from TEG Companion charges in the invoice's own currency and refuses a card in a different currency before anything is charged.

= 1.15.4 =
* Money in another currency is written with its own symbol on the TEG Rover cards.

= 1.15.3 =
* Customer links (invoices, quotes, bookings and the like) only open with their exact key; a link with a blank or altered key opens nothing.

= 1.15.2 =
* TEG Rover collects on an invoice in the currency it was issued in, and its cards count one currency at a time.
* Taking a payment on an older invoice no longer works its tax out again at today's rate: the invoice keeps the total it was issued with.

= 1.15.1 =
* Totals and reports now count one currency at a time: after a region switch, money in the old currency is listed apart instead of being added in. The TEG Companion app shows every invoice in the currency it was issued in.

= 1.15.0 =
* A note on a property now remembers the person who wrote it, not only their crew. In Customer notes it shows their name, with the crew in brackets when they have one (for example "Ana (North crew)"). Notes written by the office on the computer now show the office person's name, without the Crew mark; before, they showed no name at all. The notes on a visit in the Companion app (the Job screen) show the writer the same way.
* Notes written before this update look exactly as they did: the crew's name, or no name.
* The update adds one column to the property notes table by itself the first time the site loads. Nothing is deleted or changed.

= 1.14.0 =
* Every customer now has one Customer notes box, on the desktop and in the Companion app: the general notes first, then the notes from their visits and properties, with who wrote each one and which came from a crew.
* New: each customer has their own screen. Click a name on the Customers list (or on the Properties list) to see their details, their properties, their Customer notes and an Edit form. Before, a customer could only be added, never opened or changed on the computer.
* The general notes are the customer's Alerts (in red) and Notes, and each property's Alerts, Notes for the crew and Getting in. Getting in stays on the computer only, as gate and access details always have.
* The notes from visits and properties are the crews' notes on the property (from the route, TEG Rover, the phone and sign-offs), the notes written when a visit is marked done and the reasons a visit was skipped. Each says which visit or property it came from. Before, property notes were never shown on the computer.
* "Add a note" in the box keeps a note on the customer. "Note for the crew" on the customer's screen puts a note on one property, which the crew sees on the route.
* In the Companion app a note can now be added on the customer or on an invoice; before, notes could only go on a visit. Notes on a visit still go on the property, as before. A phone note is never added to the customer's Notes field.
* The Add a customer form now has the Alerts field.
* Nothing to do when updating. Customer notes has one new table of its own, made by itself, and it is removed with the plugin's data when you choose to delete everything.

= 1.13.1 =
* Report cards on the phone now open the matching screen on the computer: sales cards open Reports, money owed, tax, payments and refunds open Invoices, the estimates card opens Estimates, busiest times opens Visits, today so far opens the Dashboard, the customer cards open Customers, and the materials cards open Materials.
* Card names fit a lawn care firm: the quotes card is now "Estimate to acceptance" ("Average time to accept", "Accepted this month"), follow-ups says "Estimates waiting over 7 days", the margin card says "Materials used", and the cash flow card says payment plans and deposits are not used here.
* Clearer date ranges on the cards: "October 1" for a single day and "Jan 5-10" for a few days, instead of "October 1-1" or "Jan 5 to Jan 10".
* TEG Companion and online payments brought up to date with the other TEG shops. Nothing to do when updating; no new tables.

= 1.13.0 =
* New: report cards on the phone. In the TEG Companion app's Reports tab each person picks the cards they want to see, set out in sections (sales and money, customers, materials, the crews' field work). Cards include this month against last month and last year, average invoice, tax collected, busiest days and hours, repeat customers, how long quotes take to be accepted, overdue invoices and quotes waiting, money taken by payment type, today so far, money due in the next 30 days, refunds, materials cost against sales, materials sitting unused on the shelf and how fast materials are used.
* New: Reports cards page on the computer (TEG-LAWNCARE > Sales & money > Reports cards). Every card on one page. Compare this month with last month, the same month last year or two dates of your own; set a monthly and a yearly sales goal and see how close you are; download any card as a CSV file or print the page (or save it as a PDF). The figures are the same as Reports > Invoiced, so the computer and the phone always agree.
* New: "Regulars to call" card - your regular customers (three or more visits done) who have had no visit for a while, with nothing booked and no plan still running, best customers first. A customer on a plan who is just on a winter break is not counted. Choose how long counts as "lost" under Settings > Money and billing > "Lost customers after" (30 to 730 days, 90 to start with).
* New: an optional monthly summary e-mail with the cards you choose, sent on the 1st for the month just ended. It stays off until an administrator saves it once on the Reports cards page.
* Busiest hours only count visits where the crew pressed Arrived on the phone, so a visit marked done later in the office does not give a wrong time.
* Turning the plugin off now also stops its scheduled e-mails.
* TEG Companion and TEG Rover brought up to date with the other TEG shops. Nothing to do when updating; no new tables.

= 1.12.1 =
* Fix: Import from CSV now follows the licence like the rest of the shop (it was usable while the plugin was paused).

= 1.12.0 =
* New: Import from CSV. Bring your customers, properties and services over from a spreadsheet or your old software. Upload the file, match its columns to the fields here (the matching is remembered for next time), then press Test run to see exactly what would be added or changed - nothing is saved until you say so. Every import can be undone in one click from the import history.
* New: errands in TEG Rover. Send someone on a supply-yard, fuel, parts or bank run with a checklist of what to get and a spending limit. They tick the items off on the phone and snap the receipt; the office confirms what was spent. Ready-made errand lists for lawn care are included, and places you use often are saved. Errands go to the phones paired under Rover phones; the office sees what was spent under TEG Rover > Errand spending.
* Sample data: Settings > Sample data now adds a full set of example customers, properties, plans, visits, crews, estimates and invoices alongside your own, and takes exactly those away again when you are done - your own records are never touched.
* TEG Companion and TEG Rover brought up to date with the other TEG shops.
* Updating adds the tables for errands and for the CSV importer; nothing you already have changes.
= 1.11.0 =
* New: E-mail test mode (Settings > E-mail test mode). Turn it on before going live and every e-mail the site sends - invoices, receipts, reminders, status notes, staff alerts - goes to one address you choose and to nobody else. The subject starts with [TEST to ...] so you can see who it was meant for; the message is exactly what the customer would get. Administrators can switch it from the TEG Companion app too (Settings > E-mail test mode), and a red notice shows on every admin page while it is on. Text messages are not e-mail and still go out.
* TEG Companion: shared Companion core 2.4.0.

= 1.10.1 =
* Square Terminal: on a bill that still owes money, staff can press "Send to Square Terminal" to take the card on the shop's paired Square Terminal; the payment is recorded once and a tip is noted, never billed. Pair the terminal under Settings > Payments.
* Card payments taken on a Clover or Elavon terminal can be recorded by hand (US shops, off until ticked in Settings > Payments). They count as card in the totals, and a whole card number typed into the note is refused.

= 1.10.0 =
* New: take payments online. Each invoice that is owed - per visit, or one the monthly run raised - gets a Pay online button on the customer's invoice page and a "Pay online:" link in the invoice e-mail: card through Square or Stripe, or PayPal. Set it up under Settings > Money and billing (Help: Invoices > Taking payments online). Every gateway is OFF until you switch it on, so updating changes nothing a customer sees. Card details never reach your site; keys and secrets stay in Settings only, are never shown again and never go into a backup.
* New: take payment from TEG Companion. The office - or a crew lead given the Invoice permission - takes an invoice's balance (a visit, a contract's month) on the phone: the list of invoices that still owe, then the Square app on an Android phone (Tap to Pay or a Square Reader), a Square Terminal, or a Square pay link / QR code the customer pays (or gets by e-mail). A card payment is recorded only after this site has checked it with Square, once; a card payment Square cannot confirm yet waits as pending verification and is never counted as paid. Zelle, Venmo and PayPal recorded on the phone wait for the office's "Confirm received" (on the invoice). Cash and checks are recorded at once. Card money Square took for an invoice paid another way meanwhile is listed on the Invoices screen for a refund, never put on the invoice twice. Settings > Money > "Take payment in TEG Companion" (card on the phone is off until switched on; terminal device IDs). Updating adds one table (tlc_app_pay) and TEG Rover's new key-store columns; nothing existing changes. Built on WINDOCTOR's shared Take payment piece (the same code every TEG shop uses).
* Webhooks are signature-checked and booked once - a payment the gateway sends twice, or a replayed event, is recorded one time. A payment in another currency than the invoice's is not booked against it; staff get an alert.
* Refunds: each payment on an invoice has a refund box - a card / PayPal payment goes back through its gateway, a check or cash one is written back by hand. Never more than the payment took, a double click refunds once, a pending gateway refund is booked only when it confirms. The invoice and the customer's balance follow.
* New: Settings > Region - United States, United Kingdom or European Union in one tick (currency, money format, tax label and rate, payment methods); your own settings are kept, and an invoice keeps the region it was raised in. Amounts now show your currency symbol. A firm updating is in the United States, exactly as before.
* Payment methods follow the region: a US firm can also accept ACH and Cash App / Apple Pay / Google Pay; Zelle and Venmo are US-only; Bank transfer is a UK customer method (a US firm records ACH; a payment already recorded as Bank transfer keeps its name).
* Updating adds columns to the payments table (currency, the payment a refund belongs to, a reference, how it came in, the gateway's id for booking it once) and to invoices (the region stamp), and one small table (webhook events). Every payment already recorded is kept exactly as it was and counts as before; a reference typed before (kept with the payment) still shows as its reference.
* Getting paid online - safety: a card or PayPal payment that arrives for an invoice already paid another way, voided, or owing less than was paid (a customer finishing a Stripe checkout after the office took cash, say) is NOT put on the invoice. It is kept once as unapplied, the office gets an alert naming the gateway payment, and it is in the Payments CSV to refund or place by hand. A tip is never counted against an invoice.
* Help: a short "Getting paid online" page (connect Square, what the customer sees, what lands on the invoice).
* Payments stay off after updating: nothing is taken online or on the phone until you enter your own keys and switch a gateway on. A demo site never takes money.
* TEG Rover: the shared core is updated to 1.5.0 (no change to how Rover works here). DB 1.5.0.

= 1.9.0 =
* Invoice numbers and estimate references are locked unique; numbering steps past numbers already in use and a race loser retries with a new number.
* Estimate lines carry How often; an accepted recurring line becomes a plan at that frequency.
* Updates: an update whose manifest publishes no SHA-256 checksum is never offered or installed. DB 1.4.3.

= 1.8.0 =
* TEG Companion: the store chooses what the phone's home screen shows (owner 2026-10-28: too cluttered). The TEG Rover pairing page (where Companion phones are paired) has a new section, **Companion home screen defaults**: one checkbox per button, card, list and bottom-bar tab the app's home has at this shop (Buttons / Cards / Lists / Bottom bar) and "Reset to starter set". Ticked = shown by default; each person can still change it on their own phone. app/hello's module rows carry `home` {v: 1, items: [{id, label, group, on}]} - only what that person can see. Never saved = the starter set: every button the app has here on (four or fewer: New <job>, New <customer> and the shop's own extras), every list and tab on. Shared Companion core 2.1.0 (generated; tools/test-companion-home.php).

= 1.7.3 =
* Licences for the new shops: TEG-EVENTCENTER, TEG-LASTDJ and TEG-FARM are known to the licence code, in lockstep with the rest of the family. A bundle licence that includes them is read correctly and names them on the License screen; nothing else changes.

= 1.7.2 =
* Get my license: Settings > License - enter the order number and e-mail to install your license; Check license; Release this website.

= 1.7.1 =
* TEG Rover phones load their board faster. The crew's job board (the open calls and their own) is now answered by a lightweight endpoint that skips loading every other plugin and the theme, so it comes back in a fraction of the time on a busy site. It is the same signed request, checked by the very same code, and the answer is identical; only that read goes there - claiming, status changes, check-ins, photos and completions still take the normal route. If the fast endpoint cannot answer (blocked by a security plugin, the license needs checking, anything unexpected) the phone quietly uses the normal route instead. On by default; Settings > The firm > "Fast phone reads" turns it off. If you run BulletProof Security or a similar plugin that blocks direct access to plugin files, allow wp-content/plugins/teg-lawncare/fast/rover-pair.php or turn the option off.
* Lists stay quick on large sites: the invoice, estimate, visit-history, application-record and TEG Rover board lists get matching database indexes. They are checked (and any missing one re-created) on activation, on admin visits at most every ten minutes, and hourly - not as a one-off upgrade step that could silently fail on a big table.

= 1.7.0 =
* Companion phone app: pair TEG Companion from Field work > Rover phones (QR or code) and work customers and properties, visits (done or skipped by the website's own rules), notes, photos, signatures, estimates, invoices and payments taken from your phone; the phone can do only what its person can do here.
* Help Center: full manual, searchable FAQ, ? on every screen. TEG-LAWNCARE > Help (the last item of the menu) has a Getting started tutorial, a section for every screen and every Settings tab (what it is for, step by step, tips, "If it doesn't work") and a searchable FAQ; the round ? Help button in the top right of every screen opens the section for that screen.
* Scheduled off-site backups (Settings > Backup): a backup every night at the time you set (default 02:30), kept in the private backup folder like any other and restorable the same way, and copied off-site if you choose - SFTP, FTP / FTPS, Amazon S3 / Wasabi / S3-compatible, or Dropbox. Keeps the last 14 plus one a week for 8 weeks, here and off-site; backups taken by hand and the safety copy before a restore are never pruned. Passwords and keys are stored encrypted and never shown again. Test connection, Run backup now, a status table, and a notice to administrators when the last scheduled backup failed or the last good one is more than 48 hours old.
* What's new: after an update the first admin screen an administrator opens lists every release since the one they last saw (administrators only), with "Don't show again until the next update".

= 1.6.0 =
* The admin menu is grouped: Dashboard first, then OFFICE (customers, estimates, plans, properties), FIELD WORK (applications, crews, routes, visits, Rover phones, TEG Rover), MATERIALS & GEAR (equipment, materials), SALES & MONEY (invoices, price list, reports) and SETUP (settings), alphabetical within each group. The group headings are bold capitals in the open menu, the hover fly-out, the collapsed menu and on a phone; a heading only shows when you can open something under it. Every page keeps its address. (This release also carries the shared Rover module 1.2.0 already merged onto main - routes stay out of this shop.)

= 1.5.1 =
* Pairing QR codes now render for real (long) pairing codes. The QR on the Rover phones screen was missing for a real site's pairing code (about 230-260 characters; the QR encoder stopped at 213) - scanning works again, and pasting the code keeps working as before.

= 1.5.0 =
* TEG Rover: technicians' phones for house calls. The office side of the TEG Rover phone app: calls for your crew members' phones - scheduled visits, estimate visits and one-off jobs - with a priority, a time window, the checklist for the service and what must be done before the job can be finished (photos, before and after photos, a signature). Assign a crew member or put a call on the open board for the first one to claim it; a claimed visit moves to that person's crew unless it is on another crew's route for the day.
* Finishing a scheduled visit on the phone marks it done like "Mark done" (the plan moves on, per-visit customers are invoiced); the crew's notes go on the visit and the property. An estimate visit becomes a draft estimate with one click.
* A live map of the crew members on shift and the calls, anyone's route for a day, who is closest to a call, and a "probably on site" hint.
* Pair a phone by QR code or pairing code (TEG-LAWNCARE > Rover phones); each phone has its own key you can revoke at any time - even while the license is paused. GPS positions are sent only while on shift, kept 30 days by default, and included in WordPress's personal data export and erase.
* Money taken at the door is recorded and waits for the office to confirm it, then goes on the visit's invoice.
* The live map uses OpenStreetMap out of the box. With a paid license, "Get a map token from TEG" (TEG Rover > Templates and settings) switches it to Mapbox with a token locked to your site - no Mapbox account needed - or paste your own Mapbox token.
* Nothing you already have changes: the update only adds new tables (and backups now include them). Phone keys are never restored from a backup, and loading the sample data keeps them: a restore can never bring back a phone you revoked.

= 1.4.2 =
* The license server moved to wildwebwizards.com (licenses, trials and site checks now go to https://wildwebwizards.com/cgi-bin/postlicense.py). Nothing changes for your license.

= 1.4.1 =
* The admin menu now reads TEG-LAWNCARE, like the other TEG shops.

= 1.4.0 =
* "What's new" after an update: the first time you open the shop after an update, a card shows what changed - once. After that a small "What's new" button on the dashboard opens the same notes again, any time.

= 1.3.2 =
* License checking: when the license server cannot be reached, the license panel now shows the real reason (a timeout, a certificate problem, or a proxy error page) instead of a generic message, and re-checks at most every 10 minutes instead of on every admin page. A license that is still waiting for its first check-in is now labeled "AWAITING VALIDATION" rather than "REVOKED". Entering a paid code checks it in with the license server right away and says how that went.

= 1.3.1 =
* American English throughout: every screen, e-mail, printout and help text now uses American spelling (labor, color, license, canceled, catalog, authorize and the rest). Nothing you have saved changes - settings, records and translations carry over as they are.

= 1.3.0 =
* Licenses are now tied to your site. When you enter a paid code it checks in with the license server once and binds to this site's address; after that it keeps working normally even if the server is unreachable. Your data is never locked away - everything stays readable at all times.
* A brand-new install (or a copy placed on a different web address) that has a paid code but has never checked in stays in read-only mode for the paid features until it can reach the license server once. The License tab says so and "Re-check now" completes it. Sites that were already licensed and running are carried over automatically on update - nothing to do.
* The trial is unchanged: it still works fully offline for 30 days from the first run.
* The value features now pause together when a license is not active: the website inquiry form and online estimate decisions, the business report export, and taking a new backup. Reading, printing and downloading your own data (including existing backups) are always allowed, and a crew member can still clock on and off at a property.
* The License tab shows this site's bound address and whether it is validated, and warns when a code is in use on more sites than it was sold for.

= 1.2.0 =
* Payment methods you accept: Settings > Money and billing lists Zelle, PayPal, Venmo, credit card, check and cash, each with a details line shown to the customer. Card, check and cash stay ticked on an upgrade, so nothing a customer sees changes until you opt in. Saving with nothing ticked keeps the previous list and says so.
* Ways to pay on every invoice: a new invoice offers everything you accept, and the new invoice screen (Invoices > Open) has a tick list to take a method away for one customer. The customer's invoice page and the invoice e-mail show the ways to pay with your details. A method you stop accepting stays on invoices already sent.
* Recording a payment keeps a note for the office, who recorded it and when, and lists them on the invoice screen. The customer sees "Payments received" (date, method, amount), never the note. "E-mail the customer a receipt" is unticked unless you tick it, and sends a plain receipt with what is left to pay.
* Old payments recorded as "cheque" keep showing as Check.
* Restoring a backup works again. Every backup's header was misread (the settings saved inside it confused the reader), so every restore was refused as "never finished"; the backups themselves were complete and restore normally now.

= 1.1.0 =
* The license now counts: once the 30-day trial has ended without a license, or if a license is revoked, adding and changing records pauses. Everything already recorded stays readable and can be exported, customers can still book and use their portal, and entering a license carries on where you left off. A banner on every screen says so before anybody fills in a form.
* The 30-day trial now ships inside the plugin, so it starts the first time the plugin runs with nothing to sign up for.

= 1.0.2 =
* A license that has been revoked (after a refund, for example) no longer receives updates, lifetime licenses included. If the license server cannot be reached, updates carry on as before.
* CSV imports and exports no longer write a deprecation warning to the debug log on PHP 8.4.

= 1.0.1 =
* Translations now load at the point WordPress 6.7 expects, which removes the "translation loading was triggered too early" notice that filled the debug log on every request.
* Updates now follow the license: a license buys every version published while it was valid. Lifetime installs anything, a current license installs anything, and an expired one keeps every version released before its expiry date. The plugin keeps working either way.

= 1.0.0 =
* First release: routes with drive time and revenue per crew hour, plans and visits that cope with rain, chemical application records, crews, properties, equipment, estimates, invoices, the crew, customer and visitor pages, and reports.
* Self-hosted updates through Dashboard > Updates with checksum verification, and backup and restore under Settings > Backup.
