Guide to Upgrade the Mobile extension from 2.x to 3.x

Tuesday, 15 November 2022 15:27

1. Check that your server matches the minimal requirements: Joomla! 2.5 and PHP 5.6.

2. Don't forget to make a backup and, if possible, test on a copy of your website.

3. Note that the Mobile extension has been split into Mobile and Adaptive packages (the former is used for page speed optimization, caching and PWA support, and the latter is used for device detection and template switching). That's why three packages should be installed:

3.1. Install Mobile 3.x or Mobile Pro 3.x package (depending on your subscription). If you have active Mobile 2.x Pro/Club subscription, you can upgrade to Mobile 3.x for free.

3.2. Install Mobile Adaptive 3.x package.

3.3. Install mobile template adopted for Mobile 3.x:

• Mobile Basic 3.x (free)
• Mobile Elegance 3.x
• Mobile Flat 3.x
• Mobile Square 3.x
• Mobile Cupertino 3.x (formerly named Mobile iOS9, so don't forget to set this template in the Adaptive settings instead of Mobile_iOS9)

Note that if you are also upgrading Joomla (e.g. 3.x to 4.x), it's recommended to uninstall the old mobile template and then install the new version after Joomla has been upgraded.

4. To activate Mobile Pro, open Settings page, enter your API key from Account page, and save changes.