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

Блокировки¶

Добавлен компонент для блокировок на основе symfony/lock; он позволяет гарантировать эксклюзивный доступ к общим ресурсам.

Чтобы создать блокировку, используйте Tygh::$app['lock.factory'].

Пример использования:

$lock = Tygh::$app['lock.factory']->createLock('pdf-invoice-generation');

if ($lock->acquire()) {
   // The resource "pdf-invoice-generation" is locked.
   // You can compute and generate invoice safely here.

   $lock->release();
}

В блок-менеджер, в компиляцию стилей и JS добавлена эксклюзивная блокировка, чтобы избежать состояния гонки.

Чтобы отключить блокировки, используйте провайдера dummy:

$config['lock_backend'] = 'dummy';

Устаревшие шаблоны¶

• design/backend/templates/views/orders/components/payments/business_check.tpl
• design/backend/templates/views/orders/components/payments/check.tpl
• design/backend/templates/views/orders/components/payments/fax.tpl
• design/themes/basic/templates/views/orders/components/payments/business_check.tpl
• design/themes/basic/templates/views/orders/components/payments/check.tpl
• design/themes/basic/templates/views/orders/components/payments/fax.tpl
• design/themes/responsive/templates/views/orders/components/payments/business_check.tpl
• design/themes/repsonsive/templates/views/orders/components/payments/check.tpl
• design/themes/responsive/templates/views/orders/components/payments/fax.tpl

Новые хуки¶

1. Этот хук позволяет изменять поля профиля после их получения:

   fn_set_hook('get_profile_fields_post', $location, $_auth, $lang_code, $params, $profile_fields, $sections);
   

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

   fn_set_hook('check_usergroup_available_for_user_post', $user_id, $usergroup_id, $result);
   

3. Этот хук позволяет изменять привилегии после их получения:

   fn_set_hook('get_privileges_post', $usergroup, $privileges);
   

4. Этот хук позволяет менять доступность привилегий группы пользователей после основной проверки:

   fn_set_hook('check_can_usergroup_have_privileges_post', $usergroup, $result);
   

5. Этот хук позволяет расширять доступные типы групп пользователей:

   fn_set_hook('usergroup_types_get_list', $types);
   

6. Этот хук позволяет расширять соотнесение типов пользователей и типов групп пользователей:

   fn_set_hook('usergroup_types_get_map_user_type', $map);
   

7. Этот хук выполняется сразу полсе того, как получены данные аутентификации пользователя из заголовков API-запроса. Хук позволяет изменять данные, которые идентифицируют пользователя, использующего API:

   fn_set_hook('api_get_user_data', $this, $auth);
   

8. Этот хук позволяет пропустить очистку корзины при включении режима каталога:

   fn_set_hook("catalog_mode_pre_add_to_cart", $product_data, $cart, $auth, $update, $can_delete);
   

9. Этот хук позволяет повлиять на процесс обновления цен товара:

   fn_set_hook('update_product_prices', $product_id, $_product_data, $company_id, $skip_price_delete, $table_name, $condition);
   

10. Этот хук позволяет вам изменять данные пагинации:

    fn_set_hook('generate_pagination_pre', $params, $area, $deviation);
    

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

1. // Было:
   fn_set_hook('update_product_amount_pre', $product_id, $amount, $product_options, $sign, $tracking, $current_amount, $product_code);
   
   // Стало:
   fn_set_hook('update_product_amount_pre', $product_id, $amount, $product_options, $sign, $tracking, $current_amount, $product_code, $notify);
   

2. // Было:
   fn_set_hook('update_product_amount', $new_amount, $product_id, $cart_id, $tracking);
   
   // Стало:
   fn_set_hook('update_product_amount', $new_amount, $product_id, $cart_id, $tracking, $notify);
   

3. // Было:
   fn_set_hook('update_product_amount_post', $product_id, $amount, $product_options, $sign, $tracking, $current_amount, $new_amount, $product_code);
   
   // Стало:
   fn_set_hook('update_product_amount_post', $product_id, $amount, $product_options, $sign, $tracking, $current_amount, $new_amount, $product_code, $notify);
   

Устаревшие хуки¶

fn_set_hook('profile_fields_areas', $areas); устарел; используйте вместо него схему profile_fields.

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

1. Выстраивает категории товаров в базе данных по порядку:

   fn_sort_product_categories($product_id, array $category_ids)
   

2. Проверяет, можно ли назначить этому пользователю группу с таким ID:

   fn_check_usergroup_available_for_user($user_id, $usergroup_id)
   

3. Получает привилегии группы пользователей:

   fn_get_usergroup_privileges(array $usergroup)
   

4. Проверяет, могут ли у этой группы пользователей быть привилегии:

   fn_check_can_usergroup_have_privileges(array $usergroup)
   

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

   fn_get_available_usergroups($user_type)
   

6. Получает ключ доступа для определённой закрытой витрины:

   fn_ult_get_storefront_access_key($company_id)
   

7. Получает статус определённой витрины:

   fn_ult_get_storefront_status($company_id)
   

8. Открывает определённую витрину:

   fn_ult_open_storefront($company_id)
   

9. Закрывает определённую витрину:

   fn_ult_close_storefront($company_id)
   

10. Определяет, должна ли на этом шаге оформления заказа заново рассчитываться стоимость доставки:

    fn_checkout_step_needs_shipping_calculation($cart, $completed_steps)
    

11. Определяет, были ли изменены данные пользователя в корзине:

    fn_is_cart_user_data_changed(array &$cart, array $auth)
    

12. Получает тип предложения:

    \Tygh\Ym\Offers::getOfferType($product)
    

13. Получает язык карты:

    fn_rus_pickup_get_map_language($lang_code)
    

14. Управляет загрузкой файла пресета:

    \Tygh\Addons\AdvancedImport\Readers\Factory::uploadPresetFile(array $preset, $company_id = null)
    

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

1. // Было:
   function fn_set_store_mode($store_mode, $company_id = null)
   
   // Стало:
   function fn_set_store_mode($store_mode, $company_id = null, $clear_cache = true)
   

2. // Было:
   function fn_update_product_amount($product_id, $amount, $product_options, $sign)
   
   // Стало:
   function fn_update_product_amount($product_id, $amount, $product_options, $sign, $notify = true)
   

3. \Tygh\Registry::loadFromCache теперь получает значение из кэша с определённым ключом.

4. \Tygh\BlockManager\RenderManager::registerBlockCacheIfNeeded теперь возвращает массив с параметром кэширования в случае успеха.

5. fn_get_usergroups теперь возвращает только зарегистрированные типы групп пользователей. Чтобы зарегистрировать тип группы пользователей, воспользуйтесь хуком usergroup_types_get_list.

6. fn_define_usergroups теперь задаёт только зарегистрированные типы групп пользователей. Чтобы зарегистрировать тип группы пользователей, воспользуйтесь хуком usergroup_types_get_map_user_type.

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

Tygh\Enum\Addons\Pickup\MapLanguage — перечисление языков карты.