2 /************************************************************************
3 * Mailer v0.2.1-FINAL Start: 10/12/2008 *
4 * =================== Last change: 10/12/2008 *
6 * -------------------------------------------------------------------- *
7 * File : ext-debug.php *
8 * -------------------------------------------------------------------- *
9 * Short description : Extension for sending/receiving debug requests *
10 * -------------------------------------------------------------------- *
11 * Kurzbeschreibung : Erweiterung zum Versenden/Empfangen von Debug-Q. *
12 * -------------------------------------------------------------------- *
15 * $Tag:: 0.2.1-FINAL $ *
17 * Needs to be in all Files and every File needs "svn propset *
18 * svn:keywords Date Revision" (autoprobset!) at least!!!!!! *
19 * -------------------------------------------------------------------- *
20 * Copyright (c) 2003 - 2009 by Roland Haeder *
21 * Copyright (c) 2009, 2010 by Mailer Developer Team *
22 * For more information visit: http://www.mxchange.org *
24 * This program is free software; you can redistribute it and/or modify *
25 * it under the terms of the GNU General Public License as published by *
26 * the Free Software Foundation; either version 2 of the License, or *
27 * (at your option) any later version. *
29 * This program is distributed in the hope that it will be useful, *
30 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
31 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
32 * GNU General Public License for more details. *
34 * You should have received a copy of the GNU General Public License *
35 * along with this program; if not, write to the Free Software *
36 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, *
38 ************************************************************************/
40 // Some security stuff...
41 if (!defined('__SECURITY')) {
46 setThisExtensionVersion('0.0');
48 // Version history array (add more with , '0.1.0' and so on)
49 setExtensionVersionHistory(array('0.0'));
51 // Keep this extension always active!
52 setExtensionAlwaysActive('Y');
54 // This extension is in development (non-productive)
55 enableExtensionProductive(false);
57 switch (getExtensionMode()) {
58 case 'register': // Do stuff when installation is running (modules.php?module=admin is called)
59 // Table for debug log entries
60 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_log`');
61 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_debug_log` (
62 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
63 `sender_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
64 `timestamp` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00',
65 `file` VARCHAR(255) NOT NULL DEFAULT '',
66 `line` MEDIUMINT NOT NOT NULL DEFAULT 0,
69 `status` ENUM('NEW','PENDING','ACCEPTED','FIXED','INVALID','DUBLICATE','SPAM') NOT NULL DEFAULT 'NEW',
70 `inserted` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
73 ) TYPE={?_TABLE_TYPE?} COMMENT='Debug log data'");
75 // Table against debug log abuse
76 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_log_abuse`');
77 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_debug_log_abuse` (
78 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
79 `client_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
80 `timestamp` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00',
82 `inserted` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
85 ) TYPE={?_TABLE_TYPE?} COMMENT='Debug log abuse'");
87 // Table on relay/server for client exchanges
88 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_client`');
89 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_debug_client` (
90 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
91 `key` VARCHAR(255) NOT NULL DEFAULT 'SELF',
92 `url` VARCHAR(255) NOT NULL DEFAULT '',
93 `webmaster` VARCHAR(255) NOT NULL DEFAULT '',
94 `title` VARCHAR(255) NOT NULL DEFAULT '',
95 `status` ENUM('ACTIVE','NEW','PENDING','LOCKED','DELETED','SPAM') NOT NULL DEFAULT 'PENDING',
96 `type` ENUM ('CLIENT','RELAY','SERVER') NOT NULL DEFAULT 'CLIENT',
97 `inserted` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
98 `lock_spam_reason` TINYTEXT,
102 ) TYPE={?_TABLE_TYPE?} COMMENT='Debug clients'");
104 // Add this exchange as first client
105 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_debug_client` (`url`,`title`,`webmaster`,`status`) VALUES ('{?URL?}','{?MAIN_TITLE?}','{?WEBMASTER?}','ACTIVE')");
107 // Table for debug log <-> client connection
108 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_client_log`');
109 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_debug_client_log` (
110 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
111 `client_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 1,
112 `log_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
113 INDEX `client_log` (`client_id`,`log_id`),
116 ) TYPE={?_TABLE_TYPE?} COMMENT='Debug client <-> log connection'");
119 addGuestMenuSql('debug',NULL,'Debug-System','Y','Y',2);
120 addGuestMenuSql('debug','debug_info','Informationen','Y','Y',1);
121 addGuestMenuSql('debug','debug_reg','Anmeldung','Y','Y',2);
122 addGuestMenuSql('debug','debug_unreg','Abmeldung','Y','Y',3);
123 addGuestMenuSql('debug','debug_pilory','Spam-Pranger','Y','Y',4);
126 addAdminMenuSql('debug',NULL,'Debug-System','Verwalten Sie hier komfortabel das debug.log, welches sich im Verzeichnis <strong>{?CACHE_PATH?}/</strong> befindet.',10);
127 addAdminMenuSql('debug','import_debug','debug.log importieren','Importieren Sie hier manuell die debug.log, damit neue Einträge mit bestehenden abgeglichen werden können und dann evtl. hinzugefügt werden. Die <em>debug.log</em> wird nach dem Import automatisch vom Server entfernt. Dieser Vorgang wird für Sie nachts automatisch erledigt!',1);
128 addAdminMenuSql('debug','list_debug','Einträge anzeigen','Listet alle bereits importierten Einträge auf. Von hier aus versenden Sie noch nicht gemeldete Fehler an das Relay-Netzwerk, damt diese vom Entwicklerteam geprüft werden können.',2);
129 addAdminMenuSql('debug','reg_debug','Am Server anmelden','Sie müssen zuerst Ihren Debug-Client (Ihr {?mt_word?} ist dies) oder Relay am Server von mxchange.org anmelden. Dies geschieht für Sie nicht automatisch, da Sie Ihre Daten zuvor überprüfen müssen, wie z.B. URL, eMail-Adresse und {?mt_word?}-Titel.',3);
130 addAdminMenuSql('debug','unreg_debug','Vom Server abmelden','Melden Sie bitte Ihren {?mt_word?} wieder vom Projekt-Server ab, damit mein Entwicklerteam weiss, welche Keys nicht mehr genutzt werden.',4);
131 addAdminMenuSql('debug','config_debug','Einstellungen','Ändern Sie hier alle Einstellungen, wie auch den Debug-Modus - ob Client, Hub oder selber Server sein. Lesen Sie dazu die Anleitung unter DOCs/de/debug/README.txt durch! Oder kommen Sie in's Forum. Das Team von mxchange.org hilft Ihnen gerne weiter.',5);
134 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0");
135 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_key` VARCHAR(255) NOT NULL DEFAULT ''");
136 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_mode` ENUM('CLIENT','RELAY','SERVER') NOT NULL DEFAULT 'CLIENT'");
137 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_new_log` ENUM('ACCEPT','FIRST','REG') NOT NULL DEFAULT 'FIRST'");
138 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_new_client` ENUM('ACTIVE','NEW','REG') NOT NULL DEFAULT 'NEW'");
139 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_reject_log` BIGINT(20) UNSIGNED NOT NULL DEFAULT " . (getConfig('ONE_DAY') * 30));
140 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `debug_master_url` VARCHAR(255) NOT NULL DEFAULT '{?SERVER_URL?}'");
143 case 'remove': // Do stuff when removing extension
144 // SQL commands to run
145 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_client_log`');
146 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_client`');
147 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_log`');
148 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_debug_log_abuse`');
149 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_guest_menu` WHERE `action`='debug'");
150 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admin_menu` WHERE `action`='debug'");
153 case 'activate': // Do stuff when admin activates this extension
154 // SQL commands to run
155 addExtensionSql("UPDATE `{?_MYSQL_PREFIX?}_guest_menu` SET `visible`='Y',`locked`='N' WHERE `action`='debug' LIMIT 5");
158 case 'deactivate': // Do stuff when admin deactivates this extension
159 // SQL commands to run
160 addExtensionSql("UPDATE `{?_MYSQL_PREFIX?}_guest_menu` SET `locked`='Y' WHERE `action`='debug' LIMIT 5");
163 case 'update': // Update an extension
164 switch (getCurrentExtensionVersion()) {
165 case '0.0.1': // SQL queries for v0.0.1
168 // Update notes (these will be set as task text!)
169 setExtensionUpdateNotes('');
174 case 'modify': // When the extension got modified
177 case 'test': // For testing purposes. For details see file inc/modules/admin/what-extensions.php, arround line 305.
180 case 'init': // Do stuff when extension is initialized
183 default: // Unknown extension mode
184 logDebugMessage(__FILE__, __LINE__, sprintf("Unknown extension mode %s in extension %s detected.", getExtensionMode(), getCurrentExtensionName()));