Адаптация существующих модулей и тем под CS-Cart 4.11.5

Общие изменения

  • На странице списка заказов и на странице списка покупателей добавлено контекстное меню. Все инструменты, подразумевающие выделение нескольких элементов и работу с ними, перенесены из GearButton в раздел Actions нового меню. В GearButton оставлены только общие инструменты, не привязанные к конкретным элементам (например, импорт заказов с eBay).
  • Если ранее вы добавляли инструмент для работы с выбранными элементами, используя хук '[dir_name]:list_tools', то теперь для добавления элемента в меню Actions следует использовать:
    • '[dir_name]:list_tools_for_selected' — для добавления в конец меню;
    • '[dir_name]:export_tools_list_for_selected' — для добавления в секцию экспорта;
    • '[dir_name]:view_tools_list_for_selected' — для добавления в секцию, содержащую действия по просмотру. Если же вам нужен инструмент, не подразумевающий выбор конкретных элементов, то хук останется прежним: '[dir_name]:list_tools'.
  • SVG-файл иконки загрузки, использующийся, например, при подгрузке данных в фоне, был заменен средствами анимации CSS3. Если ранее вы использовали svg в своих модулях, следует заменить в файлах *.less внутри стилей класса свойство backgroud: url(...) на классы:
    • .ajax-loader — для добавления прелоадера;
    • .ajax-loader--horizontal-center — для центрирования элемента по горизонтали;
    • .ajax-loader--vertical-center — для центрирования элемента по вертикали;
    • .ajax-loader--vertical-top — для отступа в половину высоты прелоадера от верхней границы.
  • Либо эти же классы можно добавить блоку прелоадера.

Изменения в ядре

Новые классы

  1. Перечисляет возможные состояния доступности объекта:

    \Tygh\Enum\Addons\Seo\ItemAvailability
    

Изменённые функции

  1. // Было:
    fn_check_amount_in_stock($product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, &$cart, $update_id = 0)
    // Стало:
    fn_check_amount_in_stock($product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, &$cart, $update_id = 0, $skip_error_notification = false)
    
  2. // Было:
    fn_get_available_shippings($company_id = null, $get_service_params = false)
    // Стало:
    fn_get_available_shippings($company_id = null, $get_service_params = false, $storefront_id = null)
    
  3. // Было:
    \Tygh\Addons\RusOnlineCashRegister\Service::getReceiptFromOrder(array $order, $type)
    // Стало:
    \Tygh\Addons\RusOnlineCashRegister\Service::getReceiptFromOrder(array $order, $type, $payment_method = Receipt::PAYMENT_METHOD_FULL_PAYMENT)
    

Удалённые функции

  1. // Удаленная функция:
    \Tygh\Addons\StripeConnect\Payments\StripeConnect::chargeByToken
    // Что использовать вместо неё:
    \Tygh\Addons\StripeConnect\Payments\StripeConnect::chargeWithout3DSecure.
    
  2. // Удаленная функция:
    \Tygh\Addons\StripeConnect\Payments\StripeConnect::charge
    // Что использовать вместо неё:
    \Tygh\Addons\StripeConnect\Payments\StripeConnect::chargeWith3DSecure
    

Устаревшие функции

  1. // Устаревшая функция:
    fn_expand_weight($weight)
    // Что использовать вместо неё:
    fn_convert_weight_to_imperial_units.
    

