Скрипты и стили

30 августа 2017, 17:36

При инициализации PayAndSee на фронтенде сайта регистрируются скрипты и стили, указанные в системных настройках:

  • front_js - путь к скриптам, по умолчанию [[+assetsUrl]]css/web/default.min.css
  • front_css - путь к стилям, по умолчанию [[+assetsUrl]]js/web/default.min.js

Дополнительно на фронтенде регистрируется переменная payandseeConfig с примерно конфигурацией системы:

payandseeConfig={
    "actionUrl":"\/extras\/payandsee\/assets\/components\/payandsee\/action.php",
    "assetsUrl":"\/extras\/payandsee\/assets\/components\/payandsee\/",
    "ctx":"web",
    "version":"2.0.0-beta",
    "close_all_message":"\u0417\u0430\u043a\u0440\u044b\u0442\u044c",
    "price_format":[2,"."," "],
    "price_format_no_zeros":true
    };

Если вы хотите изменить родные скрипты или стили, вам нужно переименовать эти файлы, изменить, и указать новые имена в системных настройках - тогда они не будут перезаписаны при обновлении. Весь js заимствован с miniShop2, формат и синтаксис практически одинаков.

Функции обратного вызова

При разных операциях на фронтенде сайта могут запускаться javascript функции обратного вызова, то есть callbacks.

Они предусмотрены для разных операций заказа, вот список:

  • Order - действия с заказом
    • add - добавление поля в заказ (имя, email, адрес и т.д.)
    • getcost - получаение текущей стоимости заказа
    • getrequired - получение списка обязательных полей для отправки заказа
    • submit - отправка заказа на обработку

У каждого из этих действий есть несколько этапов, которые вы можете использовать для своей логики. Каждый этап представляет собой функцию или массив функций, которые будут выполнены в нужный момент:

  • before - выполняется перед началом любой операции. Если вы вернёте здесь false, то операция будет прервана.
  • ajax - технический запрос на сервер
    • done - запрос завершён успешно, то есть сервер вернул какой-то ответ.
    • fail - на сервере возникла какая-то техническая ошибка, например он вернул код 500.
    • always - выполняется при любом ответе от сервера.
  • response - получен ответ от сервера (то есть, ajax вернул done)
    • success - сервер говорит, что всё хорошо
    • error - возникла логическая ошибка, например, незаполнены необходимые поля заказа

Для добавления callback в массив нужно указать путь к нему, имя и тело функции:

payandsee.Callbacks.add('Order.add.before', 'callback_name', function() {
    payandsee.Message.error('Добавление запрещено!');

    return false;
});

А для удаления нужен только путь и имя

payandsee.Callbacks.remove('Order.add.before', 'callback_name');

Обе функции возвращают true или false в зависимости от результата работы.

Примеры

2 функции, которые выводят всплывающие окошки с результатом добавления поля в заказ:

payandsee.Callbacks.add('Order.add.response.success', 'orders_add_ok', function(response) {
    payandsee.Message.success('Всё хорошо!');
    console.log(response);
});
payandsee.Callbacks.add('Order.add.response.error', 'orders_add_err', function(response) {
    payandsee.Message.error('Возникла ошибка :-(');
    console.log(response);
});

Логируем все ajax запросы при работе с заказом

payandsee.Callbacks.add('Order.add.ajax.always', 'ajax_log', function(xhr) {
    console.log(xhr);
});