Merge branch 'WP-71' into 'main'

Resolve WP-71

See merge request ecommerce_modules/cms/wordpress/wordpress!34

.gitattributes

@@ -0,0 +1,2 @@
+*.png filter=lfs diff=lfs merge=lfs -text
+*.svg filter=lfs diff=lfs merge=lfs -text

.wp-env.json

@@ -3,7 +3,6 @@
   "core": null,
   "plugins": [
     "https://downloads.wordpress.org/plugin/woocommerce.latest-stable.zip",
-    "https://downloads.wordpress.org/plugin/woo-gutenberg-products-block.latest-stable.zip",
     "."
   ],
   "config": {

.yarnrc.yml

@@ -1,3 +1,8 @@
-nodeLinker: node-modules
+enableGlobalCache: false
 
 npmRegistryServer: "https://repo.cdek.ru/repository/cdek-npm"
+
+packageExtensions:
+  "@slorber/react-ideal-image@*":
+    dependencies:
+      "prop-types": "*"

guide/.gitignore

@@ -0,0 +1,28 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions

guide/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

guide/docs/faq.mdx

@@ -0,0 +1,95 @@
+---
+sidebar_position: 5
+---
+
+# ЧаВО
+
+Часто задаваемые вопросы по работе плагина и ответы на них.
+
+<details>
+    <summary>Как настроить способы доставки CDEKDelivery?</summary>
+
+    После активации плагина перейдите в раздел WooCommerce > Настройки > Доставка > CDEKDelivery. Здесь вы можете
+    настроить тарифы доставки, параметры доставки и другие настройки, связанные с доставкой от CDEK.
+
+</details>
+
+<details>
+    <summary>Требуется ли договор с CDEK для использования этого плагина?</summary>
+
+    Да, для использования услуг доставки от CDEK вам необходимо заключить договор с CDEK.
+
+</details>
+
+<details>
+    <summary>Есть ли тестовый режим?</summary>
+
+    Да, плагин CDEKDelivery поддерживает тестовый режим. Вы можете настроить его в разделе настроек плагина для проверки
+    его работы без ключей интеграции.
+
+</details>
+
+<details>
+    <summary>Могу ли я использовать плагин для отправки международных заказов через CDEK?</summary>
+
+    Да, в плагине есть международный режим.
+
+</details>
+
+<details>
+    <summary>Какие дополнительные услуги есть?</summary>
+
+    Доступны следующие дополнительные услуги:
+    - Страхование
+    - Бесплатная доставка от определенной суммы заказа
+    - Фиксированная стоимость доставки
+    - Возможность задать надбавку в процентах
+
+</details>
+
+<details>
+
+    <summary>Какой алгоритм определения габаритов к расчету в корзине</summary>
+
+    Сортируем в порядке возрастания параметры высота, ширина, длина.
+
+    Далее для каждого товара выполняем действия:
+
+    считываем габариты
+
+    сортируем габариты по возрастанию
+
+    если, количество товаров более 1, то наименьший габарит товара умножаем на количество товаров и полученные значения
+    опять сортируем
+
+    Затем сравниваем соответствующие значения (меньшее с меньшим, среднее со средним, наибольшее с наибольшим) из
+    настроек и из товаров и выбираем из них максимальные.
+
+    Пример: есть заказ со следующими товарами :
+    * товар 1 (10 * 12 * 15) 1 шт
+    * товар 2 (5 * 20 * 10 ) 3 шт
+    * товар 3 (7 * 3 * 25) 1 шт
+    И в настройках указаны габариты (12, 12, 12)
+
+    Тогда для сравнения будут использованы следующие значения:
+    ```
+    (12, 12, 12)
+    (10, 12, 15)
+    (10, 15, 20) ( 15 = 5 * 3 , минимальную сторону увеличиваем на количество товаров и заново сортируем)
+    (3, 7, 25)
+    ```
+
+    В итоге заказ будет рассчитан с габаритами 12, 15, 25.
+
+    Если в итоге расчета получилось 0 в одном из габаритов или есть включена отметка "Габариты товара вкл/выкл", то
+    тогда для данного габарита будет принудительного использоваться значение по умолчанию.
+
+</details>
+
+<details>
+    <summary>Можно ли указать свой номер отправления ИМ</summary>
+
+    Пока такой возможности нет, номер ИМ всегда заполняется UUID-ом заказа. А с версии 3.11.0 - номером заказа в
+    Woocommerce
+
+</details>

guide/docs/functionality-admin/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Функционал для администратора",
+  "position": 3,
+  "link": {
+    "type": "generated-index",
+    "description": "5 минут на изучение главного функционала для администратора"
+  }
+}

guide/docs/functionality-admin/cod.mdx

@@ -0,0 +1,16 @@
+---
+sidebar_position: 3
+---
+
+import Image from '@theme/IdealImage';
+
+# Наложенный платеж
+
+Плагин поддерживает наложенный платеж.
+Для настройки способов оплаты, необходимо перейти в `WooCommerce`->`Настройки`->`Платежи`, затем включить способ **Оплата при доставке**.
+
+<Image img={require('./img/list.png')} />
+
+После активации, необходимо добавить метод доставки СДЭК к способу оплаты наложенным платежом.
+
+<Image img={require('./img/cod.png')} />

guide/docs/functionality-admin/multiplace.mdx

