Удаление и переустановка

Начиная с CookieConsentManager 1.0.8-pl5 (MODX 2) и CookieConsentManager3 1.0.8-pl7 (MODX 3), пакет поддерживает штатную деинсталляцию через Package Manager. Удаление транспортного архива из списка и действие Деинсталлировать — не одно и то же.

Как удалить компонент

1. Создайте резервную копию базы данных, каталога assets/js/cookie-consent/services/ и частного каталога журналов.
2. Откройте Package Manager и запустите Деинсталлировать для установленной версии cookieconsentmanager либо cookieconsentmanager3.
3. Проверьте сообщения консоли. Если удаление завершилось ошибкой, устраните названную причину и повторите операцию. MODX не гарантирует автоматический rollback всех transport vehicles.
4. После успешной деинсталляции при желании удалите ненужный архив пакета из Package Manager.

Не запускайте деинсталляцию старого исторического пакета cookieconsent или cookieconsent3 поверх нового: его прежний uninstall-код нельзя исправить задним числом.

Что удаляется

При подтверждённой принадлежности пакету MODX удаляет пять сниппетов (CookieConsent, CookieConsentAssets, CookieConsentBanner, CookieConsentMap, CookieConsentVideo), чанк CookiesPopup, служебный плагин и его события, namespace cookie_consent, пункт меню, семь системных настроек, созданные определения прав и штатные файлы.

Удаляются поставленные адаптеры без локальных изменений и распознанные генерируемые файлы. Каталоги удаляются только если пусты. Пакет проверяет принадлежность объектов и SHA256 файлов; совпадения имени недостаточно.

Что сохраняется

• JSONL-журналы согласий и связанные частные файлы, в том числе при хранении в общем каталоге core/cache/logs/.
• Изменённые адаптеры, неизвестные JS-файлы и произвольные пользовательские файлы.
• Внешняя конфигурация аудита и произвольные пути, указанные владельцем сайта.
• Существовавшие до установки определения прав, сторонние элементы и категории с чужими объектами.
• Выбор cookie, уже сохранённый в браузерах: серверное удаление пакета не очищает его автоматически.

Сохранённые файлы могут блокировать будущую установку, поскольку preflight не перезаписывает неизвестное содержимое. В таком случае внимательно изучите предупреждения, сделайте резервную копию и вручную решите, что сохранить.

Повторная установка и обновление

После обычной успешной деинсталляции без пользовательских изменений или дополнительных файлов тот же transport устанавливается повторно без ручных SQL-запросов. При upgrade внутри одного семейства пакета настройки и изменённые адаптеры сохраняются по правилам обновления адаптеров.

Старые неопубликованные семейства cookieconsent/cookieconsent3 не поддерживаются как источник автоматической миграции. Для перехода сохраните конфигурацию отдельно, корректно удалите старую установку и установите новый пакет.

См. также диагностику установки и настройку журнала.