=== smartEngin MeetMix ===
Contributors: businesskiai
Tags: booking, appointments, scheduling, calendar, booking calendar
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.43.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Appointment booking for your website: visitors see your real availability and book a phone call, an on-site visit or an online meeting.

== Description ==

smartEngin MeetMix lets visitors book appointments directly on your website. You define your appointment types and weekly hours; visitors pick a free slot and receive a confirmation with a calendar file and a link to cancel or reschedule — no customer account needed.

= What you get =

* **Appointment types** — phone call, online meeting, you visit the customer, the customer visits you. Each with its own duration, buffer times, lead time and booking horizon, and optionally its own weekly hours.
* **A booking page** you place with a shortcode. Visitors see your real availability in their own time zone.
* **Double bookings are prevented by the database, not by a lucky guess.** Two visitors can click the same slot at the same moment; only one gets it.
* **Emails that arrive** — confirmation with a calendar file, notification to you, reminders before the appointment. Every template can be edited, and reminders run without a paid service.
* **Your own form fields** next to the seven standard ones — text, several lines, email, phone, address, a choice list, a tick box or a date of birth (entered with the date picker of the browser). Per appointment type you decide what is required, optional or hidden.
* **Your customer can cancel or reschedule** through a link that contains nothing but a random value. No account, no password.
* **Your own calendar in the admin area** — year, month, week and day. Create an appointment by clicking into it, drag it to a new time, cancel it — and you always see the email to your customer before it goes out.
* **Absences** with their own colour, an optional yearly repeat, and a switch for whether they block bookings at all — a birthday should not close your working day.
* **Public holidays for all sixteen German federal states**, each one individually selectable.
* **Privacy built in:** no IP address is ever stored, old bookings are anonymised or deleted on a schedule you set, and the customer link never carries a name or an email address.
* **Works with multilingual sites.** The language a visitor booked in is stored with the booking, and every email to that person switches to it — no forced site language, so WPML, Polylang and TranslatePress keep working.
* **The colours follow yours.** One accent colour, used everywhere.
* A **manual inside the admin area**, and a log that tells you whether an email really went out.

= The Pro extension =

smartEngin MeetMix Pro is a separate plugin. It adds Google Calendar in both directions with an own Google Meet room per appointment, Telegram messages to your phone, several booking pages, events with a waiting list, paid appointments through the free smartEngin buy plugin, a minimum age per appointment type, and your calendar on your phone. **Nothing in this plugin is locked or waiting to be unlocked** — the free plugin is complete in itself, and the extension brings its own code.

