X-Cart:New module initialization routine - Revision history

Mouse at 13:34, 22 July 2020

2020-07-22T13:34:55Z

Dohtur at 14:07, 27 February 2019

2019-02-27T14:07:43Z

Seyfin: /* Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011 */

2011-06-22T22:12:45Z

‎Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011

Seyfin at 13:01, 22 June 2011

2011-06-22T13:01:27Z

Seyfin at 12:31, 22 June 2011

2011-06-22T12:31:51Z

Seyfin at 13:18, 21 June 2011

2011-06-21T13:18:12Z

Seyfin: /* How the new module initialization routine is different from the old one? */

2011-06-21T12:04:28Z

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

Admin: /* Overview */

2011-06-21T09:59:58Z

‎Overview

Seyfin: /* Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011 */

2011-06-17T09:23:53Z

‎Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011

Seyfin at 05:55, 17 June 2011

2011-06-17T05:55:46Z

@@ Line 148: / Line 148: @@
 * 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==
+==Peculiarities of upgrading from versions 4.4.0-4.4.2 to version 4.4.3 and newer with [https://www.x-cart.com/modules.html X-Cart add-on modules] or 3rd-party add-on modules installed==
 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 X-Cart add-on modules] or 3rd-party add-on modules installed, before enabling this option in the upgraded X-Cart, you need:
