=== TEG-HOMECARE — Home Care Delivery & Compliance ===
Contributors: theeldestgeek
Tags: home care, EVV, caregivers, care plans, compliance
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.23.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The back office for a home care organization: visits captured the way Electronic Visit Verification requires, at the point of care; a plan of care that services are checked against; supervisory visits counted down before they fall due; and caregiver files that refuse to schedule somebody whose background check, TB screening or training has lapsed.

== Description ==

A visit record is evidence, not a note. TEG-HOMECARE captures each visit from the home as it happens, never silently edits it afterwards, and keeps the unverified ones off the claims. It is built around the Virginia home care licensure rules (12VAC5-381) and the federal EVV mandate.

* **Electronic Visit Verification** - clock in and clock out from the home, with the six EVV data elements: service, client, date, location, caregiver, and start and end times. The location is taken from the phone's position; where it cannot be read the visit is still recorded and says how it was captured. EVV is required per service, so private-pay companion work is not flagged as a failure.
* **Corrections are new records** - a time or location is written once; a correction sits beside the original with who made it and why, and correcting a visit is its own permission.
* **Schedule that refuses** - a visit is not booked when the caregiver's credentials have lapsed, the work is outside their scope of practice, the plan of care does not authorize it, or they are double-booked. Each refusal names the reason.
* **Plans of care** - versions rather than edits, one active at a time, with a review date counted down on the dashboard. Each plan has its own screen listing the services it authorizes (how often, how long, the tasks): add, change or take a service off the plan in force, every change written in the audit trail. A list shows every client's plan and flags a plan with no services, since nothing can be booked against it.
* **Caregivers and credentials** - background check, abuse registry, TB screening, physical, license, CPR, training hours, competency and driving record, each with its own renewal date; a lapsed blocking credential stops scheduling and clocking in, and says which one and when. "Mark verified" records who checked the document and when. Caregivers can be edited, put on leave or marked as left (they can no longer be booked; their records stay).
* **Supervisory visits** - due dates computed from the last one that actually happened, and counted down before they fall due.
* **Incidents** - the reporting clock runs from when it happened, not when it was written up; reportable kinds arrive pre-ticked, and the hours left are shown.
* **Clinical and progress notes** - notes lock (by default at the end of the day they were written) and are added to afterwards only by an addendum.
* **Clients** - the payer decides which rules apply; alerts such as fall risk or oxygen in use appear on every screen that shows the client. Family, emergency contacts and power of attorney on a Contacts tab. Discharge (never a delete - future visits are canceled) and re-admission, with the earlier discharge kept in the audit trail.
* **Standing weekly schedules** - the same visit every week (client, caregiver, service, plan of care, days, time and length, from a date and perhaps to one) books itself a set number of weeks ahead, every hour, through the scheduler's own checks. A date it refuses is listed with the reason and tried again. Change one visit, or every visit from a date on; skip a date; agency holidays can be skipped. Visits already recorded are never touched.
* **EVV is a settings choice** (Settings > Visit verification, off on a new install - an agency with private-pay clients only never sees it). When on, each payer and client says where caregivers clock in: on TEG, on TEG with the visits sent to HHAeXchange, or on HHAeXchange - never both.
* **HHAeXchange** - the visit file in HHAeXchange's published import format (VISITS_<TaxID>_<timestamp>.csv, 96 columns), every visit checked first with a validation report of anything missing; and HHAeXchange's own visit export brought in, after a dry run with a mismatch report. Sending straight to HHAeXchange (SFTP or their API) needs HHAeXchange's third-party onboarding first - see Settings > Visit verification.
* **Clock in from the app** (a switch, off by default) - caregivers may clock in and out of their own visits from TEG Companion or TEG Rover, into the same visit clock as the website, with the phone's time and location.
* **Compliance screen** - credentials, plans, supervision, incidents and EVV on one page, sorted by severity, for opening before a survey.
* **Billing** - payers and claims built from visits; an unverified visit is left off a claim, and the claim run lists what it left behind and why. Units per service (for example 15 minutes).
* **How a claim line reads** - every claim line is care time (labor), priced by its service's own rate and unit. A service billed by the hour reads "3 hrs @ $24.00 /hr". A payer claim keeps its units, the way the payer is billed: "4 units @ $6.00 /15 min". A private-pay invoice reads in hours when its units come to whole quarter hours at an exact hourly rate ("1.5 hrs @ $26.00 /hr"), and in units otherwise. The amounts are the claim's own; only the wording is shared with the other TEG shops.
* **Labor settings** (Settings > Billing) - Labor line (Offered, the default, or Off), Hourly labor rate, Labor lines (below or above other lines) and Is labor taxable? (Yes or No). On a claim every line is labor, so the one that changes money is "Is labor taxable?": No means a claim carries no tax on care, whatever the tax rate. A claim keeps the tax it was built with. Claim lines come from verified visits and are never typed, so there is no "Add labor" button and no line editor on a claim; the hourly rate is not used to price a claim (each service has its own rate).
* **When the office records a visit** - for a caregiver who cannot clock in or out themselves, the office clocks them in and out from the Schedule and the visit, or marks a visit missed, always with a reason; an office-entered time says so, the reason sits in the visit's Corrections, and with EVV on the visit's check flags it as entered by the office (the same as a time typed in by hand) so a supervisor sees it.
* **Claim status** - mark a claim submitted (only then is it owed and can take a payment, on the website and in TEG Companion), denied with the reason, or void.
* **Office alerts** - a missed visit is e-mailed the moment it passes with nobody clocked in, a reportable incident immediately, and one morning list of everything falling due (credentials, plan reviews, supervisory visits). Family messages are opt-in and off by default. Everything sent is logged.
* **Caregiver page** - `[teg-homecare-visits]`, signed in, for a phone: today's visits in order with alerts, access notes, the tasks from the plan of care, and clock in and out.
* **TEG Rover (the caregivers' phone app)** - switched OFF until the agency turns on "Rover (drivers / field staff)" under Setup > Phones; then TEG-HOMECARE > Scheduling > Visits & deliveries (this screen was called TEG Rover before 1.23.0; the phone app is still TEG Rover). A caregiver's phone shows the visits the office sent: the client's name, the address, the visit window and the status - nothing more; they claim a visit from the board (two can never take the same one), get directions, mark arrival, tick the short checklist and finish. **TEG Rover is NOT an EVV system.** Unless the agency turns on "Caregivers may clock in and out from TEG Companion / Rover" it clocks nobody in or out and records no visit time, location or verification: EVV stays in this plugin's own visit clock and is the record of hours. The phone gets minimal detail only - the open board shows a first name and last initial, the caregiver the visit is assigned to gets the full name and the phone number; never the service, the plan of care's tasks, the office's notes, a diagnosis, allergy, alert, care note, payer detail or the access notes. A lapsed credential keeps a caregiver from being given a visit, as on the schedule. Each phone pairs by QR code or code under Setup > Phones and gets its own key, revocable, with no passwords; the data stays on your own site.
* **Family view** - `[teg-homecare-account]` by link, no login: who is coming and when, who came and for how long, how to reach the office, and the private-pay invoices still to pay with a Pay online button. Clinical notes, incidents and the plan of care are not shown. The link is shown only to staff on the client's record, is built on the family page, is not listed by search engines, and stops working when the client is discharged.
* **Agency page** - `[teg-homecare]`, with an inquiry form that tells the office and never creates a client record.
* **Reports** - missed visit rate, continuity of care and the other figures an agency is judged on.
* **Access** - a caregiver sees their own clients, not everybody's; a permission matrix per role. There are no public API routes.
* **Backup and restore** - under Settings > Backup, in a protected folder on your own server. Nightly backups (off until you switch them on) keep the last 14 plus one a week for 8 weeks, and can send a copy off the server - SFTP, FTP/FTPS, Amazon S3 / Wasabi / S3-compatible or Dropbox - with the passwords stored encrypted and never put in a backup.
* **One-click setup** - the first time the plugin is activated: the agency's name, e-mail and telephone, the public pages (agency page, family page, caregivers' page) and a menu, the staff roles (caregiver, nurse, scheduler, office), and optional safe sample data that is removed again when you finish. Run it again from Settings > Backup.
* **Pay by Zelle** - a line on every private-pay invoice that still owes money (on the claims list and the print) telling the client where to send Zelle and to put the invoice number in the memo; set up at the bottom of Billing > Payers. A claim to a payer never gets it. Incoming Zelle payments posted from the bank alerts are matched to the private-pay invoice and recorded by themselves when the match is certain, else they wait on Incoming payments. Nothing is e-mailed to anyone.
* **Getting paid** - every way a family can pay a private-pay invoice. In the office: card on the Square Terminal, card on your own machine, cash or check. Online: Pay online by card or PayPal (Square, Stripe or PayPal), a Square pay link (QR code, text or e-mail), a saved card charged when each invoice is sent, or Zelle, Venmo, PayPal, bank transfer or a wallet. On the phone: a pay link texted from TEG Companion. The family page lists the invoices to pay with Pay online, and "E-mail to the family" sends an invoice with every way to pay it. A claim billed to Medicaid, an MCO, a waiver, the VA or an insurer is never offered to the family: the payer pays by remittance.
* **What's new** - a button on the Dashboard shows the version; administrators press it to read the notes for every release since the one they last opened.

