FV Simple Booking Calendar — документация

Плагин добавляет на сайт окно онлайн-записи: посетитель выбирает день, свободное время и оставляет контакты. Заявка сохраняется в базе сайта, приходит вам на почту и сразу занимает своё время в календаре.

Документация описывает версию 1.2.9. Плагин бесплатный, лицензионный ключ не требуется.

Установка

1. Скачайте архив FV-simple-booking-calendar-1.2.9.zip.
2. В админке откройте Плагины → Добавить новый → Загрузить плагин.
3. Выберите архив и нажмите Установить, затем Активировать.
4. В левом меню появится пункт FV Tools, внутри него — FV Simple Booking.

При активации плагин создаёт в базе одну таблицу для заявок. Больше ничего в сайт он не добавляет: ни типов записей, ни страниц, ни правил адресов.

Требования

• WordPress 6.0 и новее, включая 7.1.
• PHP 8.0 и новее, включая 8.5.
• Включённый REST API WordPress (работает по умолчанию).

Быстрый старт за пять минут

1. Откройте FV Tools → FV Simple Booking.
2. На вкладке Основные отметьте рабочие дни, укажите рабочие часы и длительность приёма.
3. Впишите почту для уведомлений (если оставить пусто, письма пойдут администратору сайта).
4. На вкладке Поля формы включите нужные поля и переименуйте их под своё дело.
5. На вкладке Дизайн выберите акцентный цвет.
6. Нажмите Сохранить настройки.
7. Поставьте на страницу шорткод [fv_simplebooking].

Как вывести кнопку записи

Способ 1. Шорткод

Выводит готовую кнопку, оформленную в вашем акцентном цвете:

[fv_simplebooking]

Можно задать свой текст и добавить класс темы:

[fv_simplebooking text="Записаться на приём" class="моя-кнопка"]

Способ 2. Любая кнопка темы или конструктора

Дайте кнопке ссылку на якорь:

#fv-booking

Так работают кнопки Gutenberg, Elementor, WoodMart, Divi, пункты меню и обычные ссылки в тексте. Плагин перехватывает нажатие по любой ссылке с этим якорем.

Важно: чтобы способ 2 работал на странице без шорткода, на вкладке «Основные» должна быть включена опция «Подключать календарь на всех страницах». Она включена по умолчанию.

Вкладка «Основные»

Название компании и почта

Название подставляется в письма о новых заявках; если оставить пусто, возьмётся название сайта. Почта для уведомлений — адрес, куда приходят заявки. Галочка «Отправлять копию письма клиенту» шлёт подтверждение на почту, которую оставил посетитель.

Рабочие дни и часы

Дни без галочки остаются в календаре неактивными. Рабочие часы задают границы дня, а длительность приёма строит сетку времени:

• 60 минут при дне 09:00–17:00 дадут интервалы 09:00, 10:00, 11:00 и так далее;
• 30 минут — 09:00, 09:30, 10:00;
• 90 минут — 09:00, 10:30, 12:00, 13:30, 15:00.

Часы считаются по часовому поясу WordPress. Он подписан прямо под полями вместе с текущим временем. Если часы на сайте не совпадают с вашими, поменяйте пояс в Настройки → Общие — календарь последует за ним сразу.

Горизонт записи

Минимум до приёма — запас времени, который вам нужен на подготовку, в минутах. Поставьте 30 — и посетитель в 10:00 увидит интервалы начиная с 10:30. Ноль означает, что можно занять ближайший же интервал.

Настройка действует только на ближайшие часы. На завтрашнем и более далёких днях все интервалы и так далеко, поэтому там сетка выглядит одинаково при любом значении. Под полем плагин показывает конкретный результат: во сколько начинается ближайший доступный интервал прямо сейчас.

Записывать не дальше чем на N дней — глубина календаря. Всё, что дальше этой даты, остаётся неактивным. Это мешает записаться на год вперёд и позволяет временно прекратить приём заявок, уменьшив число. Под полем написано, до какой даты календарь открыт сейчас.

Закрытые даты

