====== 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]]
  * [[https://gist.github.com/rsenden/7bc96a3e678b60e61c750517ca8de883|Eclipse on WSL]]

===== Migration =====

See [[joomla:reverseproxy|Reverse Proxy]] for guidance on how to set up a site behind a reverse proxy.
==== Migrate v3.10 to v4.4.14 ====
This migration does not work under WSL or behind a reverse proxy. Joomla 3.10 and Joomla 4 handle reverse proxies differently.

=== Do the following steps on your original Joomla 3.10 installation running php 8.1 ===
  - Change ownership of all files to ''www-data:www-data''
  - Uninstall **SP Upgrade**
  - 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 Kunena Plugins
    * System - Kunena Forum
    * Quick Icon - Kunena Forum
    * Kunena - Joomla Integration
    * Kunena - Kunena Integration
  - Disable Bethico Plugins
    * System - Bethico
    * System - Bethico System Plugin
  - Go To **Components -> Joomla Update**, click //Options// and select //Joomla Next// in //Update Channel//
  - Go To **Components -> Joomla Update**, download the update file, then select tab //Upload & Update// and select the Update-file to Joomla 4.4.14. The files update fast and the progress bar adavances to 90.8%, but the database update might take several minutes to complete.
  - Install **Akeeba Backup** 10.3.3
  - Akeeba Backup configuration, then take a backup

==== Migrate v4.4.14 to v5.4.5 ====
This migration works under WSL and behind a reverse proxy

=== Do the following steps on your existing or new server running php 8.1 or php 8.4 ===
  - <color red>WSL</color>: Copy the backup of version 4.4.14 to a local folder, then unzip from within WSL (CLI) and change ownership to www-data
  - <color red>WSL</color>: Change ownership of this local folder to www-data and permissions to 0770
  - Start the update from Joomla's back-end
  - <color red>WSL</color>: 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
  - Uninstall component **Bethico League**
  - Uninstall template **bethicoleague**
  - Manually remove folder ''/media/bethico'' and ''/media/com_bethico''
  - Manually remove files ''/language/en-GB/en-GB.tpl_bethico.ini''
  - Rename ''/images/bethico'' to ''/images/bethicoleague''

==== Settings for v5.4.5 ====
  - Set module **Bethico Legal** to position <footer>

==== 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'':<file>/templates/cassiopeia_bethicoleague/
/media/templates/site/cassiopeia_bethicoleague/
/language/en-GB/tpl_cassiopeia_bethicoleague.ini</file>
  - 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 ====
=== Development ===
  * If you did not install the new version of the module with updated manifest file you need to add the autoloader path manually to<code>/administrator/cache/autoload_psr4.php</code>
=== Update and enable Modules ===
<code>
mod_bethico_cookie
</code>
=== Disable Modules===
<code>
</code>
==== Bethico Plugins ====
=== Update and enable Plugins ===
<code>
plg_system_bethicofa
</code>
=== Disable Plugins===
<code>
</code>
==== Kunena Forum ====
==== Phoca Download ====
==== Others ====