This software helps an organization keep the records the rules require and see when something is about to fall out of compliance. It is not a compliance certificate and cannot make anybody compliant; read the current 12VAC5-381 text and the DMAS EVV requirements that apply to your own payers.

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

= Companion app =

TEG Companion is the phone app for the office and the field: clients, visits, notes, photos, the client's signature, claims and invoices (each line reads the same as on the printed claim: "3 hrs @ $24.00 /hr" or "4 units @ $6.00 /15 min"; claims are read-only on the phone, there is no "Add labor"), payments taken and the day's takings. Take payment on a private-pay invoice offers the office's Square Terminal, a Square pay link (QR code, text or e-mail) and recording by hand in every method the agency takes; a card counts as paid only when Square confirms it, and Zelle, Venmo or PayPal recorded on the phone waits for the office to confirm it. It talks to this plugin as the person it was paired for. A caregiver sees only the clients they visit, and only their name and reference; medical, payer and alert details never reach the phone. A locked note is never edited - the phone adds an addendum beside it - and notes are staff only. EVV (clock in and out, location, verification) stays on the website's visit screens (TEG Rover is not an EVV system): the phone cannot create, time or complete a visit. Pair a phone under TEG-HOMECARE > Setup > Phones (TEG Rover and TEG Companion share one list of phones and one key store): a QR code; photos and signatures are kept in a private folder, never in the Media Library; nothing is ever e-mailed to a client by the app unless someone taps to send a pay link, and a payment taken from the phone sends no receipt.

