ext-network continued, documentation updated, stelzi's fix integrated:
[mailer.git] / inc / extensions / ext-network.php
index b8a65d7..2fa8178 100644 (file)
@@ -1,7 +1,7 @@
 <?php
 /************************************************************************
- * MXChange v0.2.1                                    Start: 12/18/2008 *
- * ================                             Last change: 11/01/2009 *
+ * Mailer v0.2.1-FINAL                                Start: 12/18/2008 *
+ * ===================                          Last change: 11/01/2009 *
  *                                                                      *
  * -------------------------------------------------------------------- *
  * File              : ext-network.php                                  *
  * Needs to be in all Files and every File needs "svn propset           *
  * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
  * -------------------------------------------------------------------- *
+ * @TODO Ad-Magnet: Layer(klick?). Layerviews.Skybannerklick/-view,     *
+ * @TODO Ad-Magnet: Banner-View, Textlink-Klick/-View. Page-Peel        *
+ * @TODO ADCocktail: Traffic, BIDausKAS???                              *
+ * @TODO Ads4.de: Traffic                                               *
+ * @TODO Ads4Webbis: Traffic                                            *
+ * @TODO Ads4World: Traffic                                             *
+ * @TODO Affiliblatt: All except banner                                 *
+ * @TODO doubleads: Which charset?                                      *
+ * @TODO Fusion-Ads: Has click/banner URL in API response               *
+ * @TODO GolloX: Which charset?                                         *
+ * @TODO homeADS: Which charset?                                        *
+ * @TODO make-euros: Which charset?                                     *
+ * @TODO paid4ad: Waiting for approval                                  *
+ * -------------------------------------------------------------------- *
  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
  * For more information visit: http://www.mxchange.org                  *
  *                                                                      *
@@ -62,37 +76,39 @@ switch (getExtensionMode()) {
 `network_data_seperator` CHAR(4) NOT NULL DEFAULT '|',
 `network_row_seperator` CHAR(4) NOT NULL DEFAULT '|',
 `network_request_type` ENUM('GET','POST') NOT NULL DEFAULT 'GET',
-`network_charset` VARCHAR(20) NOT NULL DEFAULT 'ISO-8859-1',
+`network_charset` VARCHAR(20) NOT NULL DEFAULT 'UTF-8',
 UNIQUE (`network_short_name`),
 PRIMARY KEY (`network_id`)
 ) TYPE={?_TABLE_TYPE?} COMMENT='Network data'");
 
                // Types the network provider is supporting (e.g. Forced-Banner and so on)
-               // @TODO network_type_name is an internal name and needs documentation
+               // @TODO network_type_handle is an internal name and needs documentation
                addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`');
                addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types` (
 `network_type_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
-`network_type_name` VARCHAR(255) NOT NULL DEFAULT '',
-`network_type_title` VARCHAR(255) NOT NULL DEFAULT '',
-`network_type_request_url` VARCHAR(255) NOT NULL DEFAULT '',
+`network_type_handle` VARCHAR(255) NOT NULL DEFAULT '',
+`network_type_api_url` VARCHAR(255) NOT NULL DEFAULT '',
 `network_type_click_url` VARCHAR(255) NOT NULL DEFAULT '',
 `network_type_banner_url` VARCHAR(255) NOT NULL DEFAULT '',
-UNIQUE `provider_type` (`network_id`,`network_type_name`),
+`network_param_default` VARCHAR(255) NULL DEFAULT NULL,
+UNIQUE `provider_type` (`network_id`,`network_type_handle`),
 PRIMARY KEY (`network_type_id`)
-) TYPE={?_TABLE_TYPE?} COMMENT='Types provideable by networks. ONLY FILL OUT WITH PROPER IDEA!'");
+) TYPE={?_TABLE_TYPE?} COMMENT='Types provideable by networks'");
 
                // HTTP parameters (names) for URLs
                addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`');
                addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_request_params` (
+`network_param_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+`network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
-`request_param_max_reload_time` VARCHAR(10) NOT NULL DEFAULT 'reload',
-`request_param_min_waiting_time` VARCHAR(10) NOT NULL DEFAULT 'ma',
-`request_param_min_remain_clicks` VARCHAR(10) NOT NULL DEFAULT 'uebrig',
-`request_param_min_payment` VARCHAR(10) NOT NULL DEFAULT 'verguetung',
-`request_param_allow_erotic` VARCHAR(10) NOT NULL DEFAULT 'erotik',
-PRIMARY KEY (`network_type_id`)
-) TYPE={?_TABLE_TYPE?} COMMENT='Request parameters for GET/POST request ONLY FILL OUT WITH PROPER IDEA!'");
+`request_param_key` VARCHAR(10) NOT NULL DEFAULT 'invalid',
+`request_param_value` VARCHAR(10) NOT NULL DEFAULT 'invalid',
+`request_param_default` VARCHAR(10) NULL DEFAULT NULL,
+UNIQUE `provider_type_key` (`network_id`,`network_type_id`,`request_param_key`),
+UNIQUE `provider_type_value` (`network_id`,`network_type_id`,`request_param_value`),
+PRIMARY KEY (`network_param_id`)
+) TYPE={?_TABLE_TYPE?} COMMENT='Request parameters for GET/POST request'");
 
                // Error status codes
                addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_codes`');
@@ -160,7 +176,7 @@ PRIMARY KEY (`network_id`)
 `max_reload_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 `min_waiting_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 `min_remain_clicks` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
-`min_payment` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
+`min_payment` FLOAT(20,5) UNSIGNED NOT NULL DEFAULT 0.00000,
 `allow_erotic` VARCHAR(10) NOT NULL DEFAULT '',
 UNIQUE `provider_type` (`network_id`,`network_type_id`),
 PRIMARY KEY (`network_data_id`)
@@ -187,7 +203,7 @@ PRIMARY KEY (`network_cache_id`)
 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 `network_reload_lock` SMALLINT(5) UNSIGNED NOT NULL DEFAULT 0,
-`network_inserted` TIMESTAMP NOT NULL CURRENT_TIMESTAMP(),
+`network_inserted` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP(),
 UNIQUE `provider_type` (`network_id`,`network_type_id`),
 PRIMARY KEY (`network_reload_id`)
 ) TYPE={?_TABLE_TYPE?} COMMENT='Reload locks'");
@@ -212,6 +228,112 @@ PRIMARY KEY (`network_reload_id`)
                // - Request parameters incomplete
                addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUEST_PARAMS_INCOMPLETE')");
 
+               // Sponsor networks
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_data` (`network_short_name`, `network_title`, `network_reflink`, `network_data_seperator`, `network_row_seperator`, `network_request_type`, `network_charset`) VALUES ('yoomedia', 'Yoo!Media Solutions', 'http://www.yoomedia.de?ref=1715', '|', '|', 'GET', 'WINDOWS-1252')");
+
+               // Network type handlers - Yoo!Media (Please use http://www.yoomedia.de?ref=1715 for signing up)
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_types` (`network_id`,`network_type_handle`,`network_type_api_url`,`network_type_click_url`,`network_type_banner_url`) VALUES (1, 'banner', 'http://www.yoomedia.de/interface_2.0/out_banner.php', 'http://www.yoomedia.de/code/z-bannerklf.php?id=%ID%&sid=%SID%', 'http://www.yoomedia.de/code/z-banner.php?id=%ID%&sid=%SID%&bid=%BID%'),
+(1, 'surfbar', 'http://www.yoomedia.de/interface_2.0/out_sbanner.php', 'http://www.yoomedia.de/code/s-bannerklf.php?id=%ID%&sid=%SID%', 'http://www.yoomedia.de/code/s-banner.php?id=%ID%&sid=%SID%&bid=%BID%'),
+(1, 'focredbanner', 'http://www.yoomedia.de/interface_2.0/out_fbanner.php', 'http://www.yoomedia.de/code/f-bannerklf.php?id=%ID%&sid=%SID%', 'http://www.yoomedia.de/code/f-banner.php?id=%ID%&sid=%SID%&bid=%BID%'),
+(1, 'textlink', 'http://www.yoomedia.de/interface_2.0/out_textlink.php', 'http://www.yoomedia.de/code/t-textlink.php?id=%ID%&sid=%SID%', ''),
+(1, 'layer', 'http://www.yoomedia.de/interface_2.0/out_layer.php', 'http://www.yoomedia.de/code/l-layer.php?id=%ID%&sid=%SID%', ''),
+(1, 'popup', 'http://www.yoomedia.de/interface_2.0/out_popup.php', 'http://www.yoomedia.de/code/p-popup.php?id=%ID%&sid=%SID%', ''),
+(1, 'popdown', 'http://www.yoomedia.de/interface_2.0/out_popdown.php', 'http://www.yoomedia.de/code/p-popdown.php?id=%ID%&sid=%SID%', ''),
+(1, 'textmail', 'http://www.yoomedia.de/interface_2.0/out_textmail.php', 'http://www.yoomedia.de/code/t-mail.php?id=%ID%&sid=%SID%', ''),
+(1, 'htmlmail', 'http://www.yoomedia.de/interface_2.0/out_htmlmail.php', 'http://www.yoomedia.de/code/h-mail.php?id=%ID%&sid=%SID%', ''),
+(1, 'lead', 'http://www.yoomedia.de/interface_2.0/out_lead.php', 'http://www.yoomedia.de/code/lead.php?id=%ID%&sid=%SID%', ''),
+(1, 'pagepeel', 'http://www.yoomedia.de/interface_2.0/out_pagepeel.php', 'http://www.yoomedia.de/code/p-peel.php?id=%ID%&sid=%SID%', '')");
+
+               // Request parameters per type handler - Yoo!Media
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 1, 'id', 'id'),
+(1, 1, 'sid', 'sid'),
+(1, 1, 'password', 'pw'),
+(1, 1, 'reload', 'reload'),
+(1, 1, 'remain', 'uebrig'),
+(1, 1, 'reward', 'verguetung'),
+(1, 1, 'size', 'size'),
+(1, 1, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 3, 'id', 'id'),
+(1, 3, 'sid', 'sid'),
+(1, 3, 'password', 'pw'),
+(1, 3, 'reload', 'reload'),
+(1, 3, 'min_stay', 'ma'),
+(1, 3, 'remain', 'uebrig'),
+(1, 3, 'reward', 'verguetung'),
+(1, 3, 'size', 'size'),
+(1, 3, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 9, 'id', 'id'),
+(1, 9, 'sid', 'sid'),
+(1, 9, 'password', 'pw'),
+(1, 9, 'reload', 'reload'),
+(1, 9, 'min_stay', 'ma'),
+(1, 9, 'remain', 'uebrig'),
+(1, 9, 'reward', 'verguetung'),
+(1, 9, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 5, 'id', 'id'),
+(1, 5, 'sid', 'sid'),
+(1, 5, 'password', 'pw'),
+(1, 5, 'reload', 'reload'),
+(1, 5, 'remain', 'uebrig'),
+(1, 5, 'reward', 'verguetung'),
+(1, 5, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 10, 'id', 'id'),
+(1, 10, 'sid', 'sid'),
+(1, 10, 'password', 'pw'),
+(1, 10, 'reload', 'reload'),
+(1, 10, 'remain', 'uebrig'),
+(1, 10, 'reward', 'verguetung'),
+(1, 10, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 11, 'id', 'id'),
+(1, 11, 'sid', 'sid'),
+(1, 11, 'password', 'pw'),
+(1, 11, 'reload', 'reload'),
+(1, 11, 'remain', 'uebrig'),
+(1, 11, 'reward', 'verguetung'),
+(1, 11, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 7, 'id', 'id'),
+(1, 7, 'sid', 'sid'),
+(1, 7, 'password', 'pw'),
+(1, 7, 'reload', 'reload'),
+(1, 7, 'min_stay', 'ma'),
+(1, 7, 'remain', 'uebrig'),
+(1, 7, 'reward', 'verguetung'),
+(1, 7, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 6, 'id', 'id'),
+(1, 6, 'sid', 'sid'),
+(1, 6, 'password', 'pw'),
+(1, 6, 'reload', 'reload'),
+(1, 6, 'min_stay', 'ma'),
+(1, 6, 'remain', 'uebrig'),
+(1, 6, 'reward', 'verguetung'),
+(1, 6, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 2, 'id', 'id'),
+(1, 2, 'sid', 'sid'),
+(1, 2, 'password', 'pw'),
+(1, 2, 'reload', 'reload'),
+(1, 2, 'remain', 'uebrig'),
+(1, 2, 'reward', 'verguetung'),
+(1, 2, 'size', 'size'),
+(1, 2, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 4, 'id', 'id'),
+(1, 4, 'sid', 'sid'),
+(1, 4, 'password', 'pw'),
+(1, 4, 'reload', 'reload'),
+(1, 4, 'remain', 'uebrig'),
+(1, 4, 'reward', 'verguetung'),
+(1, 4, 'erotic', 'erotik')");
+               addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_request_params` (`network_id`,`network_type_id`,`request_param_key`,`request_param_value`) VALUES (1, 8, 'id', 'id'),
+(1, 8, 'sid', 'sid'),
+(1, 8, 'password', 'pw'),
+(1, 8, 'reload', 'reload'),
+(1, 8, 'min_stay', 'ma'),
+(1, 8, 'remain', 'uebrig'),
+(1, 8, 'reward', 'verguetung'),
+(1, 8, 'erotic', 'erotik')");
+
+               // Fix empty defaults to NULL
+               addExtensionSql("UPDATE `{?_MYSQL_PREFIX?}_network_request_params` SET `request_param_default`=NULL WHERE `request_param_default`=''");
+
                // Admin menu entries
                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);
                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);
@@ -220,10 +342,10 @@ PRIMARY KEY (`network_reload_id`)
                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);
                addAdminMenuSql('network','list_network_reloads','Reload-Sperren','Listen oder l&ouml;schen Sie hier Reload-Sperren. <strong>Vorsicht:</strong> Die hier gespeicherten Reload-Sperren sind vom jeweiligen Werbenetzwerk &uuml;bernommen. Eventuell verdienen Sie nichts, wenn Sie z.B. eine Mail innerhalb der Reload-Sperre erneut versenden.',5);
                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.',6);
-               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.',7);
+               addAdminMenuSql('network','list_network_types','Werbearten','<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.',7);
                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.',8);
                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.',9);
-               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.',10);
+               addAdminMenuSql('network','list_network_codes','Fehlercodes','<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 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.',10);
 
                // Configuration entries
                addExtensionSql('ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `network_cache_refresh` BIGINT(20) UNSIGNED NOT NULL DEFAULT ' . (60 * 15) . '');
@@ -275,7 +397,7 @@ PRIMARY KEY (`network_reload_id`)
                break;
 
        default: // Unknown extension mode
-               DEBUG_LOG(__FILE__, __LINE__, sprintf("Unknown extension mode %s detected.", getExtensionMode()));
+               logDebugMessage(__FILE__, __LINE__, sprintf("Unknown extension mode %s detected.", getExtensionMode()));
                break;
 } // END - switch