Новые функции

  1. Проверяет, закодирована ли строка в формате UTF-16BE:

    fn_is_utf16be($str)
    
  2. Проверяет, закодирована ли строка в формате UTF-16LE:

    fn_is_utf16le($str)
    
  3. Проверяет, должен ли покупатель соглашаться с “Условиями и положениями” во время оформления заказа:

    fn_checkout_is_terms_and_conditions_agreement_required ()
    
  4. Проверяет, считается ли заказ предоплаченным:

    \Tygh/Addons/RusOnlineCashRegister/OrderData::isStatusPrepaid()
    
  5. Устанавливает признак способа расчета в кассовом чеке:

    \Tygh/Addons/RusOnlineCashRegister/Receipt/Receipt::setPaymentMethod($payment_method)
    
  6. Получает признак способа расчета в кассовом чеке:

    \Tygh/Addons/RusOnlineCashRegister/Receipt/Receipt::getPaymentMethod()
    
  7. Конвертирует вес в фунты/унции:

    fn_convert_weight_to_imperial_units($weight)
    
  8. Конвертирует вес в килограммы/граммы:

    fn_convert_weight_to_metric_units($weight)
    
  9. Удаляет конфигурационные данные и лишнюю информацию из корзины:

    fn_storefront_rest_api_strip_service_data(array $cart)
    
  10. Меняет статус указанного пользователя:

    fn_change_user_status($user_id, $status_to, $is_notification_required = false)
    
  11. Меняет статус указанной категории:

    fn_change_category_status($category_id, $status_to)
    
  12. Делает символы в строке заглавными:

    fn_strtoupper($string, $charset = CHARSET)
    

Хуки

Изменённые хуки

  1. // Было:
    fn_set_hook('check_amount_in_stock', $product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, $cart);
    // Стало:
    fn_set_hook('check_amount_in_stock', $product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, $cart, $skip_error_notification);
    
  2. // Было:
    fn_set_hook('check_amount_in_stock_before_check', $product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, $cart, $update_id, $product, $current_amount);
    // Стало:
    fn_set_hook('check_amount_in_stock_before_check', $product_id, $amount, $product_options, $cart_id, $is_edp, $original_amount, $cart, $update_id, $product, $current_amount, $skip_error_notification);
    
  3. // Было:
    fn_set_hook('update_user_pre', $user_id, $user_data, $auth, $ship_to_another, $notify_user);
    // Стало:
    fn_set_hook('update_user_pre', $user_id, $user_data, $auth,
    

Новые хуки

  1. Выполняется перед отправкой сообщения по PHPMailer и позволяет выполнять низкоуровневые манипуляции с самим PHPMailer:

    fn_set_hook('phpmailertransport_send_message_before_send', $this, $message);
    
  2. Выполняется вместе с проверкой на то, должны ли быть “Условия и положения” приняты покупателем во время оформления заказа. Позволяет установить требования непосредственно вам:

    fn_set_hook('checkout_is_terms_and_conditions_agreement_required_pre', $is_agreement_required);
    
  3. Выполняется вместе с проверкой на необходимость принятия “Условий и положений” покупателем во время оформления заказа, после того, как определены требования. Позволяет менять результат проверки:

    fn_set_hook('checkout_is_terms_and_conditions_agreement_required_post', $is_agreement_required);
    
  4. Выполняется перед поиском способов оплаты в модуле Stripe. Позволяет менять параметры поиска:

    fn_set_hook('stripe_data_loader_get_supported_payments_before', $params);
    
  5. Выполняется при расчёте содержимого корзины после расчёта доставки. Позволяет менять содержимое корзины и список доставки:

    fn_set_hook('calculate_cart_content_after_shipping_calculation', $cart, $auth, $calculate_shipping, $calculate_taxes, $options_style, $apply_cart_promotions, $lang_code, $area, $cart_products, $product_groups);
    
  6. Выполняется после того, как заданы цены в заказе. Позволяет задавать дополнительные цены:

    fn_set_hook('storefront_rest_api_format_order_prices_post', $order, $currency);
    
  7. Выполняется после того, как из корзины удалены конфигурационные данные и лишняя информация. Позволяет удалять дополнительные данные:

    fn_set_hook('storefront_rest_api_strip_service_data_post', $cart);
    
  8. Выполняется перед сборкой содержимого дочерней корзины. Позволяет изменять содержимое дочерней корзины:

    fn_set_hook('place_suborders_pre', $order_id, $cart, $auth, $action, $issuer_id, $suborder_cart, $key_group, $group)
    

Большое обновление CS-Cart уже здесь Попробуйте новую панель администратора с темной темой