= HHAeXchange (EVV aggregator) =

With EVV on (Settings > Visit verification), Scheduling > EVV exchange writes HHAeXchange's visit import file and reads HHAeXchange's visit export; both work today. **Sending straight to HHAeXchange needs HHAeXchange onboarding first:** register as a third-party (alternate) EVV system through HHAeXchange's 3rd Party Integration Support Desk for your state. They issue the SFTP or API credentials, your payer IDs (put them on each payer) and the EDI Code Table Guide with the visit-edit and missed-visit reason and action codes (put them in Settings > Visit verification). Until then, download the file and upload it where HHAeXchange tells you. TEG does not store caregivers' Social Security numbers: set each caregiver up in HHAeXchange once, under the same caregiver code as their employee reference here.

= License =

TEG-HOMECARE 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.

== Installation ==

1. Plugins > Add New > Upload Plugin, choose the zip, and activate. The tables are created and the trial is already running.
2. Home care > Settings: the agency's details, visit verification, plans and supervision, credentials and scheduling, billing, and Access.
3. Add services (with EVV required where it applies), caregivers and their credentials, and clients with their plans of care.
4. Put `[teg-homecare-visits]` on a page for caregivers, `[teg-homecare-account]` on another for families, and `[teg-homecare]` on the agency's public page (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.23.0 =
* New: Send with Rover on the Schedule. A booked visit that has no visit record yet gets a "Send with Rover" button for a care visit or an assessment visit, for people who may schedule, while TEG Rover is on. It makes a draft call with the client, address and time; your schedule is not changed. Pressing it again opens the call that is already there.
* On the phone these are visits. There are two new reasons a visit could not be done: the client was away from home, and it was not safe to enter the home.
* The screen that was called "TEG Rover" in the menu is now called "Visits & deliveries" (the phone app is still TEG Rover).
* TEG Rover stays off until you turn it on, as before, and it is still not EVV. Caregivers need the current TEG Rover app.

= 1.22.3 =
* The family page shortcode is renamed: [teg-homecare-family] is now [teg-homecare-account]. The old name stops working, so put the new one on your family page (the one-click setup page already uses it).

= 1.22.2 =
* 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 confirmed payment's note now starts with [TEG Companion #number].
* A customer import that stopped half-way no longer blocks Undo for ever, and two Undo clicks at once can no longer clash.

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

= 1.22.0 =
* The TEG Companion and TEG Rover phone apps can show their screens in another language when your agency has the Pro edition and a language pack. This needs the next update of the apps; until then nothing changes.
* A claim or invoice opened on the phone always shows exactly what the client or family gets, in the agency language.
* Help Center and menu refresh.

= 1.21.0 =
* New: a Language screen under Home care > Settings > Language. Pick the agency's language there.
* Each person - office staff and caregivers - can choose their own language for the screens, under Users > Profile > My language in the shop.
* The agency has a language of its own for everything clients and families get: invoices follow the agency language, and so do the invoice e-mail to the family, the family page, the pay and saved-card pages, receipts and the public page with its inquiry form. What a family gets no longer depends on who clicked.
* The office e-mails (missed visit, reportable incident, the morning list) and the staff role names made by the one-click setup use the agency language too.
* Language packs (Spanish first) arrive later and need the Pro edition. With no pack installed, everything stays in English exactly as before.
* The claim export and the HHAeXchange visit file keep their fixed English column names, whatever the language.
* Help: a new "The Language tab" section in the manual and two new questions and answers.
* Shared parts brought up to date: payments 1.5.0, app payments 1.3.0.

= 1.20.2 =
* TEG Companion reports can show older months too (this month, last month and up to 10 more; set how many in Companion).
* Shared parts brought up to date: TEG Companion core 2.16.0.

= 1.20.1 =
* Payments: the currency symbol always matches the currency (a US shop never shows £).
* App payments list shows the date your region's way.
* Shared parts brought up to date: payments 1.4.0, app payments 1.2.2.

= 1.20.0 =
* Dates now follow your region: a US agency sees 12/24/2026 and 7:00 am, a UK one 24/12/2026 and 07:00, an EU one its country's own - on every screen, print, e-mail and in TEG Companion. Leave the date format blank on Settings > Billing to use the region's, or type your own. WordPress's own date setting no longer shows through; claims already built keep their dates.
* TEG Companion is told the agency's date format, so the app writes dates the same way as the website.
* The caregiver's "too early to clock in" message gives the time in your region's format.
* The same region dates on the TEG Rover dispatch and route screens, the Scheduled backups panel, the Zelle and incoming-payment lists and the Customer notes panel.
* Help: a heading in the help can now be linked to directly.