+If prior to launching the upgrade your X-Cart had any [https://www.x-cart.com/modules.html X-Cart 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.

@@ Line 223: / Line 223: @@
 See section [[X-Cart:New_module_initialization_routine#Attention_users_who_use_regular_4.4.3_install.2C_or_upgrade_their_install_using_upgrade_packs_4.4.0.2F2-.3E4.4.3_released_until_10_June.2C_2011 | "Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011"]] for more information about the patches.
-[[Category:X-Cart developer guide]]
-[[Category:X-Cart modules]]
-[[Category:X-Cart developer guide]]
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]

@@ Line 186: / Line 186: @@
 To eliminate the compatibility issue between the add-on modules and the new module initialization routine implemented in 4.4.3 version, make sure to apply the [[X-Cart:New_module_initialization_routine#Patches_for_4.4.3 | patches]], which:
-* Restore the old module initialization routine, as an alternative to the new one.
+* Restore the old module initialization routine, which was removed from 4.4.3 and replaced with the new one.
 * Add a new option "Use new module initialization routine" to the admin area, which enables/disables the new module initialization routine; the option is disabled by default.

@@ Line 176: / Line 176: @@
 * 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 (Option A).}}
-{{Note1|<b>IMPORTANT!</b> If an upgraded X-Cart has any add-on modules that do NOT support the new module initialization routine, it is recommended to keep the option "Use new module initialization routine" DISABLED. When disabled, the program will use the old module initialization routine.}}
+{{Note1|<b>IMPORTANT!</b> If an upgraded X-Cart has ANY add-on modules that do NOT support the new module initialization routine, it is recommended to keep the option "Use new module initialization routine" DISABLED. When disabled, the program will use the old module initialization routine.
 ==Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011==
@@ Line 194: / Line 197: @@
 * [[X-Cart:Applying_Patches#Applying_SQL_Patches | Applying SQL Patches]]
 * [[X-Cart:FAQs#How_to_install_patches.3F | How to install patches]]
 }}
@@ Line 213: / Line 221: @@
 * <tt>[[File:Patch_add_new_module_initialization443.sql]]</tt>
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]
@@ Line 230: / Line 256: @@
 [[Category:X-Cart modules]]
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]

@@ Line 60: / Line 60: @@
 ==What is the new module initialization routine?==
-With the new module initialization routine, each module's <u>config.php</u> is included in <u><xcart_dir>/init.php</u>, just the way it has always been. And each module's files <u>func.php</u> and <u>init.php</u> get included in the respective module's file <u>config.php</u>, at the very end of the file, just before the "?>" string. See, for example, the file <u>modules/Google_Checkout/config.php</u>:
+With the new module initialization routine, each module's <u>config.php</u> is included in <u><xcart_dir>/init.php</u>, just [[X-Cart:New_module_initialization_routine#What_is_the_old_module_initialization_routine.3F | the way it has always been]]. And each module's files <u>func.php</u> and <u>init.php</u> get included in the respective module's file <u>config.php</u>, at the very end of the file, just before the "?>" string. See, for example, the file <u>modules/Google_Checkout/config.php</u>:
 <source>
@@ Line 181: / Line 181: @@
 {{Note1|<b>IMPORTANT!</b>
-To eliminate the compatibility issue between the add-on modules and the new module initialization routine implemented in 4.4.3 version, make sure to apply the patches (<tt>[[File:Patch_add_new_module_initialization443.diff]]</tt> and <tt>[[File:Patch_add_new_module_initialization443.sql]]</tt>), which:
+To eliminate the compatibility issue between the add-on modules and the new module initialization routine implemented in 4.4.3 version, make sure to apply the [[X-Cart:New_module_initialization_routine#Patches_for_4.4.3 | patches]], which:
 * Restore the old module initialization routine, as an alternative to the new one.
@@ Line 196: / Line 196: @@
 }}
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]
@@ Line 205: / Line 230: @@
 [[Category:X-Cart modules]]
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]

@@ Line 7: / Line 7: @@
 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 old module initialization routine works?==
+==What is the old module initialization routine?==
 In the earlier versions (prior to 4.4.3) all the modules were initialized at the same time in <u><xcart_dir>/init.php</u> (<u>config.php</u>, <u>func.php</u> and <u>init.php</u> for each module were included in <u><xcart_dir>/init.php</u>):
@@ Line 58: / Line 58: @@
 </source>
-==How the new module initialization routine works?==
+==What is the new module initialization routine?==
-Beginning with version 4.4.3, each module's <u>config.php</u> is included in <u><xcart_dir>/init.php</u>, just the way it has always been:
+With the new module initialization routine, each module's <u>config.php</u> is included in <u><xcart_dir>/init.php</u>, just the way it has always been. And each module's files <u>func.php</u> and <u>init.php</u> get included in the respective module's file <u>config.php</u>, at the very end of the file, just before the "?>" string. See, for example, the file <u>modules/Google_Checkout/config.php</u>:
 <source>
@@ Line 104: / Line 79: @@
 </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>:
+Besides that, the new routine sets the initialization order for the built-in modules in the file <u>include/data_cache.php</u>:
 <source>
@@ Line 193: / Line 168: @@
 . 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.3F|"How the new module initialization routine is different from the old one"]].
+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#What_is_the_new_module_initialization_routine.3F|"What is the new module initialization routine?"]].
 {{Note1|<b>Notes:</b>
@@ Line 201: / Line 176: @@
 * 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 (Option A).}}
-{{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 the option "Use new module initialization routine" DISABLED. When disabled, the program will use the old module initialization routine.}}
+{{Note1|<b>IMPORTANT!</b> If an upgraded X-Cart has any add-on modules that do NOT support the new module initialization routine, it is recommended to keep the option "Use new module initialization routine" DISABLED. When disabled, the program will use the old module initialization routine.}}
 ==Attention users who use regular 4.4.3 install, or upgrade their install using upgrade packs 4.4.0/2->4.4.3 released until 10 June, 2011==
@@ Line 221: / Line 196: @@
 }}
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]
@@ Line 226: / Line 205: @@
 [[Category:X-Cart modules]]
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]
 [[Category:X-Cart developer guide]]
 [[Category:X-Cart modules]]

@@ Line 1: / Line 1: @@
 ==Overview==
-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.
+A new module initialization routine was introduced in X-Cart 4.4.3, which improves the code and boosts the performance. This article covers the most important facts about the new module initialization routine.
 ==Why change the module initialization routine?==

← Older revision		Revision as of 05:55, 17 June 2011
Line 216:		Line 216:
	* [[X-Cart:FAQs#How_to_install_patches.3F \| How to install patches]]		* [[X-Cart:FAQs#How_to_install_patches.3F \| How to install patches]]
	}}		}}
		+
		+	[[Category:X-Cart developer guide]]
		+	[[Category:X-Cart modules]]
		+
		+	[[Category:X-Cart developer guide]]
		+	[[Category:X-Cart modules]]