Leagues - Migrate J3.10 to J4.x to J5.x
Important Read First
Migration
See 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
-
Disable Kunena Plugins
System - Kunena Forum
Quick Icon - Kunena Forum
Kunena - Joomla Integration
Kunena - Kunena Integration
Disable Bethico Plugins
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
WSL: Copy the backup of version 4.4.14 to a local folder, then unzip from within WSL (CLI) and change ownership to www-data
WSL: Change ownership of this local folder to www-data and permissions to 0770
Start the update from Joomla's back-end
WSL: Make sure file permissions are enabled in
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
Install Bethico League (com_bethicoleague) and save the options parameters
Install the Bethico League template (tpl_cassiopeia_bethicoleague)
Set module Bethico Legal to position <footer>
-
Install Bethico Languages (mod_bethico_languages) and enable for all pages
Install Bethico Legal (mod_bethico_legal)
Re-assign all menu items and move menu Member Menu → Login to Main Menu –> Login
Install BethicoFA (plg_system_bethicofa)
Install Joomill Custom Quick Icons for admin backend
Bethicoleague Component
copy the following folders from “ipl” to “ipl4”
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
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
/administrator/cache/autoload_psr4.php
Update and enable Modules
Disable Modules
Bethico Plugins
Update and enable Plugins
Disable Plugins
Kunena Forum
Phoca Download
Others