<?php
/************************************************************************
* MXChange v0.2.1 Start: 12/18/2008 *
- * ================ Last change: 12/18/2008 *
+ * ================ Last change: 11/01/2009 *
* *
* -------------------------------------------------------------------- *
* File : ext-network.php *
* -------------------------------------------------------------------- *
* Short description : Generic (sponsor) network connection extension *
* -------------------------------------------------------------------- *
- * Kurzbeschreibung : Allgemeine Sponsornetzwerk Erweiterung *
+ * Kurzbeschreibung : Allgemeine Sponsorennetzwerk-Erweiterung *
* -------------------------------------------------------------------- *
* $Revision:: $ *
* $Date:: $ *
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`");
addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_data` (
`network_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
-`network_name` VARCHAR(255) NOT NULL DEFAULT '',
+`network_short_name` VARCHAR(50) NOT NULL DEFAULT '',
`network_title` VARCHAR(255) NOT NULL DEFAULT '',
`network_reflink` VARCHAR(255) NOT NULL DEFAULT '',
`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',
-UNIQUE (`network_name`),
+`network_charset` VARCHAR(20) NOT NULL DEFAULT 'ISO-8859-1',
+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
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`");
addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types` (
`network_type_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
+`network_id` BIGINT(20) 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_click_url` VARCHAR(255) NOT NULL DEFAULT '',
`network_type_banner_url` VARCHAR(255) NOT NULL DEFAULT '',
-UNIQUE (`network_type_name`),
+UNIQUE `provider_type` (`network_id`,`network_type_name`),
+PRIMARY KEY (`network_type_id`)
+) TYPE={?_TABLE_TYPE?} COMMENT='Types provideable by networks. ONLY FILL OUT WITH PROPER IDEA!'");
+
+ // HTTP parameters (names) for URLs
+ addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`");
+ addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_request_params` (
+`network_type_id` BIGINT(20) 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='Types provideable by networks'");
+) TYPE={?_TABLE_TYPE?} COMMENT='Request parameters for GET/POST request ONLY FILL OUT WITH PROPER IDEA!'");
// Error status codes
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_errors`");
addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_type_codes` (
`network_type_code_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
+`network_type_id` BIGINT(20) NOT NULL DEFAULT 0,
`network_type_code_value` VARCHAR(50) NOT NULL DEFAULT '',
`network_type_code_type` VARCHAR(100) NOT NULL DEFAULT 'INVALID_TYPE',
-`network_type_id` BIGINT(20) NOT NULL DEFAULT 0,
UNIQUE `code_type` (`network_type_code_value`,`network_type_id`),
INDEX (`network_type_id`),
PRIMARY KEY (`network_type_code_id`)
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_codes`");
addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_codes` (
`network_code_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
-`network_code_type` VARCHAR(100) NOT NULL DEFAULT 'INVALID_TYPE',
-UNIQUE (`network_code_type`),
+`network_code` VARCHAR(100) NOT NULL DEFAULT 'INVALID_CODE',
+UNIQUE (`network_code`),
PRIMARY KEY (`network_code_id`)
) TYPE={?_TABLE_TYPE?} COMMENT='Error types, generic data, DO NOT ALTER!'");
- // Which network provider is serving which types
- addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_provider_types`");
- addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_provider_types` (
-`network_prodider_type_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
-`network_id` BIGINT(20) NOT NULL DEFAULT 0,
-`network_type_id` BIGINT(20) NOT NULL DEFAULT 0,
-UNIQUE `provider_type` (`network_id`, `network_type_id`),
-PRIMARY KEY (`network_provider_type_id`)
-) TYPE={?_TABLE_TYPE?} COMMENT='Connection table between provider and types'");
-
// Data from the webmaster (you!)
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config_data`");
addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_config_data` (
PRIMARY KEY (`network_id`)
) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data from the webmaster (you!)'");
+ // Configuration data for e.g. reload-time
+ addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_data`");
+ addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types_data` (
+`network_data_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
+`network_id` BIGINT(20) NOT NULL DEFAULT 0,
+`network_type_id` BIGINT(20) NOT NULL DEFAULT 0,
+`max_reload_time` BIGINT(20) NOT NULL DEFAULT 0,
+`min_waiting_time` BIGINT(20) NOT NULL DEFAULT 0,
+`min_remain_clicks` BIGINT(20) NOT NULL DEFAULT 0,
+`min_payment` BIGINT(20) NOT NULL DEFAULT 0,
+`allow_erotic` VARCHAR(10) NOT NULL DEFAULT '',
+INDEX `network_affiliate` (`network_id`,`network_affiliate_id`),
+PRIMARY KEY (`network_data_id`)
+) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data for every type (e.g. reload-time)'");
+
// Insert error code types
// - Affiliate id or interface password wrong
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('AFF_ID_PASS_WRONG')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('AFF_ID_PASS_WRONG')");
// - Webmaster's site id is not assigned (invalid, different affiliate id)
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('SITE_ID_NOT_ASSIGNED')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ASSIGNED')");
// - Webmaster's site id is locked
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('SITE_ID_LOCKED')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_LOCKED')");
// - General error in interface data
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('INTERFACE_DATA_ERROR')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('INTERFACE_DATA_ERROR')");
// - Request amount depleted
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('REQUESTS_DEPLETED')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUESTS_DEPLETED')");
// - No campaigns found for given criteria (but maybe there are with more widen criteria)
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('NO_CAMPAIGNS_FOUND')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND')");
// - No campaigns found with allowed interface output (but there are maybe non-interface campaigns)
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('NO_CAMPAIGNS_FOUND_INTERFACE')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND_INTERFACE')");
// - Webmaster's site id is not unlocked for choosen type
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('SITE_ID_NOT_ALLOWED_TYPE')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ALLOWED_TYPE')");
// - Request parameters incomplete
- addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code_type`) VALUES ('REQUEST_PARAMS_INCOMPLETE')");
+ addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUEST_PARAMS_INCOMPLETE')");
// Admin menu entries
- addAdminMenuSql('network',NULL,'Sponsorennetzwerke','Verwalten Sie hier Sponsornetzwerke (API-Anbindung), versenden Sie deren Mails, oder übernehmen Sie deren Textlinks und vieles mehr. <strong>VORSICHT:</strong> Das Einrichten von weiteren Sponsornetzwerken ist nicht leicht, dafür aber sehr flexibel! Sollte ein Netzwerk fehlen, so melden Sie dies bitte <a href="http://forum.mxchange.org" target="_blank" title="Direktlink zum Forum">im Forum</a>!',4);
+ addAdminMenuSql('network',NULL,'Sponsorennetzwerke','Verwalten Sie hier Sponsorennetzwerke (API-Anbindung), versenden Sie deren Mails, oder übernehmen Sie deren Textlinks und vieles mehr. <strong>VORSICHT:</strong> Das Einrichten von weiteren Sponsorennetzwerken ist nicht leicht, dafü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_network','API-Daten','Stellen Sie Ihre Affiliate- Webseiten-Id und API-Passwort ein. Diese erhalten Sie zu über 99% aus dem jeweiligen Zugangsbereich des Anbieters. Sollten Sie bei einem Netzwerk noch nicht angemeldet sein, verwenden Sie bitte meinen Referal-Link.',1);
+ addAdminMenuSql('network','config_network_types','Werbearten','Stellen Sie hier Reload-Zeiten, Mindestauffenthalt und so weiter pro Werbeart und Sponsorennetzwerk ein. Es werden sonst Standart-Werte (Mimimumwerte: 0, Maximumwerte: sehr gross, Erotik: aus) angenommen, die Sie meistens nicht wollen.',2);
+ addAdminMenuSql('network','list_networks','Auflisten/Verwalten','<strong>Experten-Einstellungen!</strong> Hier ändern Sie die Einstellungen an den Grunddaten (Stammdaten) des jeweiligen Sponsorennetzwerks 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 Sponsorennetzwerk einrichten möchten.',3);
+ addAdminMenuSql('network','list_network_types','Werbearten verwalten','<strong>Experten-Einstellungen!</strong> Hier ändern Sie die Einstellungen zu den Werbearten pro Sponsorennetzwerken. 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 Sponsorennetzwerk einrichten möchten.',4);
+ addAdminMenuSql('network','list_network_params','Abfrageparameter','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Abfrageparameter (wie sie genannt werden müssen, um das API-Script korrekt aufrufen zu können) ein, pro Sponsorennetzwerk. 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 Sponsorennetzwerk einrichten möchten.',5);
+ addAdminMenuSql('network','list_network_code_types','','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Rückgabewerte ein, die im Falle eines Fehlers pro API-Script kommen kö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 Sponsorennetzwerk einrichten möchten.',7);
+ addAdminMenuSql('network','list_network_codes','Fehlercodes einstellen','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Namen von Fehlercodes ein, die Scripte zurückliefern kö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 Sponsorennetzwerk einrichten möchten.',7);
break;
case 'remove': // Do stuff when removing extension
// SQL commands to run
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`");
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`");
+ addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`");
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_errors`");
- addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_provider_types`");
addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config_data`");
+ addExtensionSql("DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_data`");
// Admin menu
addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admin_menu` WHERE `action`='network'");