@@ -0,0 +1,23 @@
+---
+sidebar_position: 2
+---
+
+import Image from '@theme/IdealImage';
+
+# Многоместка
+
+При включенном режиме “Многоместка” появляется возможность расфасовать товары из заказа в несколько упаковок со своими размерами.
+
+<Image img={require('./img/multiplace.png')} />
+
+На странице заказа в панели администратора, помимо выбора размера упаковки, появится выбор товаров и количество товаров которые будут в этой упаковке.
+Количество товара которое можно добавить в упаковку ограничено количеством этого товара в заказе.
+Если “Товар 1” добавлен в заказ в количестве 5 штук, а в упаковку №1 “Товар 1” добавили 3 штуки, то во вторую упаковку можно добавить только 2 единицы этого товара (оставшиеся нераспределенные единицы товары).
+
+<Image img={require('./img/multicreation.png')} />
+
+После распределения всех товаров по упаковкам, будет представлен список упаковок с их габаритами и содержимым.
+По нажатию кнопки “Создать заказ” будет создан заказ в системе СДЭК и в ответ придет номер заказа и ссылка на квитанцию,
+в графе “номер упаковки” можно убедиться в создании нескольких упаковок.
+
+<Image img={require('./img/multiready.png')} />

guide/docs/functionality-admin/order-creation.mdx

@@ -0,0 +1,50 @@
+---
+sidebar_position: 1
+---
+import Image from '@theme/IdealImage';
+
+# Отправка информации о заказе в СДЭК
+
+:::warning
+
+Информация о заказе не передается в СДЭК в автоматическом режиме, если это не включено в настройках
+
+:::
+
+На странице заказа в панели администратора, в разделе “Доставка”, появится форма для отправки габаритов упаковки и создания заказа в системе СДЭК.
+
+:::note
+
+По умолчанию, в поля габаритов подставляются значения, вычисленные в момент оформления заказа
+
+:::
+
+Необходимо заполнить габариты упаковки и отправить заказ.
+
+:::info
+
+Габариты упаковки необходимо вводить в сантиметрах
+
+:::
+
+<Image img={require('./img/creation.png')} />
+
+После отправки формы заказа, в системе СДЭК создается накладная и отображается её номер.
+По кнопке **Отменить** можно удалить эту накладную, изменить данные формы и отправить заново при необходимости
+внесения изменений.
+
+<Image img={require('./img/created.png')} />
+
+:::note
+
+По кнопке **Получить квитанцию** можно получить печатную форму накладной
+
+:::
+
+:::note
+
+По кнопке **Получить ШК** можно получить штрихкоды каждого грузоместа
+
+Формат (А4, А5, А6) печати штрихкодов можно задать в настройках доставки
+
+:::

guide/docs/functionality-customer/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "Функционал для покупателя",
+  "position": 4,
+  "link": {
+    "type": "generated-index"
+  }
+}

guide/docs/functionality-customer/checkout-versions.mdx

@@ -0,0 +1,33 @@
+---
+sidebar_position: 3
+---
+import Image from '@theme/IdealImage';
+
+# Версии страницы оформления заказа
+
+На этой странице описывается, как понять, какую версию страницы оформления заказа вы используете в данный момент.
+
+В Woocommerce есть два типа страницы оформления заказа: классическая и на основе блоков.
+
+Чтобы определить, какой тип оформления заказа вы используете, вам нужно найти страницу оформления заказа в панели администратора и открыть ее
+редактор.
+
+<Image img={require('./img/pages.png')} />
+
+## Страница оформления заказа на основе шорткода
+
+Это тип оформления заказа по умолчанию в WooCommerce.
+Страница оформления заказа генерируется шорткодом `[woocommerce_checkout]`.
+
+Таким образом, редактор покажет, что ваша страница оформления заказа выглядит так:
+
+<Image img={require('./img/shortcode.png')} />
+
+## Страница оформления заказа на основе блоков
+
+Это новый тип оформления заказа, представленный в WooCommerce 3.5. Он основан на редакторе Gutenberg и позволяет вам
+создавать пользовательскую страницу оформления заказа с использованием блоков.
+
+Таким образом, редактор покажет, что ваша страница оформления заказа выглядит так:
+
+<Image img={require('./img/block.png')} />

guide/docs/functionality-customer/new-checkout.mdx

@@ -0,0 +1,32 @@
+---
+sidebar_position: 2
+---
+import Image from '@theme/IdealImage';
+
+# Страница оформления заказа на основе блоков
+
+На этой странице описывается, как плагин работает с новой страницей оформления заказа.
+
+<details>
+    <summary>Как понять какую версию страницы оформления заказа я использую?</summary>
+
+    Вы можете проверить тип страницы оформления заказа в панели администратора.
+    Смотрите наш [гайд](./checkout-versions) для более подробной информации.
+
+</details>
+
+На новой странице оформления заказа, варианты доставки отображаются ниже адреса доставки после его ввода.
+
+<Image img={require('./img/new.png')} />
+
+Кнопка выбора пункта самовывоза не отображается, вместо нее отображается карта с доступными пунктами самовывоза.
+
+<Image img={require('./img/map.png')} />
+
+:::warning
+
+Выше описан функционал для новой версии страницы оформления заказа.
+Старая версия страницы оформления заказа имеет другое отображение карты.
+Пожалуйста, обратитесь к [гайду по старой странице оформления заказа](./old-checkout) для получения более подробной информации.
+
+:::