1. Обеспечьте параметры хостинга такими, чтобы они удовлетворяли требованиям Joomla! 4.

Если вы не можете предоставить такие технические параметры, то необходимо поменять хостинг. После этого выполните чистую установку Joomla 4.x на хостинге, под временным доменом. Это впоследствии облегчит процесс публикации сайта. Альтернативно вы можете настроить площадку для разработки на своем локальном устройстве (таком как Denwer [16]).

2. Создайте для вашей установки Joomla! 4.x новую базу данных и нового пользователя базы данных. Запомните имя базы данных, имя пользователя базы данных и пароль базы данных, так как они вам понадобятся при установке Joomla 4.

1. Создайте тестовую среду или область сборки, чтобы работать с одним из следующих вариантов:

• Поддомен.
• Поддиректория.
• Локальное устройство с использованием WAMP, MAMP, LAMP, XAMPP.
• Новый хостинг на корне временного домена (если вы хотите поменять хост в процессе миграции).

   - Восстановление сайта на локальном устройстве (см. [4]).
   - Восстановление сайта с помощью Akeeba Backup [5].

2. Разверните чистую инсталляцию последней версии Joomla 4.x на тестовой среде, используя новое имя базы данных и новую учетную запись доступа к базе данных.

Важное замечание: не устанавливайте при этом данные примера (sample data).

Если вы будете мигрировать любое из расширений ядра, которое отделено от Joomla! 3.4+, то вам понадобится установить Joomla 4.x и основное расширение, поддерживаемое ядром. Такие расширения будут доступны через Joomla Extensions Directory и закладку "Install from web" менеджера расширений (Extension Manager). Перед переносом данных убедитесь, что установлены все поддерживаемые ядром расширения. См. [6] для дополнительной информации о том, что будет отделено/удалено.  По состоянию на август 2021 года отключены только Web Links.

3. Запустите backup своего сайта Joomla 4 (см. [7], или используйте Akeeba Backup [5]).

1. Обновите свой сайт 1.5 до последней версии 1.5.26. Предварительно сделайте его бекап.

2. Почистите ваши секции, категории, модули, элементы меню. Удостоверьтесь, что у всех у них есть уникальные алиасы.

3. Очистите корзину (trash) в Content Manager (sections, categories, articles), Menu Manager, Module Manager.

Замечание: Sections больше не существует в Joomla 4. Sections стали родительской Category. Categories стали вложенными категориями родительской категории.

4. Сообщите пользователям, что любые изменения на текущем сайте с этого момента должны быть повторно введены на новом сайте. Для сложных миграций с изменениями данных см. статью [8] и видео [9].

1. Есть несколько инструментов для миграции. Некоторые бесплатные, другие стоят каких-то денег. Некоторые позволяют делать миграцию определенных данных. Некоторые позволяют мигрировать больше типов данных, чем другие.

2. Инструменты для миграции можно найти в разделе Migration & Conversion директории расширений Joomla [10].

3. Проверьте, что выбранная вами утилита миграции обновлена до совместимости с Joomla 4.

4. Каждая утилита миграции поставляется с собственной пошаговой документацией, как переносить данные (если такой документации нет, этот инструмент использовать не стоит). Некоторые утилиты миграции требуют, чтобы сайт Joomla 1.5 и сайт Joomla 4 находились на одном и том же сервере.

5. Когда вы выбираете инструмент миграции, выбирайте тот, который сохраняет идентификаторы (ItemID). Это необходимо для сохранения рейтинга вашего сайта для поисковых систем, иначе у вас может понадобиться выполнить большее количество перенаправлений (про перенаправления см. далее).

6. Если у вас маленький сайт, то возможно лучше всего сделать миграцию вручную. Создайте категории и статьи, и скопируйте HTML со старого сайта на новый. После этого скопируйте директорию изображений. Сохраните директорию /stories (которая в Joomla 4.x больше не является директорией изображений по умолчанию), или ваши ссылки на картинки могут оказаться испорченными.

7. Один из инструментов миграции (бесплатный) позволяет переносить статьи и только те изображения, которые с этими статьями связаны. Это полезно, если ваш Media Manager потерял управление.

1. Выполните миграцию всех основных данных, которые вы хотели бы перенести в Joomla 4.x. Если ваша утилита миграции запрашивает перенести Sections и Categories, определенно выполните миграцию их обоих. Преобразование выполняется автоматически для категорий и вложенных категорий.

