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

Модуль «Соответствие GDPR (Общему регламенту по защите данных в ЕС)»¶

В 4.15.1 появился новый механизм, который дает возможность пользователю отказаться от необязательных cookie и ознакомиться со списком cookie, которые использует магазин.

Изменения в значениях полей в информации о заказе¶

1. Тип расчета налога, используемый при создании заказа, сохраняется в информации о заказе и доступен в поле calculation_type у каждого налога из массива $order_info['taxes'].
2. При расчете налога за единицу не включенные в цену налоги больше не добавляются к следующим значениям:
   • $order_info['shipping_cost'];
   • $order_info['products'][$pid]['subtotal'], где $pid — идентификатор товара в данном массиве.

Новые классы¶

1. \Tygh\VendorPayoutDetailsBuilder — создает массив элементов выплат для упрощения дополнительных расчетов.

Удалённые классы¶

1. \Tygh\Addons\VendorRating\Calculator\EvalBackend

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

1. Создаёт параметры из запроса на получение списка товаров:

   fn_products_form_product_list_params($request);
   

2. Обновляет подписчика на товар (если есть подписчик, то происходит обновление; если подписчиков не было, добавляет нового):

   fn_update_product_subscriber($product_id, $subscriber_data);
   

3. Удаляет подписчиков на товар:

   fn_delete_product_subscribers($subscriber_ids);
   

4. Определяет, давать ли пользователю доступ к API администратора:

   fn_check_user_type_admin_area_for_api(array $user_data = []);
   

5. Предотвращает использование удаленных и отключенных валют:

   fn_save_currencies_integrity($primary_currency = CART_PRIMARY_CURRENCY);
   

6. Запускает транзакцию базы данных:

   db_transaction(Closure $closure, $attempts = 1);
   

7. Проверяет, имеет ли текущий пользователь доступ к управлению витриной:

   fn_check_permission_storefronts($storefront_id)
   

8. Добавляет идентификатор витрины в параметры:

   fn_prepare_storefront_id (массив и параметры $, поле $)
   

9. Получает для витрины идентификатор компании по умолчанию:

   fn_get_default_company_id_for_storefront($storefront_id)
   

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

1. // Было:
   fn_get_default_product_options($product_id, $get_all = false, array $product = []);
   // Стало:
   fn_get_default_product_options($product_id, $get_all = false, array $product = [], $only_avail = false);
   

2. // Было:
   fn_is_allowed_options($product);
   // Стало:
   fn_is_allowed_options($product, $only_avail = false);
   

3. // Было:
   fn_checkout_get_shippping_calculation_type(array $cart, $is_location_changed);
   // Стало:
   fn_checkout_get_shippping_calculation_type(array $cart, $is_location_changed, $is_shipping_method_changed = false);
   

4. // Было:
   fn_export_product_descr($product_id, $value, $lang_code, $field);
   // Стало:
   fn_export_product_descr($product_id, $value, $lang_code, $field, $skip_edition_check = false);
   

5. // Было:
   fn_import_product_descr(array $data, $product_id, $field, $is_new = false, array $object = []);
   // Стало:
   fn_import_product_descr(array $data, $product_id, $field, $is_new = false, array $object = [], $skip_edition_check = false).
   

Новые хуки¶

1. Выполняется перед созданием общего товарного предложения:

   fn_set_hook('master_products_create_vendor_product_pre', $master_product_id, $company_id, $product, $result, $can_create);
   

2. Меняет параметры для получения списка товаров:

   fn_set_hook('products_form_product_list_params_post',  $request, $params);
   

3. Выполняется перед размещением заказа для создания заказа через API-запрос. Позволяет менять данные корзины:

   fn_set_hook('api_orders_create_before_place_order', $params, $status, $data, $valid_params, $cart, $customer_auth, $order_placement_action);
   

4. Выполняется после создания запроса на обратный звонок. Позволяет использовать данные и идентификатор созданного запроса:

   fn_set_hook('create_call_request_post', $data, $request_id;
   

5. Выполняется, когда исключение не было обработано, что позволяет пользователям регистрировать исключения:

   fn_set_hook('error_handler_handle_exception', $exception);
   

6. Выполняется перед обновлением группы пользователей:

   fn_set_hook('update_usergroup_pre', $usergroup_data, $usergroup_id, $lang_code);
   

7. Выполняется перед удалением групп пользователей:

   fn_set_hook('delete_usergroups_pre', $usergroup_ids);
   

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

   fn_set_hook('vendor_payout_details_builder_create_updated_details_post', $this, $updated_order_info, $old_details, $updated_details);
   

9. Выполняется после создания всех частей платежа. Позволяет добавлять определенные элементы:

   fn_set_hook('vendor_payout_details_builder_create_details_post', $this, $order_info, $cart, $payout_details);
   

10. Позволяет выполнять дополнительные действия после установки модуля:

    fn_set_hook('install_addon_post', $addon, $show_notification, $install_demo, $allow_unmanaged);
    

11. Выполняется после обновления модуля:

    fn_set_hook('update_addon_post', $settings, $storefront_id);
    

12. Выполняется после получения списка модулей. Позволяет менять список:

    fn_set_hook('get_addons_post', $params, $items_per_page, $lang_code, $storefront_id, $company_id, $addons, $addons_counter);
    

13. Позволяет менять параметры:

    fn_set_hook('get_carts_pre', $params, $items_per_page, $fields, $condition, $join);
    

14. Подготавливает параметры перед поиском витрины:

    fn_set_hook(‘storefront_repository_find_pre’, $params, $items_per_page, $fields);

15. Выполняется после того, как расчёт поддерживаемых форматов изображений позволяет изменить список:

    fn_set_hook('image_helper_get_supported_formats_post', $object_type, $supported_formats);
    

16. Этот хук выполняется после запроса выбора варианта, позволяет модифицировать его результат:

    fn_set_hook('get_current_filters_after_variants_select_query', $params, $filters, $selected_filters, $area, $lang_code, $variant_values, $field_variant_values, $filter_id, $filter, $result, $fields_join, $products_table_base_joins, $fields_where, $products_table_base_conditions);
    

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

1. // Было:
   fn_set_hook('master_products_reindex_storefront_offers_count', $params, $conditions);
   // Стало:
   fn_set_hook('master_products_reindex_storefront_offers_count', $params, $conditions, $all_vendors_storefront_ids);
   

2. // Было:
   fn_set_hook('master_products_reindex_storefront_min_price', $params, $conditions);
   // Стало:
   fn_set_hook('master_products_reindex_storefront_min_price', $params, $conditions, $all_vendors_storefront_ids);
   

3. // Было:
   fn_set_hook('vendor_plans_calculate_commission_for_payout_before', $order_info, $company_data, $payout_data, $total, $shipping_cost, $surcharge_from_total, $surcharge_to_commission, $commission, $taxes);
   // Стало:
   fn_set_hook('vendor_plans_calculate_commission_for_payout_before', $order_info, $company_data, $payout_data, $total, $shipping_cost, $surcharge_from_total, $surcharge_to_commission, $commission, $taxes, $vendor_taxes);
   

4. // Было:
   fn_set_hook('init_currency_post', $params, $area, $primary_currency, $secondary_currency);
   // Стало:
   fn_set_hook('init_currency_post', $params, $area, $primary_currency, $secondary_currency, $currencies).