=== 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.41.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 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, 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 · 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.41.0 =
* **Fixed: a first or last name longer than 100 characters could make a booking fail** with “The booking could not be saved.” Every field now has a length that fits: names 100 characters, phone 60, other lines 200, messages 2000, the reason for a cancellation 500. Longer input is shortened; an email address is never shortened — one longer than 200 characters is refused with a clear message.
* **The calendar on your booking page now has a brake.** One connection may ask for free times at most 300 times in 10 minutes — a person browsing through the months needs a few dozen. Whoever asks more often is told to wait and is counted under Settings → Log → Blocked attacks.
* Groundwork for the Pro extension: sign-ups for free events can now wait for a confirmation by email, and somebody who has not confirmed their place on a waiting list does not move up.

= 0.40.0 =
* **When you enter or move an appointment yourself and the time is taken, a window now opens in the middle of the screen** — on your phone as well as in the admin calendar — and says what is in the way: another appointment (with its time and customer), or only the preparation and follow-up times overlapping. Until now a small line under the form said “Another appointment already occupies this time.”, and it was easy to miss.
* **New: a warning for absences, events, your linked calendar and closed public holidays.** Until now these were not checked at all when you entered an appointment yourself. Now you are told, for example “You are absent at this time: ‘Holiday’”, and you decide: choose another time, or create it anyway. Another appointment at the same time stays impossible, as before.

= 0.39.0 =
* **New: an overview of blocked attacks** under Settings → Log → Blocked attacks. You see how often bots and suspicious requests were turned away today, in the last 7 and in the last 30 days — by reason, by place (which booking view) and minute by minute. Only numbers are stored: no IP addresses and nothing anybody typed in. After 30 days the numbers are removed by themselves, and a button deletes everything at once — after asking you on the page.
* The explanations say honestly when a person may be behind it: a filled-in hidden field or a form sent within seconds is a bot; an old page or a throwaway address can also be a real visitor.
* The AI connection counts wrong connection codes and lock-outs there as well.
* The block list and the limit per IP address can now be used by the Pro extension for event sign-ups too.

= 0.38.0 =
* **The order of the appointment types in the drop-down is now yours.** Under Booking views you drag the rows into the order your visitors should see — arrow buttons do the same thing for the keyboard. Until now that order followed the Appointment types page and could not be changed per booking view. Nothing moves on its own: as long as you do not drag anything, everything stays exactly where it was.
* **An appointment type can now have its own booking confirmation — with attachments.** Switch it on under the appointment type and the text appears already filled in with your general template; extend it, attach a questionnaire, a PDF with directions or a ZIP, and save. Every other appointment type keeps using the general template from Settings → Emails, untouched.
* This works for paid appointment types too: there the confirmation goes out once the money has arrived, and it is the same email.
* A test button sits under each appointment type so you can see your own confirmation, attachments and all, without booking a real appointment.
* **Please note:** as soon as you type your own wording, that wording is fixed in every language and later improvements to the standard text no longer reach it — the same rule that already applies to the general templates. Clear both fields and save to follow the general template again.
* Attachments are picked from your media library, at most five per email. The total size is shown, and you are warned before it gets large enough for mail servers to refuse the whole email.

= 0.37.0 =
* **Fixed: the note under the confirmation appeared on every page, not just on the confirmation.** It points at the confirmation email — and there is no such email until the appointment is really booked. It now shows where it belongs, and with room above it instead of stuck to the box.
* The heading above the payment step can now be set by the Pro extension, so it can say what the customer is actually doing instead of “One last step” all the way through.

== Upgrade Notice ==

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