What it adds, in one line each: Google Calendar in both directions · an own Google Meet room per appointment · Telegram messages to your phone · several booking views · events with seat limits and a waiting list · paid appointments through the free smartEngin buy plugin · a minimum age per appointment type · your calendar on your phone. Details: [smartengin.de/meetmix](https://smartengin.de/meetmix/)

= External services =

This plugin contacts no external server at all. Nothing is loaded from a CDN, no data leaves the visitor's browser to a third party, and no IP address is stored — the spam protection turns it into a one-way value that expires after an hour. The Pro extension is where Google and Telegram come in, and it asks for those credentials itself.

= Bundled library =

FullCalendar 6.1.19 ([fullcalendar.io](https://fullcalendar.io/), MIT licence) is shipped inside the plugin so that no visitor request ever goes to a CDN. The readable source of the shipped files is at [github.com/fullcalendar/fullcalendar](https://github.com/fullcalendar/fullcalendar); the exact files, versions and download addresses are documented in `assets/vendor/fullcalendar/LIESMICH.txt` inside the plugin.

== Installation ==

1. Install the plugin and activate it.
2. Open **smartEngin MeetMix → Appointment types** and create your first type — a phone call, a visit, an online meeting. Duration, buffer times and how far ahead it can be booked belong to the type.
3. Open **Availability** and set your bookable hours per weekday. Absences and German public holidays are on the same page.
4. Put the shortcode `[smartengin_termin]` on any page — that is your booking page. `[smartengin_booking]` does the same thing under an English name.
5. Check **Settings → General** for your company name and the address that notifications are sent to.

One thing worth checking once: under **Settings → General** of WordPress itself, your time zone should be a **city** (for example Berlin), not a fixed offset such as UTC+2. A fixed offset knows no daylight saving time, and every appointment would shift by an hour in autumn. The plugin warns you about this in red if it finds it.

== Frequently Asked Questions ==

= Does the visitor need an account? =

No. Booking asks only for the fields you chose. The link to cancel or reschedule contains a long random value and nothing else — no name, no email address, no booking number.

= What happens if two visitors click the same slot at the same second? =

One gets it, the other is told the slot has just been taken. This is decided by the database through a unique key per time unit, not by a check in PHP that could be a moment too late.

= Do the reminders work without a paid service? =

Yes. They run on WordPress' own scheduled tasks, and they catch up on whatever is due instead of demanding an exact moment — so a quiet site does not silently skip them. Every reminder is sent once, recorded in the database. WordPress' scheduler only runs when somebody visits your site; if your site is quiet for long stretches, set up a real cron job at your host. The plugin shows you under Settings → Reminders whether the scheduler is healthy, and how to set that up.

= Is any personal data sent anywhere? =

No. The plugin contacts no external server. No IP address is stored — the spam protection turns it into a one-way value that cannot be turned back and expires after an hour. Under Settings → Privacy you set how long booking data is kept and whether old bookings are anonymised or deleted.

= Does it work on a multilingual site? =

Yes, and it deliberately does not force a language. The language a visitor booked in is stored with the booking, and every email to that person switches to it — including the reminder that goes out from a scheduled task. WPML, Polylang and TranslatePress keep working, because nothing here hooks the site locale. Your own wording (email templates, the names of your appointment types) is never machine-translated.

= Can I charge for an appointment? =

Not with this plugin alone. Paid appointments need the Pro extension together with the free smartEngin buy plugin, which handles checkout, invoice, coupons and refunds. There is deliberately no second payment system in here. You can enter a price without them, but nothing is ever charged, and the plugin says so on the appointment type.

= Which third-party code ships with the plugin? =

One library: FullCalendar 6.1.19 (MIT). It is shipped inside the plugin instead of loaded from a CDN, so that no visitor request ever leaves your site. Its readable source is at github.com/fullcalendar/fullcalendar, and `assets/vendor/fullcalendar/LIESMICH.txt` in the plugin names the exact files and where they came from.

= What happens to my data if I delete the plugin? =

Nothing, unless you ask for it. Deleting the plugin keeps your appointments and settings, so an accidental click never costs you your bookings. There is a switch under Settings → Privacy if you really want everything removed.

== Screenshots ==

1. The booking page a visitor sees: your appointment types, your real free times, and the times in the visitor's own time zone.
2. Your calendar in the admin area, month view — with the window for a new appointment or an absence open.
3. The week view: every appointment in its real length and in the colour of its type.
4. The year view: one glance shows which days are busy and where your absences are.
5. Settings: the name and address your emails go out under, the booking number, and what your customer is allowed to change.
6. Availability: your bookable hours per weekday. Absences and German public holidays live on the same page.
7. Your appointment types with duration, kind and status — drag a row to change the order your visitors see.
8. The manual inside the admin area: every part of the plugin explained where you need it.

== Changelog ==

= 0.43.0 =
* **Works together with smartEngin Analytics.** Every blocked attempt on your booking form, the AI connection and (with Pro) the event sign-up and the phone calendar is now also reported to smartEngin Analytics, where it appears under Security with country, map and an estimate of bot or human. Nothing is sent anywhere else, and no email address, PIN or link is ever part of the report.
* Also reported to smartEngin Analytics, but not counted in the overview: links to the customer page or to rescheduling that never existed.
* With smartEngin Analytics active, the view “Blocked attacks” points there. The numbers in MeetMix keep counting, so a Telegram alert about many attacks still works. Without Analytics nothing changes.

= 0.42.4 =
* Next to a date-of-birth field in an appointment type, a quiet note now says that a minimum age comes with MeetMix Pro. No link, no button.

= 0.42.3 =
* **Fixed for good: browsers that fill in forms for you could still trip the spam trap.** The invisible field is now read-only, so neither the browser’s autofill nor a form-filling helper can put anything into it — only a program writing into the page directly.

= 0.42.2 =
* **Fixed: a real visitor could be turned away with “Your request looks automated”.** The invisible field that catches bots was named like a website address, and some browsers filled it in when they auto-filled the booking form. It now has a name no browser fills in.

= 0.42.1 =
* The minimum age of an appointment type is now any number of years instead of a fixed choice of 16, 18 or 21 (the number is set with the Pro extension; 0 means no limit, and every existing appointment type stays at 0).
* The manual and the plugin description now explain the new “Date of birth” field type, and that a minimum age per appointment type comes with the Pro extension.

== Upgrade Notice ==

= 0.43.0 =
Reports blocked attempts to smartEngin Analytics, if it is installed. Without Analytics nothing changes.

= 0.42.4 =
Adds the date-of-birth field type, a note about the minimum age in Pro, and stops browser autofill from tripping the spam trap.

= 0.42.3 =
Stops browser autofill from tripping the spam trap on the booking form.

= 0.42.2 =
Fixes real visitors being turned away as “automated” when their browser auto-filled the booking form.

= 0.42.1 =
The minimum age of an appointment type can now be any number of years (set with MeetMix Pro 0.56.1). The manual explains the “Date of birth” field type.

= 0.42.0 =
Adds the form field type “Date of birth”. Nothing changes on your booking page until you create such a field.

= 0.41.0 =
Fixes bookings with very long names, adds a brake against programs that flood the booking calendar with requests, and prepares confirmation by email for event sign-ups.

= 0.40.0 =
A clear window instead of a small line when the time you pick for an appointment is taken — and a warning for absences, events and holidays.

= 0.39.0 =
New overview of blocked attacks under Settings → Log. Only numbers are stored, no IP addresses. Your spam protection itself works exactly as before.

= 0.38.0 =
You can now drag the appointment types of a booking view into the order your visitors see, and give a single appointment type its own booking confirmation with attachments. Nothing changes until you do it.

= 0.33.3 =
Screenshot descriptions for the plugin directory. Nothing about the plugin itself has changed.

= 0.33.2 =
The admin calendar now fills the height of your window instead of a fixed height. Nothing you click changes.

= 0.33.1 =
The reschedule calendar on the customer page loads its script the way the plugin directory asks for. Nothing you can see changes.

= 0.33.0 =
Every page is now filtered once more at the moment it is printed, as the plugin directory asks. Nothing you can see changes.

= 0.32.3 =
An internal page used for building the plugin has been removed. Nothing you can see or click changes.

= 0.32.2 =
Documentation only. Nothing about how the plugin works has changed.

= 0.32.1 =
A slot is now held for 30 minutes while somebody pays, instead of 15 - long enough for payment methods that send your customer to a site of their own.

