# Альтернативная версия AVE.CMS v3.32 ALT

## 📑 Changelog (Список изменений)

### Версия v3.32 ALT
**Добавлено Управление редиректами модулей.** Теперь каждой системной ссылке модуля можно добавить ЧПУ алиас. Создан интерфейс «История алиасов», где можно массово удалять старые записи или вручную добавлять новые редиректы с кодами 301 (постоянный) или 302 (временный).

> [!IMPORTANT]
> **При обновлении предыдущих версий** путем выборочного копирования файлов, обязательно скопируйте из репозитория файл `/tmp/update/sql.update.php`, положите его к себе на сервер по указанному пути. Таким образом вы добавите в базу данных новую таблицу `ПРЕФИКС_modules_aliases_history`, а также обновите типы полей в таблице `ПРЕФИКС_modules_aliases`.

📖 [Инструкция: Создание алиаса для модуля «Поиск»](https://gitget.ru/ave-cms-team/ave-cms-alt/wiki/Создание-алиасов-для-модулей)

---

## 🚀 Установка (Новая инсталляция)

Если вы устанавливаете систему с нуля, выполните следующие шаги:

1. **Загрузка файлов:** Скопируйте содержимое архива в корневой каталог вашего веб-сервера.
2. **Права доступа (может потребоваться):** Установите права на запись (CHMOD `755` или `777` в зависимости от настроек хостинга) для папок `/tmp/`, `/cache/`, `/uploads/` и файла `config.php`.
3. **Запуск инсталлятора:** Откройте ваш браузер и перейдите по адресу: `https://ваш-домен.ru`
4. **Следуйте инструкциям:** Введите данные для подключения к базе данных MySQL и создайте аккаунт администратора.

### 🔒 Безопасность после установки
После успешного завершения инсталляции **обязательно** выполните следующие действия:
1. **Удалите папку `/install/`** целиком.
2. **Защитите конфиг:** Установите права `644` (только чтение) на файл `config.php`.
3. **Оптимизируйте права:** Если ваш хостинг поддерживает работу PHP от имени владельца (FastCGI/FPM), смените права на папки с `777` на `755`.

---

### История версий

| Версия | Изменения |
| :--- | :--- |
| **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 (без проверки сертификата)`
*Это дает возможность полноценно настраивать почту на локальном хосте. Добавлен выбор вариантов запросов.*

---

## 🛠 Системные требования

* **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.х` и выше. Необходимо провести ревизию и обновить ваш код.

---

## 📄 Лицензия и Сообщество

* **Лицензия:** Распространяется под лицензией **GNU GPL**.
* **Разработка:** Специально для сообщества **AVE.cms**.