Difference between revisions of "X-Cart:New module initialization routine"

From X-Cart 4 Classic
Jump to: navigation, search
Line 1: Line 1:
The article will be added here
+
Since version 4.4.3, X-Cart has acquired a new module initialization routine, which improves the code and boosts the performance of the software. This article covers the most important facts about the new module initialization routine.
  
Source: https://bt.crtdev.local/view.php?id=109488#554085
+
==Why change the module initialization routine?==
  
==Зачем была изменена процедура инициализации модулей==
+
The module initialization routine was changed to optimize the code and improve the performance of X-Cart. On certain configurations, the improvement can give up 6-times increase in the operation performance.
==Как работает новая процедура инициализации модулей (в сравнении со старой)==
+
 
== Особенности апгрейда с версий 4.4.0.4.4.2 на версию 4.4.3 и старше, для случая, если установлены [http://www.x-cart.com/modules.html X-Cart add-on modules] или 3rd-party add-on modules==
+
==How the new module initialization routine is different from the old one?==
 +
 
 +
In the earlier versions (prior to 4.4.3) all the modules were initialized at the same time in <u>init.php</u>, where <u>config.php</u>, <u>func.php</u> and <u>init.php</u> were included for each module:
 +
 
 +
<source>
 +
if ($active_modules) {
 +
 
 +
foreach ($active_modules as $active_module => $tmp) {
 +
 
 +
$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . $active_module;
 +
$_config_file = $_module_dir . XC_DS . 'config.php';
 +
$_func_file = $_module_dir . XC_DS . 'func.php';
 +
 
 +
if (
 +
file_exists($_config_file)
 +
&& is_readable($_config_file)
 +
) {
 +
include $_config_file;
 +
}
 +
 
 +
if (
 +
file_exists($_func_file)
 +
&& is_readable($_func_file)
 +
) {
 +
include $_func_file;
 +
}
 +
 
 +
}
 +
 
 +
}
 +
</source>
 +
 
 +
Beginning with version 4.4.3, <u>config.php</u> is included for each module in <u>init.php</u>, just the way it has always been:
 +
 
 +
<source>
 +
if ($active_modules) {
 +
// Load functions for module (run include "modules/<module_name>/func.php")
 +
$include_func = true;
 +
 
 +
// Init modules (run include "modules/<module_name>/init.php")
 +
$include_init = true;
 +
 
 +
$_active_modules = $active_modules;
 +
foreach ($_active_modules as $active_module => $tmp) {
 +
 
 +
$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . $active_module;
 +
$_config_file = $_module_dir . XC_DS . 'config.php';
 +
 
 +
if (is_readable($_config_file)) {
 +
include $_config_file;
 +
}
 +
 
 +
}
 +
unset($include_func, $include_init, $_active_modules);
 +
}
 +
</source>
 +
 
 +
and the files <u>func.php</u> and <u>init.php</u> get included in the respective <u>config.php</u>, at the very end of the file, before the "?>" string. See, for example, the file <u>modules/Google_Checkout/config.php</u>:
 +
 
 +
<source>
 +
$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . 'Google_Checkout';
 +
/*
 +
Load module functions
 +
*/
 +
if (!empty($include_func))
 +
require_once $_module_dir . XC_DS . 'func.php';
 +
 
 +
/*
 +
Module initialization
 +
*/
 +
if (!empty($include_init))
 +
include $_module_dir . XC_DS . 'init.php';
 +
 
 +
?>
 +
</source>
 +
 
 +
Besides that, in 4.4.3 the routine sets the initialization order for the built-in modules in the file <u>include/data_cache.php</u>:
 +
 
 +
<source>
 +
/**
 +
* Sort active_modules according order to initialization
 +
*/
 +
function func_sort_active_modules($a, $b)
 +
{
 +
static $sort_order = array(
 +
'Amazon_Checkout' => 1, #can be unsetted in config/init.php
 +
'Flyout_Menus' => 1, #can be unsetted in config/init.php
 +
'Google_Checkout' => 1, #can be unsetted in config/init.php
 +
'Magnifier' => 1, #can be unsetted in config/init.php
 +
'Wishlist' => 11, #Gift_Registry depends on Wishlist
 +
'Gift_Registry' => 12, #can be unsetted in config/init.php
 +
'News_Management' => 31,
 +
'Survey' => 32,
 +
'Image_Verification' => 33,# Image_Verification depends on Survey/News_Management
 +
'Manufacturers' => 23,
 +
'XAffiliate' => 24, #XAffiliate depends on Manufacturers
 +
);
 +
$key_a = isset($sort_order[$a]) ? -$sort_order[$a] : -1000;
 +
$key_b = isset($sort_order[$b]) ? -$sort_order[$b] : -1001;
 +
return $key_b - $key_a;
 +
}
 +
</source>
 +
 
 +
The modules are initialized according to their order number, set for each module (see the above example).
 +
 
 +
When installing a new module, you need to define its initialization order, keeping in mind its dependence on other modules. Here are the guidelines for defining an order number:
 +
 
 +
* If the module depends on other modules, its order number must be greater than the order number of the module it depends on.
 +
 
 +
* If other modules depend on this module, its order number must be lesser than the order number of the module that depends on it.
 +
* If no other modules depend on this module, the module may have the greatest order number.
 +
* If the order number of the module is not set explicitly, it is assumed to be 1000.
 +
 
 +
'''Example.''' A new module initialization order:
 +
 
 +
<source>
 +
static $sort_order = array(
 +
'Amazon_Checkout' => 1, #can be unsetted in config/init.php
 +
'Flyout_Menus' => 1, #can be unsetted in config/init.php
 +
'Google_Checkout' => 1, #can be unsetted in config/init.php
 +
'Magnifier' => 1, #can be unsetted in config/init.php
 +
'Wishlist' => 11, #Gift_Registry depends on Wishlist
 +
'Gift_Registry' => 12, #can be unsetted in config/init.php
 +
'News_Management' => 31,
 +
'Survey' => 32,
 +
'Image_Verification' => 33,# Image_Verification depends on Survey/News_Management
 +
'Manufacturers' => 23,
 +
'3dPartyModule1' => 24,
 +
'XAffiliate' => 25, #XAffiliate depends on Manufacturers
 +
'3dPartyModule1' => 100,
 +
);
 +
</source>
 +
 
 +
This code means that:
 +
* 3dPartyModule1 depends on Manufacturers, and XAffiliate depends on 3dPartyModule1, thus 3dPartyModule1 will be initialized before Manufacturers and after XAffiliate.
 +
* 3dPartyModule2 will be initialized last for this array of modules.
 +
 
 +
== Peculiarities of upgrading from versions 4.4.0-4.4.2 to version 4.4.3 and newer with [http://www.x-cart.com/modules.html X-Cart add-on modules] or 3rd-party add-on modules installed==
 +
 
 +
{{Note|Attention users with upgrade packs 4.4.0/2->4.4.3 released until N June, 2011!
 +
 
 +
After upgrading from versions 4.4.0-4.4.2 to version 4.4.3, to eliminate the compatibility issue between the add-on modules and the new module initialization routine implemented in version, make sure to apply the patch [COMPATIBILITY_PATCH], which:
 +
 
 +
* Restores the old module initialization routine.
 +
* Adds a new option [OPTION NAME] to the admin area, which enables/disables the new module initialization routine; the option is disabled by default.}}
 +
func.<u>php</u>
 +
When upgrading from versions 4.4.0-4.4.2 to version 4.4.3 and newer, the program adds a new module initialization routine and a new option, "Use new module initialization routine" (disabled by default), which enables/disables this feature.
 +
 
 +
If prior to launching the upgrade your X-Cart had any [http://www.x-cart.com/modules.html add-on modules] or 3rd-party add-on modules installed, before enabling this option in the upgraded X-Cart, you need:
 +
 
 +
'''Option A.''' Install the new versions of the add-on modules, which match the version of the upgraded X-Cart and support the new module initialization routine.
 +
 
 +
{{Note1|<b>Notes:</b>
 +
 
 +
* To obtain the new version of an add-on module that support the new module initialization routine, please contact the add-on module vendor.
 +
 
 +
* After installing the add-on module, it may be necessary to re-implement the customizations made earlier over the add-on module's.}}
 +
 
 +
'''Option B.''' Bring the previously installed add-on modules to compliance with the new module initialization routine. To do so:
 +
 
 +
1. Edit <u>config.php</u> for the respective add-on module to include the required  and <u>init.php</u> according to the new module initialization routine.
 +
 
 +
2. Set the initialization order for the add-on module in <u>include/data_cache.php</u> (optional - required only if the add-on module uses other modules' functions/variables).
 +
 
 +
See examples of including files <u>func.php</u> and <u>init.php</u> for modules and setting module initialization order in section [[X-Cart:New_module_initialization_routine#|How the new module initialization routine is different from the old one]].
 +
 
 +
{{Note1|<b>Notes:</b>
 +
 
 +
* This option is not applicable to add-on modules with closed (encrypted) source code of <u>config.php</u>.
 +
 
 +
* Customizations made over the add-on module's files remain intact and, therefore, do not require re-implementation, which is the case when installing a new version of the add-on module.}}
 +
 
 +
{{Note1|<b>IMPORTANT!</b> If an upgraded X-Cart has add-on modules that do NOT support the new module initialization routine, it is recommended to keep this option DISABLED. In this case, the program will use the old module initialization routine.}}

Revision as of 17:04, 10 June 2011

Since version 4.4.3, X-Cart has acquired a new module initialization routine, which improves the code and boosts the performance of the software. This article covers the most important facts about the new module initialization routine.

Why change the module initialization routine?

The module initialization routine was changed to optimize the code and improve the performance of X-Cart. On certain configurations, the improvement can give up 6-times increase in the operation performance.

How the new module initialization routine is different from the old one?

In the earlier versions (prior to 4.4.3) all the modules were initialized at the same time in init.php, where config.php, func.php and init.php were included for each module:

if ($active_modules) {

foreach ($active_modules as $active_module => $tmp) {

$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . $active_module;
$_config_file = $_module_dir . XC_DS . 'config.php';
$_func_file = $_module_dir . XC_DS . 'func.php';

if (
file_exists($_config_file)
&& is_readable($_config_file)
) {
include $_config_file;
}

if (
file_exists($_func_file)
&& is_readable($_func_file)
) {
include $_func_file;
}

}

}

Beginning with version 4.4.3, config.php is included for each module in init.php, just the way it has always been:

if ($active_modules) {
// Load functions for module (run include "modules/<module_name>/func.php")
$include_func = true;

// Init modules (run include "modules/<module_name>/init.php")
$include_init = true;

$_active_modules = $active_modules;
foreach ($_active_modules as $active_module => $tmp) {

$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . $active_module;
$_config_file = $_module_dir . XC_DS . 'config.php';

if (is_readable($_config_file)) {
include $_config_file;
}

}
unset($include_func, $include_init, $_active_modules);
}

and the files func.php and init.php get included in the respective config.php, at the very end of the file, before the "?>" string. See, for example, the file modules/Google_Checkout/config.php:

$_module_dir = $xcart_dir . XC_DS . 'modules' . XC_DS . 'Google_Checkout';
/*
Load module functions
*/
if (!empty($include_func))
require_once $_module_dir . XC_DS . 'func.php';

/*
Module initialization
*/
if (!empty($include_init))
include $_module_dir . XC_DS . 'init.php';

?>

Besides that, in 4.4.3 the routine sets the initialization order for the built-in modules in the file include/data_cache.php:

/**
* Sort active_modules according order to initialization
*/
function func_sort_active_modules($a, $b)
{
static $sort_order = array(
'Amazon_Checkout' => 1, #can be unsetted in config/init.php
'Flyout_Menus' => 1, #can be unsetted in config/init.php
'Google_Checkout' => 1, #can be unsetted in config/init.php
'Magnifier' => 1, #can be unsetted in config/init.php
'Wishlist' => 11, #Gift_Registry depends on Wishlist
'Gift_Registry' => 12, #can be unsetted in config/init.php
'News_Management' => 31,
'Survey' => 32,
'Image_Verification' => 33,# Image_Verification depends on Survey/News_Management
'Manufacturers' => 23,
'XAffiliate' => 24, #XAffiliate depends on Manufacturers
);
$key_a = isset($sort_order[$a]) ? -$sort_order[$a] : -1000;
$key_b = isset($sort_order[$b]) ? -$sort_order[$b] : -1001;
return $key_b - $key_a;
}

The modules are initialized according to their order number, set for each module (see the above example).

When installing a new module, you need to define its initialization order, keeping in mind its dependence on other modules. Here are the guidelines for defining an order number:

  • If the module depends on other modules, its order number must be greater than the order number of the module it depends on.
  • If other modules depend on this module, its order number must be lesser than the order number of the module that depends on it.
  • If no other modules depend on this module, the module may have the greatest order number.
  • If the order number of the module is not set explicitly, it is assumed to be 1000.

Example. A new module initialization order:

static $sort_order = array(
'Amazon_Checkout' => 1, #can be unsetted in config/init.php
'Flyout_Menus' => 1, #can be unsetted in config/init.php
'Google_Checkout' => 1, #can be unsetted in config/init.php
'Magnifier' => 1, #can be unsetted in config/init.php
'Wishlist' => 11, #Gift_Registry depends on Wishlist
'Gift_Registry' => 12, #can be unsetted in config/init.php
'News_Management' => 31,
'Survey' => 32,
'Image_Verification' => 33,# Image_Verification depends on Survey/News_Management
'Manufacturers' => 23,
'3dPartyModule1' => 24,
'XAffiliate' => 25, #XAffiliate depends on Manufacturers
'3dPartyModule1' => 100,
);

This code means that:

  • 3dPartyModule1 depends on Manufacturers, and XAffiliate depends on 3dPartyModule1, thus 3dPartyModule1 will be initialized before Manufacturers and after XAffiliate.
  • 3dPartyModule2 will be initialized last for this array of modules.

Peculiarities of upgrading from versions 4.4.0-4.4.2 to version 4.4.3 and newer with X-Cart add-on modules or 3rd-party add-on modules installed

Note: Attention users with upgrade packs 4.4.0/2->4.4.3 released until N June, 2011!

After upgrading from versions 4.4.0-4.4.2 to version 4.4.3, to eliminate the compatibility issue between the add-on modules and the new module initialization routine implemented in version, make sure to apply the patch [COMPATIBILITY_PATCH], which:

  • Restores the old module initialization routine.
  • Adds a new option [OPTION NAME] to the admin area, which enables/disables the new module initialization routine; the option is disabled by default.

func.php When upgrading from versions 4.4.0-4.4.2 to version 4.4.3 and newer, the program adds a new module initialization routine and a new option, "Use new module initialization routine" (disabled by default), which enables/disables this feature.

If prior to launching the upgrade your X-Cart had any add-on modules or 3rd-party add-on modules installed, before enabling this option in the upgraded X-Cart, you need:

Option A. Install the new versions of the add-on modules, which match the version of the upgraded X-Cart and support the new module initialization routine.

Notes:
  • To obtain the new version of an add-on module that support the new module initialization routine, please contact the add-on module vendor.
  • After installing the add-on module, it may be necessary to re-implement the customizations made earlier over the add-on module's.

Option B. Bring the previously installed add-on modules to compliance with the new module initialization routine. To do so:

1. Edit config.php for the respective add-on module to include the required and init.php according to the new module initialization routine.

2. Set the initialization order for the add-on module in include/data_cache.php (optional - required only if the add-on module uses other modules' functions/variables).

See examples of including files func.php and init.php for modules and setting module initialization order in section How the new module initialization routine is different from the old one.

Notes:
  • This option is not applicable to add-on modules with closed (encrypted) source code of config.php.
  • Customizations made over the add-on module's files remain intact and, therefore, do not require re-implementation, which is the case when installing a new version of the add-on module.
IMPORTANT! If an upgraded X-Cart has add-on modules that do NOT support the new module initialization routine, it is recommended to keep this option DISABLED. In this case, the program will use the old module initialization routine.