По одной дате в строке, формат ГГГГ-ММ-ДД. Под полем есть выбор даты и кнопка «Добавить дату», вписывать руками не обязательно. Такие дни неактивны в календаре.

Занятые интервалы

Обед, планёрка, выезд к клиенту. Выберите дату, время «с» и «по», при желании впишите примечание и нажмите «Добавить занятый интервал». Формат строки:

2026-10-07 12:00-13:00 Обед

Такой интервал становится занятым ровно так же, как настоящая заявка.

Скрытые интервалы на весь месяц

Работает в двух режимах:

• Закрыть месяц целиком. Выберите месяц и нажмите «Закрыть весь месяц» — в поле появится строка вида 2026-10. Все дни этого месяца станут недоступны. Удобно на время отпуска.
• Скрыть часы в каждом дне месяца. Выберите месяц, задайте время и нажмите «Скрыть эти часы в выбранном месяце». Строка вида 2026-10 16:00-17:00 уберёт вечерний интервал из всех октябрьских дней.

Подключение и данные

«Подключать календарь на всех страницах» — держите включённой, если кнопка записи сделана средствами темы или конструктора. Если выключить, календарь подключается только там, где стоит шорткод.

«Удалять настройки и заявки при удалении плагина» — по умолчанию выключено. Обновление плагина не удаляет данные никогда.

Сброс настроек

Кнопка «Сбросить настройки к умолчаниям» возвращает расписание, тексты, поля и дизайн к состоянию только что установленного плагина. Заявки при этом не трогаются: из календаря ничего не пропадёт.

Вкладка «Тексты»

Здесь меняются все надписи окна: подпись над заголовком, сам заголовок, вводный текст, подписи трёх шагов, тексты кнопок, сообщение для закрытого дня и экран благодарности.

Оставьте поле пустым — и возьмётся встроенный текст, который сам следует за языком сайта. Заполните — и надпись станет вашей на всех языках. В поле видна подсказка со встроенным вариантом.

Вкладка «Поля формы»

Третий шаг окна. Шесть полей, у каждого четыре настройки:

• Показывать — выводить ли поле вообще;
• Обязательное — можно ли отправить заявку без него;
• Подпись — название поля; пусто означает встроенный перевод;
• Подсказка в поле — серый текст внутри поля ввода.

Поля extra1 и extra2 запасные, под что угодно: номер автомобиля, кличку питомца, номер заказа, марку техники. Поле message — единственное многострочное.

Хотя бы одно контактное поле (телефон или почта) остаётся включённым всегда, иначе на заявку невозможно ответить.

Если видимых однострочных полей нечётное число, последнее растягивается на всю ширину окна, чтобы в строке не оставалось пустого места.

Вкладка «Дизайн»

Цвета

Главная настройка — акцентный цвет. Он задаёт вид выбранного дня, выбранного интервала, активного шага, обводки полей и кнопки отправки. Дополнительно настраиваются цвет при наведении (если оставить пустым, вычислится из акцента автоматически), цвет текста на акценте, основной текст, фон окна и фон элементов.

Скругления

Отдельно для кнопок с полями и отдельно для самого окна, от 0 до 40 пикселей.

Шрифты и анимация

«Наследовать шрифты сайта» включено по умолчанию: календарь берёт тот шрифт, который ваша тема или плагин шрифтов применяет к странице. Выключайте, только если шрифт темы плохо читается в мелком размере — тогда возьмётся нейтральный системный.

«Анимировать переход между шагами» — текущий шаг уезжает влево, следующий въезжает справа. Посетителям, которые просят систему уменьшить анимацию, всегда достаётся мгновенный вариант.

Вкладка «Заявки»

Последние тридцать заявок. У каждой видно время приёма, контакты клиента, текст заявки и статус.

• Новая — посетитель отправил заявку. В публичном календаре это время подписано «На проверке».
• Подтверждена — вы взяли заявку в работу. Строка подсвечивается зелёным, кнопка становится зелёной «Взято в работу», а в календаре время подписано «Занято». Повторное нажатие на зелёную кнопку возвращает заявку на проверку.
• Отменена — время освобождается и снова доступно для записи.

