Joomla 1.5 to 2.5/3.x Migration

This PHP script assumes you have used the jUpgrade or SP Upgrade tool or similar to migrate from 1.5 to 2.5/3.x to preserve user ids.

  1. First update JEvents on source and target websites to the latest JEvents version, and back up both websites to be safe!
  2. Download the script from here and unzip.
    In phpMyAdmin or similar, remove all the Joomla 2.5/3.x jevents tables:
    • j25_jevents_categories
    • j25_jevents_exception
    • j25_jevents_catmap
    • j25_jevents_icsfile
    • j25_jevents_repbyday
    • j25_jevents_repetition
    • j25_jevents_rrule
    • j25_jevents_vevdetail
    • j25_jevents_vevent
    • j25_jev_defaults
    • j25_jev_users
  3. In phpMyAdmin or similar, add read permission for the Joomla 2.5/3.x database user to the Joomla 1.5 database (if a different database).
  4. Install the managed people, managed locations and any other jevents club addons (if you are using them) on your Joomla 2.5/3.x site.
  5. Edit the upgradejevents.php file and change line 11 to reflect the relative path of the destination website:
    e.g. if source is and destination is, amend line 11 to: define("NEWSITEPATH", "j25");
    e.g. if source is and destination is, amend line 11 to: define("NEWSITEPATH", "..");
  6. Upload the upgradejevents.php file to the root of your Joomla 1.5 installation.
  7. Log in to the backend of Joomla 2.5/3.x as a Super Admin.
  8. Run the script by calling it in your browser e.g.
  9. All being well the script will migrate the data, creating categories automatically with default permissions and show:
    • migrated categories
    • migrated main tables
    • updated category references
    • reset access levels
    • migrated user permissions
    • migrated categories
  10. Check your events and categories to see that they have migrated across correctly.
    You may need to set up JEvents configuration manually on the destination website as the script does not migrate configuration settings.

Please note that the database user for the Joomla 2.5/3.x site will need read access to the Joomla 1.5 site's database - so if your Joomla 2.5x3.x uses a different database to your Joomla 1.5 site you may need to check your database permissions.

NOTE: it's a good idea to install JEvents via the Joomla! Extension manager once the migration is finished, this will just make sure all the tables are installed and setup correctly.

Let us know how you get on in the forums.

  • Last Updated: Saturday, 16 December 2017