= 1.19.1 =
* Visits: a visit under way (clocked in, not yet out) is now called "In progress" instead of "Open", on the website and in TEG Companion - the app's Visits tab showed two "Open" chips.
* Companion: the Visits tab's Open list now shows the sample agency's visits under way: the phone moves today's sample visits on to the time it is before showing them, as the website's pages do.
* Sample agency: one visit is always under way when the sample is made (a four-hour shift that began a few minutes before), so the Visits list is not empty after the nightly demo reset.

= 1.19.0 =
* New: Take payment in TEG Companion. On a private-pay invoice the app now offers the office's Square Terminal and a Square pay link (a QR code to scan, or a link sent by text or e-mail), next to recording a payment by hand. A card payment counts as paid only when Square confirms it - the app checks, and the website checks again every 15 minutes. Type the Terminal's device ID on Settings > Billing under "Take payment in TEG Companion".
* New: Zelle, Venmo and PayPal recorded on a phone wait under the claim's Payments ("Payments started in TEG Companion") until someone in the office clicks Confirm received. Card money Square took for an invoice that no longer owed it is listed at the top of the Claims tab, never put on the invoice twice.
* New: saved cards. With "Charge saved cards" on (Settings > Billing, needs Square or Stripe), the family saves a card on a secure page and each private-pay invoice is charged to it when you mark it submitted. "Saved card" on the client's Overview sends them the link; "Charge ... now" under the claim charges at once.
* New: "E-mail to the family" under a private-pay claim that is submitted and still owes. It sends the invoice to the client's e-mail with the amount due, the Pay online link, every way to pay, the Zelle line and the office phone. Only when you click.
* New: the family page shows "Invoices to pay" - each private-pay invoice that still owes, with a Pay online button and the ways to pay. A claim to a payer is never shown.
* New: the claim's Payments shows the family's online pay link, ready to copy or text.
* Changed: a claim billed to a payer of kind "Private pay" now counts as the family's to pay everywhere (Pay online, the print, the Zelle line), the same as a claim with no payer.
* Changed: TEG Companion's list of payment methods is every method the website's Record a payment offers (all the methods your region has, the card terminals and by-hand methods you ticked, and the payer's remittance). On a claim billed to Medicaid, an MCO, the VA or an insurer the phone records only the payer's remittance; on a private-pay invoice never the remittance.
* Fixed: a card terminal (Clover, Elavon) or a by-hand wire ticked on Settings > Billing is accepted when a claim's paid amount is changed from its status form.
* The help manual has a new "Getting paid" section listing every way a family can pay, in the office, online and on the phone, and the questions-and-answers cover every change. One new table (thh_app_pay) is made by itself; nothing already recorded changes.

= 1.18.0 =
* Changed: a visit the office clocked in or out for a caregiver ("Clock in for them" / "Clock out for them") is now flagged on Visit verification as "entered by the office", the same as a time typed in by hand, so a supervisor sees it. The reason stays in the visit's Corrections.
* New: nightly backups. Settings > Backup has Scheduled backups: switch on "Back up every night", choose the time and how many to keep (the last 14 plus one a week for 8 weeks by default). A nightly backup is an ordinary backup you can download or restore; backups taken by hand are never deleted by the schedule.
* New: an off-site copy of the nightly backup - to an SFTP or FTP/FTPS server, Amazon S3 / Wasabi / S3-compatible storage, or Dropbox - with Test connection. Passwords and keys are stored encrypted, never shown again and never put in a backup file. A notice tells administrators if the nightly backup failed or has not run for two days; nothing is e-mailed.
* New: one-click setup the first time the plugin is activated - the agency's details, the agency, family and caregivers' pages with a menu, the four staff roles, and optional safe sample data that is removed again when you click Finish. "Run setup again" is on Settings > Backup.
* New: Pay by Zelle on private-pay invoices. Type your Zelle e-mail or phone at the bottom of Billing > Payers, and every private-pay invoice that still owes money shows "To pay by Zelle: send ... and put the invoice number in the memo" under the claim and on the print. Claims to Medicaid, an MCO, a waiver, the VA or an insurer never show it.
* New: Incoming payments (Sales & money). When the bank's Zelle alert is passed on to the site by TEGANSWER, a payment that fits one private-pay invoice for certain is recorded on it by itself, with no receipt sent; anything else waits for you to pick the invoice or ignore it.
* Changed: the "What's new" note after an update now shows only to administrators, on the first admin page they open, and lists every release since the one they last saw. "Don't show again until the next update" closes it.
* 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 visit'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 invoice before it is taken.
* The help manual and questions-and-answers cover every change. The new tables (incoming payments) are made by themselves; nothing already recorded changes.

= 1.17.0 =
* New: services on a plan of care. Open a plan (Plans of care, or "Open the plan" on the client) and add the services it authorizes - how many visits, how often, how long, and the tasks for the caregiver - or change one, or take one off. Before this a new agency's plans had no services, and with "Only deliver what the plan authorizes" on (the default) every booking was refused. Plans of care also lists every client's plan and shows in red a plan with no services. Only the plan in force can be changed; each change is written in the audit trail, and older versions stay exactly as they were.
* Fixed: "Mark reviewed" on Plans of care now records the review (it said "No such plan").
* New: Change status on a claim - Mark submitted, Mark denied (with the reason), Void it. A claim must be marked submitted before a payment can be taken on it here or in TEG Companion; a draft is not owed yet.
* New: Edit on Caregivers and on Services. A caregiver can be put on leave or marked as left (with the date) - they can no longer be booked and their records stay. A service can be retired; a new rate applies to claims built from then on.
* New: Discharge and Re-admit tabs on a client, and a Discharged list. Discharging cancels the visits booked after now; re-admitting keeps the earlier discharge in the audit trail.
* New: a Contacts tab on a client - family, emergency contacts and power of attorney, added, changed or removed. The emergency contact shows on the Overview.
* New: Mark verified on Credentials records who checked the document and when.
* New: the office can clock a caregiver in (Schedule, "Clock in for them") and out (on the visit), or mark a visit missed, always with a reason. An office-entered time shows as "Entered by the office" and the reason is written in the visit's Corrections.
* Fixed: saving a client's Edit form no longer clears their DNR flag or admission date or makes a discharged client active again. The form now has E-mail, Physician telephone, DNR, Advance directive and Admitted on.
* Fixed: the client's Family link is built on your family page (the one with [teg-homecare-account]) instead of the home page, is shown only to staff, and is switched off while the client is discharged. The family page tells search engines not to list it.
* Changed: the report card row reads "Clients not back in 90+ days" (was "Regulars ..."), matching the "Clients to call" card.
* The help manual and questions-and-answers cover every new screen. No database change.

= 1.16.1 =
* New: a help manual and questions-and-answers inside the plugin. Home Care > Help & Tutorials has a step-by-step manual for every screen and a searchable list of common questions, and the "?" at the top of every Home Care screen opens the manual at that screen's section.

= 1.16.0 =
* Claim lines now read the same way as every TEG shop's invoice. A service billed by the hour reads "3 hrs @ $24.00 /hr". A payer claim keeps its units, as the payer is billed: "4 units @ $6.00 /15 min". A private-pay invoice reads in hours when its units come to whole quarter hours at an exact hourly rate ("1.5 hrs @ $26.00 /hr"), otherwise in units. The printed claim shows Date, Service (with its codes), Quantity and Amount, and TEG Companion shows the same words.
* New on Settings > Billing: Labor line (Offered / Off), Hourly labor rate, Labor lines (below / above other lines) and Is labor taxable? (Yes / No). They replace the old "Is labor taxable?" row, and your saved choice carries over. Every claim line is care (labor), so "Is labor taxable? No" still means a claim carries no tax on care. A claim already built keeps its tax.
* Claims stay read-only: their lines come from verified visits, so there is no "Add labor" and no line editor. Each service keeps its own rate; the hourly labor rate does not price a claim. No urgent or emergency rates.
* TEG Companion shows a claim's lines with the same wording as the print; claims stay read-only on the phone.
* Built on the shared invoice core 1.1.0. No database change: every claim, its amounts, its tax and its CSV export stay exactly as they were.

= 1.15.0 =
* New: standing weekly schedules (Scheduling > Standing schedules). Set a client's regular visit once - caregiver, service, plan of care, days of the week, start time, length, from and to dates - and it books itself the set number of weeks ahead (Settings > Credentials and scheduling), checked every hour, never twice. Each date goes through the same checks as a booking made by hand; a date that is refused is listed with the reason and booked by itself once the reason is put right. Change one visit only, or this and following; skip a date and put it back; agency holidays (a new setting) can be skipped per standing schedule. Visits already recorded, and every booking made before, are left exactly as they are.
* New: EVV is now a setting - "This agency serves Medicaid or state-program clients (EVV)" under Settings > Visit verification. It is off on a new install, so a private-pay agency sees none of it. An agency already running keeps it on, with everything as before.
* New: with EVV on, each payer (Billing > Payers) and, where one differs, each client says where its caregivers clock in: on TEG; on TEG with the visits sent to HHAeXchange; or on HHAeXchange. A client clocked on HHAeXchange cannot be clocked in on TEG - one visit, one record.
* New: Scheduling > EVV exchange writes HHAeXchange's visit import file (VISITS_<TaxID>_<timestamp>.csv, its published 96-column format, times in your time zone) for the visits that go there. Every visit is checked first; one missing something HHAeXchange rejects for (member or caregiver ID, procedure code, times, location, edit or missed-visit codes) stays out of the file and is in the validation report with the reason.
* New: the same screen brings in HHAeXchange's own visit export for the clients clocked there. A dry run comes first and writes nothing; each row is matched by Medicaid number (then member ID), caregiver code and procedure code, and the mismatch report lists every row that does not match or was also clocked in on TEG. Imported visits keep the device times, GPS and call type; a visit changed in HHAeXchange afterwards comes in as a correction beside the original.
* Not yet: sending straight to HHAeXchange (an SFTP drop or their API) needs HHAeXchange's third-party onboarding - their credentials, your payer IDs and their EDI Code Table Guide. Until then, download the file and upload it where HHAeXchange says.
* New: "Caregivers may clock in and out from TEG Companion / Rover" (Settings > Credentials and scheduling, off by default). On, a caregiver's phone clocks in and out of their own booked visits into the same visit clock as the website, with the phone's time and location and every check of the website; a TEG Rover care visit clocks in on "arrived" and out on "completed". A resend never makes a second record. Off, nothing changes: the website only, and the app is told so.
* Every client, caregiver, visit, booking, claim and setting stays exactly as it was.

= 1.14.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 caregivers and the people with a Caregiver, Nurse, Scheduler or Office role - the same rule as every TEG shop. Each person is listed once, your caregivers first. Visit hours are worked out exactly as before.

= 1.14.0 =
* New: TEG Back Office reads your caregivers for payroll. Its staff list is your caregivers who have a login (the WordPress user ID on the Caregivers screen) and the people with the Caregiver, Nurse, Scheduler or Office role, instead of everyone who can open the back office. Their hours are the completed visits' clocked minutes, day by day - the same visits a timesheet is built from (a visit still in progress counts once it is clocked out).
* Payments brought up to date (shared payments 1.2.0): pay-by-QR codes for Zelle, Venmo or Cash App can be shown under Ways to pay on a bill, and Settings > Payments has "Also recorded by hand" for a bank transfer a payer sends you (never offered online).
* TEG Companion and TEG Rover brought up to date: Report cards dates follow your date format, and the Device pairing page masks the addresses it shows.
* Every client, caregiver, visit, claim and setting stays exactly as it was.

= 1.13.13 =
* One credential check at every clock-in - the office screen, the caregiver portal and the REST clock-in - and the portal no longer offers "I have arrived" to a caregiver who may not work. A visit clocked in by somebody who may not work today is shown as such on the dashboard and in TEG Companion, not as "in the home now".
* Visits still booked for a caregiver who may not work now count today's and the past week's (including one already clocked in), not only those from tomorrow.
* Compliance findings no longer repeat the person's name ("Tanya Whitfield: Tanya Whitfield: ...").
* The compliance register (Licenses & permits) opens for whoever may see the compliance screens; the menu and the page agree.
* A client's name is written one way everywhere: "Harold (Hal) Trask" (Plans of care and Supervision used the legal name, other screens the preferred one). Searching by the preferred name finds them.
* Notes show the caregiver who wrote them; the sample's notes are by the visit's caregiver, not by the site's administrator.
* TEG Companion shows draft (and denied or void) claims with nothing due; only submitted claims carry a balance, as "Owed by payers" counts them.
* Visit verification reasons are no longer cut off mid-sentence (the column is wider; reasons cut before are written again on update).
* The Compliance screen says which dates its verification counts cover and links to Verification on the same dates; Verification says which dates it shows.

= 1.13.12 =
* Clocking in is refused for a caregiver whose blocking credential has lapsed, as scheduling already was - including on a visit booked before it lapsed. Such bookings are flagged on the dashboard (REASSIGN) and the compliance screen.
* A professional license is required only of the licensed disciplines (nurses and therapists); aides are no longer listed as missing one.
* Credentials with no expiry show "No expiry" instead of 0 days.
* Owed by payers counts submitted claims only; drafts show apart as "Not yet submitted", on the dashboard and on Reports (Billed is labelled "submitted").
* Caregiver hours a week are worked out to today, not over the whole month.
* An open visit shows how long it has been running; a missed visit's verification reason says why it was missed.
* Sample data: a realistic agency - credentials mostly in date, the agency's license and insurance on the compliance register, nine weeks of visits through the scheduler's own checks, today's round, and claims paid, owed and in draft.

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

= 1.13.10 =
* Printed invoices no longer print web addresses: scan the QR code instead.

= 1.13.9 =
* Back Office shows as Back Office in Setup; the pairing page is called Device pairing everywhere.
* TEG Companion: the home screen no longer offers a "New customer" button the app could not show.

= 1.13.8 =
* The admin menu is grouped the same way as the other TEG shops: the phone pairing page is now "Device pairing" and Settings is the last row of Setup.

= 1.13.7 =
* The licence check and the updater now share one tested core: a slow licence server can no longer slow the shop down.
* The update check no longer waits on the update server: it reads a saved copy and refreshes it in the background twice a day.

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

= 1.13.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).

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

