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

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

  • Модули: Водяные знаки: Модуль больше не пытается получить данные изображений из базы данных, а получает их из хука generate_thumbnail_post.

Схема категорий платёжных систем

  • Чтобы добавить новую категорию для платёжных систем, теперь нужно создать такую схему в payments/categories.php:

    (string) CategoryId => [
    'id' => (string) CategoryId,
    'name' => (string) TemplateLanguageVariable,
    'position' => (int) CategoryPosition
    'criteria' => [
        (string) ProcessorField => (mixed) ProcessorFieldValue,
         ...
        ],
    ],
    
  • Платёжные системы в режимах manage и update контроллера payments теперь сгруппированы по категориям. Каждой системе присваивается только 1 категория.

Функции

Новые классы

Tygh\Enum\SiteArea — перечисление возможных областей сайта.

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

  1. // Было:
    fn_get_checkout_payment_buttons(&$cart, &$cart_products, &$auth)
    // Стало:
    fn_get_checkout_payment_buttons(&$cart, &$cart_products, &$auth, array $checkout_payments = null)
    
  2. // Было:
    fn_generate_thumbnail($image_path, $width, $height = 0, $lazy = false, $return_rel_path = false)
    // Стало:
    fn_generate_thumbnail($image_path, $width, $height = 0, $lazy = false, $return_rel_path = false, array $image = [])
    

    Если вы используете функцию fn_generate_thumbnail напрямую, вам необходимо передать в неё массив $image.

  3. // Было:
    fn_get_product_prices($product_id, &$product_data, $auth, $company_id = 0)
    // Стало:
    fn_get_product_prices($product_id, &$product_data, $auth, $company_id = 0, $get_all = false)
    
  4. // Было:
    \Tygh\Common\OperationResult::showNotifications($translate_messages = false)
    // Стало:
    \Tygh\Common\OperationResult::showNotifications($translate_messages = false, $message_state = '')
    
  5. // Было:
    fn_init_currency($params, $area = AREA)
    // Стало:
    fn_init_currency($params, $area = AREA, $account_type = null)
    

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

  1. fn_seo_get_availability_for_snippet
  2. fn_seo_extract_feature_brand
  3. fn_mobile_app_uninstall_layout

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

  1. Получает элементы разметки Schema.org для товара:

    fn_seo_get_schema_org_markup_items(array $product_data, $show_price = true, $currency = CART_PRIMARY_CURRENCY)
    
  2. Получает данные чека и преобразует их в нужную форму для отправки в API Робокассы:

    fn_rus_payments_robokassa_encode_receipt(array $receipt, array $processor_data)
    
  3. Возвращает все данные чека в соответствии с требованиями из документации API Робокассы:

    fn_rus_payments_robokassa_get_full_payment_receipt(array $processor_data, array $order_info, array $params = [])
    
  4. Обновляет позицию товара в выбранной категории:

    fn_update_product_position_in_category($product_id, $category_id, $position)
    
  5. Сортирует все платёжные системы по соответствующим категориям:

    fn_get_payment_processors_by_category($allow_multiple_categories = false)
    
  6. Инициализирует пустую корзину для запросов Storefront REST API:

    fn_storefront_rest_api_get_empty_cart($cart_service_id, array $auth)
    
  7. Получает ID cart_services (это сервисы, которые работают с корзинами, содержащими товары только одного продавца):

    fn_storefront_rest_api_get_cart_service_ids(array $auth)
    
  8. Группирует товары из корзины по cart_services:

    fn_storefront_rest_api_group_cart_products(array $cart_products)
    
  9. Получает ID продавцов, чьи товары находятся в корзине покупателя:

    \Tygh\Addons\DirectPayments\Cart\Service::getVendorIdsByUserId($user_id)
    

Хуки

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

  1. // Было:
    fn_set_hook('get_checkout_payment_buttons', $cart, $cart_products, $auth, $checkout_buttons, $checkout_payment_ids, $payment_id);
    // Стало:
    fn_set_hook('get_checkout_payment_buttons', $cart, $cart_products, $auth, $checkout_buttons, $checkout_payment_ids, $payment_id, $payment, $checkout_payments);
    
  2. // Было:
    fn_set_hook('generate_thumbnail_post', $th_filename, $lazy, $image_path, $width, $height);
    // Стало:
    fn_set_hook('generate_thumbnail_post', $th_filename, $lazy, $image_path, $width, $height, $image);
    
  3. // Было:
    fn_set_hook('checkout_select_default_payment_method', $cart, $payment_methods, $completed_steps_legacy);
    // Стало:
    fn_set_hook('checkout_select_default_payment_method', $cart, $payment_methods, $completed_steps_legacy, $auth);
    
  4. // Было:
    fn_set_hook('form_cart_pre_fill', $order_id, $cart, $auth, $order_info);
    // Стало:
    fn_set_hook('form_cart_pre_fill', $order_id, $cart, $auth, $order_info, $copy);
    
  5. // Было:
    fn_set_hook('google_sitemap_generate_link_get_object_link', $type, $id, $languages, $extra, $storefront_id);
    // Стало:
    fn_set_hook('google_sitemap_generate_link_get_object_link', $type, $id, $languages, $extra, $storefront_id, $link);
    
  6. // Было:
    fn_set_hook('get_product_data', $product_id, $field_list, $join, $auth, $lang_code, $condition);
    // Стало:
    fn_set_hook('get_product_data', $product_id, $field_list, $join, $auth, $lang_code, $condition, $price_usergroup);
    

Новые хуки

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

    fn_set_hook('tier_manager_update_tier_pre', $user_ids, $type, $allow_downgrade);
    
  2. Выполняется при получении элементов разметки Schema.org, непосредственно перед возвращением результата. Позволяет менять созданные элементы разметки:

    fn_set_hook('seo_get_schema_org_markup_items_post', $product_data, $show_price, $currency, $markup_items);
    
  3. Выполняется при обновлении количества товара на складе, но до проверки состояния настроек отслеживания:

    fn_set_hook('update_product_amount_before_tracking_checking', $product_id, $amount_delta, $product_options, $sign, $notify, $order_info);
    
  4. Позволяет менять код добавленного статуса:

    fn_set_hook('update_status_new_status_code', $status, $status_data, $type, $lang_code, $existing_codes);
    
  5. Выполняется перед созданием формы оплаты. Позволяет менять данные формы:

    fn_set_hook('create_payment_form_pre', $submit_url, $data, $payment_name, $exclude_empty_values, $method, $parse_url, $target, $connection_message);
    
  6. Выполняется при изменении позиции товара в категории:

    fn_set_hook('update_product_position_in_category_post', $product_id, $category_id, $position);
    
  7. Выполняется после инициализации пустой корзины для запросов Storefront REST API. Позволяет менять инициализируемую корзину:

    fn_set_hook('storefront_rest_api_get_empty_cart_post', $cart_service_id, $auth, $cart);
    
  8. Выполняется после инициализации списка доступных ID cart_services для запроса Storefront REST API. Позволяет менять список cart_services:

    fn_set_hook('storefront_rest_api_get_cart_service_ids_post', $auth, $cart_service_ids);
    
  9. Выполняется после того, как товары рассортированы в группы для запроса Storefront REST API. Позволяет менять инициализируемые группы:

    fn_set_hook('storefront_rest_api_group_cart_products_post', $cart_products, $groups);
    
  10. Выполняется, когда новый пользователь авторизуется через стороннюю учётную запись (социальную сеть и т.п.). Позволяет изменять данные пользователя перед созданием учётной записи в магазине:

    fn_set_hook('hybrid_auth_create_user', $auth_data, $provider, $user_data);
    

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