* -------------------------------------------------------------------- *
* Kurzbeschreibung : Erweiterungen-Management *
* -------------------------------------------------------------------- *
- * *
+ * $Revision:: $ *
+ * $Date:: $ *
+ * $Tag:: 0.2.1-FINAL $ *
+ * $Author:: $ *
+ * Needs to be in all Files and every File needs "svn propset *
+ * svn:keywords Date Revision" (autoprobset!) at least!!!!!! *
* -------------------------------------------------------------------- *
* Copyright (c) 2003 - 2008 by Roland Haeder *
* For more information visit: http://www.mxchange.org *
// Load the extension and maybe found language and function files.
function LOAD_EXTENSION ($ext_name, $EXT_LOAD_MODE = "", $EXT_VER = "", $dry_run = false) {
- global $INC_POOL;
-
// Init array
- $INC_POOL = array();
+ INIT_INC_POOL();
+
+ // Set current extension name
+ EXT_SET_CURR_NAME($ext_name);
+
+ // Init EXT_UPDATE_DEPENDS
+ EXT_INIT_UPDATE_DEPENDS();
+
+ // Init current extension name list
+ INIT_EXT_SQLS();
// Is the extension already loaded?
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "Loading extension {$ext_name}, mode={$EXT_LOAD_MODE}, ver={$EXT_VER}.");
return false;
} // END - if
- // Construct FQFN for extension file
- $FQFN = sprintf("%sinc/extensions/ext-%s.php",
- constant('PATH'),
- $ext_name
- );
+ // Construct include filename and FQFN for extension file
+ $INC = sprintf("inc/extensions/ext-%s.php", $ext_name);
+ $FQFN = constant('PATH') . $INC;
// Is the extension file NOT there?
- if (!FILE_READABLE($FQFN)) {
+ if (!INCLUDE_READABLE($INC)) {
// Debug message
DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Extension %s not found.", $ext_name));
// Extensions are not always active by default
EXT_SET_ALWAYS_ACTIVE("N");
- // By default an extension update does not depend on other extensions
- EXT_SET_UPDATE_DEPENDS("");
-
// Extension update notes
EXT_SET_UPDATE_NOTES("");
// Include the extension file
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "Extension loaded.");
- require_once($FQFN);
+ require($FQFN);
// Is this extension deprecated?
if (EXT_GET_DEPRECATED() == "Y") {
}
// Registeres an extension and possible update depencies
-function EXTENSION_REGISTER ($ext_name, $task_id, $dry_run = false, $logout = true) {
- global $INC_POOL;
- global $NOTES;
-
+function REGISTER_EXTENSION ($ext_name, $task_id, $dry_run = false, $logout = true) {
// This shall never do a non-admin user!
if (!IS_ADMIN()) return false;
// Is this extension already installed?
if (EXT_IS_ACTIVE($ext_name)) return false;
- // Init queries
- INIT_SQLS();
+ // Set current extension name
+ EXT_SET_CURR_NAME($ext_name);
+
+ // Init EXT_UPDATE_DEPENDS
+ EXT_INIT_UPDATE_DEPENDS();
+
+ // Is the task id zero? Then we need to auto-fix it here
+ if ($task_id == 0) {
+ // Try to find the task
+ $task_id = DETERMINE_EXTENSION_TASK_ID(EXT_GET_CURR_NAME());
+
+ // Still zero and not in dry-run?
+ if (($task_id == 0) && (!$dry_run)) {
+ // Then request a bug report
+ debug_report_bug(sprintf("%s: task_id is still zero after DETERMINE_EXTENSION_TASK_ID(%s)",
+ __FUNCTION__,
+ EXT_GET_CURR_NAME()
+ ));
+ } // END - if
+ } // END - if
+
+ // Init queries and notes
+ INIT_EXT_SQLS();
+ EXT_INIT_NOTES();
// Init variables
$ret = false;
- $NOTES = "";
- $INC_POOL = array();
+ $test = false;
+ INIT_INC_POOL();
// By default we have no failures
EXT_SET_REPORTS_FAILURE(false);
// Does this extension exists?
- if (LOAD_EXTENSION($ext_name, "register", "", $dry_run)) {
+ //* DEBUG: */ print __LINE__.":".EXT_GET_CURR_NAME()."<br />\n";
+ if (LOAD_EXTENSION(EXT_GET_CURR_NAME(), "register", "", $dry_run)) {
// And run possible updates
+ //* DEBUG: */ print __LINE__.":".EXT_GET_CURR_NAME()."<br />\n";
$history = EXT_GET_VER_HISTORY();
foreach ($history as $ver) {
- //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "ext_name={$ext_name}, ext_ver={$ver}");
+ //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "ext_name={EXT_GET_CURR_NAME()}, ext_ver={$ver}");
// Load extension in update mode
- LOAD_EXTENSION($ext_name, "update", $ver, $dry_run);
+ LOAD_EXTENSION(EXT_GET_CURR_NAME(), "update", $ver, $dry_run);
// Add update notes to our output
- $NOTES .= ADD_EXTENSION_NOTES($ver);
+ ADD_EXTENSION_NOTES($ver);
} // END - foreach
// Does this extension depends on an outstanding update of another update?
- if (EXT_GET_UPDATE_DEPENDS() != "") {
- // Backup SQL commands and clear current
- $SQLs2 = GET_SQLS();
- INIT_SQLS();
- $test = false;
- $ext_update = EXT_GET_UPDATE_DEPENDS();
+ for ($dmy = EXT_GET_UPDATE_ITERATOR(); EXT_GET_UPDATE_ITERATOR() < EXT_COUNT_UPDATE_DEPENDS();) {
+ // Get next update
+ $ext_update = EXT_GET_ITERATOR_UPDATE_DEPENDS();
+
+ // Increment here to avoid endless loop
+ EXT_INCREMENT_UPDATE_INTERATOR();
// Check for required file
if (LOAD_EXTENSION($ext_update, "register", "", $dry_run)) {
// Entry found?
if ($task > 0) {
// Try to register the extension
- $test = EXTENSION_REGISTER($ext_update, $task, $dry_run, false);
+ //* DEBUG: */ print __LINE__.sprintf(":ext_update=%s,task=%s<br />\n", $ext_update, $task);
+ $test = REGISTER_EXTENSION($ext_update, $task, $dry_run, false);
+ //* DEBUG: */ var_dump($test);
} // END - if
} elseif ($ext_ver != EXT_GET_VERSION()) {
// Ok, update this extension now
// But this is fine for the first time...
}
- // Finally restore previous SQLs
- SET_SQLS($SQLs2); unset($SQLs2);
- } else {
- // Does not depend on an other extension
+ // Restore the current extension name
+ EXT_SET_CURR_NAME($ext_name);
+ } // END - for
+
+ // Is there no update?
+ if (EXT_COUNT_UPDATE_DEPENDS(EXT_GET_CURR_NAME()) == 0) {
+ // Then test is passed!
$test = true;
- }
+ } // END - if
// Switch back to register mode
$EXT_LOAD_MODE = "register";
// Remains true if extension registration reports no failures
+ //* DEBUG: */ print __LINE__.":".EXT_GET_CURR_NAME();
+ //* DEBUG: */ var_dump($test);
$test = (($test === true) && (EXT_GET_REPORTS_FAILURE() === false));
+ //* DEBUG: */ var_dump($test);
// Does everthing before wents ok?
- if ($test) {
+ if ($test === true) {
// "Dry-run-mode" activated?
- if (!$dry_run) {
+ if ((!$dry_run) && (!EXT_IS_ON_REMOVAL_LIST())) {
+ //* DEBUG: */ print __LINE__.": ext_name=".EXT_GET_CURR_NAME()."<br />\n";
+ // Init SQLs and transfer ext->generic
+ INIT_SQLS();
+ SET_SQLS(GET_EXT_SQLS());
+
// Run installation pre-installation filters
runFilterChain('pre_extension_installed', array('dry_run' => $dry_run));
// Register extension
SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_extensions` (ext_name, ext_active, ext_version) VALUES ('%s','%s','%s')",
- array($ext_name, EXT_GET_ALWAYS_ACTIVE(), EXT_GET_VERSION()), __FILE__, __LINE__);
+ array(EXT_GET_CURR_NAME(), EXT_GET_ALWAYS_ACTIVE(), EXT_GET_VERSION()), __FILE__, __LINE__);
// Remove cache file(s) if extension is active
- runFilterChain('post_extension_installed', array('ext_name' => $ext_name, 'task_id' => $task_id, 'inc_pool' => $INC_POOL));
+ runFilterChain('post_extension_installed', array('ext_name' => EXT_GET_CURR_NAME(), 'task_id' => $task_id));
+
+ // Remove all SQL commands
+ UNSET_SQLS();
// In normal mode return a true on success
$ret = true;
- } else {
- // Rewrite SQL command to keep { and } inside
+ } elseif ($dry_run) {
+ // Init SQLs and transfer ext->generic
+ INIT_SQLS();
+ SET_SQLS(GET_EXT_SQLS());
+
+ // Rewrite SQL command to keep { and } inside for dry-run
foreach (GET_SQLS() as $key => $sql) {
$sql = str_replace('{', "{", str_replace('}', "}", $sql));
SET_SQL_KEY($key, $sql);
// Remove all SQL commands
UNSET_SQLS();
+ } else {
+ // Extension has been removed for updates, so all is fine!
+ $ret = true;
}
} else {
// No, an error occurs while registering extension :-(
+ //* DEBUG: */ print __LINE__.":".EXT_GET_CURR_NAME()."<br />\n";
$ret = false;
}
- } elseif (($task_id > 0) && (!empty($ext_name))) {
+ } elseif (($task_id > 0) && (EXT_GET_CURR_NAME() != "")) {
// Remove task from system when id and extension's name is valid
SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{!_MYSQL_PREFIX!}_task_system` WHERE id=%s AND `status`='NEW' LIMIT 1",
array(bigintval($task_id)), __FILE__, __LINE__);
}
// Is this the sql_patches?
- //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ":{$ext_name}/{$EXT_LOAD_MODE}");
- if (($ext_name == "sql_patches") && (($EXT_LOAD_MODE == "register") || ($EXT_LOAD_MODE == "remove")) && (!$dry_run) && ($test)) {
+ //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ":{EXT_GET_CURR_NAME()}/{$EXT_LOAD_MODE}");
+ if ((EXT_GET_CURR_NAME() == "sql_patches") && (($EXT_LOAD_MODE == "register") || ($EXT_LOAD_MODE == "remove")) && (!$dry_run) && ($test)) {
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ": LOAD!");
if ($logout === true) {
// Then redirect to logout
// This shall never do a non-admin user!
if (!IS_ADMIN()) return false;
+ // Get extension's name
+ $ext_name = GET_EXT_NAME($ext_id);
+
+ // If it is not set then maybe there is no extension for that ID number
+ if ($ext_name == "") return false;
+
+ // Set current SQL name
+ EXT_SET_CURR_NAME($ext_name);
+
+ // Init EXT_UPDATE_DEPENDS
+ EXT_INIT_UPDATE_DEPENDS();
+
// Init array
- INIT_SQLS();
+ INIT_EXT_SQLS();
// By default no SQL has been executed
$sqlRan = false;
- // Get extension's name
- $ext_name = GET_EXT_NAME($ext_id);
- // If it is not set then maybe there is no extension for that ID number
- if (empty($ext_name)) return false;
-
// Load extension in detected mode
- //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ":ext_name[{$ext_id}]={$ext_name}");
- LOAD_EXTENSION($ext_name, $load_mode, "", false);
+ //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ":ext_name[{$ext_id}]={EXT_GET_CURR_NAME()}");
+ LOAD_EXTENSION(EXT_GET_CURR_NAME(), $load_mode, "", false);
+
+ // Init these SQLs
+ INIT_SQLS();
+ SET_SQLS(GET_EXT_SQLS());
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ":SQLs::count=".COUNT_SQLS()."");
if ((IS_SQLS_VALID() && (COUNT_SQLS() > 0))) {
if ($load_mode == "remove") {
// Delete this extension (remember to remove it from your server *before* you click on welcome!
SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{!_MYSQL_PREFIX!}_extensions` WHERE ext_name='%s' LIMIT 1",
- array($ext_name), __FILE__, __LINE__);
+ array(EXT_GET_CURR_NAME()), __FILE__, __LINE__);
} // END - if
} // END - if
// Remove cache file(s) if extension is active
if (((EXT_IS_ACTIVE("cache")) || (GET_EXT_VERSION("cache") != "")) && (((SQL_AFFECTEDROWS() == 1)) || ($sqlRan === true) || ($load_mode == "activate") || ($load_mode == "deactivate"))) {
// Run filters
- runFilterChain('post_extension_run_sql', $ext_name);
+ runFilterChain('post_extension_run_sql', EXT_GET_CURR_NAME());
} // END - if
// Is this the sql_patches?
- //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ": {$ext_id}/{$ext_name}/{$load_mode}");
- if (($ext_name == "sql_patches") && (($load_mode == "register") || ($load_mode == "remove"))) {
+ //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ": {$ext_id}/{EXT_GET_CURR_NAME()}/{$load_mode}");
+ if ((EXT_GET_CURR_NAME() == "sql_patches") && (($load_mode == "register") || ($load_mode == "remove"))) {
// Then redirect to logout
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ": LOAD!");
LOAD_URL("modules.php?module=admin&logout=1&".$load_mode."=sql_patches");
// Count cache hits
incrementConfigEntry('cache_hits');
} elseif (isset($GLOBALS['ext_loaded'][$ext_name])) {
- // Extension is loaded!
- die("LOADED:$ext_name");
+ // @TODO Extension is loaded, what next?
+ mxchange_die("LOADED:$ext_name");
} elseif (($ext_name == "cache") || (GET_EXT_VERSION("cache") == "")) {
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "DB! ext_name={$ext_name}");
// Load from database
SQL_FREERESULT($result);
// Write cache array
- //* DEBUG: */ echo $ext_name."[DB]: {$active}");
+ //* DEBUG: */ echo $ext_name."[DB]: {$active}<br />\n";
$GLOBALS['cache_array']['extensions']['ext_active'][$ext_name] = $active;
} else {
// Extension not active!
- //* DEBUG: */ echo $ext_name.": Not active!");
+ //* DEBUG: */ echo $ext_name.": Not active!<br />\n";
$GLOBALS['cache_array']['extensions']['ext_active'][$ext_name] = "N";
}
// By default no extension is found
$ext_ver = false;
+ // Empty extension name should be fixed!
+ if (empty($ext_name)) {
+ // Please report this bug!
+ debug_report_bug(__FUNCTION__.": ext_name is empty which is not allowed here.");
+ } // END - if
+
// Extensions are all inactive during installation
if ((!isInstalled()) || (isInstalling())) return "";
//* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, ": ext_name={$ext_name}");
// Updates a given extension with current extension version to latest version
function EXTENSION_UPDATE ($ext_name, $ext_ver, $dry_run = false) {
- // This shall never do a non-admin user!
- global $NOTES;
- global $INC_POOL;
-
- // Init arrays
- INIT_SQLS();
- $INC_POOL = array();
-
- // Init notes
- $NOTES = "";
-
// Only admins are allowed to update extensions
if ((!IS_ADMIN()) || (empty($ext_name))) return false;
+ // Set current SQL name
+ EXT_SET_CURR_NAME($ext_name);
+
+ // Init arrays
+ INIT_EXT_SQLS();
+ EXT_INIT_NOTES();
+ INIT_INC_POOL();
+
// Load extension in test mode
LOAD_EXTENSION($ext_name, "test", $ext_ver, $dry_run);
$history = EXT_GET_VER_HISTORY();
// Remove old SQLs array to prevent possible bugs
- INIT_SQLS();
+ INIT_EXT_SQLS();
// Check if version is updated
if (((EXT_GET_VERSION() != $ext_ver) || ($dry_run)) && (is_array($history))) {
$start = array_search($ext_ver, $history);
// And load SQL queries in order of version history
- for ($idx = ($start + 1); $idx < sizeof($history); $idx++) {
+ for ($idx = ($start + 1); $idx < count($history); $idx++) {
// Set extension version
- $GLOBALS['cache_array']['update_ver'][$ext_name] = $history[$idx];
+ $GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()] = $history[$idx];
// Load again...
- LOAD_EXTENSION($ext_name, "update", $GLOBALS['cache_array']['update_ver'][$ext_name], $dry_run);
+ LOAD_EXTENSION(EXT_GET_CURR_NAME(), "update", $GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()], $dry_run);
if (EXT_GET_UPDATE_DEPENDS() != "") {
- // Backup current SQL queries
- $GLOBALS['cache_array']['update_sqls'][$ext_name] = GET_SQLS();
-
// Is the extension there?
if (GET_EXT_VERSION(EXT_GET_UPDATE_DEPENDS()) != "") {
// Update another extension first!
$test = EXTENSION_UPDATE(EXT_GET_UPDATE_DEPENDS(), GET_EXT_VERSION(EXT_GET_UPDATE_DEPENDS()), $dry_run);
} else {
// Register new extension
- $test = EXTENSION_REGISTER(EXT_GET_UPDATE_DEPENDS(), 0, $dry_run, false);
+ $test = REGISTER_EXTENSION(EXT_GET_UPDATE_DEPENDS(), 0, $dry_run, false);
}
-
- // Restore previous SQL queries
- SET_SQLS($GLOBALS['cache_array']['update_sqls'][$ext_name]);
- unset($GLOBALS['cache_array']['update_sqls'][$ext_name]);
} // END - if
// Add notes
- $NOTES .= ADD_EXTENSION_NOTES($GLOBALS['cache_array']['update_ver'][$ext_name]);
+ ADD_EXTENSION_NOTES($GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()]);
} // END - for
// In real-mode execute any existing includes
if (!$dry_run) {
- $GLOBALS['cache_array']['inc_pool'][$ext_name] = $INC_POOL;
- runFilterChain('load_includes', $INC_POOL);
- $INC_POOL = $GLOBALS['cache_array']['inc_pool'][$ext_name];
- unset($GLOBALS['cache_array']['inc_pool'][$ext_name]);
+ $GLOBALS['cache_array']['inc_pool'][EXT_GET_CURR_NAME()] = GET_INC_POOL();
+ runFilterChain('load_includes');
+ SET_INC_POOL($GLOBALS['cache_array']['inc_pool'][EXT_GET_CURR_NAME()]);
+ unset($GLOBALS['cache_array']['inc_pool'][EXT_GET_CURR_NAME()]);
} // END - if
+ // Init these SQLs
+ INIT_SQLS();
+ SET_SQLS(GET_EXT_SQLS());
+
// Run SQLs
runFilterChain('run_sqls', array('dry_run' => $dry_run));
if (!$dry_run) {
// Create task
- CREATE_EXTENSION_UPDATE_TASK(GET_CURRENT_ADMIN_ID(), $ext_name, $GLOBALS['cache_array']['update_ver'][$ext_name], SQL_ESCAPE($NOTES));
+ CREATE_EXTENSION_UPDATE_TASK(GET_CURRENT_ADMIN_ID(), EXT_GET_CURR_NAME(), $GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()], SQL_ESCAPE(EXT_GET_NOTES(EXT_GET_NOTES())));
// Update extension's version
SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_extensions` SET ext_version='%s' WHERE ext_name='%s' LIMIT 1",
- array($GLOBALS['cache_array']['update_ver'][$ext_name], $ext_name), __FILE__, __LINE__);
+ array($GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()], EXT_GET_CURR_NAME()), __FILE__, __LINE__);
// Remove arrays
UNSET_SQLS();
- unset($GLOBALS['cache_array']['update_ver'][$ext_name]);
+ unset($GLOBALS['cache_array']['update_ver'][EXT_GET_CURR_NAME()]);
// Run filters on success extension update
- runFilterChain('extension_update', $ext_name);
+ runFilterChain('extension_update', EXT_GET_CURR_NAME());
} // END - if
} // END - if
}
'ver' => $ver,
'notes' => EXT_GET_UPDATE_NOTES()
);
+
+ // Reset them
EXT_SET_UPDATE_NOTES("");
} elseif (($ver == "0.0") || ($ver == "0.0.0")) {
// Initial release
$out = LOAD_TEMPLATE("admin_ext_notes", true, $content);
} // END - if
- // Return the output
- return $out;
+ // Add the notes
+ EXT_APPEND_NOTES($out);
}
// Getter for CSS files array
// Setter for EXT_ALWAYS_ACTIVE flag
function EXT_SET_ALWAYS_ACTIVE ($active) {
- $GLOBALS['ext_always_active'] = $active;
+ $GLOBALS['ext_always_active'][EXT_GET_CURR_NAME()] = (string) $active;
}
// Getter for EXT_ALWAYS_ACTIVE flag
function EXT_GET_ALWAYS_ACTIVE () {
- return $GLOBALS['ext_always_active'];
+ return $GLOBALS['ext_always_active'][EXT_GET_CURR_NAME()];
}
// Setter for EXT_VERSION flag
function EXT_SET_VERSION ($version) {
- $GLOBALS['ext_version'] = $version;
+ $GLOBALS['ext_version'][EXT_GET_CURR_NAME()] = (float) $version;
}
// Getter for EXT_VERSION flag
function EXT_GET_VERSION () {
- return $GLOBALS['ext_version'];
+ return $GLOBALS['ext_version'][EXT_GET_CURR_NAME()];
}
// Setter for EXT_DEPRECATED flag
function EXT_SET_DEPRECATED ($deprecated) {
- $GLOBALS['ext_deprecated'] = $deprecated;
+ $GLOBALS['ext_deprecated'][EXT_GET_CURR_NAME()] = (string) $deprecated;
}
// Getter for EXT_DEPRECATED flag
function EXT_GET_DEPRECATED () {
- return $GLOBALS['ext_deprecated'];
+ return $GLOBALS['ext_deprecated'][EXT_GET_CURR_NAME()];
}
// Setter for EXT_UPDATE_DEPENDS flag
-function EXT_SET_UPDATE_DEPENDS ($updateDepends) {
- $GLOBALS['ext_update_depends'] = $updateDepends;
+function EXT_ADD_UPDATE_DEPENDS ($updateDepends) {
+ // Is the update depency empty? (NEED TO BE FIXED!)
+ if (empty($updateDepends)) {
+ // Please report this bug!
+ debug_report_bug("updateDepends is left empty!");
+ } // END - if
+
+ // Is it not yet added?
+ if (!in_array($updateDepends, $GLOBALS['ext_running_updates'])) {
+ //* DEBUG */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."/".$updateDepends."<br />\n";
+ // Add it to the list of extension update depencies map
+ $GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()][] = (string) $updateDepends;
+
+ // Remember it in the list of running updates
+ $GLOBALS['ext_running_updates'][] = $updateDepends;
+ } // END - if
+}
+
+// Init EXT_UPDATE_DEPENDS flag
+function EXT_INIT_UPDATE_DEPENDS () {
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+
+ // Init update depency map
+ $GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()] = array();
+
+ // Init running updates array
+ EXT_INIT_RUNNING_UPDATES();
+}
+
+// Initializes the list of running updates
+function EXT_INIT_RUNNING_UPDATES () {
+ // Auto-init ext_running_updates
+ if (!isset($GLOBALS['ext_running_updates'])) {
+ $GLOBALS['ext_running_updates'] = array();
+ } // END - if
}
// Getter for EXT_UPDATE_DEPENDS flag
function EXT_GET_UPDATE_DEPENDS () {
- return $GLOBALS['ext_update_depends'];
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+ return $GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()];
+}
+
+// Getter for next iterator depency
+function EXT_GET_ITERATOR_UPDATE_DEPENDS () {
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+ return ($GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()][EXT_GET_UPDATE_ITERATOR()]);
+}
+
+// Counter for extension update depencies
+function EXT_COUNT_UPDATE_DEPENDS () {
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+ return count($GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()]);
+}
+
+// Removes given extension from update denpency list
+function EXT_REMOVE_UPDATE_DEPENDS ($ext_name) {
+ // Look it up
+ $key = array_search($ext_name, EXT_GET_UPDATE_DEPENDS());
+
+ // Is it valid?
+ if ($key !== false) {
+ // Then remove it
+ unset($GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()][$key]);
+
+ // And sort the array
+ ksort($GLOBALS['ext_update_depends'][EXT_GET_CURR_NAME()]);
+ } // END - if
+}
+
+// Init iterator for update depencies
+function EXT_INIT_UPDATE_ITERATOR () {
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+ $GLOBALS['ext_depend_iterator'][EXT_GET_CURR_NAME()] = 0;
+}
+
+// Getter for depency iterator
+function EXT_GET_UPDATE_ITERATOR () {
+ // Auto-init iterator
+ if (!isset($GLOBALS['ext_depend_iterator'][EXT_GET_CURR_NAME()])) EXT_INIT_UPDATE_ITERATOR();
+
+ // Return it
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."/".$GLOBALS['ext_depend_iterator'][EXT_GET_CURR_NAME()]."<br />\n";
+ return $GLOBALS['ext_depend_iterator'][EXT_GET_CURR_NAME()];
+}
+
+// Increments the update iterator
+function EXT_INCREMENT_UPDATE_INTERATOR () {
+ //* DEBUG: */ print __FUNCTION__.":".EXT_GET_CURR_NAME()."<br />\n";
+ $GLOBALS['ext_depend_iterator'][EXT_GET_CURR_NAME()]++;
}
// Setter for EXT_REPORTS_FAILURE flag
function EXT_SET_REPORTS_FAILURE ($reportsFailure) {
- $GLOBALS['ext_reports_failure'] = $reportsFailure;
+ $GLOBALS['ext_reports_failure'] = (bool) $reportsFailure;
}
// Getter for EXT_REPORTS_FAILURE flag
$GLOBALS['ext_ver_history'] = (array) $verHistory;
}
-// Getter for EXT_VER_HISTORY flag
+// Getter for EXT_VER_HISTORY array
function EXT_GET_VER_HISTORY () {
return $GLOBALS['ext_ver_history'];
}
// Setter for EXT_UPDATE_NOTES flag
function EXT_SET_UPDATE_NOTES ($updateNotes) {
- $GLOBALS['ext_update_notes'] = (array) $updateNotes;
+ $GLOBALS['ext_update_notes'] = (string) $updateNotes;
}
// Getter for EXT_UPDATE_NOTES flag
return $GLOBALS['ext_update_notes'];
}
+// Init extension notice
+function EXT_INIT_NOTES () {
+ $GLOBALS['ext_notes'] = "";
+}
+
+// Append extension notice
+function EXT_APPEND_NOTES ($notes) {
+ $GLOBALS['ext_notes'] .= (string) $notes;
+}
+
+// Getter for extension notes
+function EXT_GET_NOTES () {
+ return $GLOBALS['ext_notes'];
+}
+
+// Setter for current extension name
+function EXT_SET_CURR_NAME ($ext_name) {
+ $GLOBALS['curr_ext_name'] = (string) $ext_name;
+}
+
+// Getter for current extension name
+function EXT_GET_CURR_NAME () {
+ if (isset($GLOBALS['curr_ext_name'])) {
+ return $GLOBALS['curr_ext_name'];
+ } // END - if
+
+ // Not set!
+ debug_report_bug(__FUNCTION__.": curr_ext_name not initialized. Please execute INIT_EXT_SQLS() before calling this function.");
+}
+
+// Init SQLs array for current extension
+function INIT_EXT_SQLS () {
+ // Auto-init the array now...
+ if (!isset($GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()])) {
+ $GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()] = array();
+ } // END - if
+}
+
+// Adds SQLs to the SQLs array but "assigns" it with current extension name
+function ADD_EXT_SQL ($sql) {
+ $GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()][] = $sql;
+}
+
+// Getter for SQLs array for current extension
+function GET_EXT_SQLS () {
+ // Output debug backtrace if not found (SHOULD NOT HAPPEN!)
+ if (!isset($GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()])) {
+ // Not found, should not happen
+ debug_report_bug(sprintf("ext_sqls is empty, current extension: %s",
+ EXT_GET_CURR_NAME()
+ ));
+ } // END - if
+
+ // Return the array
+ return $GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()];
+}
+
+// Removes SQLs for current extension
+function UNSET_EXT_SQLS () {
+ unset($GLOBALS['ext_sqls'][EXT_GET_CURR_NAME()]);
+}
+
+// Auto-initializes the removal list
+function EXT_INIT_REMOVAL_LIST () {
+ // Is the remove list there?
+ if (!isset($GLOBALS['ext_update_remove'])) {
+ // Then create it
+ $GLOBALS['ext_update_remove'] = array();
+ } // END - if
+}
+
+// Checks wether the current extension is on the removal list
+function EXT_IS_ON_REMOVAL_LIST () {
+ // Init removal list
+ EXT_INIT_REMOVAL_LIST();
+
+ // Is it there?
+ return (in_array(EXT_GET_CURR_NAME(), $GLOBALS['ext_update_remove']));
+}
+
+// Adds the current extension to the removal list
+function EXT_ADD_CURRENT_TO_REMOVAL_LIST () {
+ // Simply add it
+ $GLOBALS['ext_update_remove'][] = EXT_GET_CURR_NAME();
+}
+
+// Getter for removal list
+function EXT_GET_REMOVAL_LIST () {
+ // Return the removal list
+ return $GLOBALS['ext_update_remove'];
+}
+
//
?>