= 1.13.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.13.2 =
* TEG Rover collects on an invoice in the currency it was issued in, and its cards count one currency at a time.
* After a region switch, TEG Rover errands and amounts typed on a call are in the agency's new currency, not dollars.

= 1.13.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.13.0 =
* Every client now has one Client notes box, on the desktop and in the Companion app: the general notes first, then the notes from their visits and scheduled visits, with who wrote each one and which came from a caregiver. You find it on the client's Overview tab.
* The general notes are the client's "Please note" line (shown in red) and "Getting in", followed by the notes written on the client. Then come the notes from their visits: care notes, a caregiver's note on a task, and the scheduler's note on a booked visit, each saying which visit it came from.
* A locked note says it is locked, and an addendum says which note it adds to. Locking a note and adding an addendum stay on the Notes tab.
* "Add a note" in the box saves a progress note in the care record, the same as the Notes tab.
* The box, "Add a note" and "Remove" only work for a client on your case load, the same rule as the client screen. The office, who see every client, see every client's notes.
* In the Companion app, a client now shows their notes, with the "Please note" line at the top, and a visit shows its client's "Please note" and "Getting in" lines. A note written on a client in the app still goes into the care record.
* Deleting the plugin with data removal on also removes the Companion's customer notes table and its setting.

= 1.12.2 =
* The small print on the report cards now uses home care words too: "3 claims" instead of "3 sales" on the monthly billing and average claim cards, "of 5 scheduled" instead of "of 5 booked" on the missed visits card, and "claimed 1.0 of 2.0 hours" instead of "billed 1.0 of 2.0 h" on the caregiver utilization card. The monthly card's description now starts "Billed before tax" instead of "Sales before tax".
* The cash flow card no longer shows "Payment plans" and "Deposits" lines, because a home care agency has neither.
* Deleting the plugin with data removal on now removes all of its settings.

