Міграція (перехід) з Joomla 3 на Joomla 4 крок за кроком

Зараз ми з вами на реальному прикладі розглянемо процес оновлення CMS Joomla з третьої версії до останньої на сьогоднішній день — 4-ої версії. Але перш ніж приступати до опису міграції, я хочу наголосити на одному дуже важливому нюансі: щоб не втратити свій сайт, всі дії потрібно робити або на локальному сервері, або на тестовому домені, чи піддоміні. І лише потім, у разі успішної міграції, можна переносити сайт на основний домен.

Взагалі, перехід з Joomla 3.10.x на 4.x вважається міні-міграцією чи незначною міграцією. Це означає, що базові розширення Joomla будуть оновлюватися за допомогою «оновлення в один клік», але сторонні розширення спірні і повинні застосовуватись у кожному конкретному випадку.

Тут важливо підкреслити, що оновити CMS Joomla до 4-ї версії можна тільки якщо поточна версія вашої системи керування вмістом 3.10, або пізніша. Якщо ж у вас рання версія CMS, наприклад Joomla 3.9, то спочатку потрібно оновитися до версії 3.10 і тільки потім мігрувати на 4-у.

Які дії потрібно зробити до оновлення з Joomla 3 на Joomla 4

1. Переконайтеся, що ваш сайт працює під керуванням CMS Joomla 3.10.x.
2. Переконайтеся, що ваш сервер відповідає мінімальним технічним вимогам Joomla 4. Якщо не відповідає, то вам потрібно буде змінити хости.

   Системні вимоги для Joomla! 4.x

   Програмне забезпечення	Рекомендовані вимоги	Мінімальні вимоги
   PHP	8.0	7.2.5
   Підтримувані бази даних
   MySQL	5.6 +	5.6
   Підтримувані веб-сервери
   Apache	2.4 +	2.4
   Nginx	1.18 +	1.10
   Microsoft IIS	10 +	8

3. Виберіть середовище розробки (як і де ви будете робити оновлення). Можливі три варіанти:
   • Перший варіант — оновлення буде здійснюватись на локальному пристрої. На мою думку, це найоптимальніший варіант. Вам не потрібно платити ні за хостинг, ні за домен. Спочатку ви переносите базу даних та всі файли свого сайту з хостингу на локальний сервер, після цього оновлюєте версію CMS, і потім завантажуєте назад на хостинг вже оновлений сайт та його базу даних.
   • Другий варіант — створити піддомен, перенести туди ваш поточний сайт і зробити оновлення. Це також нормальний варіант за умови, що ваш тарифний план на хостингу дозволяє створювати більше однієї бази даних. Адже для перенесення сайту на піддомен вам потрібно буде створювати і окрему базу даних під новий сайт. І на цьому етапі потрібно бути дуже уважним та правильно внести зміни до файлу конфігурації нового сайту — configuration.php. Тому що, якщо ви залишите цей файл без змін (наприклад, забудете), або неправильно щось запишите (наприклад, не зміните ім'я бази даних), то є ризик того, що при міграції буде змінено базу даних основного сайту. Ось чому я рекомендую робити оновлення на локальному веб-сервері.
   • Третій варіант — створити новий обліковий запис на хостингу. Наприклад, через технічні характеристики ваш сайт не може бути розміщений на тому чи іншому сервері.
4. Складіть список усіх сторонніх розширень, що використовуються. Сюди входять компоненти, модулі, плагіни, мови та шаблони. Подивіться, які розширення вам потрібні, а які ні. Видаліть непотрібні розширення та увімкніть розширення, які ви вирішили залишити.
5. Визначте, чи готові сторонні розширення, які ви маєте, для версії Joomla, на яку ви переходите. Зробити це можна, вибравши опцію Joomla Next (після запуску Joomla 3.10.x) в налаштуваннях компонента «Оновлення Joomla» (Компоненти → Оновлення Joomla → Сервер оновлень вибираємо Joomla! Next і тиснемо Зберегти або Зберегти та закрити). Саме оновлення не запускайте. Просто подивіться чи сумісні ваші розширення з Joomla 4. Так ви зрозумієте, які розширення доведеться видалити, або замінити, а які можна буде залишити. Що нам покаже програма перевірки перед оновленням до Joomla 4:
   • Верхня частина перевірки перед оновленням показує, чи сумісне ваше поточне серверне середовище з цільовою версією Joomla як для необхідних налаштувань PHP, так і для налаштувань бази даних. Тут дуже важливо перевірити, чи не відображається щось червоним кольором. Якщо так, то значить цей параметр несумісний з Joomla 4.x і вам потрібно поговорити зі своїм хостинг-провайдером, або змінити хост перед переходом на Joomla 4.x.
   • Далі йде "Перевірка розширень перед оновленням". У червоному блоці перераховані розширення, які поки не підтримують систему оновлень Joomla або, принаймні, не мають тега targetplatform, який вказує на підтримку обраної цільової версії Joomla. Вам потрібно звернутися до розробника перерахованих тут розширень, щоб переконатися, що вони сумісні з Joomla 4.x. У помаранчевому блоці перераховані розширення, які вимагають оновлення для правильної роботи Joomla 4.x. Рекомендується зв'язатися з розробником перелічених розширень, щоб дізнатися, чи потрібно вам оновлювати компонент до або після оновлення CMS.
6. Визначте, чи дійсно вам потрібні всі розширення, які ви використовуєте. Адже може бути таке, що в Joomla 4 з'явилися вбудовані функції, які можуть виключити використання певних сторонніх розширень.
7. Погляньте на свої категорії та статті. Подумайте, може потрібно виконати очищення, щоб не перенести при міграції непотрібний контент?
8. Перевірте свій шаблон. Якщо ви придбали шаблон зі стороннього джерела, то дізнайтеся, чи випущена для нього версія підходяща для Joomla 4.x? Чи є спосіб оновлення, опублікований розробником? Будьте уважні! Основний шаблон для Joomla 3.x, Protostar НЕ сумісний з Joomla 4. Після міграції він зникне.
9. Якщо ви плануєте міняти шаблон сайту на новий, то подумайте, чи потрібні для цього нові зображення? Наприклад, якщо ваш поточний сайт має білий фон, а ваш логотип або інші зображення являють собою зображення .jpg з білим фоном, то вони будуть також добре виглядати на новому шаблоні (якщо новий шаблон має іншу колірну гаму).
10. Обов'язково подумайте, якщо ви зміните дизайн, або внесете зміни до навігації свого сайту, чи з'являться у вас якісь сторінки, для яких буде потрібно перенаправлення? Якщо так, задокументуйте їх.
11. Кошик має бути порожнім. Тому, якщо на вашому сайті в кошику є якісь матеріали, їх потрібно видалити (і будь-які відповідні медіа файли, які можуть бути пов'язані з цими матеріалами, якщо вони не використовуються де-небудь ще на сайті). Залишені в кошику матеріали (категорії та пункти меню) можуть викликати проблеми під час міграції. Щоб видалити матеріали з кошика, виконуємо такі дії: Матеріали → Матеріали → Інструменти пошуку → Вибір стану (В кошику). Так вибираємо всі матеріали у кошику та видаляємо їх. Аналогічну операцію проводитом і для пунктів меню та категорій.
12. Якщо ви в минулому перейшли з Joomla 2.5 на 3.x, то можуть бути деякі розширення, які необхідно очистити. Нижче наведено застарілі розширення 2.5 або 3.x, які потрібно видалити перед оновленням до Joomla 4:
    • plg_content_geshi
    • Bluestork Administrator Template
    • Beez_20
    • Beez5
    • Atomic