Менеджер пакетов MODX представляет собой инструмент, который позволяет управлять установкой и обновлением компонентов (дополнений) для MODX. Он предоставляет возможность быстрой и удобной установки дополнительного функционала на сайт.
Чтобы попасть в менеджер пакетов перейдите в Пакеты -> Установщик
.
Откроется страница Менеджер пакетов на которой есть две вкладки «Пакеты» и «Поставщики». В первой вы можете загружать и устанавливать дополнения. Во второй управлять поставщиками: добавлять, редактировать и удалять поставщиков.
- Пакеты MODX
- Загрузка и установка пакетов из репозитория MODX
- Ручная установка
- Обновление пакетов
- Удаление пакетов
- Поставщики (провайдеры) пакетов
- Изменение, удаление провайдеров
- Добавление новых провайдеров
- Список дополнительных провайдеров и данные по их подключению
- Как устанавливать дополнения сторонних провайдеров
Пакеты MODX
Загрузка и установка пакетов из репозитория MODX
Чтобы загрузить и установить дополнение, откройте менеджер пакетов. На вкладке «Пакеты» (активна по умолчанию) нажмите кнопку «Загрузить пакеты».
Откроется список доступных пакетов разделенных на 2 колонки: в первой самые популярные и во второй недавно выпущенные.
Это пакеты из официального репозитория https://modx.com/extras/ который по умолчанию подключен к MODX.
Так же в дереве слева вы можете развернуть вкладку Extracs и выбрать нужную для вас категорию, чтобы увидеть какие пакеты находятся в ней.
Загрузите нужные вам пакеты (сколько угодно), нажав на соответствующую кнопку. Пакет будет загружен в соответствующий каталог MODX (core/packages).
После загрузки вернитесь в Менеджер пакетов. И вы увидите загруженные пакеты и нажать «Установить», чтобы установить.
Важно! Не все пакеты совместимы с MODX 3 и могут поломать сайт.
После нажатия на кнопку «Установить», загрузится консоль, показывающая детали установки пакета.
Если у пакета есть лицензионное соглашение, вам необходимо согласиться с ним, прежде чем продолжить. Кроме того, пакет может предоставить файл README, с которым вы можете ознакомиться перед установкой. Еще часть пакетов имеет зависимости (например: версия php > или = 7.3, версия MODX > или = 3.0.3) и вы не можете установить его пока их не устраните.
После этого пакет может запросить (а может не запрашивать) некоторые предустановочные параметры и настройки, такие как: Имя, email и т.д.
Если видите везде opcional — обычно можно не заполнять и сразу жать Установить пакете
Затем пакет будет установлен в вашей системе MODX.
Ручная загрузка и установка транспортных пакетов
Все пакеты которые находятся в официальном репозитории (рассмотрели выше), можно найти и скачать по адресу https://modx.com/extras/, там же вы можете посмотреть их описания, инструкции по установке и т.п. (на английском языке). Единственное рекомендую при поиске указывать что у вас 3я версия, чтобы отобразились только совместимые пакеты.
Находите нужное, щелкаете по нему и проваливаетесь на страницу с описанием, ссылками на документацию и т.д. (есть не у вех пакетов). И промотав страницу до конца вы увидите ссылки на скачивание данного пакета.
Вы можете скачать и вручную скопировать пакет в каталог core/packages
. Пакет должен быть transport.zip-архивом, таким как migx-3.0.2-beta1.transport.zip
. Либо загрузить через менеджер пакетов (делает тоже самое), выбрав пункт «Загрузить пакет с компьютера».
Затем нажмите «Загрузить пакеты» в списке и выберите «Искать пакеты локально». Пакет теперь будет отображаться в списке пакетов, и вы можете установить его как обычно.
Для загрузки пакетов требуется, чтобы на вашем веб-сервере были установлены cURL или сокеты. Если они не установлены, список пакетов будет пустым.
Обновление пакетов
Вы можете легко обновить любой пакет, который был загружен у поставщика. Просто нажмите на кнопку «Проверить наличие обновлений» или «Обновить», и MODX покажет все новые версии пакета. Если ваш пакет обновлен, появится сообщение об этом.
Затем вы можете выбрать версию, которую хотите установить, и MODX скачает пакет и начнет процесс установки.
Если вы хотите вернуться на предыдущую версию пакета, вам необходимо нажать «Деинсталлировать».
Удаление пакетов
Вы можете удалить любой пакет или удалить или деинсталлировать его. Удаление полностью удаляет zip-файл из вашего каталога core/packages
. Деинсталляция же просто удаляет его последнюю версию.
Обратите внимание на три метода деинсталляции пакета:
Поставщики (провайдеры) пакетов
Если в менеджере пакетов открыть вкладку «Поставщики», то там вы там увидите официального поставщика: modx.com, который имеет URL-адрес: https://rest.modx.com/extras/ (он поставляется в комплекте с MODX).
URL-адрес: https://rest.modx.com/extras/ является транспортным провайдером — удаленным источником, с которого можно загружать транспортные пакеты. Просто указав URL-адрес службы, вы можете легко подключиться к транспортному провайдеру и легко получить из него последние транспортные пакеты.
MODX поддерживает неограниченное количество транспортных провайдеров, и каждый из них может быть из любого источника.
Изменение, удаление провайдеров
Для настройки или удаления транспортного провайдера просто перейдите на страницу управления пакетами и там нажмите на заголовок таба «Поставщики». Это откроет сетку провайдеров, которыми вы можете легко управлять.
Здесь вы можете отредактировать или удалить поставщика, нажав на шестеренку.
Добавление новых провайдеров
Чтобы добавить нового поставщика, нажмите на кнопку «Создать», далее в сплывающем окне указываете название поставщика и URL-адрес службы, пример:
Также большинство провайдеров не подключатся без имени пользователя и ключа API (получите его после регистрации у провайдера).
Информация по подключению к поставщикам представлена ниже.
Список дополнительных провайдеров и данные по их подключению
Вот источники и доступные торговые площадки, которые обычно предлагают комбинацию бесплатных и премиальных дополнений:
Имя | Количество дополнений | Данные для подключения |
---|---|---|
modstore.pro (Russian) | 100+ (EN), 400+ (RU) | Имя — modstore.pro. URL сервиса — https://modstore.pro/extras/ (если через https не работает, попробуйте просто http) Все, для загрузки бесплатных дополнений. Если нужны премиальные, тогда вам нужно зарегистрироваться, и затем указать: Имя пользователя — электронная почта, при помощи которой вы авторизуетесь на этом сайте. Ключ API — ваш сгенерированный ключ доступа. Вот статья в которой описано как покупать и устанавливать платные дополнения с modstore.pro |
modmore.com | 20+ | Здесь без ключа API ничего скачивать нельзя, следовательно вам нужно зарегистрироваться: https://modmore.com/signup/ и подтвердить email, далее создать по ссылке https://modmore.com/account/api-keys/ ключ API, после этого получите все данные для подключения данного провайдера. |
extras.io | 5 | Регистрируйтесь, создаете здесь https://extras.io/account/projects/ проект и получаете данные для подключения. |
bobsguides.com | 47 | Не понятно как подключится, по-моему все доступно бесплатно и загружено в общий репозиторий. Платных дополнения покупаются через левый сайт. |
Советую добавить репозиторий modstore.pro (добавляется без регистрации на нем), данные в табличке выше и на скриншоте выше. Мы с него будем устанавливать множество дополнений.
Если вы не смогли добавить какого-либо провайдера и вам нужна подробная инструкция по их добавлению, пишите в комментариях, сделаю)
Как устанавливать дополнения сторонних провайдеров
После того как вы добавили дополнительных провайдеров:
На вкладке Пакеты вы можете переключатся между ними щелкнув по стрелочке у кнопки «Загрузить пакеты» -> Выберите поставщика
Далее в сплывающем окне выбираем нужного поставщика и жмем по кнопке «Сохранить и перейти в обозреватель пакетов».
Откроется страница с набором пакетов данного поставщика.
Дальше загружаете нужно и устанавливаете как обычно (указано выше). Как я уже говорил выше не все пакеты совместимы с MODX 3, поэтому не спешите устанавливать все подряд (что рекомендуют в устаревших уроках по MODX 2). Пока для тренировки можете установить дополнение ACE — оно нам поможет с интеграцией дизайна. Его можно установить как с оф. репозитория, так и с modstore.pro, а так как основная поддержка его идет именно в modstore.pro, лучше устанавливать от туда.
Далее мы разберем основные дополнения которые нам понадобятся для разработки сайтов.