= 1.12.1 =
* Report cards on the phone now open the matching screen on the website: the billing and caregiver-hour cards open Reports, the money owed, cash flow, payments and refunds cards open Billing (claims), the client cards open Clients and "Today so far" opens Visits.
* Card names now fit home care: "Average claim", "Billed per caregiver hour", "Caregiver utilization", "Returning clients", "Clients to call", "Missed and cancelled visits" and "Best times by service". Inside the cards, "invoices" are now "claims" and "sales" now say "billed".
* The overdue claims card no longer shows a "Quotes waiting" line, because home care has no quotes.
* Clearer dates on the cards, such as "October 1" instead of "October 1-1" and "Jan 5-10, 2031" instead of "Jan 5, 2031 to Jan 10, 2031".
* A refund that is still waiting to go through is checked again after the plugin is turned off and back on.

= 1.12.0 =
* New: report cards on the TEG Companion phone app. Each person picks the cards they want to see, and the cards are sorted into sections (such as Every day, Money, Customers and Staff) so they are easy to find.
* New: a "Reports cards" page on the website, next to Reports. See every card on one page, compare with the last period, the same time last year or dates you choose, set goals, and download the figures as a CSV file or print them.
* New cards for home care: billed this month against last month, average claim, tax, busiest visit hours, repeat clients, overdue claims, payments by method, today so far, money due in the next 30 days, refunds and voided claims, clients who have not been back, missed and cancelled visits, caregiver hours, how much of each caregiver's time has been billed, and the busiest times for each service.
* New: a "Billed" figure on the Reports screen. It counts claims you have sent (submitted, part paid or paid) and leaves out drafts, denied and voided claims, so the cards and the Reports screen always agree.
* New: Settings > Billing > "Lost customers after N days" lets you choose when a regular client counts as not coming back (90 days to start with).
* New: an optional monthly summary e-mail of your report cards. It stays off until you set it up and save it.
* Turning the plugin off now also stops its scheduled e-mails.

