README

Описание

Package Navigator - это мощный визуальный менеджер пакетов для Evolution CMS, который предоставляет удобный веб-интерфейс для управления расширениями. Модуль позволяет устанавливать, удалять и управлять пакетами без необходимости использования командной строки.

Основные возможности

Управление пакетами

• Установка из репозитория - установка пакетов напрямую из Packagist
• Загрузка из архивов - поддержка ZIP, TAR.GZ форматов
• Удаление пакетов - полное удаление с очисткой service providers
• Просмотр информации - детальная информация об установленных пакетах

Маркетплейс с фильтрацией

• Поиск - поиск по названию и описанию пакетов
• Фильтрация по категориям - группировка пакетов по тематикам
• Фильтрация по тегам - дополнительная категоризация
• Фильтрация по типам - сортировка по типам пакетов
• Статистика - отображение количества пакетов в каждой категории

Автоматизация процессов

• Автопубликация ресурсов - автоматическая публикация стилей, конфигураций и assets
• Выполнение миграций - автоматический запуск миграций базы данных
• Регистрация провайдеров - автоматическая обработка service providers

Использование

Главный интерфейс

После установки модуль доступен в админ-панели Evolution CMS через раздел "Package Navigator". Интерфейс разделен на две основные вкладки:

Установленные пакеты

• Просмотр всех установленных пакетов
• Быстрое удаление ненужных пакетов (кроме папки assets)

Магазин дополнений

• Просмотр доступных пакетов из удаленного репозитория
• Расширенный поиск и фильтрация
• Установка в один клик
• Информация о репозиториях и документации

Установка пакетов

Из репозитория Packagist

1. Перейдите на вкладку "Установленные пакеты"
2. Введите имя пакета в формате vendor/package-name
3. Укажите версию (или оставьте * для последней версии)
4. Нажмите "Установить пакет"
5. Дождитесь завершения процесса установки

Из архивного файла

1. Нажмите "Выберите файл"
2. Выберите файл архива (ZIP, TAR.GZ)
3. Дождитесь распаковки и установки
4. Система автоматически определит пакет и выполнит все необходимые действия

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

1. Найдите пакет в списке установленных
2. Нажмите кнопку "Удалить"
3. Подтвердите действие в диалоговом окне
4. Система автоматически выполнит:
   • Удаление файлов service providers
   • Обновление custom/composer.json
   • Запуск composer update
5. У меня, еще нет удаления опубликованных стилей и js

Технические особенности

Поддерживаемые функции Composer

• Установка пакетов с указанием версий
• Обновление зависимостей
• Работа с custom/composer.json
• Обработка autoload и service providers

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

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

• Проверьте доступность командной строки
• Убедитесь в правах на запись в vendor директорию
• Проверьте логи Composer для детальной информации

Архив не загружается

• Убедитесь что размер файла не превышает 50MB
• Проверьте формат архива (ZIP, TAR.GZ)

Ошибки при удалении пакетов

• Проверьте наличие прав на удаление файлов
• Убедитесь что пакет присутствует в custom/composer.json
• Проверьте логи на наличие ошибок выполнения команд

Установка

Выполните команды из директории /core:

1. Установка пакета

php artisan package:installrequire roilafx/packagenavigator "*"

1. Публикация стилей и скриптов

php artisan vendor:publish --provider="roilafx\PackageNavigator\PackageNavigatorServiceProvider"