GrIT AJAX Reservation - бронирование товаров в Joomla и JoomShopping

Назначение плагина

GRIT AJAX Reservation - универсальная система бронирования товаров JoomShopping без стандартной корзины и многоэтапного оформления заказа.

Плагин подходит для любых товаров, которые необходимо временно закрепить за покупателем до подтверждения заказа или получения оплаты.

Его можно использовать для:

• товаров в единственном экземпляре;
• товаров с ограниченным остатком;
• изделий ручной работы;
• мебели и предметов интерьера;
• оборудования и техники;
• лимитированных серий;
• предварительных заказов;
• коллекционных товаров;
• подарков и сувениров;
• приёма заявок с ручным выставлением счёта;
• продаж без подключённого эквайринга;
• первичного тестирования спроса.

Плагин также можно использовать для услуг, если услуги оформлены в JoomShopping как товары.

Основные возможности

• AJAX-отправка формы без перезагрузки страницы.
• Повторная серверная проверка остатка перед созданием заявки.
• Уникальный номер каждой заявки.
• Автоматическое завершение просроченного резерва.
• Продление срока после отправки счёта.
• Отправка уведомления продавцу.
• Опциональное письмо покупателю.
• Персональная страница статуса заказа.
• Сброс активной брони.
• Удаление тестовых и ненужных заявок.
• Добавление трек-номера.
• Добавление ссылки на отслеживание.
• Копирование трек-номера одним нажатием.
• Опциональное обнуление остатка после оплаты.
• Передача целей в Яндекс.Метрику.
• Отображение всех дат по московскому времени.
• Журналирование важных операций.

Системные требования

• Joomla 6.x.
• Компонент JoomShopping.
• PHP 8.1 или новее.
• MySQL или MariaDB.
• Работающая отправка почты Joomla.
• Возможность создать переопределение шаблона JoomShopping.

Установка

Во время установки автоматически создаётся таблица:

#__grit_ajaxreservations

Интеграция в шаблон JoomShopping

Почему нужно использовать переопределение шаблона

Не следует изменять файлы непосредственно внутри каталога компонента JoomShopping. Такие изменения могут быть удалены при обновлении компонента.

Правильное решение - создать переопределение представления товара в активном шаблоне Joomla.

Обычно переопределение находится в каталоге:

/templates/ВАШ_ШАБЛОН/html/com_jshopping/product/

Точное имя PHP-файла зависит от установленной версии JoomShopping и используемого шаблона магазина.

Создание переопределения через Joomla

1. Откройте Система - Шаблоны сайта.
2. Выберите активный шаблон.
3. Откройте раздел создания переопределений.
4. Найдите компонент com_jshopping.
5. Создайте переопределение представления страницы товара.
6. Все последующие изменения выполняйте только в созданной копии.

Файлы интеграции

После установки примеры находятся в каталоге:

Шаг 1. Найдите стандартную кнопку корзины

В шаблоне страницы товара найдите кнопку, которая добавляет товар в корзину. Обычно она находится внутри блока кнопок и содержит обработчик отправки формы JoomShopping.

Пример стандартной кнопки:

<button
	type="submit"
	class="btn btn-success button btn-buy"
	onclick="jQuery('#to').val('cart');"
>
	В корзину
</button>

Удалите только эту кнопку. Остальные элементы блока - кнопку вопроса, информацию о доставке и другие ссылки - можно оставить.

Шаг 2. Добавьте кнопку бронирования

Вместо удалённой кнопки вставьте вызов layout-файла плагина:

<?php
print \Joomla\CMS\Layout\LayoutHelper::render(
	'trigger',
	[
		'productId' => (int) $product->product_id,
		'productName' => (string) $productName,
		'productEan' => (string) $product->getEan(),
		'priceText' => trim(
			strip_tags(
				Helper::formatprice($product->getPriceCalculate())
					. (string) $product->_tmp_var_price_ext
			)
		),
		'priceValue' => (float) $product->getPriceCalculate(),
		'buttonIcon' => $productCharacterIcon('cart'),
		'buttonLabel' => 'Забронировать товар',
		'buttonClass' => 'btn btn-success button btn-buy',
	],
	JPATH_PLUGINS . '/ajax/grit_ajaxreservation/layouts'
);
?>

Значение buttonLabel можно изменить:

• Забронировать товар
• Оформить бронь
• Забронировать
• Оставить заявку

