====== Leagues - 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]]
* [[https://downloads.joomla.org/language-packs/translations-joomla3/downloads/joomla-5---korean|Korean Language Pack for Version 5.0.2.1]]
===== Migration =====
==== Migrate v3.10 to v4.4.13 ====
This migration does not work under WSL, must execute on a live site\\
- Change ownership of all files to ''www-data:www-data''
- 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", click //Options// and select //Joomla Next// in //Update Channel//
- Go To "Components - Joomla Update" and do the Live Update to Joomla 4.4.14
- Install Akeeba Backup 10.0.3
- Akeeba Backup configuration, then take a backup
==== Migrate v4.4.13 to v5.1.3 (5.4.1) ====
This migration works under WSL
- Copy the backup of version 4.4.13 to a local folder, then unzip from within WSL (CLI) and change ownership to www-data
- Change ownership of this local folder to www-data and permissions to 0770
- 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
==== 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.
- click the ''cassiopeia'' template and create a child template for cassiopeia named ''bethicoleague'', this will create a child template named ''cassiopeia_bethicoleague''
- paths with modified files for template ''cassiopeia_bethicoleague'':/templates/cassiopeia_bethicoleague/
/media/templates/site/cassiopeia_bethicoleague/
/language/en-GB/tpl_cassiopeia_bethicoleague.ini
- move "Login" from "Member Menu" to "Main Menu"
- set //Layout// to //Collapsible Dropdown// in //System -> Site Modules -> Main Menu -> Advanced//
- install ''plg_system_bethicoFA''
- Menu Items: go to each //Menu Item -> Link Type// and set //Link Icon Class// to something like ''fas fa-home'' and set //Display Menu Item Title// to //yes//
- move ''login disabled'' to module
- strings in install package wrong for ''mod_bethico_switcher''
- move Webmaster settings to new module
==== Bethico Modules ====
=== Update and enable Modules ===
mod_bethico_cookie
=== Disable Modules===
==== Bethico Plugins ====
=== Update and enable Plugins ===
plg_system_bethicofa
=== Disable Plugins===
==== Kunena Forum ====
==== Phoca Download ====
==== Others ====