= 1.11.0 =
* New: TEG Rover, the caregivers' phone app, now comes with the plugin. It stays switched off until you turn it on under Setup > Phones. Once on, the visits you send show on a caregiver's phone with only what they need: the client's name, address, visit time and the phone number of the assigned caregiver - never notes, care tasks or medical details. Rover is not an EVV system; clock in and out stays on the website. TEG Companion phones pair on the same Phones page, and phones you paired before keep working.
* New: errands. You can send a caregiver on a short run - a pharmacy pickup, a grocery run, a supplies run, the bank or the post office - with a list of what to get. Ready-made errand types are included, and what they spend is listed for the office.
* New: Import from CSV (Setup > Import from CSV). Bring your existing clients and client contacts in from a spreadsheet. The importer matches your columns to the right fields for you, lets you do a test run first to see exactly what would happen, and every import can be undone.
* Better sample data: Settings > Sample data adds a full set of example clients, caregivers, visits, claims and payments so you can try everything, and removes it again in one click without touching your own records.
* The Import from CSV page is now locked like the rest of the plugin when the licence is paused or not active.

= 1.10.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.9.3 =
* 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.9.2 =
* Payments now run on the TEG family's one shared payments engine: money that arrives for a document that no longer owes it is kept as unapplied money for the office to refund or move; a demo site never takes a payment; staff are alerted when a gateway payment is lost; a manual payment is capped at what is still owed; and each bill is locked while a payment is recorded, so two payments at the same moment cannot both land on it.
* Region: the region is inferred only from a currency the shop typed, never from the factory default currency it shipped with.

= 1.9.1 =
* Demo sites never take a real payment: on a demo (Demo mode, or the TEG SHOPS demo) the pay area says This is a demo - no payment is taken, every pay link and webhook is refused and nothing is recorded as paid.

= 1.9.0 =
* Claim references are locked unique (checked on activation and every upgrade; repeats are listed for the administrator).
* A claim with payments on it cannot be voided until they are refunded or moved.
* Clock-in is allowed from 2 hours before a booking starts until it ends (overnight shifts included).
* Services is hidden from caregivers.
* Payments: a manual payment cannot exceed what the document still owes; staff are alerted when a gateway payment arrives for a document that is gone.
* Updates: an update whose manifest publishes no SHA-256 checksum is never offered or installed. DB 1.7.2.

