XOOPSCubeLegacy​/HowToUpgrade​/FromAlpha

STEP 1 Preparation

There is no need for any preparation in this procedure.

STEP 2 Close site

1. Select 'default' theme. And, disable selectable themes.
2. Change the debug mode to PHP debug mode.
3. Close your site, but the administrator keeps to access.
4. Disable and uninstall base and user module as the following.

1) Turn off the active value of Legacy and User module in the module management.

2) Then, you'll be forwarded to the 2nd installer. But, you have not completed uninstalling yet. Uninstall two modules completely. Click each 'Uninstall' links.

STEP 3 File replace

1. Delete all of files, except mainfile.php and the following directories:

• • images
  • themes
  • uploads
  • modules
  • preload
  • your XOOPS_TRUST_PATH (if existing)

1. Delete the following modules:

• • base
  • user
  • legacyRender
  • pm
  • stdCache

1. Overwrite with the package.

STEP 4 Upgrade

• Patch your mainfile.php.

How to patch your mainfile.php? It's very easy. Modify your mainfile.php as the following with a text editor like notepad.

From:
if (!isset($xoopsOption['nocommon']) && XOOPS_ROOT_PATH != '') {
  include XOOPS_ROOT_PATH."/include/common.php";
}

To:
if (!defined('_LEGACY_PREVENT_LOAD_CORE_') && XOOPS_ROOT_PATH != '') {
  @include_once XOOPS_ROOT_PATH."/include/cubecore_init.php";
  if (!isset($xoopsOption['nocommon']) && !defined('_LEGACY_PREVENT_EXEC_COMMON_')) {
    include XOOPS_ROOT_PATH."/include/common.php";
  }
}

If you use XOOPS Protector, you have to adjust your mainfile.php more. Read 'About mainfile.php' of this document.

• Go to your Homepage and install required modules in the automatically started 2nd installer.
• Delete cache files in the folder template_c.
• Go to the module management, and update all of your modules.

STEP 5 Open site

1. Open your site.
2. After you have finished checking everything, change the debug mode to OFF.