=== TEG-EVENTCENTER ===
Contributors: theeldestgeek
Tags: event venue, wedding venue, banquet hall, booking, contracts
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.11.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sales and bookings for an event venue: inquiries, ranked holds, proposals, an e-signed contract and the retainer at one link, payment schedules, room combinations that can never be double booked, BEOs, vendors and the client portal.

== Description ==

For wedding and banquet halls, conference and event spaces, community halls, and wineries or barns that rent space.

* Inquiry form with live availability, and a pipeline: new, contacted, proposal, booked, lost.
* Spaces with capacity by layout, setup and turnover buffers, and combinations (the Grand Hall = Hall East + Hall West) - a date is sold once, by a unique key in the database, never by a check that could race.
* Holds ranked 1st, 2nd, 3rd that lapse on their own; a lower hold challenges the 1st, who is told by e-mail and text and given a deadline.
* Packages and add-ons priced flat, per guest or per hour, with minimums; tax, service charge and gratuity as separate lines.
* Proposal, contract and retainer at one signed link with no login: ESIGN consent, the SHA-256 of the exact version signed, name, time and IP, a copy e-mailed to both sides.
* Payment schedule: retainer, installments by date or days before the event, final balance; pay-by-link by default; auto-pay with a saved card only with the client's stored-card consent (Pro).
* BEO on your letterhead: timeline, menu with allergens, headcount and tables, setup and AV, vendor arrivals with insurance status.
* Menus from TEG-RESTAURANT when it is installed (Pro), otherwise your own.
* Vendors: preferred, required, client's own, with the certificate-of-insurance expiry checked against the event date.
* Final headcount lock date, with the balance recalculated on every change.
* Security deposit as a card hold placed shortly before the event (Pro), or a refundable deposit.
* Site tours booked from your website. Website shortcodes: `[teg-eventcenter-contact]` (inquiry form), `[teg-eventcenter-account]` (client page) and `[teg-eventcenter-tour]` (tour booking); full list: help/manual.md, Shortcodes.
* Client portal, Google Calendar both ways, reports, the dispute evidence pack.
* No platform fee: payments go to your own Square, Stripe or PayPal account.
* Dates and times follow your region; leave the date format blank to use it, or type your own (Settings > Region).
* Language: run the plugin in English or Spanish (more languages can be added later, no new version needed). Pick the shop language under Settings > Language; each person on your team can pick their own on their profile. Everything your clients see - the proposal, contract, payment page, tour booking, e-mails and texts - is in the shop language.

== Frequently Asked Questions ==

= How do I change the language? =

Open Settings > Language. "Shop language" is the language your clients see: the proposal, the contract, the payment page, the tour booking, the saved-card page, the sign-in page, the BEO print, and every e-mail and text. Choose "Same as WordPress" to follow your site's language. Under "Languages on this site" you can see which languages are ready; press "Check for language updates" to look for new ones (they download in the background, and nothing is sent about you or your clients). A language that is not ready yet shows English until it arrives. Language packs need the Pro edition. Languages already on the site keep working.

= Can my coordinators and office team use a different language from the clients? =

Yes. Each person can choose "My language in the shop" on their own profile screen (Users > Profile). It changes only what that person sees on their own screens. Clients still get the shop language, whoever sent the message.

= Can the phone apps run in Spanish? =

Yes, once the next update of TEG Companion and TEG Rover is out, and when your shop has the Pro edition and a language pack. The apps then show their lists and screens in the language of the phone. Everything that is saved or sent - the sign-off note, receipts, e-mails and texts to your clients - stays in the shop language you chose under Settings > Language. Without the Pro edition the apps stay in English.

= Why is a page still in English? =

Only words that have been translated change. Until a language is complete, the rest stays in English. A language that covers less than half of the plugin is not switched on by itself because the site is in that language; choose it under Settings > Language if you want it anyway. Your own translation files (for example from Loco Translate) are used too and win over the downloaded ones.

== Changelog ==

= 1.11.0 =
* New button "Send with Rover: off-site job" on the event screen, under the status buttons. For a Signed or Booked event it makes a draft visit with the client and the event's number, title and date; add the address and the time, then send it to a coordinator's phone.
* One open job per event. When the coordinator finishes (done or not done), the event's log gets a line about it.
* The Rover screen in the menu is now called "Visits & deliveries" (the phone app is still TEG Rover).
* Rover stays off until you switch it on on the Phones page, as before.
* Coordinators need the current TEG Rover app on their phone.

= 1.10.2 =
* Website shortcodes renamed to the teg-eventcenter-... pattern (the old names are gone): [tev_inquiry] is now [teg-eventcenter-contact], [tev_portal] is now [teg-eventcenter-account], [tev_tour] is now [teg-eventcenter-tour]. Pages that hold an old tag need the new one.

= 1.10.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.10.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.
* The note saved when a client signs off an event on the phone is always written in the shop language, whoever's phone it was.
* Shared parts brought up to date: language 1.2.0, TEG Companion 2.18.1, TEG Rover 1.11.0 and the menu groups.

