From 6fbe3b0feff12f731b76afaefde9f380b77b6d1c Mon Sep 17 00:00:00 2001 From: Repellent Date: Thu, 23 Apr 2026 09:05:31 +0000 Subject: [PATCH] update readme --- README.md | 74 ++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 52 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 94a6521..3bdad55 100644 --- a/README.md +++ b/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.х` и выше. Необходимо провести ревизию и обновить ваш код. \ No newline at end of file