Передаваемые параметры

'buttonIcon' => '',

Шаг 3. Подключите модальную форму

Найдите закрывающий тег основной формы товара:

</form>

Сразу после него вставьте:

<?php if ($isAvailable && !$hideBuy) { ?>
	<?php
	print \Joomla\CMS\Layout\LayoutHelper::render(
		'modal',
		[
			'productId' => (int) $product->product_id,
			'productName' => (string) $productName,
			'productEan' => (string) $product->getEan(),
			'priceText' => trim(
				strip_tags(
					Helper::formatprice($product->getPriceCalculate())
						. (string) $product->_tmp_var_price_ext
				)
			),
			'priceValue' => (float) $product->getPriceCalculate(),
		],
		JPATH_PLUGINS . '/ajax/grit_ajaxreservation/layouts'
	);
	?>
<?php } ?>

Правильная структура шаблона

<form class="jshop productfull" method="post">

	Основные данные товара

	<div class="product-buttons">

		Кнопка GRIT AJAX Reservation

	</div>

	Скрытые поля JoomShopping

</form>

Модальное окно GRIT AJAX Reservation

Другие блоки страницы товара

Проверка доступности

В пользовательском шаблоне можно определять доступность по стандартному остатку JoomShopping:

<?php
$isAvailable = (float) $product->getQty() > 0;
?>

Когда product_quantity становится равным нулю, кнопку бронирования следует скрыть и вывести сообщение о недоступности товара.

Пример:

<?php if ($isAvailable) { ?>

	Кнопка бронирования

<?php } else { ?>

	<div class="product-unavailable">
		<strong>Товар больше недоступен</strong>
		<span>Оформить новую бронь нельзя</span>
	</div>

<?php } ?>

Настройки плагина

Ссылка на политику конфиденциальности

Указывайте относительный путь:

/privacy-policy

или:

/politika-konfidentsialnosti

Полный адрес с доменом указывать не нужно.

Как проходит бронирование

1. Покупатель открывает карточку товара.
2. Плагин проверяет остаток и активную бронь.
3. Покупатель нажимает кнопку бронирования.
4. Открывается модальная форма.
5. Покупатель вводит имя, фамилию, телефон и email.
6. Выбирает способ доставки и указывает ПВЗ.
7. Сервер повторно проверяет товар.
8. Создаётся заявка с уникальным номером.
9. Товар временно блокируется.
10. Продавцу отправляется уведомление.
11. При включённой настройке покупатель получает письмо.
12. Продавец отправляет счёт или платёжную ссылку.
13. После оплаты заявка переводится в соответствующий статус.

Данные формы

• Имя.
• Фамилия.
• Телефон.
• Email.
• Способ доставки.
• Адрес, код или ссылка на ПВЗ.
• Комментарий.
• Согласие на обработку персональных данных.

Способы доставки

• ПВЗ Wildberries.
• ПВЗ Яндекс Маркета.
• ПВЗ Ozon.
• ПВЗ СДЭК.

Панель управления бронированиями

После установки в административном меню Joomla появляется пункт управления бронированиями.

Панель также доступна по адресу:

/administrator/index.php?option=com_ajax&plugin=gritAjaxreservation&format=raw&action=panel

В панели можно:

• просматривать все заявки;
• искать заявки;
• фильтровать их по статусу;
• просматривать контакты покупателя;
• просматривать данные доставки;
• изменять статус;
• указывать трек-номер;
• указывать ссылку отслеживания;
• сбрасывать активный резерв;
• удалять заявку;
• открывать страницу статуса покупателя;
• переходить к настройкам плагина.

Статусы заявок

Сброс брони

Сброс переводит активную заявку в статус «Отменён» и снова разрешает бронирование товара.

Запись остаётся в истории.

Удаление заявки

Удаление полностью стирает запись. Действие выполняется после подтверждения и не может быть отменено.

Работа с остатками JoomShopping

Источником фактической доступности является стандартная таблица товаров JoomShopping:

#__jshopping_products

Используемый столбец:

product_quantity

Логика:

• product_quantity > 0 - товар доступен.
• product_quantity = 0 - товар недоступен.

При включённой опции «Обнулять остаток после оплаты» плагин выполняет:

UPDATE `#__jshopping_products`
SET `product_quantity` = 0
WHERE `product_id` = ID_ТОВАРА;