= 1.8.0 =
* TEG Companion: the store chooses what the phone's home screen shows (owner 2026-10-28: too cluttered). Phones (TEG Companion) 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 =
* Saving always says so: the "saved" notice now travels in the address the save returns to (signed for the logged-in user), so it shows even when another open screen, an auto-refreshing page or a non-persisting object cache would have swallowed the stored copy. It appears as a dismissible notice plus a toast (fades after 6 seconds; errors stay) and leaves the address bar. No database change.
* Compliance (a new page in the menu): a register of the licenses and permits the business and its staff hold - Home care organization license, Staff certification (CNA, RN, LPN ...), Criminal background check, General and professional liability insurance, Business license (BPOL), or anything else - with the number, who issued it, issue and expiry dates, bond and surety where one applies, and the scanned certificate. Renewing keeps the old one as history; each shows Current, Expiring (60 days), Expired or Missing.
* Reminders by e-mail 60, 30 and 7 days before anything expires or falls due, and when overdue; a dashboard box; a warning on the shop's pages while anything required is missing or expired. One click makes an inspection binder (print or save as PDF, or a ZIP with the certificates).
* Scans are kept in a private folder (never the media library) with their hidden metadata removed, and every view is logged. The register is in the backups. Deleting the plugin keeps the register unless you choose otherwise. The presets are examples (Virginia first), not legal advice.
* Settings > Billing: "Is labor taxable?" Yes/No. Every claim line is a care service (labor), so No means a claim carries no tax whatever the tax rate (Virginia: No - labor stated separately is not taxed). New installs default to Yes; an agency upgrading keeps exactly what it had (Yes, written down once). Changing the region never changes it.
* Each claim records the choice it was built under, so a claim built before you change it keeps its tax and prints exactly as it did.

= 1.7.0 =
* Companion phone app: pair TEG Companion from Setup > Phones (QR or code) to work visits, notes, photos, the client's signature, claims and payments from your phone. A caregiver sees only their own clients, by name and reference; a locked note takes an addendum, never an edit; EVV stays in TEG Rover and on the website.
* TEG Companion: the phone app can now run this agency - clients (a caregiver sees only their own case load, name and reference only), visits, notes (an addendum, never an edit, on a locked note), photos, the client's signature, claims and payments, the day's takings. Pair a phone under Setup > Phones (TEG Companion). EVV stays in TEG Rover and on the website.

= 1.6.0 =
* Region: choose United States, United Kingdom or European Union (and the EU country) under Settings > Region. Currency, number and date formats, the tax label, address wording and spelling follow it. Settings you typed yourself are kept.
* Claims keep the region, currency and agency details they were built with. Changing the region later never changes a claim already issued, and the new claim print shows the ways to pay and the terms wording.
* Payments on claims now go through one payments ledger. Each claim has a Payments box with its payments and refunds, a refund form on each payment and a form to record a payment. A payer's claim is paid by remittance; a private-pay client can pay online (Square, PayPal or Stripe, when you set one up) in the claim's own currency.
* Claims paid before this update are carried into the ledger once, dated on the day they were paid.
* Refunds are never more than was paid. A double click or two people refunding at once refunds only once, and a card refund the gateway has not confirmed yet shows as pending until it does. A void claim keeps its refund forms.
* Payment methods follow the region: Zelle and Venmo are US only, PayPal is everywhere. A payment already recorded with a method the region no longer offers still shows, exports and can be refunded.
* Backups no longer contain payment keys or webhook secrets. Older backups are cleaned before they are downloaded, and restoring a backup never replaces the keys you have saved now.
* "Owed by payers" shows each currency separately. A Payments CSV link is on the claims screen, and CSV exports always work, licensed or not.
* The Billing settings tab has payment terms days, claim prefix and rows per page back.

= 1.4.0 =
* Admin menu grouped by job with bold headings (SCHEDULING, CLIENTS & CARE, CAREGIVERS, COMPLIANCE, SALES & MONEY, SETUP), alphabetical within each group. The same bold capitals show 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.

= 1.3.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.3.1 =
* The admin menu now reads TEG-HOMECARE, like the other TEG shops.

= 1.3.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.2.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.2.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.2.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 public inquiry form, the business/claim/compliance exports, and taking a new backup. Reading, printing and downloading your own data (including existing backups), and caregivers' visit clock-in/out at the client's door, are always allowed.
* 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.1.1 =
* Restoring a backup works again. Every backup was being refused as "never finished" because its header could not be read; the header is now read correctly, so a backup taken on this site restores.

= 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: EVV visit capture with corrections kept beside the originals, a schedule that refuses lapsed or out-of-scope caregivers and unauthorized work, plans of care, credentials, supervisory visits, incidents, notes, the compliance screen, billing, the caregiver, family and agency pages, and reports.
* Self-hosted updates through Dashboard > Updates with checksum verification, and backup and restore under Settings > Backup.
