From 9b3bfaf3ff0cbfdb0e62f890e354a54c3983f39c Mon Sep 17 00:00:00 2001
From: Kocmonavtik <61938582+Kocmonavtik@users.noreply.github.com>
Date: Fri, 11 Aug 2023 16:11:49 +0300
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D0=B0=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82?=
 =?UTF-8?q?=D0=B0=D1=86=D0=B8=D1=8F=20=D0=BF=D0=BE=20=D0=BA=D0=B0=D1=81?=
 =?UTF-8?q?=D1=82=D0=BE=D0=BC=D0=B8=D0=B7=D0=B8=D1=80=D0=BE=D0=B2=D0=B0?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=8E=20=D0=BA=D0=BB=D0=B0=D1=81=D1=81=D0=BE=D0=B2?=
 =?UTF-8?q?.=20(#308)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/Module settings/Customization.md | 44 ++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 doc/Module settings/Customization.md

diff --git a/doc/Module settings/Customization.md b/doc/Module settings/Customization.md
new file mode 100644
index 00000000..bb442f85
--- /dev/null
+++ b/doc/Module settings/Customization.md	
@@ -0,0 +1,44 @@
+### Кастомизация модуля
+
+В модуле доступна кастомизация классов, без потери модифицированного кода при обновлении.
+
+Для этого требуется создать копию необходимого для кастомизации файла и расположить его директории
+`bitrix/php_inteface/retailcrm`
+
+Имеется возможность кастомизации следующих файлов:
+* RestNormalizer.php
+* Logger.php
+* Client.php
+* RCrmActions.php
+* RetailCrmUser.php
+* RetailCrmICML.php
+* RetailCrmInventories.php
+* RetailCrmPrices.php
+* RetailCrmCollector.php
+* RetailCrmUa.php
+* RetailCrmEvent.php
+* RetailCrmHistory_v4.php
+* RetailCrmHistory_v5.php
+* RetailCrmOrder_v4.php
+* RetailCrmOrder_v5.php
+* ApiClient_v4.php  
+* ApiClient_v5.php
+
+С версии 6.3.19 доступна кастомизация ICML, файлы которого расположены в модуле по пути `lib/icml`:
+* xmlofferbuilder.php
+* xmlofferdirector.php
+* icmlwriter.php
+* queryparamsmolder.php
+* settingsservice.php
+* xmlcategorydirector.php
+* xmlcategoryfactory.php
+* icmldirector.php
+
+Кастомизированные файлы каталога также должны быть расположены в директории `bitrix/php_inteface/retailcrm`
+Например, кастом оригинального файла `lib/icml/xmlofferbuilder.php` будет иметь путь `bitrix/php_interface/retailcrm/xmlofferbuilder.php`
+
+Для кастомизации файлов, в названии которых есть используемая версия API,
+создаются файлы с названием без указания версии, например - `RetailCrmHistory.php`.
+
+После создания копии файла с классом в директории `bitrix/php_interface/retailcrm`
+модуль будет использовать кастомизированный класс, в котором можно вносить изменения в его методы.