Новые и подтверждённые заявки держат своё время занятым. Отмена или удаление освобождает интервал.

Языки

Русский и английский поставляются в комплекте и переключаются из ядра WordPress: отдельной настройки языка в плагине нет. Смените язык сайта в Настройки → Общие — и окно записи заговорит на нём.

Названия месяцев, дни недели, первый день недели и формат времени берутся из настроек WordPress, а не из собственного словаря плагина. Поэтому в русской локали дата выглядит как «среда, 16 сентября», а не «16 Сентябрь».

Файлы переводов лежат в папке languages внутри плагина. Свой перевод делается обычным способом — через файл .po с текстовым доменом fv-simple-booking-calendar.

Обновление

1. Скачайте новый архив.
2. Откройте Плагины → Добавить новый → Загрузить плагин и выберите его.
3. WordPress покажет сравнение версий — нажмите «Заменить текущую версию загруженной».

Настройки и заявки при обновлении сохраняются. Деактивировать плагин перед обновлением не нужно.

Если стоит кэширующий плагин, после обновления очистите кэш страниц.

1. Установите и активируйте FV Simple Booking Calendar. При активации он сам перенесёт настройки, закрытые даты, занятые интервалы и все заявки.
2. Только после этого деактивируйте и удалите старый плагин — иначе на сайте окажутся два окна записи.

Страницы править не нужно: прежний шорткод [dmsmotors_booking_button] и прежний якорь #dmsmotors-booking продолжают работать. Настройки старого плагина при переносе не удаляются, поэтому откат назад остаётся возможным.

Решение проблем

Кнопка есть, а окно не открывается

Проверьте на вкладке «Основные» галочку «Подключать календарь на всех страницах». Если кнопка сделана средствами темы или конструктора, а не шорткодом, она должна быть включена.

Окно открывается с задержкой в несколько секунд

Так ведёт себя функция «Отложенное выполнение JavaScript» (Delay JavaScript execution) в WP Rocket, LiteSpeed Cache и подобных: она откладывает загрузку всех скриптов до первого действия посетителя. Добавьте файл fv-simple-booking-calendar.min.js в список исключений этой функции.

Сегодняшний день неактивен

Скорее всего, рабочий день уже закончился и записываться сегодня некуда — плагин так и напишет: «Свободного времени на этот день не осталось». Если день закрыт надписью «На этот день всё уже занято», значит время действительно разобрали заявками: посмотрите вкладку «Заявки».

Изменил «минимум до приёма», а в календаре ничего не поменялось

Это ожидаемо. Настройка прячет только интервалы, которые начинаются слишком скоро от текущей минуты. На далёких датах все интервалы и так далеко, поэтому они выглядят одинаково. Результат виден только на сегодняшнем дне и только в рабочие часы.

Время в календаре не совпадает с реальным

Проверьте часовой пояс сайта в Настройки → Общие. Плагин считает всё по нему; текущий пояс и время подписаны на вкладке «Основные» под рабочими часами.

Заявки не приходят на почту

Плагин отправляет письма стандартной функцией WordPress. Если с сайта не уходят никакие письма вообще, поставьте SMTP-плагин — например, WP Mail SMTP — и настройте отправку. Проверить можно любой другой формой на сайте.

При обновлении появилось сообщение о недоступном установочном файле

Посмотрите версию плагина в списке: скорее всего, обновление уже прошло. Такое сообщение появляется, когда загруженный архив исчез до подтверждения замены — обычно его удаляет чистильщик медиа или базы.

Для разработчиков

После сохранения заявки срабатывает действие:

do_action( 'fv_simplebooking_request_created', $id, $values );

За него цепляют отправку в CRM, Telegram или таблицу. В $values приходят поля name, phone, email, extra1, extra2, message.

Принудительно подключить ассеты на конкретной странице можно фильтром:

add_filter( 'fv_simplebooking_needs_assets', '__return_true' );

Заявки хранятся в таблице {префикс}fv_simplebooking_requests вашей базы данных и никуда не передаются.