После этого карточка товара получает новый статус непосредственно из базы. JavaScript используется только для обновления интерфейса, но не является источником сведений об остатке.

Почтовые уведомления

Плагин использует стандартный почтовый транспорт Joomla.

Перед запуском проверьте тестовое письмо:

Система - Общие настройки - Сервер - Почта

Письмо продавцу

Содержит:

• номер заявки;
• название товара;
• стоимость;
• артикул;
• имя и фамилию покупателя;
• телефон;
• email;
• способ доставки;
• данные ПВЗ;
• комментарий;
• срок резерва;
• ссылку на товар;
• ссылку на административную панель.

Email покупателя устанавливается как Reply-To.

Письмо покупателю

При включённой опции письмо начинается с обращения:

Здравствуйте, Имя Фамилия!

Также письмо содержит:

• название товара;
• номер заявки;
• стоимость;
• доставку и ПВЗ;
• срок резерва;
• дальнейшие инструкции;
• персональную ссылку на статус.

Страница статуса и отслеживание отправления

Каждая заявка получает случайный публичный токен и персональную ссылку.

Покупатель может увидеть:

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

Телефон и email на публичной странице не выводятся.

После указания трек-номера рядом появляется кнопка «Копировать». После нажатия над кнопкой выводится уведомление «Номер скопирован».

Передача целей в Яндекс.Метрику

Поддерживаются две цели:

• reservation_form_open - открытие формы;
• reservation_success - успешное бронирование.

Названия можно изменить в настройках.

Для успешной заявки передаются параметры:

• product_id;
• product_name;
• reservation_code;
• order_price;
• currency: RUB.

В Яндекс.Метрике необходимо создать цели типа «JavaScript-событие» с теми же идентификаторами.

Безопасность

Публичная форма

• CSRF-токен Joomla.
• Серверная проверка HTTP-метода.
• Проверка допустимого AJAX-действия.
• Очистка и валидация полей.
• Honeypot против спам-ботов.
• Минимальное время заполнения.
• Лимит заявок по IP.
• Лимит заявок по email.
• Повторная проверка товара перед записью.
• Транзакция базы данных.
• Защита от двойного бронирования.

Административные операции

• Доступ только авторизованному администратору.
• Проверка ACL Joomla.
• Проверка права core.manage для com_plugins.
• CSRF-токен для изменения данных.
• Изменения выполняются через POST.
• Транзакции при критических операциях.
• Запись действий в журнал.

Проверка после установки

1. Установите тестовому товару количество больше нуля.
2. Откройте карточку товара в приватном окне браузера.
3. Нажмите кнопку бронирования.
4. Заполните и отправьте форму.
5. Проверьте письмо продавцу.
6. При включённой настройке проверьте письмо покупателю.
7. Обновите страницу товара и убедитесь, что отображается активная бронь.
8. Откройте административную панель заявок.
9. Переведите заявку в статус «Счёт отправлен».
10. Проверьте новый срок резерва.
11. Добавьте трек-номер и ссылку отслеживания.
12. Откройте персональную страницу покупателя.
13. Проверьте копирование трек-номера.
14. Переведите заявку в статус «Оплачен».
15. При включённой опции проверьте значение product_quantity.
16. Убедитесь, что товар больше нельзя забронировать.

Журнал плагина

Диагностические записи сохраняются в:

/administrator/logs/plg_grit_ajaxreservation.php

Журнал содержит:

• создание брони;
• фактический срок резерва;
• результат отправки писем;
• ошибки почты;
• состояние переключателей;
• изменение остатка товара;
• сброс брони;
• удаление заявки;
• изменение статусов.

Ограничения текущей версии

• Плагин не принимает оплату самостоятельно.
• Счёт или платёжная ссылка отправляются продавцом вручную.
• Плагин не формирует чек.
• Нет прямого подключения к приложению «Мой налог».
• Не рассчитывается стоимость доставки.
• ПВЗ не загружаются автоматически с карты.
• Адрес, код или ссылка на ПВЗ вводятся вручную.
• Получение оплаты подтверждается администратором.

Обновление и удаление

Обновление

Новый ZIP-архив устанавливается поверх предыдущей версии через стандартный установщик Joomla.

Предварительно удалять плагин не нужно.

Удаление

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

Для полного ручного удаления используется таблица:

#__grit_ajaxreservations