2 /************************************************************************
\r
3 * MXChange v0.2.1 Start: 03/25/2004 *
\r
4 * =============== Last change: 09/29/2004 *
\r
6 * -------------------------------------------------------------------- *
\r
7 * File : extensions.php *
\r
8 * -------------------------------------------------------------------- *
\r
9 * Short description : Extension management *
\r
10 * -------------------------------------------------------------------- *
\r
11 * Kurzbeschreibung : Erweiterungen-Management *
\r
12 * -------------------------------------------------------------------- *
\r
14 * -------------------------------------------------------------------- *
\r
15 * Copyright (c) 2003 - 2008 by Roland Haeder *
\r
16 * For more information visit: http://www.mxchange.org *
\r
18 * This program is free software; you can redistribute it and/or modify *
\r
19 * it under the terms of the GNU General Public License as published by *
\r
20 * the Free Software Foundation; either version 2 of the License, or *
\r
21 * (at your option) any later version. *
\r
23 * This program is distributed in the hope that it will be useful, *
\r
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
\r
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
\r
26 * GNU General Public License for more details. *
\r
28 * You should have received a copy of the GNU General Public License *
\r
29 * along with this program; if not, write to the Free Software *
\r
30 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, *
\r
31 * MA 02110-1301 USA *
\r
32 ************************************************************************/
\r
34 // Some security stuff...
\r
35 if (ereg(basename(__FILE__), $_SERVER['PHP_SELF']))
\r
37 $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4) . "/security.php";
\r
41 function EXTENSION_REGISTER($ext_name, $id, $dry_run=false)
\r
43 global $NOTES, $CONFIG, $INC_POOL;
\r
44 // We want to register an extension and registration status is by default "failed" (= false)
\r
45 $EXT_LOAD_MODE = "register"; $ret = false; $SQLs = array();
\r
46 $INC_POOL = array();
\r
48 // This shall never do a non-admin user!
\r
49 if (!IS_ADMIN()) return false;
\r
51 // Is this extension already installed?
\r
52 if (EXT_IS_ACTIVE($ext_name)) return false;
\r
54 // Generate file name
\r
55 $file = sprintf(PATH."inc/extensions/ext-%s.php", $ext_name);
\r
57 // Does this extension exists?
\r
58 if (file_exists($file) && is_readable($file))
\r
60 // Extension was found so we can load it in registration mode
\r
63 // And run possible updates
\r
64 $EXT_LOAD_MODE = "update"; $EXT_UPDATE_DEPENDS = "";
\r
65 foreach ($EXT_VER_HISTORY as $EXT_VER)
\r
68 if (((GET_EXT_VERSION("sql_patches") != "") && ($CONFIG['verbose_sql'] == "Y")) || (!EXT_IS_ACTIVE("sql_patches")))
\r
70 if (!empty($UPDATE_NOTES))
\r
72 // Update notes found
\r
73 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR>".$UPDATE_NOTES."<BR><BR>\n";
\r
76 elseif (($EXT_VER == "0.0") || ($EXT_VER == "0.0.0"))
\r
79 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR>".INITIAL_RELEASE."<BR><BR>\n";
\r
83 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR><I>".NO_UPDATE_NOTES."</I><BR><BR>\n";
\r
88 // Does this extension depends on an outstanding update of another update?
\r
89 if (!empty($EXT_UPDATE_DEPENDS))
\r
91 // Backup SQL commands and clear current
\r
92 $SQLs2 = $SQLs; $SQLs = array(); $test = false;
\r
94 // Backup language as well
\r
95 $LANG_BCK = $EXT_LANG_PREFIX;
\r
97 // Load required extension also in update mode
\r
98 $file = sprintf(PATH."inc/extensions/ext-%s.php", $EXT_UPDATE_DEPENDS);
\r
100 // Check for required file
\r
101 if (file_exists($file) && is_readable($file))
\r
103 // File exists so let's load it
\r
104 $VER_BACKUP = $EXT_VERSION;
\r
106 $EXT_VERSION = $VER_BACKUP;
\r
108 // If versions mismatch update extension first
\r
109 $ext_ver = GET_EXT_VERSION($EXT_UPDATE_DEPENDS);
\r
110 if (empty($ext_ver))
\r
112 // Extension not registered so far so first load task's ID...
\r
113 $result = SQL_QUERY_ESC("SELECT id FROM "._MYSQL_PREFIX."_task_system WHERE task_type='EXTENSION' AND subject LIKE '[%s:]%%' LIMIT 1",
\r
114 array($EXT_UPDATE_DEPENDS), __FILE__, __LINE__);
\r
115 if (SQL_NUMROWS($result) == 1)
\r
117 // Task found so load task's ID and register extension...
\r
118 list($task) = SQL_FETCHROW($result);
\r
119 SQL_FREERESULT($result);
\r
120 $test = EXTENSION_REGISTER($EXT_UPDATE_DEPENDS, $task, $dry_run);
\r
123 elseif ($ext_ver != $EXT_VERSION)
\r
125 // Ok, update this extension now
\r
126 EXTENSION_UPDATE(basename($file), $EXT_UPDATE_DEPENDS, $ext_ver, $dry_run);
\r
131 // Nothing to register / update before...
\r
137 // Required file for update does not exists!
\r
139 // But this is fine for the first time...
\r
142 // Finally restore previous SQLs
\r
143 $SQLs = $SQLs2; unset($SQLs2);
\r
144 $EXT_LANG_PREFIX = $LANG_BCK;
\r
148 // Does not depend on an other extension
\r
152 // Does everthing before wents ok?
\r
155 // "Dry-run-mode" activated?
\r
158 // Are there any SQL commands to run?
\r
159 if (count($SQLs) > 0)
\r
161 foreach ($SQLs as $sql)
\r
167 // Run SQLs without compiling them...
\r
168 $result = SQL_QUERY($sql, __FILE__, __LINE__, false);
\r
173 // Check for added include files
\r
174 if (count($INC_POOL > 0))
\r
176 // Loads every include file
\r
177 foreach ($INC_POOL as $inc)
\r
179 require_once($inc);
\r
183 // Register extension
\r
184 $result = SQL_QUERY_ESC("INSERT INTO "._MYSQL_PREFIX."_extensions (ext_name, ext_lang_file, ext_active, ext_version) VALUES ('%s', '%s', 'N', '%s')",
\r
185 array($ext_name, $EXT_LANG_PREFIX, $EXT_VERSION), __FILE__, __LINE__);
\r
187 // Update task management
\r
188 $result = SQL_QUERY_ESC("UPDATE "._MYSQL_PREFIX."_task_system SET status='SOLVED' WHERE id=%d LIMIT 1",
\r
189 array(bigintval($id)), __FILE__, __LINE__);
\r
191 // In normal mode return a true on success
\r
192 $ret = true; unset($SQLs);
\r
196 // Rewrite SQL command to keep { and } inside
\r
197 foreach ($SQLs as $key=>$sql)
\r
199 $sql = str_replace('{', "{", str_replace('}', "}", $sql));
\r
200 $SQLs[$key] = $sql;
\r
203 // In "dry-run" mode return array with all SQL commands
\r
206 // Remove all SQL commands
\r
212 // No, an error occurs while registering extension :-(
\r
216 elseif (($id > 0) && (!empty($ext_name)))
\r
218 // Remove task from system when id and extension's name is valid
\r
219 $result = SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM "._MYSQL_PREFIX."_task_system WHERE id=%d AND status='NEW' LIMIT 1",
\r
220 array(bigintval($id)), __FILE__, __LINE__);
\r
222 // Return status code
\r
226 function EXTENSION_RUN_SQLS($id, $EXT_LOAD_MODE)
\r
229 // This shall never do a non-admin user!
\r
230 if (!IS_ADMIN()) return false;
\r
232 // Get extension's name
\r
233 $result = SQL_QUERY_ESC("SELECT ext_name FROM "._MYSQL_PREFIX."_extensions WHERE id=%d LIMIT 1",
\r
234 array(bigintval($id)), __FILE__, __LINE__);
\r
235 list($ext_name) = SQL_FETCHROW($result);
\r
236 SQL_FREERESULT($result);
\r
237 if (empty($ext_name)) return false;
\r
239 // Load extension in detected mode
\r
240 $file = sprintf(PATH."inc/extensions/ext-%s.php", $ext_name); $SQLs = array();
\r
241 if (file_exists($file) && is_readable($file)) require($file);
\r
242 if ((is_array($SQLs) && (sizeof($SQLs) > 0)))
\r
244 // Run SQL commands...
\r
245 foreach ($SQLs as $sql)
\r
251 $result = SQL_QUERY($sql, __FILE__, __LINE__, false);
\r
255 // Remove cache file(s) if extension is active
\r
256 if (EXT_IS_ACTIVE("cache"))
\r
258 // Remove cache filer
\r
259 if ($CACHE->cache_file("extensions", true)) $CACHE->cache_destroy();
\r
260 if ($CACHE->cache_file("mod_reg", true)) $CACHE->cache_destroy();
\r
261 if ($CACHE->cache_file("config", true)) $CACHE->cache_destroy();
\r
266 function EXT_IS_ACTIVE ($ext_name, $ignore_admin=false, $ignore_cache=false)
\r
268 global $EXTENSIONS, $CONFIG;
\r
270 // Extensions are all inactive during installation
\r
271 if ((!mxchange_installed) || (mxchange_installing) || (empty($ext_name))) return false;
\r
273 // Extension's file name will also be checked
\r
274 $FILE = PATH."inc/extensions/ext-".$ext_name.".php";
\r
275 if ((!file_exists($FILE)) && (!is_readable($FILE))) return false;
\r
276 //* DEBUG: */ echo "*".$ext_name."*<BR>";
\r
278 // Failed is the default
\r
280 if ((!empty($EXTENSIONS['ext_active'][$ext_name])) && (!$ignore_cache))
\r
283 $active = $EXTENSIONS['ext_active'][$ext_name];
\r
285 // Count cache hits
\r
286 if (isset($CONFIG['cache_hits'])) $CONFIG['cache_hits']++;
\r
290 // Load from database
\r
291 $result = SQL_QUERY_ESC("SELECT ext_active FROM "._MYSQL_PREFIX."_extensions WHERE ext_name='%s' LIMIT 1",
\r
292 array($ext_name), __FILE__, __LINE__);
\r
293 if (SQL_NUMROWS($result) == 0)
\r
295 // Extension was not found!
\r
298 list($active) = SQL_FETCHROW($result);
\r
299 SQL_FREERESULT($result);
\r
301 // Write cache array
\r
302 $EXTENSIONS['ext_active'][$ext_name] = $active;
\r
305 // Is this extension activated? (For admins we always have active extensions...)
\r
306 $inc = sprintf(PATH."inc/extensions/ext-%s.php", $ext_name);
\r
310 ($active == "Y") || (
\r
312 (!$ignore_admin) &&
\r
323 function GET_EXT_VERSION ($ext_name)
\r
325 global $EXTENSIONS, $CONFIG;
\r
326 // Extensions are all inactive during installation
\r
327 if ((!mxchange_installed) || (mxchange_installing)) return "";
\r
329 // Is the cache written?
\r
330 if (!empty($EXTENSIONS['ext_version'][$ext_name]))
\r
332 // Load data from cache
\r
333 $ret = $EXTENSIONS['ext_version'][$ext_name];
\r
335 // Count cache hits
\r
336 if (isset($CONFIG['cache_hits'])) $CONFIG['cache_hits']++;
\r
340 // Load from database
\r
341 $result = SQL_QUERY_ESC("SELECT ext_version FROM "._MYSQL_PREFIX."_extensions WHERE ext_name='%s' LIMIT 1",
\r
342 array($ext_name), __FILE__, __LINE__);
\r
343 list($ret) = SQL_FETCHROW($result);
\r
344 SQL_FREERESULT($result);
\r
347 $EXTENSIONS['ext_version'][$ext_name] = $ret;
\r
352 function EXTENSION_UPDATE($file, $ext, $EXT_VER, $dry_run=false)
\r
354 // This shall never do a non-admin user!
\r
355 global $CACHE, $CONFIG, $NOTES; $SQLs = array();
\r
356 if ((!IS_ADMIN()) || (empty($ext))) return false;
\r
358 // Load extension in update mode
\r
359 $EXT_LOAD_MODE = "update"; $EXT_UPDATE_DEPENDS = ""; $NOTES = "";
\r
360 include(PATH."inc/extensions/".$file);
\r
361 if (!empty($EXT_UPDATE_DEPENDS))
\r
363 // Update another extension first!
\r
364 $test = EXTENSION_UPDATE(("ext-".$EXT_UPDATE_DEPENDS.".php"), $EXT_UPDATE_DEPENDS, GET_EXT_VERSION($EXT_UPDATE_DEPENDS), $dry_run);
\r
367 // Check if version is updated
\r
368 if ((($EXT_VERSION != $EXT_VER) || ($dry_run)) && (is_array($EXT_VER_HISTORY)))
\r
370 // Search for starting point
\r
371 $start = array_search($EXT_VER, $EXT_VER_HISTORY);
\r
374 // And load SQL queries in order of version history
\r
375 for ($idx = ($start + 1); $idx < sizeof($EXT_VER_HISTORY); $idx++)
\r
377 // Remove old SQLs array to prevent possible bugs
\r
378 if (!$dry_run) { unset($SQLs); $SQLs = array(); }
\r
381 $EXT_VER = $EXT_VER_HISTORY[$idx];
\r
383 // Include again...
\r
384 include(PATH."inc/extensions/".$file);
\r
387 if ($CONFIG['verbose_sql'] == "Y")
\r
389 $EXT_VER = $EXT_VER_HISTORY[$idx];
\r
390 if (!empty($UPDATE_NOTES))
\r
392 // Update notes found
\r
393 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR>".$UPDATE_NOTES."<BR><BR>\n";
\r
394 $UPDATE_NOTES = "";
\r
396 elseif ($EXT_VER == "0.0")
\r
399 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR>".INITIAL_RELEASE."<BR><BR>\n";
\r
403 $NOTES .= "<STRONG>v".$EXT_VER.":</STRONG><BR><I>".NO_UPDATE_NOTES."</I><BR><BR>\n";
\r
408 if ((is_array($SQLs)) && (!$dry_run))
\r
410 // Run SQL commands
\r
411 foreach ($SQLs as $sql)
\r
416 // Run SQL command...
\r
417 $result = SQL_QUERY($sql, __FILE__, __LINE__, false);
\r
420 } elseif (GET_EXT_VERSION("sql_patches") == "") {
\r
421 // Remove SQLs if extension is not installed
\r
428 // In normal mode insert task and update extension's version...
\r
429 $ext_subj = "[UPDATE-".$ext."-".$EXT_VERSION.":] ".ADMIN_UPDATE_EXT_SUBJ;
\r
432 $result = SQL_QUERY_ESC("SELECT id FROM "._MYSQL_PREFIX."_task_system WHERE subject='%s' LIMIT 1",
\r
433 array($ext_subj), __FILE__, __LINE__);
\r
434 if (SQL_NUMROWS($result) == 0)
\r
436 // Task not created so it's a brand-new extension which we need to register and create a task for!
\r
437 $result = SQL_QUERY_ESC("INSERT INTO "._MYSQL_PREFIX."_task_system (assigned_admin, userid, status, task_type, subject, text, task_created) VALUES ('%s', '0', 'NEW', 'EXTENSION_UPDATE', '%s', '%s', UNIX_TIMESTAMP())",
\r
438 array(GET_ADMIN_ID(SQL_ESCAPE($_COOKIE['admin_login'])), $ext_subj, addslashes($NOTES)), __FILE__, __LINE__);
\r
442 SQL_FREERESULT($result);
\r
444 // Update extension's version
\r
445 $result = SQL_QUERY_ESC("UPDATE "._MYSQL_PREFIX."_extensions SET ext_version='%s' WHERE ext_name='%s' LIMIT 1",
\r
446 array($EXT_VERSION, $ext), __FILE__, __LINE__);
\r
449 if (EXT_IS_ACTIVE("cache"))
\r
451 if ($CACHE->cache_file("extensions", true) == true) $CACHE->cache_destroy();
\r
452 if ($CACHE->cache_file("config", true) == true) $CACHE->cache_destroy();
\r
453 if ($CACHE->cache_file("mod_reg", true) == true) $CACHE->cache_destroy();
\r
461 // In "dry-run" mode return array with SQL commands
\r
467 function EXTENSION_VERBOSE_TABLE($SQLs, $title=ADMIN_SQLS_EXECUTED_ON_REMOVAL, $dashed="", $switch=false, $WIDTH="480")
\r
471 $S = false; $SW = 2; $i = 1;
\r
473 if ((is_array($SQLs)) && (GET_EXT_VERSION("sql_patches")) && ($CONFIG['verbose_sql'] == "Y"))
\r
475 $OUT = "<DIV align=\"center\">
\r
476 <TABLE border=\"0\" cellspacing=\"0\" cellpadding=\"0\" width=\"".$WIDTH."\" align=\"center\"".$dashed.">
\r
478 <TD colspan=\"2\" align=\"center\" class=\"admin_title bottom2\" height=\"24\">
\r
479 <STRONG>".$title.":</STRONG>
\r
482 foreach ($SQLs as $idx=>$sql)
\r
489 <TD class=\"switch_sw".(3 - $SW)." bottom2\" style=\"padding-left: 2px\" width=\"30\">".$i.".</TD>
\r
490 <TD class=\"switch_sw".(3 - $SW)." bottom2\" style=\"padding-left: 5px; padding-right: 5px\">
\r
494 if ($switch) $SW = 3 - $SW;
\r
500 if ((!$S) && (GET_EXT_VERSION("sql_patches")) && ($CONFIG['verbose_sql'] == "Y"))
\r
502 // No addional SQL commands to run
\r
504 <TD colspan=\"2\" align=\"center\" class=\"switch_sw2 bottom2\" height=\"24\">
\r
505 <FONT class=\"admin_note\">".ADMIN_NO_ADDIONAL_SQLS."</FONT>
\r
510 if (!empty($OUT)) {
\r
511 // Add missing close-table tag
\r
518 function GET_EXT_NAME($id)
\r
521 global $EXTENSIONS, $CONFIG;
\r
522 if (!empty($EXTENSIONS['ext_id'][$id]))
\r
525 $ret = $EXTENSIONS['ext_id'][$id];
\r
527 // Count cache hits
\r
528 $CONFIG['cache_hits']++;
\r
532 // Load from database
\r
533 $result = SQL_QUERY_ESC("SELECT ext_name FROM "._MYSQL_PREFIX."_extensions WHERE id=%d LIMIT 1",
\r
534 array(bigintval($id)), __FILE__, __LINE__);
\r
535 list($ret) = SQL_FETCHROW($result);
\r
536 SQL_FREERESULT($result);
\r
541 function GET_EXT_ID($name)
\r
544 global $EXTENSIONS, $CONFIG;
\r
545 if ((isset($EXTENSIONS['ext_id'])) && (is_array($EXTENSIONS['ext_id'])))
\r
548 $ret = array_search($name, $EXTENSIONS['ext_id']);
\r
550 // Count cache hits
\r
551 $CONFIG['cache_hits']++;
\r
555 // Load from database
\r
556 $result = SQL_QUERY_ESC("SELECT id FROM "._MYSQL_PREFIX."_extensions WHERE ext_name='%s' LIMIT 1",
\r
557 array($name), __FILE__, __LINE__);
\r
558 list($ret) = SQL_FETCHROW($result);
\r
559 SQL_FREERESULT($result);
\r