2. Запустите исправление базы данных (Database Fix) через Extension Manager → Database, и кликните на кнопку Fix в верхней части тулбара.

3. Установите ваш новый шаблон (template), или сконвертированный шаблон, чтобы увидеть содержимое вашего сайта (для дополнительной информации см. [11]).

4. Добавьте новые меню, если ваша утилита миграции их не перенесла. Если вы хотите использовать разделенные меню (split menu), то сейчас самое время их настроить.

5. Добавьте модули, если ваша утилита миграции это не сделала. Если же выбранная утилита модули перенесла, то поменяйте позиции модулей в новом шаблоне, чтобы ваши модули отображались и вы могли видеть, с чем работаете.

6. Проверьте наличие задублированных алиасов и исправьте связанные с этим проблемы.

7. Проверьте работу внутренних ссылок. Если они нарушены, исправьте.

8. Сделайте backup.

9. Установите и сконфигурируйте сторонние расширения (например редакторы, Akeeba backup, slideshow, или плагины).

10. Сделайте backup.

11. Если у вас есть большие расширения, для которых требуется миграция данных, выполните индивидуальную миграцию каждого из них в соответствии с документацией разработчика. Сделайте backup после миграции каждого такого расширения.

12. Если ваша утилита миграции не переносит изображения, то вы можете захотеть перенести картинки из сайта 1.5 на сайт 4.x. Замечание: сохраните директорию /stories, если вы решили не исправлять все ссылки на изображения. Вы можете создать новую организационную структуру в директории /images.

13. Рекомендуется, но не требуется, если у вас есть проблемы ассетами, см. [12]. Может помочь полезный инструмент [13].

14. Если вы собираетесь добавить что-нибудь на сайт, или использовать новые основные функции ядра Joomla, такие как Tags или Custom Fields, то сейчас самое время это их установить и сконфигурировать.

15. Проверьте ваши URL на сайте Joomla 4 и сравните с сайтом Joomla 1.5. Если они отличаются, то задокументируйте каждый Joomla 1.5 URL, и какой Joomla 4.x URL они будут использовать, чтобы вы могли настроить перенаправление с адресов 1.5 и сохранить рейтинг для поисковых систем (в этом может помочь таблица Excel). См. рекомендации [14, 15].

16. Сделайте backup.

17. Все проверьте.

18. Выполните дополнительную очистку.

19. Протестируйте все, что сможете.

20. Сделайте backup.

21. Перенесите или поменяйте, или добавьте обновленные данные с сайта Joomla 1.5 на сайт Joomla 4.

22. Добавьте Google Analytics на шаблон, или используйте сторонний плагин.

23. Проверьте Global Configuration - все ли так, как должно быть?

24. Сделайте финальный backup сайта Joomla 4.x.

25. Сделайте финальный backup сайта Joomla 1.5.

26. Переместите ваш сайт Joomla 1.5 с корневого домена на другой субдомен или в подкаталог, или просто удалите его.

27. Сделайте backup и restore (например с помощью рекомендуемой утилиты Akeeba Backup [5], или просто переместите файлы для восстановления вашего сайта Joomla 4.x на корневом домене хостинга.

Замечание: если вы поменяли хосты, то можете оставить ваш сайт Joomla 4.x на месте, и просто перенастроить DNS для вашего домена на новый сервер, где находится Joomla 4.x.

28. Если это необходимо, разрешите .htaccess для Search Engine Friendly URL.

29. Создайте карту сайта (sitemap), и отправьте её в Google Webmaster Tools или другую используемую вами поисковую систему.

30. Сделайте все перенаправления из созданной ранее электронной таблицы для URL-адресов, которые изменились в процессе миграции.

31. Внесите любые другие изменения, которые нужны для ожидания запуска сайта Joomla 4.x.

32. Еще раз все протестируйте.

33. Сделайте другой backup.

34. Удалите любой экземпляр Joomla 1.5, когда сможете.

35. Удалите все другие сайты разработки, с которыми вы возможно работали, или поддерживайте их в актуальном состоянии, если на них установлена текущая версия, чтобы предотвратить попытки взлома на вашем сервере.

36. Добро пожаловать в мир Joomla! 4.x!