====== Migrate J3.10 to J4.x to J5.x ======
===== Important Read First =====
  * [[https://docs.joomla.org/Joomla_3.x_to_4.x_Step_by_Step_Migration|Joomla 3.x to 4.x Step by Step Migration]]
  * [[https://www.akeeba.com/documentation/akeeba-backup-joomla/migrate-j3-to-j4.html|Akeeba: Joomla 3 to Joomla 4]]
  * [[https://github.com/akeeba/magiceraser/releases/tag/1.0.1|Akeeba Magic Eraser]]
  * [[https://manual.joomla.org/docs/building-extensions/modules/module-development-tutorial/step2-tmpl-file/|Module Development]]

===== Migration =====
==== Migrate J3.10 to J4.4.13 ====
This migration does not work under WSL, must execute on a live site\\
<color red>Check whether it's a file permission issue: [[web:eclipse#wsl_settings|WSL Settings]]</color>
  - Uninstall Akeeba Backup 8.4.1.1
  - Install Akeeba Magic Eraser - ignore all error messages
  - Install [[https://www.phoca.cz/download/68-phoca-download/4-phoca-download-component|Phoca Download]] 4.0.9 over 3.2.3
  - Disable Plugin "System - Kunena Forum"
  - Disable Plugin "System - Bethico"
  - Disable Plugin "System - Bethico System Plugin"
  - Disable Plugin "Quick Icon - Kunena Forum"
  - Go To "Components - Joomla Update" and do the Live Update
  - Install Akeeba Backup 10.0.3
  - Akeeba Backup configuration, then take a backup

==== Migrate J4.4.13 to J5.1.3 ====
This migration works under WSL
  - Start the update from Joomla's back-end
  - Make sure file permissions are enabled in [[web:eclipse#wsl_settings|WSL Settings]], otherwise it is not possible to install extensions
  - Update Plugin "System - Bethico"
  - Enable "Track Session Metadata" in Global Configuration -> System -> System

==== Bethicoleague Component ====
  - copy the following folders from "ipl" to "ipl4"
    * components/com_bethico
    * administrator/components/com_bethico
    * media/bethico
    * media/com_bethico

==== Bethicoleague Template ====
Abandon the bethicoleague template and integrate into cassiopeia, which will give us a much easier way to maintain the template.
  - create a child template for cassiopeia named ''cassiopeia_bethicoleague''
  - move Webmaster settings to new module
  - move "Login" from "Member Menu" to "Main Menu"
  - install ''plg_system_bethicofa'' first, then ''discover''
  - Menu Items: go to each ''Menu Item -> Link Type'' and set ''Link Icon Class'' and ''Display Menu Item Title''
  - move ''login disabled'' to module
  - updated plugin ''plg_system_bethicoFA''
  - strings in install package wrong for ''mod_bethico_switcher''

==== Kunena Forum ====
==== Phoca Download ====
==== Others ====