New extension added, ext-uberwach rewritten (unfinished), some fixes
[mailer.git] / inc / extensions / ext-network.php
1 <?php
2 /************************************************************************
3  * MXChange v0.2.1                                    Start: 12/18/2008 *
4  * ================                             Last change: 11/01/2009 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : ext-network.php                                  *
8  * -------------------------------------------------------------------- *
9  * Short description : Generic (sponsor) network connection extension   *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Allgemeine Werbenetzwerk-Erweiterung             *
12  * -------------------------------------------------------------------- *
13  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
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  * For more information visit: http://www.mxchange.org                  *
22  *                                                                      *
23  * This program is free software; you can redistribute it and/or modify *
24  * it under the terms of the GNU General Public License as published by *
25  * the Free Software Foundation; either version 2 of the License, or    *
26  * (at your option) any later version.                                  *
27  *                                                                      *
28  * This program is distributed in the hope that it will be useful,      *
29  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
30  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
31  * GNU General Public License for more details.                         *
32  *                                                                      *
33  * You should have received a copy of the GNU General Public License    *
34  * along with this program; if not, write to the Free Software          *
35  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
36  * MA  02110-1301  USA                                                  *
37  ************************************************************************/
38
39 // Some security stuff...
40 if (!defined('__SECURITY')) {
41         die();
42 } // END - if
43
44 // Version number
45 setThisExtensionVersion('0.0');
46
47 // Version history array (add more with , '0.1.0' and so on)
48 setExtensionVersionHistory(array('0.0'));
49
50 // This extension is in development (non-productive)
51 enableExtensionProductive(false);
52
53 switch (getExtensionMode()) {
54         case 'register': // Do stuff when installation is running (modules.php?module=admin is called)
55                 // Main table which hold
56                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`');
57                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_data` (
58 `network_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
59 `network_short_name` VARCHAR(50) NOT NULL DEFAULT '',
60 `network_title` VARCHAR(255) NOT NULL DEFAULT '',
61 `network_reflink` VARCHAR(255) NOT NULL DEFAULT '',
62 `network_data_seperator` CHAR(4) NOT NULL DEFAULT '|',
63 `network_row_seperator` CHAR(4) NOT NULL DEFAULT '|',
64 `network_request_type` ENUM('GET','POST') NOT NULL DEFAULT 'GET',
65 `network_charset` VARCHAR(20) NOT NULL DEFAULT 'ISO-8859-1',
66 UNIQUE (`network_short_name`),
67 PRIMARY KEY (`network_id`)
68 ) TYPE={?_TABLE_TYPE?} COMMENT='Network data'");
69
70                 // Types the network provider is supporting (e.g. Forced-Banner and so on)
71                 // @TODO network_type_name is an internal name and needs documentation
72                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`');
73                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types` (
74 `network_type_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
75 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
76 `network_type_name` VARCHAR(255) NOT NULL DEFAULT '',
77 `network_type_title` VARCHAR(255) NOT NULL DEFAULT '',
78 `network_type_request_url` VARCHAR(255) NOT NULL DEFAULT '',
79 `network_type_click_url` VARCHAR(255) NOT NULL DEFAULT '',
80 `network_type_banner_url` VARCHAR(255) NOT NULL DEFAULT '',
81 UNIQUE `provider_type` (`network_id`,`network_type_name`),
82 PRIMARY KEY (`network_type_id`)
83 ) TYPE={?_TABLE_TYPE?} COMMENT='Types provideable by networks. ONLY FILL OUT WITH PROPER IDEA!'");
84
85                 // HTTP parameters (names) for URLs
86                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`');
87                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_request_params` (
88 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
89 `request_param_max_reload_time` VARCHAR(10) NOT NULL DEFAULT 'reload',
90 `request_param_min_waiting_time` VARCHAR(10) NOT NULL DEFAULT 'ma',
91 `request_param_min_remain_clicks` VARCHAR(10) NOT NULL DEFAULT 'uebrig',
92 `request_param_min_payment` VARCHAR(10) NOT NULL DEFAULT 'verguetung',
93 `request_param_allow_erotic` VARCHAR(10) NOT NULL DEFAULT 'erotik',
94 PRIMARY KEY (`network_type_id`)
95 ) TYPE={?_TABLE_TYPE?} COMMENT='Request parameters for GET/POST request ONLY FILL OUT WITH PROPER IDEA!'");
96
97                 // Error status codes
98                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_codes`');
99                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_type_codes` (
100 `network_type_code_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
101 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
102 `network_type_code_value` VARCHAR(50) NOT NULL DEFAULT '',
103 `network_type_code_type` VARCHAR(100) NOT NULL DEFAULT 'INVALID_TYPE',
104 UNIQUE `code_type` (`network_type_code_value`,`network_type_id`),
105 INDEX (`network_type_id`),
106 PRIMARY KEY (`network_type_code_id`)
107 ) TYPE={?_TABLE_TYPE?} COMMENT='Error codes for all types'");
108
109                 // Code types (internal table)
110                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_codes`');
111                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_codes` (
112 `network_code_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
113 `network_code` VARCHAR(100) NOT NULL DEFAULT 'INVALID_CODE',
114 UNIQUE (`network_code`),
115 PRIMARY KEY (`network_code_id`)
116 ) TYPE={?_TABLE_TYPE?} COMMENT='Error types, generic data, DO NOT ALTER!'");
117
118                 // Valid translation keys (we hate hard-coded arrays, you see?)
119                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_translations`');
120                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_translations` (
121 `network_translate_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
122 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
123 `network_translation` VARCHAR(100) NOT NULL DEFAULT '',
124 UNIQUE `type_trans` (`network_type_id`,`network_translation`),
125 PRIMARY KEY (`network_translate_id`)
126 ) TYPE={?_TABLE_TYPE?} COMMENT='Translations for array keys, generic data, DO NOT ALTER!'");
127
128                 // Data from the webmaster (you!)
129                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config`');
130                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_config` (
131 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
132 `network_affiliate_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
133 `network_api_password` VARCHAR(255) NOT NULL DEFAULT '',
134 `network_site_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
135 `network_query_amount` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
136 UNIQUE `network_affiliate` (`network_id`,`network_affiliate_id`),
137 UNIQUE `affiliate_site` (`network_affiliate_id`,`network_site_id`),
138 PRIMARY KEY (`network_id`)
139 ) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data from the webmaster (you!)'");
140
141                 // Configuration data for e.g. reload-time
142                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_config`');
143                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types_config` (
144 `network_data_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
145 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
146 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
147 `max_reload_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
148 `min_waiting_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
149 `min_remain_clicks` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
150 `min_payment` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
151 `allow_erotic` VARCHAR(10) NOT NULL DEFAULT '',
152 UNIQUE `provider_type` (`network_id`,`network_type_id`),
153 PRIMARY KEY (`network_data_id`)
154 ) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data for every type (e.g. reload-time)'");
155
156                 // Cache for queried APIs. Re-check depends on config
157                 // `network_cache_refresh` in seconds or if set to zero, full day
158                 // divided by query amount.
159                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_cache`');
160                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_cache` (
161 `network_cache_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
162 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
163 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
164 `network_cache_data` MEDIUMBLOB,
165 `network_cache_timestamp` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00',
166 UNIQUE `provider_type` (`network_id`,`network_type_id`),
167 PRIMARY KEY (`network_cache_id`)
168 ) TYPE={?_TABLE_TYPE?} COMMENT='Cache for all queried APIs'");
169
170                 // Array-Element translation tables per type/provider
171                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_array_translation`');
172                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_array_translation` (
173 `network_translate_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
174 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
175 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
176 `network_array_key` SMALLINT(5) UNSIGNED NOT NULL DEFAULT 0,
177 `network_translation` VARCHAR(100) NOT NULL DEFAULT '',
178 UNIQUE `provider_type_key` (`network_id`,`network_type_id`,`network_array_key`),
179 UNIQUE `provider_type_trans` (`network_id`,`network_type_id`,`network_translation`),
180 PRIMARY KEY (`network_translate_id`)
181 ) TYPE={?_TABLE_TYPE?} COMMENT='Cache for all queried APIs'");
182
183                 // Insert error code types
184                 // - Affiliate id or interface password wrong
185                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('AFF_ID_PASS_WRONG')");
186                 // - Webmaster's site id is not assigned (invalid, different affiliate id)
187                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ASSIGNED')");
188                 // - Webmaster's site id is locked
189                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_LOCKED')");
190                 // - General error in interface data
191                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('INTERFACE_DATA_ERROR')");
192                 // - Request amount depleted
193                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUESTS_DEPLETED')");
194                 // - No campaigns found for given criteria (but maybe there are with more widen criteria)
195                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND')");
196                 // - No campaigns found with allowed interface output (but there are maybe non-interface campaigns)
197                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND_INTERFACE')");
198                 // - Webmaster's site id is not unlocked for choosen type
199                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ALLOWED_TYPE')");
200                 // - Request parameters incomplete
201                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUEST_PARAMS_INCOMPLETE')");
202
203                 // Admin menu entries
204                 addAdminMenuSql('network',NULL,'Werbenetzwerke','Verwalten Sie hier Werbenetzwerke (API-Anbindung), versenden Sie deren Mails, oder &uuml;bernehmen Sie deren Textlinks und vieles mehr. <strong>VORSICHT:</strong> Das Einrichten von weiteren Werbenetzwerken ist nicht leicht, daf&uuml;r aber sehr flexibel! Sollte ein Netzwerk fehlen, so melden Sie dies bitte <a href="http://forum.mxchange.org/topic-462.html" target="_blank" title="Direktlink zum Forum">im Forum</a>!',4);
205                 addAdminMenuSql('network','config_networks','API-Daten','Stellen Sie Ihre Affiliate- Webseiten-Id und API-Passwort ein. Diese erhalten Sie zu &uuml;ber 99% aus dem jeweiligen Zugangsbereich des Anbieters. Sollten Sie bei einem Netzwerk noch nicht angemeldet sein, verwenden Sie bitte meinen Referal-Link.',1);
206                 addAdminMenuSql('network','config_network_types','Werbearten','Stellen Sie hier Reload-Zeiten, Mindestauffenthalt und so weiter pro Werbeart und Werbenetzwerk ein. Es werden sonst Standart-Werte (Mimimumwerte: 0, Maximumwerte: sehr gross, Erotik: aus) angenommen, die Sie meistens nicht wollen.',2);
207                 addAdminMenuSql('network','query_networks','APIs abfragen','Fragt alle eingestellten APIs ab. Die Ergebnisse werden dann f&uuml;r einen einstellbaren Zeitraum gecacht und nicht erneut angefordert.',3);
208                 addAdminMenuSql('network','config_network','Einstellungen','Stellen Sie generelle Einstellungen ein, die f&uuml;r alle Werbenetzwerke gelten, wie z.B. Cache-Erneuerungsinterval. Generell sind aber die Einstellungen in Ordnung, da z.B. sonst Ihre freien Abfragen beim Werbenetzwerk sich zu schnell abbauen.',4);
209                 addAdminMenuSql('network','list_networks','Auflisten/Verwalten','<strong>Experten-Einstellungen!</strong> Hier &auml;ndern Sie die Einstellungen an den Grunddaten (Stammdaten) des jeweiligen Werbenetzwerks ab. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',5);
210                 addAdminMenuSql('network','list_network_types','Werbearten verwalten','<strong>Experten-Einstellungen!</strong> Hier &auml;ndern Sie die Einstellungen zu den Werbearten pro Werbenetzwerken. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',6);
211                 addAdminMenuSql('network','list_network_params','Abfrageparameter','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Abfrageparameter (wie sie genannt werden m&uuml;ssen, um das API-Script korrekt aufrufen zu k&ouml;nnen) ein, pro Werbenetzwerk. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',7);
212                 addAdminMenuSql('network','list_network_code_types','R&uuml;ckgabewerte','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die R&uuml;ckgabewerte ein, die im Falle eines Fehlers pro API-Script kommen k&ouml;nnen. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',8);
213                 addAdminMenuSql('network','list_network_codes','Fehlercodes einstellen','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Namen von Fehlercodes ein, die Scripte zur&uuml;ckliefern k&ouml;nnen. <strong>Dies sind INTERNE Daten und sollten nur vom MXChange-Entwicklerteam angepasst werden.</strong> Stellen Sie an diesen Einstellungen bitte nichts um. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',9);
214
215                 // Configuration entries
216                 addExtensionSql('ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `network_cache_refresh` BIGINT(20) UNSIGNED NOT NULL DEFAULT ' . (60 * 15) . '');
217                 break;
218
219         case 'remove': // Do stuff when removing extension
220                 // SQL commands to run
221                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`');
222                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`');
223                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`');
224                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_codes`');
225                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_translations`');
226                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config`');
227                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_config`');
228                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_cache`');
229                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_array_translation`');
230
231                 // Admin menu
232                 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admin_menu` WHERE `action`='network'");
233                 break;
234
235         case 'activate': // Do stuff when admin activates this extension
236                 // SQL commands to run
237                 break;
238
239         case 'deactivate': // Do stuff when admin deactivates this extension
240                 // SQL commands to run
241                 break;
242
243         case 'update': // Update an extension
244                 switch (getCurrentExtensionVersion()) {
245                         case '0.0.1': // SQL queries for v0.0.1
246                                 addExtensionSql('');
247
248                                 // Update notes (these will be set as task text!)
249                                 setExtensionUpdateNotes('');
250                                 break;
251                 } // END - switch
252                 break;
253
254         case 'modify': // When the extension got modified
255                 break;
256
257         case 'test': // For testing purposes. For details see file inc/modules/admin/what-extensions.php, arround line 305.
258                 break;
259
260         case 'init': // Do stuff when extension is initialized
261                 break;
262
263         default: // Unknown extension mode
264                 DEBUG_LOG(__FILE__, __LINE__, sprintf("Unknown extension mode %s detected.", getExtensionMode()));
265                 break;
266 } // END - switch
267
268 // [EOF]
269 ?>