= 1.9.0 =
* New Language screen in Settings. Each staff member can pick their own language for the screens they use.
* The shop has a language of its own for what clients receive: the proposal, contract, payment page, tour booking, e-mails and texts. What a client gets no longer depends on who clicked the button.
* The BEO print is in the shop language.
* The venue roles (Venue manager, Event coordinator) are now named in the shop language when they are first created.
* Language packs (Spanish first) arrive later and need the Pro edition. With no pack installed, everything stays in English exactly as before.
* Shared parts brought up to date: language 1.1.0, payments 1.5.0.

= 1.8.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.8.1 =
* Event times follow your region (5:30 pm in the US, 17:30 in the UK): the dashboard, event screens, BEO print, contracts, the client page, vendor arrivals, tour booking times and TEG Companion.
* Payments: the currency symbol always matches the currency (a US shop never shows £).
* Shared parts brought up to date: events core 1.4.0, payments 1.4.0.

= 1.8.0 =
* Dates now follow your region: US shops see 11/09/2026, UK shops 09/11/2026, EU shops their country's own way - on every screen, print, e-mail, the client page and TEG Companion. Leave Settings > Region > Date format (and Time format) blank to use your region's, or type your own. Formats you saved before are kept.
* TEG Companion: the app is told your date format and order, so its dates match your screens.
* Tours: the tours list, the booking e-mails and the reminder show the tour's date and time in your region's format (they showed 2026-05-04 14:00); a planned security hold shows its date the same way.
* Shared parts brought up to date: region 1.2.0, events core 1.3.0, TEG Companion 2.15.0, TEG Rover 1.10.0, payments 1.3.0.

= 1.7.1 =
* TEG Companion: an event's Total and Balance show once, in the money section (they were listed twice, the second time in lower case).
* Calendar: the key under the grid now matches it - pink cell with a filled square = booked, hollow square = setup / turnover, grey with a cross = blocked, yellow H = holds (it said "Red: booked"). Events core 1.2.2.
* Sample data: the sample DJ vendor has an invented name (Copperline Sound & Lighting).

= 1.7.0 =
* TEG Back Office: lists the venue's staff (Venue managers, Event coordinators and the site administrators) and reads the sales tax rate from Event settings > Sales tax % (default 0, so existing events and totals are unchanged).
* Shared modules brought up to date: payments 1.2.0 (pay-by-QR codes under Ways to pay; a bank transfer can be recorded by hand), Companion 2.13.0 (report card dates follow your date format), Rover 1.8.0 (Device pairing masks IP addresses), site move and licence check.

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

= 1.6.11 =
* Back Office shows as Back Office in Setup; the pairing page is called Device pairing everywhere.

= 1.6.10 =
* 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.6.8 =
* Loading the sample data no longer tries to send e-mails.
* Sample payments are due on realistic dates instead of all today.

= 1.6.7 =
* 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.6.6 =
* Money in another currency is written with its own symbol on the TEG Rover cards.

= 1.6.5 =
* 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.6.4 =
* TEG Rover collects on an invoice in the currency it was issued in, and its cards count one currency at a time.

= 1.6.3 =
* The Event reports page now counts one currency at a time, like the rest of the shop.

= 1.6.2 =
* 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.6.1 =
* On an event, the client's name now opens the client's own page.

= 1.6.0 =
* New: 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 events, holds and tours, with who wrote each one and which came from your staff (an event coordinator).
* New: a Clients screen (under Sales). Click a client to see their details, Edit them, their events and their Client notes box. Add a note there, or in the app on the client or on one of their events. Client names on the Tours screen open it.
* New: the Companion app now shows notes. On a client: the client's Notes, then every note from their events (the event's staff notes, the BEO notes for the team, the sign-off note), holds and tours. On an event: the client's Notes on top and the event's own notes. Notes are for your staff only; clients never see them.
* Fixed: a staff note written on a new event, inquiry or tour is no longer copied into the client's Notes when the client is new. Notes already copied stay where they are.

= 1.5.2 =
* Improved: the report cards in the TEG Companion app now use your venue's words in the small print too. Booked revenue and the average now count events ("2 events" instead of "2 sales"), and the average card is called "Average per event". Repeat customers and where new customers come from now say clients. Booked ahead counts space days instead of slots, and occupancy talks about your spaces instead of rooms or halls. Proposal to booking now shows the average time to book and the proposals booked this month.
* Improved: rows that do not apply to a venue are left out. The money owed to clients card no longer shows a gift cards line while you have none, and the no-shows card no longer shows money lost, because a missed site tour costs you nothing.

