update readme

README.md

@@ -1,31 +1,61 @@
-### Альтернативная версия AVE.CMS v3.32 ALT
+# Альтернативная версия AVE.CMS v3.32 ALT
 
-### Changelog:
+## 📑 Changelog (Список изменений)
 
-#### Версия v3.32 ALT - Добавлено Управление редиректами модулей. Теперь каждой системной ссылке модуля можно добавить ЧПУ алиас. Создан интерфейс «История алиасов», где можно массово удалять старые записи или вручную добавлять новые редиректы с кодами 301 (постоянный) или 302 (временный).
-##### При обновлении предыдущих версий путем выборочного корирования файлов, обязательно скопируйте из репозитория файл ```/tmp/update/sql.update.php``` , положите его к себе на сервер по указанному пути. Таким образом вы добавите в базу данных новую таблицу ```ПРЕФИКС_modules_aliases_history```, а так же обновите типы полей в таблице ```ПРЕФИКС_modules_aliases```.
+### Версия v3.32 ALT
+**Добавлено Управление редиректами модулей.** Теперь каждой системной ссылке модуля можно добавить ЧПУ алиас. Создан интерфейс «История алиасов», где можно массово удалять старые записи или вручную добавлять новые редиректы с кодами 301 (постоянный) или 302 (временный).
 
