Давайте-ка потестируем PR в репозитории MODX

Ну что, поможем с пулл-реквестами для MODX 3?

Создаём у себя на хостинге новый пустой сайт и пустую базу данных. Версию PHP поставьте 7.1. После этого подключаемся к серверу по SSH (с помощью Putty, например). На хостинге Beget есть SSH прямо в личном кабинете:



Заходим в корень новой пустой папки и скачиваем MODX с гитхаба:

cd modx-test.dev/public_html/
rm -rf *
git clone https://github.com/modxcms/revolution .

Точка в конце — это не опечатка. Она указывает, что нужно не создавать дочернюю папку revolution, а загружать прямо в текущую директорию.

После этого вводим такую команду (вроде, для простого теста необязательно, но не помешает):

git remote add upstream https://github.com/modxcms/revolution

Теперь выбираем, какой PR будем тестировать. Вот, например, реквест Ивана Климчука: github.com/modxcms/revolution/pull/14031

В нём нет комментариев, значит, наша помощь очень требуется. В самом верху написано

Alroniks wants to merge 13 commits into modxcms:3.x from Alroniks:3x-feature-13849_fa_and_updated_libs

Это значит, что Иван хочет «влить» 13 коммитов в ветку modxcms:3.x из своей ветки Alroniks:3x-feature-13849_fa_and_updated_libs.

Нам надо воспроизвести это действие. Сначала переключаемся на ветку modxcms:3.x (ту, куда автор хочет «влить» свои коммиты). После этого «собираем» MODX (если с консолью особо не знакомы, вводите каждую строчку отдельно):

git checkout 3.x
composer install
cd _build
cp build.config.sample.php build.config.php
cp build.properties.sample.php build.properties.php
php transport.core.php

Если консоль что-то спрашивает, скорее всего, нужно нажать [y] и [Enter]

После этого запускаем site.ru/setup/ и устанавливаем MODX как обычно, только НЕ УДАЛЯЕМ папку setup (галочка должна быть снята).

Заходим в админку, любуемся MODX 3 и наполняем сайт каким-нибудь контентом. Я устанавливаю siteExtra. А вы придумайте что-то своё — тестировать надо на разных системах, с разными решениями.

Когда тестовый сайт будет готов, наполнен и будет нормально работать, мы можем приступать к тестированию. «Вливаем» коммиты Ивана на свой сайт:

git remote add Alroniks https://github.com/Alroniks/revolution
git fetch Alroniks
git checkout 3x-feature-13849_fa_and_updated_libs

Alroniks и 3x-feature-13849_fa_and_updated_libs я взял всё в той же верхней строке пулл-реквеста на гитхабе.

После этого отключаем сжатие CSS и JS в системных настройках, очищаем кеш своего браузера и кеш MODX (чтобы изменения, собственно, увидеть).

Ну и начинается работа на Open source — читаем описание, переводим через Яндекс или Гугл. Понимаем, что Иван предлагает обновить FontAwesome, чтобы появились новые иконки. Идём на сайт FontAwesome, ищем старую версию и ту, которую предлагает интегрировать Иван, узнаём, какие иконки в этой версии появились и пробуем их назначить, например, шаблону.

У меня не получилось это сделать с первого раза, я спросил совета в чате MODX (в Telegram) и мне подсказали, что для этого PR нужно установить NodeJS и запустить команду grunt build. Вот инструкция по установке NodeJS на Beget: beget.com/ru/articles/webapp_nodejs

Когда всё сделано, переходим в _build/templates/default и вводим

npm i
npm install -g grunt-cli
grunt build

После этого иконки появились:


Багов, вроде, не обнаружено, поэтому я отписался в комментариях

I tested this PR. New icons work. No bugs found

Если не знаете точно, что можно писать, или как лучше сформулировать, напишите сначала Ивану лично — думаю, он поможет =)

После того, как один PR протестировали, делаем просто

git checkout 3.x

и приступаем к следующему PR (начиная с места git remote add Alroniks...) — заново всю процедуру проделывать не нужно.