= 1.5.1 =
* Improved: report cards in the TEG Companion app now open the matching desktop screen. Booked revenue, proposals, follow-ups, cash flow and money owed to clients open Event reports; how full your spaces are and the days booked ahead open the calendar; missed site tours open Tours; where new clients come from opens Inquiries; today so far opens the dashboard.
* Improved: the cards now use your venue's words. "Quote to approval" is now "Proposal to booking", follow-ups show overdue event payments and proposals waiting, cash flow shows final balances and installments due, "Owed to customers" is now "Owed to clients", and the no-shows card talks about site tours.
* Improved: clearer date ranges on the cards, for example "October 1" instead of "October 1-1" and "Jan 5-10" instead of "Jan 5 to Jan 10".
* Improved: turning the plugin off or deleting it now clears the monthly summary e-mail more thoroughly. Your figures and settings are still kept unless you chose to delete all data.

= 1.5.0 =
* New: report cards on the phone. Each person picks the cards they want to see in the TEG Companion app, and the cards are sorted into sections (bookings, money and more) so they are easy to find.
* New: a Reports cards page on the desktop (under Money). Compare any card with the last period, the same time last year or dates you choose, set goals and see how close you are, and download the figures as a spreadsheet (CSV) or print them.
* New cards for your venue: your proposal pipeline and win rate, booked revenue for this month and the next two, balances due and overdue, how full each space is this month, and the events cancelled this month with what was paid and kept. There are also cards for how busy each space is over the next week and month, deposits you are holding, how quickly proposals turn into bookings, where new clients heard about you, and missed site tours.
* New: "Lost customers after N days" setting (Settings > Venue rules). Choose after how many days without a booking a returning client counts as lost; the lost customers card follows it.
* New: an optional monthly summary e-mail with your key figures. It stays off until you set it up and save it.
* Fix: turning the plugin off now also stops its scheduled e-mails, such as the monthly summary. They start again when you turn it back on.

= 1.4.0 =
* New: TEG Rover for drivers and field staff is now included. It is switched off until you turn it on (Phones page > Rover). Once on, the office can send an off-site job - address, time, checklist and the client - to a coordinator's phone. The TEG Companion app pairs on the same Phones page; phones you paired before keep working without pairing again.
* New: errands. Send a staff member to the rental company, the flower wholesaler, the party store or the bank with a list of things to tick off, a spending limit and a photo of the receipt. Ready-made lists fill in the common runs, and the office confirms what was spent (Rover > Errand spending).
* New: Import from CSV. Bring in your clients, vendors and spaces from a spreadsheet: match your columns to ours, do a test run that shows what would happen without saving anything, then import. Column matches are remembered for next time, and a whole import can be undone in one click.
* Sample data: the one-click installer can add a full sample venue alongside your own setup and remove exactly what it added later, without touching your settings.
* TEG Companion: more report cards on the phone - this month against last month, average sale, this year against last year, busiest hours, takings by payment method and more.
* Import from CSV pauses with the rest of the plugin while the licence is not active; exporting to CSV keeps working.

= 1.3.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.2.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.2.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.2.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.2.0 =
* A rebuilt payment schedule voids (never deletes) the unpaid rows it replaces; old pay links go to the event's next open payment.
* A signed gateway payment for an event payment that does not exist is answered 503 so the gateway retries, and staff are alerted.
* 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.

= 1.1.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.0.0 =
* Before release, a third review: a contract version whose price changed after it was issued (a line added or removed while no signed version stood) can no longer be signed - the client is told a new version will follow, the office is e-mailed, and the event screen says the issued version is out of date; re-issuing it lets the client sign. Versions issued before this change are kept only where their text still matches the event exactly; any other must be re-issued. One office save that changes a signed event (the time and the guest count together) now sends the client one notice and the office one, not two.
* Before release, a second review: the event coordinator cannot mark an event completed while money is owed (on the website or in TEG Companion), send the client a new link, or move a signed event to another space, date or time; a completed event that still owes keeps its reminders, late fees, automatic payments and its place in the balance report. Any change to a signed price (or a move) is e-mailed and texted to the client with the old and new total, what changed and their link, and the office is told; an automatic payment that went up waits until the client confirms the new amount on their page (kept, with the time and IP address, in the evidence pack). Changing the settings never re-prices a signed event (tax rules, late fee).
* Before release, a security review: the event coordinator role (view + edit, no money) sees no price, total, payment, schedule or the client's own link on any screen, in TEG Companion or the REST API, and every money change (lines, rates, the schedule, menu dishes, contracts, cancelling a booked date, refunds) is refused on the server. A signed price changes only as an explicit amendment kept in the history. Moving an event to a taken date leaves it exactly where it was. The public forms never add a phone number to a known client.
* First release: inquiries and the pipeline, spaces and combinations on a unique-key inventory, ranked holds with challenges, packages and add-ons, the proposal / e-signed contract / retainer at one link, payment schedules with consented auto-pay, BEOs, menus (TEG-RESTAURANT aware), vendors with insurance dates, the headcount lock, security deposits, tours, the client portal, Google Calendar sync, reports and the dispute evidence pack.
* A sample venue for the demonstration site (Dashboard > Load the sample venue).