-[Инструкция: Создание алиаса для модуля «Поиск»](https://gitget.ru/ave-cms-team/ave-cms-alt/wiki/Создание-алиасов-для-модулей)
+> [!IMPORTANT]
+> **При обновлении предыдущих версий** путем выборочного копирования файлов, обязательно скопируйте из репозитория файл `/tmp/update/sql.update.php`, положите его к себе на сервер по указанному пути. Таким образом вы добавите в базу данных новую таблицу `ПРЕФИКС_modules_aliases_history`, а также обновите типы полей в таблице `ПРЕФИКС_modules_aliases`.
 
-#### Версия v3.31 ALT - Готова для работы в среде PHP-8.4.x; исправлены ошибки тянущиеся из прошлых версий. Добавлен PHPMailer для отправки почты методами mail и sendmail, Symfony Mailer работает исключительно с SMTP протоколом. 
-#### Версия v3.30 ALT - Шаблонизатор Smarty обновлен до версии 5.6
-#### Версия v3.29 ALT - удален устаревший Swift Mailer, на замену ему интегрирован Symfony Mailer;
-#### В Системных настройках, при выборе метода отправки почты: SMTP --> Шифрование, добавлены новые пункты: TLS (без проверки сертификата) и SSL (без проверки сертификата). Это дает возможность полноценно настраивать почту на локальном хосте. Добавлен выбор вариантов запросов.
+📖 [Инструкция: Создание алиаса для модуля «Поиск»](https://gitget.ru/ave-cms-team/ave-cms-alt/wiki/Создание-алиасов-для-модулей)
 
+---
 
+### История версий
 
-#### Системные требования: min версия PHP-8.2.x и выше; MySQL-8.x
-#### Рекомендуемая версия PHP-8.4.x
+| Версия | Изменения |
+| :--- | :--- |
+| **v3.31 ALT** | Готова для работы в среде **PHP-8.4.x**; исправлены ошибки прошлых версий. Добавлен **PHPMailer** (mail, sendmail). Symfony Mailer работает только с SMTP. |
+| **v3.30 ALT** | Шаблонизатор **Smarty** обновлен до версии **5.6**. |
+| **v3.29 ALT** | Удален Swift Mailer, интегрирован **Symfony Mailer**. |
 
+**Доработки системных настроек:**
+При выборе метода отправки почты **SMTP → Шифрование**, добавлены пункты:
+* `TLS (без проверки сертификата)`
+* `SSL (без проверки сертификата)`
+*Это дает возможность полноценно настраивать почту на локальном хосте. Добавлен выбор вариантов запросов.*
 
-###  Основное отличие от оригинала v3.28:
-#### Выбор какие запросы использовать, либо из ver 2.09RC1, либо из ver 3.28
-#### В запросах ver 2.09RC1, доступен выпадающий список в качестве панели управления условиями запроса из публичной части сайта, условия созданные в админке полностью работоспособны.
-#### Управление запросами находится в разделе Системные настройки → Дополнительные настройки → Запросы 
-#### Работает в программной среде: PHP-8.4.x MySQL-8.4.x
-#### Добавлена поддержка графических файлов изображений в формате .webp
-#### Обновлены библиотеки 
-### Обновление старых версий:
-#### Перед обновлением более старых версий на версию 3.31 ALT, если вы делаете это путем копирования новых файлов на старые, обязательно удалите свою папку fields со всем ее содержимым (поля системы) и только после этого начинайте обновление. В противном случае вы получите ошибки в системе, т.к. в версии v3.31 были упорядочены названия полей и их каталогов, и при обычном копировании, без удаления каталога fields, это вызовет дубли методов полей и соответственно фатальные ошибки. 
-#### Так же обратите внимание, что в AVE.Cms Alt есть два типа запросов, и по умолчанию используются запросы из версии Ave.cms 2.09RC1, а у вас, скорее всего, используются запросы из Ave.cms ver 3.28 - а это значит, что при использовании определенных условий запросы не будут совместимы. В этих случаях выберите в системных настройках нужную вам версию запросов и только после этого начинайтие с ними работать. Можно пробовать пересохранить запросы одной версии в другой, но положительный результат при этом не гарантируется. 
-#### Учитывайте, что если у вас есть PHP код в системных блоках, в Исполняемом коде для рубрик и так далее, скорее всего вам придется его обновить, т.к. PHP код работающий до и в PHP-7.x.x скорее всего вызовет ошибку начиная с  PHP-8.2.х и выше.
+---
+
+## 🛠 Системные требования
+
+* **PHP:** минимум `8.2.x` (рекомендуется `8.4.x`)
+* **MySQL:** `8.x`
+
+---
+
+## 💎 Основное отличие от оригинала v3.28
+
+* **Выбор логики запросов:** возможность использовать запросы из `ver 2.09RC1` либо из `ver 3.28`.
+* **Улучшенные запросы (v2.09RC1):** доступен выпадающий список для управления условиями запроса из публичной части сайта; условия из админки полностью работоспособны.
+* **Управление:** находится в разделе *Системные настройки → Дополнительные настройки → Запросы*.
+* **Современная среда:** корректная работа в `PHP-8.4.x` и `MySQL-8.4.x`.
+* **Графика:** добавлена поддержка формата **.webp**.
+* **Библиотеки:** произведено обновление системных библиотек.
+
+---
+
+## ⚠️ Инструкция по обновлению старых версий
+
+### 1. Удаление старых полей (Fields)
+Перед обновлением более старых версий на версию **3.31 ALT**, если вы делаете это путем копирования новых файлов на старые, **обязательно удалите папку `fields`** со всем ее содержимым.
+> **Важно:** В версии v3.31 были упорядочены названия полей и их каталогов. Без удаления старой папки возникнут дубли методов, что вызовет фатальные ошибки системы.
+
+### 2. Типы запросов
+В AVE.CMS Alt есть два типа запросов. По умолчанию используются запросы из `v2.09RC1`. Если у вас использовались запросы из `v3.28`, они могут быть несовместимы при определенных условиях.
+* **Действие:** Выберите в системных настройках нужную версию запросов перед началом работы. Пересохранение запросов из одной версии в другую не гарантирует успех.
+
+### 3. Обновление PHP-кода
+Если в системе используется PHP-код (в системных блоках, исполняемом коде для рубрик и т.д.):
+* Код, работавший в `PHP-7.x.x`, скорее всего **вызовет ошибку** в среде `PHP-8.2.х` и выше. Необходимо провести ревизию и обновить ваш код.